Integración de Claude Code

Conecta Claude Code a 1折AI: usa ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN (variables de entorno o settings.json), con instrucciones para Windows, mapeo de modelos, extensión de VS Code y errores comunes.

Claude Code solo necesita dos variables: ANTHROPIC_BASE_URL apunta a nosotros, ANTHROPIC_AUTH_TOKEN contiene tu clave API (API key). No necesitas iniciar sesión en una cuenta de Anthropic.

Ruta más corta

Si ya tienes Claude Code instalado y una clave API a mano, escribe estas dos líneas en ~/.claude/settings.json y luego ejecuta claude:

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
5
  }
6
}

Si el archivo ya existe, combina estos dos elementos en el env existente, sin sobrescribir otras configuraciones.

Pasos completos

Instalar Claude Code
Si ya lo instalaste, puedes omitirlo. Los siguientes comandos provienen de la documentación oficial de instalación de Claude Code:
macOS / Linux
Windows PowerShell
Homebrew
npm（需要 Node.js 22+）
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Homebrew
brew install --cask claude-code
npm（需要 Node.js 22+）
npm install -g @anthropic-ai/claude-code
Al instalar con npm, no agregues sudo.
Obtener clave API
Crea una clave API nueva en la consola; se recomienda usar una dedicada para el Claude Code de esta máquina. Consulta obtener y gestionar claves API.

Configuración (elige una de tres)

Ubicación de settings.json: en macOS / Linux es ~/.claude/settings.json, en Windows es %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 持久写入当前用户，重开终端后生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")

# 只在当前窗口生效
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"

setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"

ANTHROPIC_BASE_URL debe contener la dirección raíz; no agregues /v1, Claude Code añadirá /v1/messages por sí mismo.

Iniciar y confirmar
Ejecuta claude en el directorio del proyecto y, una vez dentro, escribe /status. Observa dos líneas:
- La línea de la URL base muestra https://1zheai.com
- La línea de credenciales muestra que el origen es ANTHROPIC_AUTH_TOKEN
Luego haz una pregunta y revisa los registros de llamadas para ver si hay un registro nuevo. Si lo hay, la conexión está establecida.
Si no quieres entrar en la interfaz interactiva, también puedes probar una vez en modo no interactivo (probado el 2026-10-15, devolvió ok):
bash
```
1
claude -p "say ok" --model claude-sonnet-4-6
```

Por qué usar ANTHROPIC_AUTH_TOKEN

Claude Code tiene dos variables donde puedes colocar la clave API; la diferencia es la siguiente (explicación oficial):

Variable	Forma de envío	Comportamiento
`ANTHROPIC_AUTH_TOKEN`	`Authorization: Bearer <值>`	Surte efecto inmediatamente al configurarla, sin pedir confirmación
`ANTHROPIC_API_KEY`	`x-api-key: <值>`	En modo interactivo, la primera vez aparece un diálogo preguntando si deseas usar esta clave API

Ambas las admitimos; se recomienda ANTHROPIC_AUTH_TOKEN. Configura solo una de las dos: si en el sistema aún queda el ANTHROPIC_API_KEY oficial anterior, bórralo para evitar mezclarlos y obtener un 401.

Otras dos reglas que suelen causar problemas:

Cuando el env de settings.json y el export de la terminal configuran la misma variable, prevalece settings.json. Si cambiaste la variable de la terminal y no surtió efecto, revisa primero settings.json.
No escribas la clave API en el .claude/settings.json del proyecto; este archivo normalmente se envía al repositorio. Para diferenciar por proyecto, usa un .claude/settings.local.json que no se envíe.

Mapeo de modelos

En Claude Code, opus, sonnet, haiku y fable son alias; puedes especificar con variables de entorno el modelo concreto al que apuntan. La categoría Haiku también la usa Claude Code para ejecutar algunas pequeñas tareas en segundo plano.

Variable	Función	Valor de ejemplo
`ANTHROPIC_MODEL`	Modelo usado al iniciar	`claude-sonnet-5-5`
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Modelo al que apunta el alias `opus`	`claude-opus-5-5`
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Modelo al que apunta el alias `sonnet`	`claude-sonnet-5-5`
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Modelo para el alias `haiku` y las tareas en segundo plano	`claude-haiku-5-5`
`ANTHROPIC_DEFAULT_FABLE_MODEL`	Modelo al que apunta el alias `fable`	`claude-fable-5-1`

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
4
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
5
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
6
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
7
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
8
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
9
  }
10
}

El ID del modelo debe estar entre los modelos admitidos. Durante la ejecución también puedes cambiar temporalmente con /model claude-opus-5-5.

Extensión de VS Code

La extensión de VS Code de Claude Code verifica las credenciales antes de iniciar; la recomendación oficial es escribir las variables en la configuración de usuario de VS Code (Paleta de comandos → Preferences: Open User Settings (JSON)):

1
{
2
  "claudeCode.environmentVariables": [
3
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
4
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
5
  ]
6
}

Si solo se escriben en ~/.claude/settings.json, la comprobación de inicio de sesión de la propia extensión podría no leerlas.

Configuraciones opcionales

Variable	Función
`API_TIMEOUT_MS`	Tiempo de espera de la solicitud; por defecto 600000 (10 minutos); si las tareas largas superan el tiempo de espera con frecuencia, puedes aumentarlo
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`	Desactiva actualizaciones automáticas, telemetría, informes de errores y otro tráfico no esencial. Ten en cuenta que configurarla como `0` o `false` también cuenta como activada; para desactivarla debes eliminar esta variable
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`	Úsalo cuando aparezca un 400 como “Extra inputs are not permitted”
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`	Hace que la lista `/model` obtenga los modelos disponibles desde `/v1/models`

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 ya se ha probado y funciona (Claude Code 2.1.296, 2026-10-15): tras iniciar, en el registro de depuración aparece [gatewayDiscovery] cached 14 models, y los 14 modelos coinciden con los modelos admitidos.

No configures DISABLE_PROMPT_CACHING; desactivará la caché y la factura aumentará notablemente; consulta Prompt Caching.

Preguntas frecuentes

Al iniciar aparece la pantalla de inicio de sesión / se muestra Please run /login

Claude Code no leyó la clave API. Revisa la ortografía del nombre de la variable; si usas variables de entorno, confirma que se inicia en una terminal nueva; si usas settings.json, confirma que el formato JSON es correcto (una coma extra invalida todo).

401 / Invalid API key

La clave API se copió de forma incompleta, o ANTHROPIC_API_KEY y ANTHROPIC_AUTH_TOKEN coexisten y uno de ellos es un valor antiguo. Deja solo uno de los dos. Para más detalles, consulta códigos de error y solución de problemas.

404

En ANTHROPIC_BASE_URL se escribió de más /v1. Cámbialo por https://1zheai.com.

Elegí Opus, pero en los registros aparecen llamadas a Haiku

Esto es Claude Code ejecutando pequeñas tareas en segundo plano con la categoría Haiku. Si quieres cambiarlo por otro modelo, configura ANTHROPIC_DEFAULT_HAIKU_MODEL.

¿Cómo cambiar entre la cuenta oficial y 1折AI?

Elimina (o comenta) las dos variables anteriores para volver al inicio de sesión oficial. Si cambias con frecuencia, usa CC Switch; un clic y cambias.

¿Usar 1折AI afectará a mi cuenta de Anthropic?

No genera ninguna asociación. Al conectarte a 1折AI, Claude Code usa nuestra clave API y no inicia sesión en tu cuenta de Anthropic.