Cómo conseguir una API key de Anthropic (clave de API de Claude) en 2026: pasos, créditos y opciones gratis

Una clave de API de Anthropic (también llamada API key de Claude) se crea en la Claude Console: inicia sesión en platform.claude.com, abre la página de claves de API, haz clic en Create key (crear clave) y copia la clave, que empieza por sk-ant- y solo se muestra una vez. La API de Claude es prepago, así que también necesitas créditos en la página Billing para que las solicitudes funcionen. No hay un nivel gratuito continuo de la API: el FAQ de precios de Anthropic solo dice que los nuevos usuarios reciben una pequeña cantidad de créditos gratis para probar la API, sin indicar el importe. Los planes Max 5x, Max 20x y Team incluyen créditos de API más grandes.

Esta guía recorre cada paso con los nombres exactos de la Console, muestra cómo configurar la variable ANTHROPIC_API_KEY en macOS, Linux y Windows, hace una primera solicitud de prueba, explica lo que cuestan las solicitudes y recoge los errores más habituales con su solución. Todo se comprobó con la documentación y el centro de ayuda de Anthropic el 17 de octubre de 2026.

Lo que necesitas antes de empezar

• Una cuenta de Claude Console. Es independiente de una suscripción al chat de claude.ai. Puedes entrar en la Console con el mismo correo, pero un plan Pro o Max no te da por sí solo acceso a la API ni créditos de API.
• Una tarjeta de pago o créditos incluidos. El FAQ de precios de Anthropic dice que se aceptan las principales tarjetas de crédito en las cuentas estándar, y los clientes enterprise pueden acordar facturación. Si tienes Max 5x, Max 20x o Team, puedes vincular una organización de la Console para recibir créditos mensuales en lugar de pagar con tarjeta.
• El rol adecuado en la Console. Para comprar créditos necesitas el rol Admin o Billing. Si te invitaron a la organización de otra persona y el botón Create key aparece en gris, tu rol no permite crear claves.
• Un sitio donde guardar el secreto. Un gestor de contraseñas o de secretos. Solo verás la clave una vez.

Paso 1: crea tu clave de API en la Claude Console

1. Ve a platform.claude.com e inicia sesión, o crea una cuenta de Claude Console.
2. Abre la página API keys en platform.claude.com/settings/keys.
3. Haz clic en Create key, ponle un nombre a la clave, elige una caducidad y en Linked account (cuenta vinculada) selecciónate a ti (clave personal) o a una cuenta de servicio. También puedes limitar la clave a un workspace.
4. Copia la clave completa enseguida y guárdala en un gestor de contraseñas o de secretos. La Console solo muestra la clave una vez, al crearla. Si la pierdes, no puedes volver a verla, así que tendrás que crear una nueva.

Si el botón Create key está desactivado, probablemente tu rol en la organización no permite crear claves. Pide a un administrador de la organización que cambie tu rol o que cree una clave de cuenta de servicio para ti.

Qué tipo de clave elegir

La documentación de autenticación de Anthropic explica por qué se prefieren las claves ligadas a una identidad: una clave personal o de cuenta de servicio deja de funcionar automáticamente cuando esa persona o carga de trabajo se elimina, así que las claves no sobreviven a sus dueños. Una clave personal compartida actúa como una sola persona y se rompe cuando esa persona se va, así que todo lo compartido debería usar una cuenta de servicio.

Elegir la caducidad

Al crear una clave eliges una caducidad predefinida de 3 horas, 1 día, 7 días o 30 días, una duración personalizada o Never (nunca) para claves que guardas en un gestor de secretos y rotas tú mismo. Si tu organización fija una política de caducidad máxima, Never no aparece. La caducidad se fija al crear la clave y no se puede cambiar después. Anthropic envía un correo a quien creó la clave antes de que caduque: 7 días antes para claves con una vida de al menos 14 días, y 1 día antes para claves con una vida de al menos 7 días. Las claves de vida más corta caducan sin aviso. Una clave caducada devuelve un 401 authentication_error y no se puede reactivar; tienes que crear una nueva.

Workspaces y la cabecera de workspace

