--- title: "Integración de Claude Code" description: "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." headingIds: {"Ruta más corta":"section-1","Pasos completos":"section-2","Por qué usar ANTHROPIC_AUTH_TOKEN":"section-3","Mapeo de modelos":"section-4","Extensión de VS Code":"section-5","Configuraciones opcionales":"section-6","Preguntas frecuentes":"section-7"} --- 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`: ```json title="~/.claude/settings.json" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` Si el archivo ya existe, combina estos dos elementos en el `env` existente, sin sobrescribir otras configuraciones. ## Pasos completos Si ya lo instalaste, puedes omitirlo. Los siguientes comandos provienen de [la documentación oficial de instalación de Claude Code](https://code.claude.com/docs/en/setup): ```bash title="macOS / Linux" curl -fsSL https://claude.ai/install.sh | bash ``` ```powershell title="Windows PowerShell" irm https://claude.ai/install.ps1 | iex ``` ```bash title="Homebrew" brew install --cask claude-code ``` ```bash title="npm（需要 Node.js 22+）" npm install -g @anthropic-ai/claude-code ``` Al instalar con npm, no agregues `sudo`. Crea una clave API nueva en la [consola](https://1zheai.com/console?lng=es); se recomienda usar una dedicada para el Claude Code de esta máquina. Consulta [obtener y gestionar claves API](/es/docs/api-keys/). Ubicación de settings.json: en macOS / Linux es `~/.claude/settings.json`, en Windows es `%USERPROFILE%\.claude\settings.json`. ```json title="settings.json（推荐）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key" } } ``` ```bash title="macOS / Linux 环境变量" # 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端 export ANTHROPIC_BASE_URL="https://1zheai.com" export ANTHROPIC_AUTH_TOKEN="sk-你的Key" ``` ```powershell title="Windows PowerShell" # 持久写入当前用户，重开终端后生效 [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" ``` ```bat title="Windows CMD" 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. 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](/es/docs/usage-logs/) 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 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](https://code.claude.com/docs/en/authentication)): | 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` | ```json title="~/.claude/settings.json（带模型映射）" { "env": { "ANTHROPIC_BASE_URL": "https://1zheai.com", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5" } } ``` El ID del modelo debe estar entre los [modelos admitidos](/es/docs/models/). 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)): ```json title="VS Code settings.json" { "claudeCode.environmentVariables": [ { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" }, { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" } ] } ``` 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](/es/docs/models/). No configures `DISABLE_PROMPT_CACHING`; desactivará la caché y la factura aumentará notablemente; consulta [Prompt Caching](/es/docs/prompt-caching/). ## Preguntas frecuentes 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). 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](/es/docs/troubleshooting/). En `ANTHROPIC_BASE_URL` se escribió de más `/v1`. Cámbialo por `https://1zheai.com`. 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`. Elimina (o comenta) las dos variables anteriores para volver al inicio de sesión oficial. Si cambias con frecuencia, usa [CC Switch](/es/docs/quickstart-cc-switch/); un clic y cambias. 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.