Configurar Claude Code: modelos Claude, API Key y Base URL

Los modelos Claude se pueden conectar directamente mediante variables de terminal o un archivo de ajustes. Kimi y GLM usan la misma Base URL con mapeos de modelos explícitos. GPT requiere una configuración avanzada.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://www.bettertoken.ai`
Model	Administrado por Claude Code

Requisitos previos

Instala la versión más reciente de Claude Code
Instala Node.js
Crea y copia una BetterToken API Key

Instalación

npm install -g @anthropic-ai/claude-code

Configuración por línea de comandos

El script de configuración automática de BetterToken escribe la configuración del proveedor para Claude Code. Requiere Node.js y solicita la API Key si no se proporciona como argumento.

macOS / Linux
Windows

curl -fsSL "https://bettertoken.ai/install-claudecode-provider.sh" | bash

iwr "https://bettertoken.ai/install-claudecode-provider.ps1" -OutFile "$env:TEMP\install-claudecode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-claudecode-provider.ps1"

Cuando termine, revisa ~/.claude/settings.json (o %USERPROFILE%\.claude\settings.json en Windows) y reinicia Claude Code por completo. Usa la configuración manual si quieres controlar cada campo.

Configuración manual

Configurar el proveedor Claude

Claude Code CLI lee estos archivos:

Sistema	Archivo
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

Añade:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

El proveedor Claude solo necesita estas cuatro variables. No añadas ANTHROPIC_MODEL ni ANTHROPIC_DEFAULT_*_MODEL.

Configurar un proveedor Kimi o GLM

Kimi y GLM necesitan mapeos de modelos en el mismo settings.json. Sustituye cada YOUR_MODEL_ID por un Model ID del cuadro de configuración o del model plaza:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID"
  }
}

Los tres mapeos pueden usar un solo Model ID o modelos diferentes del mismo proveedor. No escribas aquí un Model ID de GPT; usa la configuración avanzada al final de esta página.

Configurar la extensión Claude Code para VS Code

La extensión usa el archivo settings.json de VS Code. Añade una configuración claudeCode.environmentVariables independiente:

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    }
  ]
}

Ejecuta Developer: Reload Window o reinicia VS Code por completo.

Verificar la conexión

Inicia Claude Code en tu proyecto:

claude

Envía un mensaje corto. Una respuesta normal sin errores 401, de conexión o de modelo confirma la configuración. Reinicia Claude Code por completo después de modificar el archivo.

Cambiar de modelo

Proveedor Claude: deja que Claude Code gestione la selección del modelo. No añadas ANTHROPIC_MODEL ni ANTHROPIC_DEFAULT_*_MODEL.
Proveedor Kimi o GLM: cambia ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL y ANTHROPIC_DEFAULT_OPUS_MODEL y reinicia Claude Code por completo.
Proveedor GPT: sigue la configuración avanzada para cambiar de modelo.

Errores frecuentes

Error	Solución
`401` o error de autenticación	Comprueba `ANTHROPIC_AUTH_TOKEN` y elimina los espacios alrededor de la API Key.
`ConnectionRefused`	Usa exactamente `https://www.bettertoken.ai`; no añadas `/v1`.
Modelo no encontrado	No configures manualmente un modelo para Claude. Con Kimi o GLM, comprueba que los tres valores `ANTHROPIC_DEFAULT_*_MODEL` usen Model IDs actuales.
La configuración no se aplica	Comprueba la ruta del archivo, elimina variables de entorno que entren en conflicto y reinicia Claude Code por completo.

Configuración avanzada

Proveedores compatibles

Proveedor	Estado
Claude	Línea de comandos y configuración manual
GPT	Configuración avanzada
Kimi	Configuración manual
GLM	Configuración manual

Los estados se aplican al método de configuración de BetterToken descrito en esta página.

Qué significa cada método de configuración

Configuración avanzada: instala CC Switch y usa un proxy local, conversión de protocolo o mapeo de modelos.
Configuración manual: introduce la API Key, la Base URL y el Model.
Configuración por línea de comandos y manual: usa un comando generado o sigue todos los pasos manuales.

Para usar GPT en Claude Code, configúralo mediante CC Switch con BetterToken. Introduce la API Key, la Base URL y el Model Mapping en la pestaña Claude Code y activa el proxy.

Preguntas relacionadas

Detalles técnicos

Protocolo y endpoint

Claude Code usa Anthropic Messages. Configura ANTHROPIC_BASE_URL como https://www.bettertoken.ai; el cliente añade /v1/messages, por lo que no debes añadir /v1 a la Base URL.

Primeros pasos

Configuración de Coding Agents

Configuración de plataformas de aplicaciones de IA

Configuración avanzada

Configurar Claude Code: modelos Claude, API Key y Base URL

Ajustes principales

Requisitos previos

Instalación

Configuración por línea de comandos

Configuración manual

Configurar el proveedor Claude

Configurar un proveedor Kimi o GLM

Configurar la extensión Claude Code para VS Code

Verificar la conexión

Cambiar de modelo

Errores frecuentes

Configuración avanzada

Proveedores compatibles

Preguntas relacionadas

Detalles técnicos

​Ajustes principales

​Requisitos previos

​Instalación

​Configuración por línea de comandos

​Configuración manual

​Configurar el proveedor Claude

​Configurar un proveedor Kimi o GLM

​Configurar la extensión Claude Code para VS Code

​Verificar la conexión

​Cambiar de modelo

​Errores frecuentes

​Configuración avanzada

​Proveedores compatibles

​Preguntas relacionadas

​Detalles técnicos

Ajustes principales

Requisitos previos

Instalación

Configuración por línea de comandos

Configuración manual

Configurar el proveedor Claude

Configurar un proveedor Kimi o GLM

Configurar la extensión Claude Code para VS Code

Verificar la conexión

Cambiar de modelo

Errores frecuentes

Configuración avanzada

Proveedores compatibles

Preguntas relacionadas

Detalles técnicos