Una clave limitada a un solo workspace solo funciona en ese workspace, y las solicitudes pueden omitir el ID del workspace. Una clave personal o de cuenta de servicio que funciona en varios workspaces necesita la cabecera anthropic-workspace-id en cada solicitud a la API de Claude. Puedes ver el ID de un workspace en la columna ID de la página Workspaces, en platform.claude.com/settings/workspaces. Para una primera clave, limitarla a un workspace es lo más sencillo.

Paso 2: añade créditos (facturación)

El uso de la API de Claude y del playground de la Console se paga con créditos de uso prepagados. Sin créditos, las solicitudes fallan con un error de saldo de crédito.

1. Inicia sesión en la Console con el rol Admin o Billing.
2. Ve a Settings > Billing, haz clic en Buy credits (comprar créditos), introduce un importe y confirma. Los créditos comprados están disponibles al momento.
3. Opcional: en la sección Credit balance, haz clic en Set up auto-reload (configurar recarga automática). Introduce un umbral en When credit balance reaches y un objetivo en Bring credit balance back up to. Si tu saldo ya está en el umbral o por debajo, se te cobra al momento para volver al objetivo, más los impuestos aplicables. Para desactivarla después, haz clic en Manage auto-reload y luego en Turn off.
4. Recomendado: en la sección Spend limits de la página Billing, haz clic en Adjust limit (o Set limit) para poner un tope al gasto mensual. Tu propio límite no puede superar el tope de tu nivel.

Según el centro de ayuda de Anthropic, los créditos comprados caducan un año después de la fecha de compra, la caducidad no se puede ampliar y ninguna compra de créditos es reembolsable. Los créditos caducados aparecen en Invoice history en la página Billing. Anthropic no publica un importe mínimo de compra en ese artículo. Para los precios por token, consulta precios de la API de Claude.

Niveles de uso y topes de gasto mensual

Cada organización tiene además un nivel de uso con un tope de gasto mensual. Anthropic asigna el nivel automáticamente según el historial de uso y la situación de la cuenta. Las organizaciones nuevas pueden empezar en un nivel Evaluation con límites más bajos que suben automáticamente a medida que se acumula historial. Puedes ver tu nivel en la página Rate limits, en platform.claude.com/usage/limits, y pedir más con Request tier increase en esa misma página.

Cuando tu organización alcanza el tope de su nivel, el uso de la API se pausa hasta las 00:00 UTC del primer día del mes siguiente, salvo que consigas antes un límite mayor. Cuando alcanza un límite de gasto más bajo que hayas fijado tú, las solicitudes fallan hasta que lo subas o lo quites. La sección de solución de problemas de abajo explica cómo distinguirlos.

Paso 3: configura la variable de entorno ANTHROPIC_API_KEY

Los SDK oficiales leen ANTHROPIC_API_KEY automáticamente, así que no tienes que pegar la clave en tu código. Para configurarla en la sesión de terminal actual en macOS, Linux o WSL:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Eso solo dura hasta que cierres la ventana. Para mantenerla en cada nueva terminal, la documentación del CLI de Anthropic añade la línea a tu perfil de shell. Para Zsh, el shell predeterminado en macOS:

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
source ~/.zshrc

Para Bash:

echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc
source ~/.bashrc

En Windows, configura una variable de entorno de usuario y abre una terminal nueva para que el cambio surta efecto:

setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Cualquier cosa que se ejecute con tu usuario puede leer una clave guardada en un perfil de shell, y es fácil olvidarse de ella. Si más adelante vuelves a usar Claude Code con una suscripción, o rotas la clave, acuérdate de quitar o actualizar esa línea. Para servidores y CI, usa el almacén de secretos de tu plataforma en lugar de un archivo de perfil.

Paso 4: haz una primera solicitud de prueba

Las solicitudes HTTP directas envían la clave en la cabecera x-api-key (la documentación de Anthropic dice que una cabecera Authorization: Bearer también funciona). Esta solicitud, sacada de la documentación de autenticación de Anthropic, comprueba que la clave y la facturación funcionan:

