Cómo conseguir una clave API de Claude (guía 2026)
Updated 2026-07-15
Crea una cuenta en console.anthropic.com, compra créditos prepagados con una tarjeta y luego genera una clave en Settings y API Keys. Si no puedes añadir una tarjeta, una clave de gateway prepagada llega por correo y funciona con el mismo código.
Respuesta rápida: tres pasos hasta una clave API de Claude
Para conseguir una clave API de Claude de Anthropic: crea una cuenta en console.anthropic.com, compra créditos prepagados en Plans and billing (se requiere una tarjeta de crédito o débito), luego abre Settings, ve a API Keys y haz clic en Create Key. La clave empieza por sk-ant- y se muestra exactamente una vez, así que cópiala a un gestor de contraseñas o una variable de entorno de inmediato. Dos cosas confunden a la gente. Primero, una suscripción de chat Claude Pro o Max no incluye acceso a la API; la Console es un producto separado con facturación separada. Segundo, las peticiones fallan con un error de crédito hasta que has comprado créditos de verdad, aunque la creación de la clave en sí funcione sin pago. Si tu primera llamada devuelve un error sobre tu saldo, esa es la razón. Si no puedes añadir una tarjeta, o quieres una sola clave que llegue a Claude además de otras familias de modelos, un gateway prepagado es la alternativa práctica. Esa ruta se cubre al final de esta guía, con las contrapartidas dichas sin rodeos.
Paso 1: crea una cuenta de Anthropic Console
La Console en console.anthropic.com es el panel de desarrollador de Anthropic, y es distinta de la app de chat claude.ai. Regístrate con una dirección de correo o una cuenta de Google. Anthropic te pide verificar un número de teléfono durante el registro, y el acceso a la API está limitado a países soportados, así que revisa la lista de disponibilidad de Anthropic si el flujo de registro te bloquea en este paso. Durante la configuración creas una organización. Claves, créditos, límites de tasa y registros de uso pertenecen todos a la organización y no a tu inicio de sesión personal. Esto importa más adelante si invitas a compañeros de equipo: todos comparten el mismo fondo de créditos, y los administradores pueden ver el uso desglosado por clave. Nada cuesta dinero todavía en esta fase. Puedes navegar la lista de modelos, leer la referencia de la API y abrir el Workbench, un playground de navegador para probar prompts contra los modelos de Claude, antes de añadir ningún dato de facturación. El Workbench es útil para comprobar que un prompt se comporta como esperas antes de escribir una sola línea de código de integración.
Paso 2: configura la facturación antes de tu primera petición
La API de Anthropic es prepagada. En Plans and billing, añade una tarjeta y compra un bloque inicial de créditos; la compra mínima es pequeña, históricamente cinco dólares. Cada llamada a la API descuenta de este saldo a tarifas por token, así que no hay factura sorpresa a fin de mes. Cuando el saldo llega a cero, las peticiones se detienen. Dos ajustes merecen configurarse desde el primer día. Auto-reload recarga el saldo automáticamente cuando baja de un umbral que tú fijas. Actívalo para cargas de trabajo de producción para que un saldo agotado nunca se convierta en una caída de servicio. Déjalo desactivado para experimentos, así un bucle descontrolado no puede gastar más de lo que cargaste a propósito. Los límites de tasa escalan con los niveles de uso. Las organizaciones nuevas empiezan en el nivel más bajo, y los límites de peticiones por minuto y tokens por minuto suben a medida que crece tu gasto acumulado. Si ves respuestas 429 durante un pico de tráfico en una cuenta joven, el sistema de niveles suele ser la causa, no tu código.
Paso 3: crea la clave y haz tu primera llamada
En la Console, abre Settings, luego API Keys, luego Create Key. Ponle a la clave un nombre que identifique la app o el entorno al que pertenece, porque acabarás teniendo varias y las claves sin nombre se vuelven imposibles de auditar. El valor completo de la clave se muestra solo en el momento de la creación; después de cerrar el diálogo, la Console solo muestra una versión truncada. Exporta la clave como variable de entorno y pruébala desde la terminal antes de tocar el código de la aplicación. Dos detalles propios de Anthropic sorprenden a quien migra desde otros proveedores: la autenticación usa una cabecera x-api-key en lugar de Authorization: Bearer, y toda petición debe incluir una cabecera anthropic-version. Una cabecera de versión ausente falla con un mensaje de error claro, así que lee el cuerpo de la respuesta cuando algo se rompa.
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-sonnet-4-6",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Say hello in five words."}]
}'Seguridad de la clave: cinco hábitos que evitan una mala semana
Estos hábitos son baratos de adoptar el primer día y caros de aplicar después de un incidente. Si de verdad subes una clave por accidente, trátala como filtrada incluso en un repositorio privado: revócala, rótala y limpia el historial de commits. Escáneres de secretos como gitleaks en un hook de pre-commit atrapan el error antes de que salga de tu máquina.
- Solo variables de entorno o un gestor de secretos. Una clave pegada en el código fuente acabará subida a un repositorio, y hay scrapers que vigilan repositorios públicos buscando específicamente el prefijo sk-ant-.
- Una clave por app y por entorno. Claves separadas para desarrollo, staging y producción hacen legibles los registros de uso y te permiten revocar una superficie sin romper las demás.
- Nunca publiques una clave en código de navegador o móvil. Cualquier cosa en JavaScript del lado del cliente es pública por definición. Enruta las llamadas a través de tu propio backend y mantén la clave en el servidor.
- Revoca de inmediato ante cualquier filtración sospechada. Borrar una clave en la Console la mata al instante; crea primero la clave de reemplazo si la app tiene que seguir activa durante la rotación.
- Configura notificaciones de gasto. Un umbral de alerta de facturación convierte una clave filtrada o en bucle de una factura grande en una pequeña, y no cuesta nada configurarlo.
Lo que cuesta una llamada a Claude, con las opciones más baratas al lado
Claude se factura por token, con tarifas separadas de entrada y de salida, y los tokens de salida dominan la factura en generación de formato largo. Compara ambas columnas, no solo el precio de entrada del titular. Para dar contexto, la tabla de abajo lista Claude junto a otros modelos disponibles a través del catálogo del gateway descrito en la siguiente sección. DeepSeek es aproximadamente el favorito de la comunidad para tráfico económico de alto volumen, y Claude sigue siendo la elección cuando la calidad de la prosa es la prioridad.
| Modelo | Entrada / 1M tokens | Salida / 1M tokens |
|---|---|---|
| claude-opus-4-7 | $4.00 | $20.00 |
| claude-sonnet-4-6 | $2.40 | $12.00 |
| gpt-5.5 | $4.00 | $24.00 |
| gemini-3.5-flash | $1.20 | $7.20 |
| glm-5 | $0.514 | $2.314 |
| deepseek-v4-pro | $0.3915 | $0.783 |
| deepseek-v4-flash | $0.126 | $0.252 |
¿Sin tarjeta? Consigue una clave funcional a través de un gateway
Si el requisito de tarjeta, un bloqueo regional o la propia configuración de la cuenta es el obstáculo, APIsRouter es la ruta de gateway que documenta este sitio. Es un gateway compatible con OpenAI: el checkout en /topup no requiere registro, pagas primero y la clave llega por correo. La facturación es pago por uso sin suscripción. Los modelos globales corren con un 20% por debajo del precio oficial de lista, los modelos chinos quedan por debajo de sus tarifas oficiales, y tu primera recarga añade un 100% al saldo. Apunta cualquier SDK de OpenAI a https://api.apisrouter.com/v1 y pasa un ID de modelo del catálogo: claude-sonnet-4-6 o claude-opus-4-7 para la familia Claude, deepseek-v4-flash o glm-5 cuando quieras tokens más baratos desde la misma clave. La misma clave también funciona en apps de usuario final. Los usuarios de SillyTavern pegan la URL base terminada en /v1 y la lista de modelos se rellena automáticamente desde /v1/models. JanitorAI necesita el endpoint completo https://api.apisrouter.com/v1/chat/completions más un nombre de modelo y la clave. La contrapartida frente a una clave directa de Anthropic es honesta y simple: estás confiando tu tráfico a un intermediario, y las funciones del lado de Anthropic llegan según el calendario del gateway. La ventaja es un solo saldo y un solo endpoint entre Claude, GPT, Gemini, DeepSeek y GLM en lugar de una cuenta de facturación separada por proveedor.
| Clave de Anthropic Console | Clave de gateway | |
|---|---|---|
| Tarjeta requerida | Sí, tarjeta de crédito o débito | No, se paga en el checkout |
| Configuración de cuenta | Registro en Console más verificación de teléfono | Ninguna, la clave llega por correo |
| Modelo de facturación | Créditos prepagados, auto-reload opcional | Recargas de pago por uso |
| Modelos cubiertos | Solo la familia Claude | Claude, GPT, Gemini, DeepSeek, GLM, Kimi |
| Forma de la API | Anthropic Messages API | Chat completions compatible con OpenAI |
| Endpoint | https://api.anthropic.com/v1/messages | https://api.apisrouter.com/v1/chat/completions |
from openai import OpenAI
client = OpenAI(
api_key="sk-...", # arrives by email after checkout
base_url="https://api.apisrouter.com/v1",
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)Preguntas frecuentes
¿Cómo consigo una clave API de Anthropic?
Crea una cuenta en console.anthropic.com, verifica tu número de teléfono, compra créditos prepagados en Plans and billing, y luego ve a Settings, API Keys, Create Key. Copia la clave sk-ant- de inmediato; se muestra solo una vez.
¿Es gratis usar la API de Claude?
No. No hay un nivel de API gratuito. La app de chat claude.ai tiene un plan gratuito, pero el acceso a la API se factura por token y requiere créditos comprados antes de que las peticiones tengan éxito. Una pequeña recarga prepagada cubre una cantidad sorprendente de peticiones de prueba cortas, así que probar Claude cuesta centavos, no dólares.
¿Puedo usar la API de Claude sin tarjeta de crédito?
No directamente a través de Anthropic, que requiere una tarjeta para comprar créditos. La solución alternativa es una clave de gateway prepagada: paga a través de un checkout que admita tu método de pago, recibe una clave por correo, y llama a los modelos de Claude a través de un endpoint compatible con OpenAI.
¿Por qué no funciona mi clave API de Claude?
Cuatro causas habituales, en orden de probabilidad: aún no se han comprado créditos (la clave se autentica pero las peticiones se rechazan), la cabecera de autenticación equivocada (Anthropic espera x-api-key, no Authorization: Bearer), una cabecera anthropic-version ausente, o un ID de modelo mal escrito. El cuerpo del error nombra la parte que falla, así que léelo antes de cambiar código.
¿Una suscripción Claude Pro incluye acceso a la API?
No. Claude Pro y Max cubren solo las apps de claude.ai. La API se factura por separado a través de la Console con créditos prepagados, y ningún saldo se transfiere al otro.
¿Caducan las claves API de Anthropic?
No. Las claves siguen siendo válidas hasta que las revocas en la Console. Es justo por eso que importan las claves por app y la rotación periódica: una clave olvidada de un proyecto paralelo antiguo sigue funcionando hasta que alguien la borra.