← Blog  /  ■ Herramientas IA

Claude API key: cómo obtenerla y usar la API de Claude paso a paso

La suscripción y la API son dos productos distintos. Aquí está cómo sacar la llave en la consola, cuánto cuesta cada modelo y el código para tu primera llamada.

Por Luisa Navarro · 18/10/2026 · 10 min de lectura

Luisa Navarro es cofundadora de PorContar, ingeniera industrial, magíster en Big Data y magíster en inteligencia artificial. Enseña a equipos de empresa a llevar la IA a sus procesos reales.

Para obtener tu Claude API key, entra a Claude Console en platform.claude.com, compra créditos en Settings → Billing y crea la llave en platform.claude.com/settings/keys con el botón Create key. La API se paga aparte de la suscripción Pro, por consumo de tokens, y la llave solo se muestra una vez: guárdala en la variable de entorno ANTHROPIC_API_KEY.

La mayoría de las guías sobre este tema están en inglés. Esta va en español y está verificada en la documentación oficial de Anthropic a octubre de 2026.

Qué es la API de Claude y para qué sirve

La API de Claude es el acceso para usar los modelos de Claude desde tus propios sistemas. En vez de abrir claude.ai, un programa le manda la instrucción y recibe la respuesta: un flujo que resume contratos para que un abogado los revise, un CRM que redacta seguimientos, un tablero que clasifica solicitudes.

La API key es la credencial de ese acceso. Cada llamada la lleva en el encabezado x-api-key, junto con la versión de la API (anthropic-version: 2023-06-01). Quien la tenga puede gastar tus créditos.

El cobro es por tokens, y cada modelo tiene su precio. Para entender las diferencias entre Fable, Opus, Sonnet y Haiku, mira los modelos de Claude explicados.

¿Claude Pro incluye la API? Suscripción vs. API

Pro no incluye la API. La ayuda oficial de Anthropic lo dice así: los planes pagos de Claude y Claude Console son productos separados, y la API se factura aparte.

Hay una excepción nueva. A octubre de 2026, según la ayuda de Anthropic sobre créditos mensuales de API, los planes Max y Team traen un crédito mensual para la API:

PlanCrédito mensual de API (USD)
Max 5x100 al mes
Max 20x200 al mes
Team20 por asiento estándar y 100 por asiento premium, sumados en un solo saldo con tope de 500 al mes
Free, Pro y EnterpriseNo incluyen

El crédito se reclama vinculando una organización de Claude Console al plan; si te acabas de suscribir, después de 7 días. Sirve para la API, el Playground de la consola, Claude Managed Agents y el Agent SDK. No sirve para Claude Code interactivo, ni para el uso extra de las apps, ni para Claude en Bedrock, Google Cloud o Foundry. Y no se acumula: lo que no uses vence al cerrar cada ciclo.

Si usas Claude Code con tu suscripción: cuando la variable ANTHROPIC_API_KEY está definida, Claude Code usa esa llave y cobra a la API en vez de usar tu plan. Si no quieres pagar por los dos lados, no la dejes definida en la terminal donde trabajas con Claude Code.

Cómo obtener la API key de Claude paso a paso

  1. Entra a Claude Console

    La consola vive en platform.claude.com. La dirección vieja, console.anthropic.com, redirige ahí, y la documentación está en platform.claude.com/docs.

  2. Compra créditos

    En Settings → Billing (platform.claude.com/settings/billing) pulsa Buy credits. Lo hace un usuario con rol Admin o Billing, con las principales tarjetas de crédito. Las cuentas nuevas pueden recibir un pequeño crédito de prueba; Anthropic no publica el monto.

  3. Crea la llave

    En platform.claude.com/settings/keys pulsa Create key. Le pones un nombre, una fecha de vencimiento y la cuenta vinculada (Linked account): tú o una cuenta de servicio.

  4. Cópiala en ese momento

    La llave empieza por sk-ant- y solo se muestra una vez. Si cierras la ventana sin copiarla, tendrás que crear otra.

  5. Guárdala en una variable de entorno

    La variable recomendada es ANTHROPIC_API_KEY. El SDK oficial (la librería de Anthropic para cada lenguaje de programación) la lee de ahí, así que la llave nunca tiene que aparecer en tu código.

