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:
| Plan | Crédito mensual de API (USD) |
|---|---|
| Max 5x | 100 al mes |
| Max 20x | 200 al mes |
| Team | 20 por asiento estándar y 100 por asiento premium, sumados en un solo saldo con tope de 500 al mes |
| Free, Pro y Enterprise | No 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.
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
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.
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.
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.
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.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.
# 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:
| Nivel | Tope de gasto mensual |
|---|---|
| Evaluation | Cuentas nuevas o con poco historial, con límites menores (la documentación no da cifras) |
| Start | USD 500 |
| Build | USD 1.000 |
| Scale | USD 200.000 |
| Custom | Sin 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:
| Modelo | ID en la API | Entrada | Salida | Contexto |
|---|---|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 | 10,00 | 50,00 | 1M tokens |
| Claude Opus 5.5 | claude-opus-5-5 | 4,00 | 20,00 | 1M tokens |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | 2,00 | 10,00 | 1M tokens |
| Claude Haiku 5.5 | claude-haiku-5-5 | 0,10 | 0,50 | 1M 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 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:
pip install anthropic
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_KEYdefinida 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 conanthropic-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 tu empresa ya paga Claude Team o Enterprise y quiere que el equipo lo use de verdad: capacitación en Claude para empresas.
- Si es el área de tecnología la que va a integrar la API en su código: Claude Code para equipos de tecnología.
- Si quieres que el equipo deje procesos funcionando con IA conectada a sus herramientas: el curso de automatización de procesos con IA.
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 →Sigue aprendiendo con nuestros cursos
Domina Claude para Negocios
MarketingEstrategia de Marketing con IA
ContenidoStorytelling con IA y Creación de Contenido
Preguntas frecuentes
¿Cómo obtener la API key de Claude?
¿La API de Claude es gratis?
¿Claude Pro incluye la API?
¿Cuánto cuesta la API de Claude?
¿Dónde compro créditos de la API de Claude y cuándo vencen?
¿Claude Code usa la API key?
¿Puedo usar Claude desde AWS, Google Cloud o Azure?
¿Qué hago si pierdo la API key o se filtra?
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
