Cómo conseguir una API key de Claude en la Console

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, comprar créditos prepago y crear la clave en Settings → API keys. Tu suscripción Pro o Max no incluye esa clave. Son dos productos distintos, con cuentas de facturación distintas, aunque uses el mismo correo para los dos.

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 dice claramente: un plan de pago de Claude mejora la experiencia de chat, pero no incluye acceso a la Claude API ni a la Console. 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 y los planes de equipo. Pagas una cuota fija y tienes límites de uso por sesión.

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 funciona con créditos prepago. Primero compras saldo y después cada llamada lo va consumiendo según la tarifa vigente. Sin saldo, la clave existe pero las llamadas no funcionan.

El camino es este:

1. En la Console, abre Settings → Billing.
2. Pulsa Buy credits.
3. Escribe el importe que quieres cargar.
4. Confirma el pago.

Según el artículo de ayuda de Anthropic sobre cómo pagar el uso de la API (leído el 3 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 un importe de recarga, y la Console recarga sola cuando bajas de ese mínimo. 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.

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), y el saldo de créditos también se muestra en 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.

1. Abre Settings → API keys.
2. Pulsa Create key.
3. Escribe un nombre que diga para qué sirve, por ejemplo portatil-pruebas o vps-bot-telegram.
4. En Linked account, elige el tipo de clave: tú mismo (clave personal) o una cuenta de servicio.
5. Elige la caducidad.
6. Si quieres, elige el workspace al que queda limitada la clave.
7. 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, la causa es tu rol: tu rol en la organización no 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_KEY

Ahora 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 3 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 3 de octubre de 2026):

• authentication_error, con código 401, significa un problema con la clave: mal copiada, revocada o caducada. Comprueba la variable con echo ${#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.
• rate_limit_error, con código 429, significa que has superado un límite de peticiones o el tope de gasto mensual de tu nivel de uso. 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 no fija una cadena de texto que puedas buscar, y el código exacto puede cambiar. 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.

Una advertencia final: las claves baratas que se venden fuera de la Console suelen ser acceso revendido a la cuenta de otra persona, y pueden dejar de funcionar en cualquier momento.

FAQ: preguntas frecuentes

¿Mi suscripción Claude Pro o Max incluye una API key?

No. Pro, Max, Team y Enterprise son planes de claude.ai, la aplicación de chat. La API se contrata aparte en la Claude Console, en platform.claude.com, con créditos prepago propios. 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 3 de octubre de 2026, los créditos 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.

¿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 significa que la API no acepta la clave: está mal copiada, revocada o caducada. 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.