Variable de entorno
# macOS / Linux
export ANTHROPIC_API_KEY="tu_api_key"

# Windows (PowerShell)
setx ANTHROPIC_API_KEY "tu_api_key"

Reemplaza tu_api_key por tu llave. En Windows, la variable queda disponible en las terminales que abras después.

Qué tipo de llave crear

Hay tres tipos: llave personal, llave de cuenta de servicio y llave de workspace, que es heredada y Anthropic no la recomienda. Para una integración de la empresa, la cuenta de servicio evita que la llave dependa de una persona que mañana puede cambiar de cargo.

Cómo comprar créditos de la API de Claude

La API y el Playground se pagan con créditos prepagados. Según la ayuda y la documentación de precios de Anthropic, a octubre de 2026:

  • Se compran en Settings → Billing → Buy credits. Las empresas pueden pactar el pago por factura.
  • Recarga automática cuando el saldo baja de un umbral que tú defines.
  • Vencen un año después de la compra, el plazo no se puede extender y no son reembolsables.
  • Algunas organizaciones pagan mes vencido en vez de prepagar.
  • Monto mínimo de compra: no está publicado.

Niveles de uso y topes de gasto de la API de Claude

Anthropic asigna un nivel a cada cuenta según su historial y su estado, sin que tengas que pedirlo. A octubre de 2026 son cinco, cada uno con un tope de gasto mensual:

NivelTope de gasto mensual
EvaluationCuentas nuevas o con poco historial, con límites menores (la documentación no da cifras)
StartUSD 500
BuildUSD 1.000
ScaleUSD 200.000
CustomSin tope; se pacta con ventas

Al llegar al tope, la API se pausa hasta las 00:00 UTC del primer día del mes siguiente y responde con un error 429. Puedes fijar un límite propio más bajo en Billing → Spend limits, y también límites por workspace. Para subir de nivel, usa Request tier increase en platform.claude.com/usage/limits.

Como referencia, en el nivel Start con Claude Opus 5.5 el límite es de 1.000 solicitudes por minuto, 2.000.000 de tokens de entrada por minuto y 400.000 de salida por minuto. Los tokens leídos de caché no cuentan para el límite de entrada en casi todos los modelos.

Si una guía habla de «Tier 1 a Tier 4» con depósitos fijos, está desactualizada: esos niveles ya no están en la documentación.

Precio de la API de Claude por modelo

La API de Claude cobra por millón de tokens, con un precio para lo que el modelo lee (entrada) y otro para lo que escribe (salida). Precios de la API directa de Anthropic, en USD por millón de tokens, a octubre de 2026:

ModeloID en la APIEntradaSalidaContexto
Claude Fable 5.1claude-fable-5-110,0050,001M tokens
Claude Opus 5.5claude-opus-5-54,0020,001M tokens
Claude Sonnet 5.5claude-sonnet-5-52,0010,001M tokens
Claude Haiku 5.5claude-haiku-5-50,100,501M tokens

Haiku 5.5 tiene esos precios en prompts de hasta 100.000 tokens; por encima, cuesta USD 0,50 de entrada y USD 2,50 de salida. La Batch API, que responde de forma asíncrona, cobra la mitad del precio normal. Siguen disponibles modelos de generaciones anteriores.

Fable 5.1 es el más capaz de la familia, y la recomendación oficial para empezar es Claude Opus 5.5. Nuestra regla para empresas: prueba la tarea con el modelo más pequeño que pueda resolverla y sube solo si falla. Entre Haiku 5.5 y Fable 5.1 hay 100 veces de diferencia por token.

