Inicio / Aprende / Cómo obtener una clave de API de Claude
Claves de API de Claude. Una llave dibujada con esmero abre una puerta hecha a partir de una ventana de código.

Cómo obtener una clave de API de Claude

Puedes obtener una clave de API de Claude en la consola de Claude de Anthropic para acceder directamente a la API, o crear una cuenta de AI Prime Tech para acceder a través de esta pasarela independiente. Elige primero tu proveedor: su clave, facturación y URL base deben corresponder entre sí. Los pasos siguientes cubren ambas vías y muestran cómo comprobar una clave de la pasarela antes de enviar la primera solicitud.

Elige dónde obtener tu clave de API de Claude

Una clave de API identifica la cuenta o el proyecto que paga las solicitudes. Las credenciales del chat de Claude y una clave de API tienen funciones diferentes. Si quieres la interfaz de chat o las funciones de suscripción, compara el acceso a la API de Claude y las suscripciones antes de comprar uso de la API.

Vía Dónde crear una clave Facturación y endpoint
Acceso directo a AnthropicConsola de ClaudeCuenta de Anthropic y facturación de la API; api.anthropic.com
AI Prime TechCrea una cuenta, y después abre Claves de API en el panelCréditos de la pasarela o un plan por tiempo elegible; aiprimetech.io

AI Prime Tech opera de forma independiente y no está afiliado a Anthropic ni cuenta con su respaldo. Utiliza la vía que se ajuste a tus requisitos de integración, facturación y soporte; las cuentas y las claves son independientes.

Obtén una clave en la consola oficial de Claude

  1. Inicia sesión en la Consola de Claude y selecciona el espacio de trabajo que utilizarás.
  2. Revisa la facturación de la API y los límites de uso de la cuenta. Completa cualquier configuración que la consola requiera para tu cuenta.
  3. Abre Claves API, crea una clave para tu aplicación y guárdala de forma segura cuando se muestre.
  4. Sigue la guía oficial de inicio rápido de Anthropic para las solicitudes directas. Mantén el endpoint oficial para esta vía; el ejemplo de la pasarela que aparece a continuación utiliza una clave de AI Prime Tech.

Crea una clave de AI Prime Tech

  1. Regístrate en AI Prime Tech y completa la verificación que se muestra durante el registro.
  2. Elige créditos de API de prepago para la facturación basada en el uso o revisa los planes por tiempo de Claude. Comprueba la oferta actual, los modelos elegibles y los límites antes de pagar. Si quieres evaluar primero el servicio, la guía de prueba muestra las ofertas de bienvenida actuales y sus condiciones.
  3. Abre Claves de API en el panel y crea una clave para esta aplicación. Comprueba el grupo seleccionado y las restricciones de la clave para que coincidan con el acceso a Claude que compraste.
  4. Copia la clave en una variable de entorno local o en un gestor de secretos. Utiliza una clave distinta para cada aplicación para poder identificar el uso y sustituir una clave sin cambiar todas las integraciones.

La creación de una clave y el pago no demuestran que una integración funcione. Primero comprueba el catálogo de modelos con esa clave y después realiza una solicitud pequeña al modelo que quieras utilizar.

Verifica la clave y los identificadores de modelos disponibles

En macOS, Linux o WSL, configura tu clave de la pasarela en el terminal actual. Sustituye el marcador de posición por tu propia clave de forma local; no la incluyas en scripts compartidos ni en capturas de pantalla.

export ANTHROPIC_API_KEY="YOUR_GATEWAY_KEY"

En Windows PowerShell, utiliza esta sintaxis para la variable de entorno:

$env:ANTHROPIC_API_KEY = "YOUR_GATEWAY_KEY"

Solicita la lista de modelos. Esta es una solicitud al catálogo; no genera una respuesta de un modelo. El siguiente comando es para un intérprete de comandos compatible con Bash:

curl --fail-with-body --silent --show-error \
  https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

Para PowerShell:

$headers = @{ Authorization = "Bearer $env:ANTHROPIC_API_KEY" }
(Invoke-RestMethod "https://aiprimetech.io/v1/models" -Headers $headers).data | Select-Object id