curl 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-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Una llamada correcta devuelve un JSON con un array content que contiene la respuesta de Claude. Un error devuelve un cuerpo JSON con un tipo de error como authentication_error; consulta la tabla de solución de problemas más abajo.

Python

Instala el SDK oficial:

pip install anthropic

Después llama a la API. Este es el ejemplo de inicio rápido de la documentación de Anthropic; el cliente toma ANTHROPIC_API_KEY por su cuenta:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What should I search for to find the latest developments in renewable energy?",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

TypeScript o JavaScript

npm install @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 1000,
  messages: [
    {
      role: "user",
      content: "What should I search for to find the latest developments in renewable energy?"
    }
  ]
});

for (const block of message.content) {
  if (block.type === "text") {
    console.log(block.text);
  }
}

Los SDK oficiales reintentan los fallos transitorios (errores de conexión, límites de uso y errores 5xx) dos veces por defecto con espera exponencial, y respetan la cabecera retry-after cuando está presente.

Lo que costarán tus primeras solicitudes

Pagas por millón de tokens (MTok), con precios distintos para entrada y salida. Estos son los precios estándar de la página de precios de Anthropic para tres modelos actuales:

Ejemplo práctico: una app pequeña envía 1,000 solicitudes al día, cada una con 2,000 tokens de entrada y 500 tokens de salida. Eso son 2 millones de tokens de entrada y 0.5 millones de tokens de salida al día.

• Opus 5.5: 2 × 4 $ + 0.5 × 20 $ = 8 $ + 10 $ = 18 $ al día
• Sonnet 5.5: 2 × 2 $ + 0.5 × 10 $ = 4 $ + 5 $ = 9 $ al día
• Haiku 5.5: 2 × 0.10 $ + 0.5 × 0.50 $ = 0.20 $ + 0.25 $ = 0.45 $ al día

Dos descuentos oficiales lo reducen aún más: la Message Batches API cuesta un 50 por ciento menos para trabajo que no necesita respuesta inmediata, y el prompt caching abarata mucho el contexto repetido (los aciertos de caché en Sonnet 5.5 cuestan 0.10 $ / MTok en lugar de 2 $). La tabla completa, con precios de escritura en caché y modelos antiguos, está en nuestra página de precios de la API de Claude.

¿Existe una API key de Anthropic gratis?

Solo una pequeña. El FAQ de precios de Anthropic dice que los nuevos usuarios reciben una pequeña cantidad de créditos gratis para probar la API; no publica el importe y no hay un nivel gratuito continuo. Para pruebas enterprise ampliadas, el FAQ remite al equipo de ventas de Anthropic. Las webs que regalan una API key de Claude suelen ser revendedores o proxies, no Anthropic, y estarías enviando tus prompts a través de un tercero. Estas son las vías oficiales para conseguir créditos de la API de Claude sin comprarlos directamente:

Ejemplo de créditos de Team según la documentación de Anthropic: un equipo con tres puestos Standard y dos Premium recibe 3 × 20 $ + 2 × 100 $ = 260 $ al mes. Añadir otro puesto Premium sube el crédito del mes siguiente a 360 $, y el fondo nunca supera los 500 $. Los créditos incluidos se gastan antes que los comprados, y una organización vinculada a un plan elegible sube como mínimo al nivel Start (o al menos a Build si sus créditos mensuales superan los 200 $).

Los créditos de API mensuales de los planes Max y Team cubren la API de Claude, Managed Agents, el Agent SDK y el playground, pero no Claude Code ni el uso extra en las apps de Claude, ni Claude en Bedrock, Google Cloud o Microsoft Foundry. Los planes Free, Pro y Enterprise no los reciben. Cada plan se vincula a una sola organización de la Console y no puedes cambiar el vínculo tú mismo, así que elige la organización en la que vas a desarrollar. Compara planes en precios de Claude.

Si estás comparando proveedores, nuestra guía de claves de API de IA gratis recoge qué APIs tienen niveles gratuitos reales, y la guía de la clave de API de Gemini cubre la de Google, que sí tiene nivel gratuito. Para más opciones, consulta cómo conseguir créditos de IA gratis.

Usar tu clave de API con Claude Code