¿Tu empresa ya paga Claude Team o Enterprise?

En la capacitación cada área aprende a usar Claude sobre su trabajo real, con reglas claras de qué información entra a la herramienta y quién revisa lo que sale.

Ver la capacitación en Claude para empresas →

Tu primera llamada a la API de Claude: cURL y Python

Estos ejemplos siguen el quickstart oficial de Anthropic, con dos cambios nuestros: el mensaje va en español y max_tokens es 1024 (el quickstart usa 1000 y una pregunta en inglés). El modelo es el mismo: claude-opus-5-5.

cURL · adaptado del quickstart oficial
curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hola, Claude"}
    ]
  }'

Para Python, instala primero el SDK oficial:

Instalación
pip install anthropic
Python · adaptado del quickstart oficial
import anthropic

client = anthropic.Anthropic()  # lee la llave de la variable ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hola, Claude"}],
)
for block in response.content:
    if block.type == "text":
        print(block.text)

El cliente lee la llave de ANTHROPIC_API_KEY, así que no aparece en el código. La respuesta llega en bloques, y el ejemplo imprime los que son de texto. Si Claude te saluda de vuelta, tu llave funciona.

Claude en Amazon Bedrock, Google Cloud (Vertex AI) y Microsoft Foundry

Si tu empresa ya tiene contrato con una nube, puedes usar Claude desde ahí, con las credenciales y la facturación de esa nube:

  • Amazon Bedrock: los IDs llevan el prefijo anthropic. (por ejemplo, anthropic.claude-opus-5-5). Necesitas una región de AWS y pagas el precio que fija Bedrock.
  • Google Cloud (Vertex AI): la documentación de Anthropic ahora lo llama «Google Cloud's Agent Platform». Usa el mismo ID sin prefijo (claude-opus-5-5), pide un proyecto y una región de Google Cloud, y se autentica con credenciales de Google, no con la llave de Anthropic. El precio lo fija Google.
  • Microsoft Foundry: mismas tarifas que la API directa, facturadas por Azure Marketplace.
  • Claude Platform on AWS: operada por Anthropic dentro de AWS, con las funciones nuevas el mismo día.

Dos cosas cambian frente a la API directa: la llave de Anthropic no sirve en Google Cloud, y los créditos mensuales de Max y Team no aplican en Bedrock, Google Cloud ni Foundry.

Cómo proteger tu Claude API key

  • Nunca dentro del código ni en un repositorio público. Va en una variable de entorno o en un gestor de secretos.
  • Ponle fecha de vencimiento al crearla. La consola te la pide en el mismo formulario.
  • Usa cuentas de servicio para producción y deja las llaves personales para pruebas.
  • No crees llaves de workspace. Son heredadas y no se recomiendan.
  • Fija un límite de gasto propio en Billing → Spend limits, más bajo que el tope de tu nivel, y límites por workspace si tienes varios equipos.
  • Una llave por integración. Si una se expone, la eliminas sin tumbar las demás.

Errores comunes con la API de Claude

  • Creer que Pro incluye la API. No la incluye; Max y Team traen un crédito mensual que hay que activar.
  • Dejar ANTHROPIC_API_KEY definida mientras usas Claude Code con tu plan. Pasa a cobrar a la API.
  • Cerrar la ventana sin copiar la llave. Solo se muestra una vez.
  • Mandar la llave en el encabezado equivocado. La API de Claude la espera en x-api-key, junto con anthropic-version.
  • Guiarse por los niveles viejos. Hoy son Evaluation, Start, Build, Scale y Custom.
  • Llegar al tope mensual sin saberlo. La API responde 429 hasta el primer día del mes siguiente.
  • Usar la llave de Anthropic en Google Cloud. Ahí se autentica con credenciales de Google.
  • Esperar que el crédito de Max sirva en Bedrock o en Claude Code interactivo. No aplica.

