
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 Anthropic | Consola de Claude | Cuenta de Anthropic y facturación de la API; api.anthropic.com |
| AI Prime Tech | Crea una cuenta, y después abre Claves de API en el panel | Cré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
- Inicia sesión en la Consola de Claude y selecciona el espacio de trabajo que utilizarás.
- 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.
- Abre Claves API, crea una clave para tu aplicación y guárdala de forma segura cuando se muestre.
- 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
- Regístrate en AI Prime Tech y completa la verificación que se muestra durante el registro.
- 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.
- 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.
- 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 idUna 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 anthropicimport 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.pyPara 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_REQUIRED | Confirma 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 denegado | Comprueba el estado de la clave, el grupo seleccionado, los permisos de la cuenta y el modelo solicitado. |
| Modelo no encontrado o no compatible | Copia 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álido | Comprueba el saldo del panel, el período del plan y el grupo de acceso de la clave. |
| 404 o una respuesta HTML | Comprueba 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 529 | Examina 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?
¿Dónde encuentro mi clave API de Claude?
¿Puedo obtener una clave API de Claude gratis?
¿Una suscripción a Claude Pro o Max cubre el coste de esta pasarela?
¿Qué ID de modelo debo usar?
Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.
Obtén tu clave de APIAI 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.