Claude Code puede usar la misma clave. Si ANTHROPIC_API_KEY está configurada, Claude Code pregunta una vez si quieres usarla y, si lo apruebas, la clave tiene prioridad sobre tu inicio de sesión de Pro o Max. El uso se cobra entonces de tus créditos de API en lugar de tu suscripción. En modo no interactivo (la opción -p), la clave se usa siempre que está configurada. Si en cambio inicias sesión en Claude Code con una cuenta de la Console, Anthropic dice que se crea automáticamente un workspace "Claude Code" en la Console para seguir los costes.

Para volver a tu suscripción, elimina la variable en tu shell (y bórrala de tu perfil de shell para que no vuelva):

unset ANTHROPIC_API_KEY

Después inicia Claude Code y comprueba qué inicio de sesión está activo con este comando dentro de la sesión:

/status

Recuerda que los créditos de API mensuales de Max y Team no pagan Claude Code. Si una organización de la Console solo tiene esos créditos, Claude Code muestra el mensaje Credit balance too low (saldo de crédito demasiado bajo). Consulta precios de Claude Code para ver qué opción sale más barata, y cómo instalar Claude Code para la configuración.

Solución de errores con la clave de API

La API de Claude devuelve un error JSON con un código HTTP y un tipo de error. Estos son los que más aparecen al configurar una clave nueva, con la solución que da la documentación de Anthropic para cada uno.

La clave funciona en curl pero no en mi app

• Tu app se inició desde un shell o servicio que nunca cargó la variable. Las variables de entorno configuradas en una terminal no llegan a programas lanzados desde otro sitio, como un IDE abierto desde el Dock o un servicio de systemd. Configura la variable donde arranca ese programa, o pasa la clave desde tu gestor de secretos.
• En Windows, una variable configurada con setx solo aparece en las terminales abiertas después. Cierra y vuelve a abrir la terminal o el editor.
• Busca una clave antigua que esté sobrescribiendo la nueva, por ejemplo una línea olvidada en tu perfil de shell o un archivo .env que carga tu framework.

He perdido mi clave o creo que se ha filtrado

La Console nunca puede volver a mostrar el secreto de una clave, y Anthropic señala que la Admin API tampoco puede recuperar una clave perdida; solo devuelve una pista parcialmente oculta. Crea una clave nueva, cambia tus apps a ella y después desactiva o elimina la antigua en la página de claves de API. Disable (desactivar) es reversible (puedes volver a activar la clave), mientras que Delete (eliminar) es permanente.

El botón Create key aparece en gris

Tu rol en esa organización no permite crear claves. Pide a un administrador de la organización que cambie tu rol o que cree una clave de cuenta de servicio para tu carga de trabajo. Si te uniste solo para usar Claude Code, el rol Claude Code solo permite crear claves de Claude Code.

Me limitan el uso en una cuenta recién creada

Las organizaciones nuevas pueden empezar en el nivel Evaluation, cuyos límites están por debajo de los del nivel Start estándar mientras se acumula historial. Anthropic dice que estos límites suben automáticamente. Anthropic también señala que un aumento brusco del uso puede provocar errores 429 por límites de aceleración, así que aumenta el tráfico de forma gradual.

Consejos de seguridad para tu clave de API

• Nunca subas una clave a Git ni la pegues en código del lado del cliente, como un navegador o una app móvil. Cárgala desde una variable de entorno o un gestor de secretos en un servidor que controles.
• Elige una caducidad al crear la clave y usa claves de cuenta de servicio para sistemas compartidos o de producción.
• Da a cada proyecto su propio workspace con un límite de gasto de workspace para que una clave filtrada no pueda vaciar todo tu saldo.
• Fija en la página Billing un límite de gasto de organización por debajo del tope de tu nivel.
• Rota las claves periódicamente. Para cargas de trabajo en la nube, Anthropic también admite Workload Identity Federation, que sustituye las claves de larga duración por tokens de corta duración de un proveedor de identidad que ya uses.
• Si se filtra una clave, crea una nueva en la Console, cambia tus apps a ella y desactiva o elimina la antigua. Las claves perdidas no se pueden recuperar.