Cómo lleva una empresa la API de Claude al trabajo real

Sacar la llave toma minutos. Lo que toma criterio es decidir qué proceso conectar, qué información puede salir hacia la API y quién revisa lo que vuelve. En PorContar damos capacitación en IA para empresas sobre el trabajo real de cada área, y la API encaja en tres rutas:

Si aprendes por tu cuenta, mira los cursos de IA para personas. Y si estás comparando proveedores, la misma guía existe para la OpenAI API key y para la API de Perplexity.

Antes de conectar Claude, mide cómo usa la IA tu equipo

El diagnóstico es gratuito y toma dos minutos: ves en qué nivel de adopción está tu equipo y por dónde conviene empezar.

Hacer el diagnóstico de IA →

Preguntas frecuentes

¿Cómo obtener la API key de Claude?
Entra a Claude Console en platform.claude.com, compra créditos en Settings → Billing → Buy credits y crea la llave en platform.claude.com/settings/keys con el botón Create key. La llave empieza por sk-ant- y solo se muestra una vez: guárdala en la variable de entorno ANTHROPIC_API_KEY.
¿La API de Claude es gratis?
No. Se paga con créditos prepagados que se descuentan por tokens. Las cuentas nuevas pueden recibir un pequeño crédito de prueba, sin monto publicado, y a octubre de 2026, según la ayuda de Anthropic, los planes Max y Team traen un crédito mensual de API.
¿Claude Pro incluye la API?
No. Pro no incluye uso de la API: la suscripción y Claude Console son productos separados. A octubre de 2026, según la ayuda de Anthropic, Max y Team traen un crédito mensual de API que se activa vinculando una organización de Claude Console; Free, Pro y Enterprise no lo tienen.
¿Cuánto cuesta la API de Claude?
Depende del modelo. A octubre de 2026, por millón de tokens de entrada y salida: Claude Fable 5.1 cuesta USD 10 y USD 50; Claude Opus 5.5, USD 4 y USD 20; Claude Sonnet 5.5, USD 2 y USD 10; Claude Haiku 5.5, USD 0,10 y USD 0,50 en prompts de hasta 100.000 tokens. La Batch API cobra la mitad.
¿Dónde compro créditos de la API de Claude y cuándo vencen?
En Claude Console, Settings → Billing → Buy credits, con un usuario de rol Admin o Billing. Los créditos vencen un año después de la compra, el plazo no se puede extender y no son reembolsables. Anthropic no publica un monto mínimo de compra.
¿Claude Code usa la API key?
Claude Code funciona con una suscripción Pro, Max, Team o Enterprise, o con una cuenta de Claude Console que paga por uso. Si tienes definida la variable ANTHROPIC_API_KEY, Claude Code usa esa llave y cobra a la API en vez de usar tu suscripción.
¿Puedo usar Claude desde AWS, Google Cloud o Azure?
Sí. Claude está en Amazon Bedrock, en Google Cloud (Vertex AI) y en Microsoft Foundry. En Bedrock y Google Cloud el precio lo fija cada nube y se usan sus credenciales; en Foundry se aplican las tarifas estándar de la API, facturadas por Azure Marketplace.
¿Qué hago si pierdo la API key o se filtra?
La llave solo se muestra una vez, al crearla. Si la perdiste o crees que se expuso, crea una nueva en platform.claude.com/settings/keys, cámbiala en tus aplicaciones y elimina la anterior. Un límite de gasto propio en Billing reduce el daño mientras tanto.

Datos verificados el 17 de octubre de 2026 en la documentación oficial de Anthropic: API key, precios, niveles de uso, pago de la API y créditos de Max y Team · Revisión trimestral

¿Te sirvió? Esto llega cada semana

Guías como esta, casos y estrategias de IA para tu negocio. Gratis y directo al grano.

Más guías de API

Más
Hablemos en WhatsAppDiagnóstico