Cómo conseguir una API key de Claude en la Console
Pro no incluye la API y Max y Ultra traen créditos mensuales para ella. Así se compran créditos y se crea la clave en platform.claude.com, con su tipo, su caducidad y el IVA.
La respuesta corta: la API key de Claude no viene con tu plan
Para conseguir una API key de Claude tienes que entrar en la Claude Console, en platform.claude.com, y crear la clave en Settings → API keys. Ningún plan de claude.ai trae esa clave dentro de la aplicación de chat. Son dos productos distintos, con cuentas de facturación distintas, aunque uses el mismo correo para los dos. Lo que sí depende de tu plan es el saldo: Pro no incluye créditos mensuales para la API, y con Max o Ultra recibes cada mes créditos para la API si vinculas una organización de la Console a tu plan.
Esta confusión es muy común. Pagas Claude cada mes, buscas "claude api key" y esperas encontrar un botón dentro de claude.ai. Ese botón no existe. El centro de ayuda de Anthropic lo explica así (consultado el 31 de octubre de 2026): un plan de pago de Claude mejora la experiencia de chat, y la Claude API se factura aparte. El mismo artículo añade que los planes Max, Ultra y Team incluyen créditos mensuales para la Claude API. Si quieres las dos cosas, contratas el plan por un lado y configuras la Console por otro.
Dos cuentas: claude.ai y la Claude Console
claude.ai es la aplicación de chat. Ahí están Free, Pro, Max, Ultra y los planes de equipo. Los planes de pago tienen una cuota fija y límites de uso; Ultra tiene límites semanales y las cuentas Ultra verificadas no tienen límite de cinco horas.
platform.claude.com es la Claude Console. Mucha gente la busca como "Anthropic Console", "Claude Console" o "Claude platform". Es la misma cosa. Es la plataforma para desarrolladores: ahí creas claves, pruebas prompts en el playground, ves tu consumo y pagas por uso. Una API (interfaz de programación de aplicaciones) es la puerta que usa tu propio código para hablar con Claude, sin pasar por la ventana de chat.
La diferencia importa por el modelo de pago. En claude.ai pagas una cuota. En la Console pagas por los tokens que consumes, a un precio por millón de tokens. Si dudas cuál de los dos te sale más barato, la comparación de el coste de la API frente a la suscripción hace las cuentas con ejemplos.
Un caso especial es Claude Code. Puedes usar Claude Code con tu suscripción, iniciando sesión con tu cuenta de claude.ai, sin ninguna API key. Si lo que buscabas era eso, la guía sobre iniciar sesión en Claude Code con la suscripción o con una API key explica qué cambia en cada caso y de dónde se cobra cada uno.
Paso 1: entrar en platform.claude.com
Abre platform.claude.com e inicia sesión. Si es tu primera vez, la Console te pide crear una cuenta y una organización. La organización es el contenedor de la facturación: los créditos y las claves dependen de ella.
Durante el alta la Console te pide una dirección. Escríbela bien desde el principio, porque Anthropic usa la dirección de facturación para decidir qué impuesto te aplica. Volvemos a esto en la sección de impuestos.
Paso 2: comprar créditos prepago
La API de autoservicio funciona con créditos prepago. Primero compras saldo y después cada llamada lo va consumiendo según la tarifa vigente. Sin saldo en una organización de prepago, la clave existe pero las llamadas no funcionan. Algunas organizaciones de la Console pagan a mes vencido mediante un acuerdo de facturación con el equipo de Ventas de Anthropic, en lugar de comprar créditos por adelantado. Eso depende del acuerdo de la organización, no de la suscripción de chat.
Si tienes un plan Max o Ultra, puede que al principio no necesites comprar nada. Según la documentación de Anthropic (consultada el 31 de octubre de 2026), Max incluye 100 USD al mes en créditos para la Claude API y Ultra incluye 200 USD. Para recibirlos, abre Settings → Billing en claude.ai y, en la sección API credits, elige la organización de la Console que debe recibirlos. Elige bien, porque no puedes cambiar esa organización tú mismo. No hace falta añadir un método de pago en la Console, y si acabas de contratar Max o Ultra puedes reclamarlos tras 7 días. Estos créditos caducan al final de cada ciclo de facturación, no se acumulan y no cubren las sesiones interactivas de Claude Code. Sí cubren claude -p y el Claude Agent SDK cuando los ejecutas tú mismo con una API key de la organización vinculada; las ejecuciones desde GitHub Action, una extensión de IDE o la aplicación de escritorio no están cubiertas. Free, Pro y Enterprise no los tienen. Team y el resto de detalles están en los créditos mensuales de API de Max, Ultra y Team.
El camino para comprar créditos es este:
- En la Console, abre Settings → Billing.
- Pulsa Buy credits.
- Escribe el importe que quieres cargar.
- Confirma el pago.
Según el artículo de ayuda de Anthropic sobre cómo pagar el uso de la API (leído el 31 de octubre de 2026), los créditos están disponibles en cuanto se completa la compra. Aquí no aparece un importe mínimo: la página de Billing te muestra las opciones reales en el momento de pagar, y ese dato puede cambiar.
Antes de cargar mucho dinero, ten en cuenta dos reglas de ese mismo artículo. Primera: los créditos caducan un año después de la fecha de compra, y esa fecha no se puede ampliar. Segunda: todas las compras de créditos son no reembolsables. Por eso conviene empezar con una cantidad pequeña, probar tu proyecto y recargar después.
En la misma página de Billing está Auto-reload. Defines un saldo mínimo y el saldo al que quieres volver, y la Console recarga sola cuando llegas a ese mínimo. El umbral se aplica solo al saldo comprado: puede activar una recarga aunque todavía queden créditos mensuales incluidos en tu plan. Es cómodo para un servicio en producción. Para hacer pruebas, déjalo apagado, así un error en tu código no se convierte en una recarga tras otra. Si vas a dejar un agente funcionando solo en un servidor, la guía de control de costes para agentes de IA en un VPS explica cómo poner topes antes de que llegue una factura inesperada.
Una buena noticia: Anthropic solo cobra las llamadas que terminan bien. Una petición que falla no se descuenta del saldo. Si tu cliente se desconecta o agota su tiempo de espera durante una petición que iba a completarse correctamente, esa petición sí se cobra.
Y una pregunta frecuente: ¿hay saldo gratis para empezar? Eso cambia con el tiempo. Lo que hay y lo que no está explicado en el nivel gratuito de la API de Claude.
Pagar en dólares desde España o Latinoamérica
Los precios de la API se publican en dólares estadounidenses (USD). Si tu tarjeta está en euros, pesos mexicanos, pesos colombianos, pesos argentinos o soles, tu banco convierte el importe. Esa conversión tiene dos costes posibles: el tipo de cambio que aplica tu banco y una comisión por operación en divisa extranjera. Muchas tarjetas cobran esa comisión, y algunas tarjetas y cuentas multidivisa no la cobran. Qué tarjetas funcionan y cuánto se pierde en el cambio está en los métodos de pago de Claude y las comisiones por cambio de divisa, así que no lo repito aquí.
Sobre los impuestos, el centro de ayuda de Anthropic deja clara una regla: tu dirección de facturación decide tu jurisdicción fiscal. En la API de autoservicio, esa dirección va ligada a tu método de pago. La cambias en Settings → Billing, con el icono del lápiz junto al número de tu tarjeta. Esto significa que el IVA (impuesto sobre el valor añadido en España, impuesto al valor agregado en buena parte de Latinoamérica), o el impuesto equivalente de tu país, se calcula según esa dirección. Por eso debe ser la dirección real desde la que contratas el servicio.
Si compras como empresa y tienes un número de identificación fiscal o un NIF-IVA, añádelo en Settings → Organization y pulsa Save changes. Guárdalo antes de la compra, porque así aparece en el recibo. Anthropic envía un recibo por correo por cada compra de créditos, también por las que hace Auto-reload, y los usuarios con rol de administración o de facturación lo encuentran en la sección de Billing de la Console. Si necesitas ver cómo funcionan el IVA y las facturas en el lado de la suscripción, la guía de IVA y facturas de la suscripción de Claude lo cubre.
Cómo crear la API key de Claude en la Console
Con saldo en la cuenta, ya puedes crear la clave.
- Abre Settings → API keys.
- Pulsa Create key.
- Escribe un nombre que diga para qué sirve, por ejemplo
portatil-pruebasovps-bot-telegram. - En Linked account, elige el tipo de clave: tú mismo (clave personal) o una cuenta de servicio.
- Elige la caducidad.
- Si quieres, elige el workspace al que queda limitada la clave.
- Copia la clave que aparece.
Cada decisión tiene una razón.
El tipo de clave. Una clave personal actúa en tu nombre y deja de funcionar si sales de la organización. Una clave de cuenta de servicio representa a una cuenta de servicio, pensada para procesos automáticos como un bot, un pipeline de integración continua o un agente. La documentación lo resume así: clave personal para tu propio desarrollo, cuenta de servicio para todo lo compartido. Existe también la clave de workspace, un tipo antiguo sin dueño que sigue funcionando aunque su creador se vaya. Anthropic recomienda los otros dos tipos, porque dejan de funcionar solos cuando se elimina la cuenta asociada.
La caducidad. Una clave que caduca limita el daño si se filtra. Cuando caduca, la API la rechaza igual que a una clave revocada, así que apunta la fecha.
El workspace. Un workspace separa entornos dentro de la organización, por ejemplo pruebas y producción, y cada uno puede tener sus propios límites de gasto. Si la clave queda limitada a un solo workspace, tus peticiones corren en ese workspace sin cabeceras extra. Si la clave sirve para varios workspaces, cada petición debe incluir además la cabecera anthropic-workspace-id. Para empezar, elige un solo workspace y el resto de esta guía funciona tal cual.
Copiarla ahora. La Console muestra la clave completa, que empieza por sk-ant-, una sola vez: en el momento de crearla. Si cierras el diálogo sin copiarla, no hay forma de volver a verla. La solución es crear otra clave y borrar la perdida.
Si el botón Create key aparece desactivado, comprueba si tu rol en la organización te permite crear claves. Pide a un administrador que cambie tu rol o que cree una clave de cuenta de servicio para tu proyecto.
Probar la clave con una llamada a la API
La forma más directa de saber si todo funciona es una llamada a la Messages API con curl. La clave se lee de una variable de entorno. No la escribas dentro del comando, porque lo que escribes en la terminal queda guardado en el historial de la shell.
Este comando pide la clave sin mostrarla en pantalla y la guarda en la variable ANTHROPIC_API_KEY. Pega la clave y pulsa Enter:
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEYAhora haz la llamada:
curl -sS https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hola, Claude. Responde con una sola frase."}]
}'Una respuesta sana es un JSON con "type": "message" y un array content que incluye un bloque "type": "text" con la frase de Claude. También trae un campo usage con los tokens de entrada y de salida. Esos tokens son lo que se descuenta de tu saldo. El identificador claude-sonnet-5-5 corresponde a Claude Sonnet 5.5 en la tabla de modelos de Anthropic (consultada el 31 de octubre de 2026). Si un modelo cambia de nombre, consulta esa tabla y cambia solo esa línea.
Los SDK (kits de desarrollo de software) oficiales leen ANTHROPIC_API_KEY de forma automática. La misma variable te sirve cuando pases de curl a Python o a TypeScript.
Clave mala o saldo vacío: cómo distinguirlos
Si la llamada falla, la API devuelve un JSON con un objeto error que siempre tiene un type y un message. Lee los dos. No adivines la causa solo por el código HTTP.
Según la página de errores de la documentación (leída el 4 de noviembre de 2026):
authentication_error, con código 401, puede indicar un problema con la clave: mal copiada, revocada o caducada. Si elmessageempieza porCORS requests are not allowed for this Organization, la causa es una restricción de la organización a las peticiones directas desde el navegador, no un problema con la clave. Envía esas peticiones desde tu propio back end. Para comprobar la variable, usaecho ${#ANTHROPIC_API_KEY}, que imprime solo su longitud y no la clave. Si la longitud es 0, la variable está vacía en esta terminal.billing_error, con código 402, significa un problema con la facturación o con el método de pago. Revisa Settings → Billing.permission_error, con código 403, significa que la clave no tiene permiso para ese recurso. Suele ser un problema de workspace o de rol.invalid_request_error, con código 400, cubre peticiones mal formadas. También aparece cuando llegas a un límite de gasto que tú mismo pusiste en la organización o en el workspace, salvo los límites del workspace de Claude Code, que pueden devolver un 429.rate_limit_error, con código 429, significa que has superado un límite de peticiones, el tope de gasto mensual de tu nivel de uso o un límite de gasto del workspace de Claude Code. Las cabeceras de límite de la API de Claude te dicen cuánto margen te queda.
Para el saldo vacío, la documentación sí recoge un mensaje que empieza por Your credit balance is too low to access the Anthropic API. La comprobación útil es leer el message y, si habla de crédito o de saldo, abrir Settings → Billing. Guarda también el campo request_id de la respuesta, porque el soporte de Anthropic lo pide para localizar una petición concreta.
Después de crear la clave
Una clave en una variable de tu portátil sirve para probar. En un servidor necesitas algo más: guardarla fuera del código y rotarla sin cortar el servicio. Todo eso está en cómo guardar y rotar la API key de Claude en un servidor. Cuando la clave funcione, el siguiente paso es tu primera aplicación con la API de Claude en un VPS, que empieza justo donde termina esta guía.
FAQ: preguntas frecuentes
¿Mi suscripción Claude Pro o Max incluye una API key?
La clave no, pero Max y Ultra sí incluyen saldo para la API. Pro, Max, Ultra, Team y Enterprise son planes de claude.ai, la aplicación de chat, y la clave siempre se crea aparte en la Claude Console, en platform.claude.com. Free, Pro y Enterprise no incluyen créditos mensuales para la API: pagas su uso por separado, con créditos prepago o a mes vencido si la organización de la Console tiene un acuerdo de facturación con Ventas. Max y Ultra incluyen 100 y 200 USD al mes en créditos para la API, que llegan a la organización de la Console que vincules a tu plan, y Team incluye créditos compartidos de hasta 500 USD al mes (documentación consultada el 31 de octubre de 2026). Puedes usar el mismo correo para las dos cuentas, pero la facturación es independiente.
¿Dónde se crea la API key de Claude?
En la Claude Console, en platform.claude.com, dentro de Settings → API keys. Pulsa Create key, ponle nombre, elige si es personal o de cuenta de servicio, elige la caducidad y, si quieres, un workspace. La clave empieza por sk-ant- y solo se muestra una vez. Si la pierdes, crea otra.
¿Los créditos de la API caducan o se pueden devolver?
Según el centro de ayuda de Anthropic, leído el 31 de octubre de 2026, los créditos que compras caducan un año después de la fecha de compra y esa fecha no se puede ampliar. Todas las compras de créditos son no reembolsables. Por eso conviene comprar poco al principio y recargar cuando sepas cuánto consume tu proyecto. Los créditos mensuales de Max, Ultra y Team funcionan de otra forma: caducan al final de cada ciclo de facturación y no se acumulan.
¿Me cobran IVA al comprar créditos de la API desde España o Latinoamérica?
Anthropic calcula los impuestos según tu dirección de facturación, que en la API de autoservicio va ligada a tu tarjeta. Si compras como empresa, añade tu número fiscal o NIF-IVA en Settings → Organization antes de comprar, para que aparezca en el recibo. Además del impuesto, tu banco puede cobrar una comisión por convertir los dólares a tu moneda.
¿Por qué mi API key de Claude devuelve un error 401?
Un 401 con authentication_error puede indicar que la clave está mal copiada, revocada o caducada. Si el message empieza por CORS requests are not allowed for this Organization, la clave no es el problema: la organización prohíbe las peticiones directas desde el navegador y debes enviarlas desde tu propio back end. Comprueba que la variable ANTHROPIC_API_KEY no está vacía con echo ${#ANTHROPIC_API_KEY}, que imprime su longitud, y que la clave sigue activa en Settings → API keys. Un problema de saldo o de pago da otro tipo de error, así que lee siempre el type y el message.