Una respuesta correcta enumera los identificadores de modelos disponibles para la clave. Elige un modelo de Claude y copia su id exactamente en CLAUDE_MODEL. El acceso a los modelos puede depender del grupo y los permisos de la clave; una respuesta del catálogo por sí sola no garantiza que un modelo del proveedor complete una solicitud.

export CLAUDE_MODEL="PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"
# PowerShell alternative:
# $env:CLAUDE_MODEL = "PASTE_A_CLAUDE_MODEL_ID_FROM_THE_RESPONSE"

Antes de conectar un agente, confirma que la clave utiliza el grupo correspondiente al acceso que elegiste. La lista de comprobación para configurar agentes relaciona esa comprobación con la guía de la herramienta adecuada.

Realiza tu primera solicitud con Python

Instala el SDK de Python de Anthropic en el entorno de tu proyecto, guarda el ejemplo como test_claude.py, y ejecútalo desde el terminal donde configuraste la clave y el modelo. Esta solicitud utiliza el modelo seleccionado y está sujeta a la facturación o al plan de tu cuenta.

python -m pip install anthropic
test_claude.py
import os
import anthropic

# Set CLAUDE_MODEL to an exact Claude model ID returned for your key.
client = anthropic.Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://aiprimetech.io",
)
message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Reply with hello."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)
python test_claude.py

Para este SDK, la URL base de la pasarela es https://aiprimetech.io sin /v1; el SDK construye la ruta de la API de mensajes. Los clientes que utilizan el formato compatible con OpenAI generalmente usan https://aiprimetech.io/v1. Consulta la guía del SDK de Python de Anthropic o guía de la API compatible con OpenAI para el formato que necesita tu aplicación.

Cuando llegue la respuesta, revisa los detalles de la solicitud y del uso en el panel. Para la CLI, continúa con la configuración de claves API de Claude Code; para un IDE, sigue la guía de Cursor.

Si tu clave API de Claude no funciona

Síntoma Qué comprobar
401 o API_KEY_REQUIREDConfirma que la variable de entorno esté configurada en esta terminal y que la solicitud envíe la clave al proveedor que la emitió.
403 o acceso denegadoComprueba el estado de la clave, el grupo seleccionado, los permisos de la cuenta y el modelo solicitado.
Modelo no encontrado o no compatibleCopia el ID exacto de la lista de modelos de tu clave. Si aparece en la lista pero sigue fallando, contacta con soporte e incluye el error de la solicitud y el ID, sin la clave.
Saldo insuficiente o ningún plan válidoComprueba el saldo del panel, el período del plan y el grupo de acceso de la clave.
404 o una respuesta HTMLComprueba el nombre de host, el formato de la API y la ruta. No dupliques /v1 cuando el cliente lo añada por su cuenta.
429, 500 o 529Examina la respuesta, reduce la concurrencia cuando sea necesario y sigue la guía de errores de la API.

Dónde encontrar y gestionar tu clave

Abre Claves API en el panel del proveedor que emitió la clave. Usa los controles disponibles para copiarla, mostrarla y revocarla. Si no puedes recuperar un secreto utilizable, crea una clave de reemplazo y revoca la antigua después de actualizar tu aplicación.

No incluyas claves en el control de versiones, incidencias públicas ni código JavaScript del navegador. Si una clave queda expuesta, reemplázala y revisa su uso. Una cookie de sesión del navegador no sustituye a una clave API.

¿Es gratuita una clave API de Claude?

Crear una clave y pagar por el uso del modelo son pasos distintos. Las condiciones actuales de las cuentas de Anthropic se muestran en su Console. En AI Prime Tech, la guía de prueba muestra las ofertas de bienvenida disponibles; los página de recargas y página pública de planes muestran las opciones de pago habituales.

Comprueba los requisitos y la oferta que se muestra al registrarte. Un crédito temporal o una prueba no permiten usar el servicio gratis de forma indefinida.

Preguntas frecuentes

