Claude API Key: consola, recarga, llamadas y proxies (2026)

La API de Claude es la interfaz de modelos que ofrece Anthropic, muy usada para documentos largos, código, agentes y razonamiento complejo. Muchos desarrolladores confunden tres cosas en la primera configuración: la suscripción web de Claude, Claude Code y la API de Claude.

Este artículo explica cómo obtener una Claude API Key, cómo llamar a la API, cómo conectarla a Claude Code y las dos opciones de acceso habituales desde China continental.

Nota: Claude y Anthropic son marcas registradas de sus respectivos propietarios. Este artículo refleja el uso habitual a octubre de 2026. Los endpoints y precios están sujetos a la documentación oficial y a este sitio.

1. Separa primero los tres conceptos

Nombre	Qué es	Cómo se usa
Claude web/App	Producto de chat	Comprar una suscripción
Claude Code	Herramienta de programación de línea de comandos	Llama a los modelos mediante la API
Claude API	Interfaz de modelos	Llama a `/v1/messages` con una clave

Este artículo trata de la Claude API Key. No es una cuenta de membresía web, y una suscripción web no puede usarse directamente como clave de API.

2. Ruta A: una clave oficial de Anthropic Console

Abre Anthropic Console.
Regístrate o inicia sesión.
Ve a la página API Keys.
Crea una clave, ponle nombre y guárdala.
Añade un método de pago y confirma tus límites.
Copia la clave y guárdala en un gestor de contraseñas.

El endpoint para una clave oficial suele ser:

https://api.anthropic.com

Las peticiones requieren las cabeceras x-api-key y anthropic-version. Consulta la documentación oficial para más detalles.

3. Ruta B: una clave de ZSQH AI Gateway

Si los endpoints oficiales son inestables desde China continental, o necesitas una factura unificada y varios modelos:

Abre ZSQH AI Gateway y regístrate.
Ve a API Keys y crea una clave.
Fija un límite de gasto y una fecha de caducidad.
Recarga tu saldo.
Copia la clave.

El gateway ofrece dos modos habituales:

Compatible con Anthropic: para Claude Code y otras herramientas que usan el protocolo de Anthropic.
Compatible con OpenAI: para el SDK de OpenAI, Cursor, Chatbox, Dify y herramientas similares, con la Base URL https://ai.zhongshangqihang.com/v1.

4. Llamar al endpoint nativo de Anthropic con curl

export ANTHROPIC_API_KEY="sk-your-key"

curl "https://ai.zhongshangqihang.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-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Explain what an API gateway is in three sentences."}
    ]
  }'

Los nombres de modelo están en Precios de modelos. Si la ruta compatible con Anthropic del gateway es distinta, sigue la guía de conexión del proveedor.

5. Llamar a Claude con el SDK de OpenAI

Muchas herramientas solo admiten el protocolo de OpenAI. En ese caso, usa el endpoint compatible con OpenAI del gateway:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-5",
    messages=[{"role": "user", "content": "Reply with OK only"}],
)
print(resp.choices[0].message.content)

Ten en cuenta que la interfaz nativa de Anthropic y la interfaz compatible con OpenAI usan formatos de petición diferentes. No los mezcles.

6. Conectar con Claude Code

Claude Code usa el protocolo de Anthropic. Una configuración habitual es:

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_API_KEY="sk-your-key"
claude

Si tu cliente requiere ANTHROPIC_AUTH_TOKEN, sustitúyelo según la documentación del cliente. Para los pasos detallados, consulta la guía de la API de Claude Code.

7. Errores comunes

Error	Causa	Solución
`401`	Clave incorrecta o caducada, o cabeceras incorrectas	Revisa `x-api-key` o la autenticación Bearer
`404`	Base URL o ruta incorrecta	Usa `/v1/messages` para llamadas nativas y `/v1` para compatibilidad con OpenAI
`model not found`	Nombre de modelo incorrecto	Copia el nombre de la página de precios
`429`	Límite de velocidad o cuota	Reduce la concurrencia, reintenta o sube tu límite
`insufficient quota`	Saldo insuficiente	Recarga
`anthropic-version` error	Falta la cabecera de versión	Añade `anthropic-version: 2023-06-01`

8. Recomendaciones de seguridad

No expongas claves en el código de frontend.
Usa una clave por persona y fija límites por proyecto.
Configura fechas de caducidad y rota las claves con regularidad.
Nunca hagas commit de claves en Git.
En producción, usa variables de entorno o un gestor de secretos.

9. Acceso oficial directo vs. un gateway

Dimensión	Acceso oficial directo	ZSQH AI Gateway
Acceso	Depende de tu entorno de red	Optimizado para China continental
Pago	Métodos oficiales	Recarga en el sitio del proveedor
Modelos	Solo Claude	Claude, GPT, Gemini, DeepSeek y más
Facturación	Panel oficial	Consola unificada
Cambio de proveedor	Puede requerir cambios de código	Cambia el nombre del modelo

Si solo usas Claude y el acceso oficial funciona bien, el acceso directo es suficiente. Si necesitas acceso estable desde China continental y gestión unificada de varios modelos, un gateway encaja mejor.

Preguntas frecuentes

¿La Claude API Key es la misma que usa Claude Code?

Claude Code usa una clave de la API de Claude, o una clave compatible de un gateway. Una suscripción web no es una clave de API.

¿Puede una clave llamar a varios modelos de Claude?

Sí. El modelo se especifica en los parámetros de la petición. Consulta la página de precios para ver los modelos disponibles.

¿Por qué no funciona el código de la documentación oficial?

La causa habitual es una discrepancia entre la Base URL, las cabeceras de la petición y el nombre del modelo. Las interfaces nativa y compatible con OpenAI deben configurarse por separado.

Próximos pasos

Si necesitas acceso estable desde China continental o un único punto de entrada para varios modelos, regístrate en ZSQH AI Gateway, crea una clave de prueba y completa tu primera petición con esta guía. Los nombres de modelo y los precios están en Precios de modelos.

Lecturas relacionadas: