Claude Code
NezhaGate ofrece la misma API Messages que Anthropic, así que el uso de herramientas, el razonamiento y la caché de prompts de Claude Code funcionan sin cambios. Define dos variables de entorno y empieza.
Antes de empezar
- Una clave de API de NezhaGate (créala en la página API Keys de la consola).
- Claude Code instalado. Si no lo tienes, ejecuta esto (Node.js 18 o posterior):
npm install -g @anthropic-ai/claude-code
Paso 1: define las variables de entorno
Defínelas en la terminal donde vas a ejecutar claude. ANTHROPIC_AUTH_TOKEN es tu clave de NezhaGate; ANTHROPIC_MODEL es el modelo que se usa por defecto.
export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY export ANTHROPIC_MODEL=claude-sonnet-5 export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5 claude
Así solo valen para la terminal actual; una terminal nueva las necesita otra vez. Para que se queden, usa settings.json en el paso siguiente.
Paso 2 (recomendado): guárdalas en settings.json
Escribe los mismos ajustes en el archivo de configuración de usuario de Claude Code y cualquier terminal los usará. El archivo es ~/.claude/settings.json en macOS / Linux y %USERPROFILE%\.claude\settings.json en Windows; créalo si no existe.
{
"env": {
"ANTHROPIC_BASE_URL": "https://nezhagate.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
}
}Paso 3: arranca y comprueba
Ejecuta claude en la carpeta de tu proyecto y escribe /status para ver la configuración actual: la URL base debe ser https://nezhagate.com/anthropic.
Elige un modelo
Claude Code solo puede usar modelos Claude (el endpoint /anthropic solo acepta modelos Claude). Disponibles ahora:
| ID del modelo | Entrada | Salida | Lectura de caché |
|---|---|---|---|
claude-sonnet-4-6 | $1.50 | $7.50 | $0.15 |
claude-opus-5 | $4.00 | $20.00 | $0.40 |
claude-fable-5 | $8.00 | $40.00 | $0.80 |
claude-sonnet-5 | $1.00 | $5.00 | $0.10 |
Precios en dólares por millón de tokens.
Escribe /model seguido de un ID de modelo para cambiar durante la sesión, por ejemplo /model claude-opus-5. Qué modelo usan las opciones Opus y Sonnet del menú /model lo deciden ANTHROPIC_DEFAULT_OPUS_MODEL y ANTHROPIC_DEFAULT_SONNET_MODEL.
El modelo de segundo plano
Claude Code encarga tareas pequeñas en segundo plano (como poner título a una conversación) a un modelo pequeño y pide Claude Haiku por defecto. NezhaGate no ofrece Haiku, así que apunta ANTHROPIC_DEFAULT_HAIKU_MODEL a uno de los modelos de arriba; si no, esas peticiones devolverán 404.
Facturación y caché
Se cobra por token, a los mismos precios que los endpoints /v1. Los aciertos de la caché de prompts se cobran al precio de lectura de caché de la tabla, muy por debajo del precio de entrada. Claude Code envía en cada turno el mismo prompt de sistema y el mismo contexto del proyecto, así que suele acertar en la caché en cada turno.
Errores habituales
La clave está mal escrita, tiene un espacio de más o está desactivada. Revísala en la consola y vuelve a definirla.
El modelo pedido no está en la lista de NezhaGate; casi siempre es el Haiku que piden por defecto las tareas en segundo plano. Define ANTHROPIC_MODEL y ANTHROPIC_DEFAULT_HAIKU_MODEL como se indica arriba.
La cuenta se quedó sin saldo, o la clave llegó al presupuesto que le pusiste. Recarga en la consola o sube el límite de la clave.
Define las variables de entorno antes de arrancar claude y en la misma terminal; si editas settings.json, reinicia Claude Code. /status muestra la URL base en uso.
Todas las líneas de este modelo están ocupadas en este momento. Reintenta en unos segundos; no se cobra nada.