¿Cómo obtengo una clave API de Claude?
Crea una clave en la Consola de Claude para acceder directamente a Anthropic, o regístrate en AI Prime Tech, elige el acceso adecuado a la pasarela y crea una clave en el panel. Usa el endpoint del proveedor que la emitió.
¿Dónde encuentro mi clave API de Claude?
Abre Claves API en el panel del proveedor que la emitió y usa los controles de gestión de claves disponibles. Guarda el secreto de forma segura; si no puedes recuperarlo, crea una clave de reemplazo y revoca la antigua.
¿Puedo obtener una clave API de Claude gratis?
Crear una clave no financia por sí solo las solicitudes a la API. Consulta las condiciones actuales del proveedor que la emite. La guía de prueba de AI Prime Tech enumera las ofertas de bienvenida vigentes y sus condiciones.
¿Una suscripción a Claude Pro o Max cubre el coste de esta pasarela?
No. AI Prime Tech tiene su propia cuenta, sus propias claves y su propia facturación. Consulta Acceso a la API frente a suscripciones para elegir el producto que necesitas.
¿Qué ID de modelo debo usar?
Realiza una solicitud GET /v1/models con tu clave de la pasarela y elige un ID exacto de modelo Claude de los que se devuelvan para esa clave. Realiza una pequeña solicitud a Messages para verificar que el modelo funciona con tu acceso.
Empieza a usar Claude en minutos

Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.

Obtén tu clave de API

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.

Más guías de la API de Claude

Precios de la API de Claude, explicadosLa forma más económica de usar la API de ClaudeCursor ilimitado con la API de ClaudeAcceso ilimitado a Claude CodeGateway de la API de Claude frente al acceso directo a AnthropicUtiliza Claude con el SDK de OpenAI: endpoint compatible con OpenAI, streaming, herramientas y límitesLos modelos de Claude explicados: una comparación de Claude Opus, Sonnet, Haiku y Fable; todos los modelos de la API de Claude, nombres de modelos de Anthropic y precios (2026)Pagar la API de Claude con criptomonedasAcceso a la API de Claude sin lista de esperaCómo reducir el uso de tokens de ClaudeCline ilimitado con la API de ClaudeRoo Code ilimitado con la API de ClaudeClaude ilimitado en los IDE de JetBrainsAider con Claude a través de una pasarela: ANTHROPIC_API_BASE, archivos de configuración, modo arquitecto y solucionesClaude ilimitado en VS CodeConfiguración de OpenCode para Claude: ajustes de opencode.json, modelos y errores comunesHermes Agent con Claude a través de una pasarela: configuración de un proveedor personalizado, controles de costes y solucionesEjecutar OpenClaw sin límites con ClaudeQué significa una API compatible con AnthropicClave API de Claude Code — ANTHROPIC_API_KEY: cómo obtenerla, configurarla y cuándo usar claude setup-token en su lugarCostes de la API de Claude Code: precios y cómo reducirlosExplicación de los errores de la API de Claude: error del servidor 500, sobrecarga 529, límite de solicitudes 429, solicitud incorrecta 400 y la solución para cada unoCómo comprar créditos de la API de ClaudeAPI gratuita de Claude: ¿existe una clave API de Claude gratuita y qué es realmente gratis en 2026?API de Claude frente a la suscripción Claude Pro/Max: cuál elegirCodex CLI con un proveedor personalizado: config.toml, modelos GPT y Claude, extensión para IDE y solucionesConectar Claude a n8nEnrutar LiteLLM a ClaudeUsar Claude en Kilo CodeGitHub Copilot Chat con Claude a través de una pasarela: configuración de Custom Endpoint, modo agente y solucionesConecta Zed a Claude a través de la pasarelaConecta Cherry Studio a ClaudeChatAnthropic en LangChain: importación, base_url, streaming, herramientas y erroresSDK de Python de Anthropic: instalación, configuración de base_url, streaming y gestión de erroresClaude con Vercel AI SDK: baseURL de createAnthropic, streaming y solucionesEjecuta Factory Droid con ClaudeLa API de Claude Code, explicadaIntegración de la API de Claude en tu aplicaciónCómo obtener uso ilimitado de ClaudeQué significa el acceso ilimitado a la API de Claude