Configuración de Coding Agents

Instalación de Claude Code, API Key, Base URL y modelos

Conecta Claude Code con tu BetterToken API Key, Base URL y Model ID. Elige el modelo antes de iniciar o cambia con /model durante la sesión.

Conecta Claude Code con tu BetterToken API Key, la Base URL https://bettertoken.ai y el Model ID que quieras usar. Copia el Model ID exacto de la model plaza.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai`
Model	`YOUR_MODEL_ID`

Requisitos previos

Instala Claude Code
Instala Node.js si usas el script de configuración automática de BetterToken; la instalación con npm requiere Node.js 22 o posterior
Crea y copia una BetterToken API Key

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Instalación

Anthropic recomienda el instalador nativo, que no requiere Node.js. Si prefieres npm, instala Node.js 22 o posterior y ejecuta:

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

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

Windows

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

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

Copia el Model ID exacto de la model plaza.

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

Sustituye YOUR_MODEL_ID por el ID copiado. ANTHROPIC_MODEL define el modelo principal y las tres variables ANTHROPIC_DEFAULT_*_MODEL definen los alias Haiku, Sonnet y Opus. Puedes usar el mismo modelo o uno distinto para cada función.

Los ejemplos incluyen el ajuste opcional CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1. Desactiva las actualizaciones automáticas, el envío de informes de errores y algunas comprobaciones de disponibilidad y funciones de cuenta; no es necesario para la autenticación. Para actualizar manualmente, ejecuta claude update o usa tu gestor de paquetes si este administra la instalación. Consulta las instrucciones de actualización y los efectos del ajuste.

Extensión de 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://bettertoken.ai"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "3000000"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "YOUR_MODEL_ID"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "YOUR_MODEL_ID"
    }
  ]
}

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. En la sesión interactiva, ejecuta /status y comprueba dos líneas:

Anthropic base URL debe mostrar la Base URL de BetterToken: https://bettertoken.ai. Si no aparece, la variable no llegó a la sesión actual. Comprueba la ruta de settings.json y reinicia Claude Code por completo.
La línea de autenticación debe mostrar ANTHROPIC_AUTH_TOKEN, en lugar de un inicio de sesión con una cuenta de claude.ai.

Para verificar la conexión desde un script, envía un prompt breve:

claude -p "Reply with only: OK"

Una respuesta normal con OK confirma que la conexión funciona.

Conflictos con un inicio de sesión existente

Las credenciales de las variables de entorno tienen prioridad sobre un inicio de sesión guardado de claude.ai. Si al iniciar ves una advertencia sobre dos fuentes de credenciales, elimina una de ellas. Para conservar solo tu BetterToken API Key, ejecuta /logout. Si también tienes ANTHROPIC_API_KEY configurada en tu intérprete de comandos, elimínala primero.

Cambiar de modelo

Actualiza el Model ID en la configuración y reinicia Claude Code. Para cambiar durante una sesión, usa /model YOUR_MODEL_ID.

Para otros alias, como fable con ANTHROPIC_DEFAULT_FABLE_MODEL, sigue la asignación oficial de alias y usa un Model ID disponible. Si Claude Code presupone una ventana de contexto incorrecta para un ID personalizado, sigue la guía de contexto para modelos personalizados con el límite confirmado del modelo.

Mostrar modelos de BetterToken en /model (opcional)

Usa una versión reciente de Claude Code. Añade "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1" al bloque env existente en ~/.claude/settings.json y reinicia Claude Code por completo. Al iniciarse, Claude Code consulta /v1/models en https://bettertoken.ai para obtener los modelos disponibles. Consulta la guía oficial de configuración de gateways.

Para comprobar que la detección funciona, inicia claude --debug y busca las líneas con [gatewayDiscovery] en ~/.claude/debug/<session-id>.txt. Una línea que indique que se han almacenado modelos en caché confirma que la detección se completó correctamente.

Claude Code solo muestra modelos de la pasarela cuyo Model ID contiene claude o anthropic (sin distinguir mayúsculas de minúsculas), como se describe en su protocolo de pasarela. Los demás modelos devueltos por /v1/models, incluidos los GPT, no aparecen en /model aunque BetterToken los ofrezca. Claude Code puede seguir llamándolos si configuras su Model ID directamente; en las pruebas con Claude Code 2.1.309, un modelo GPT indicado de esta forma respondió a solicitudes de texto y de lectura de archivos mediante Anthropic Messages.

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://bettertoken.ai`; no añadas `/v1`.
Model ID	Comprueba el Model ID exacto en la model plaza e introdúcelo en los ajustes del modelo del cliente.
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.
Advertencia sobre dos fuentes de credenciales en conflicto al iniciar	Elimina una de las fuentes o ejecuta `/logout`.
Error de certificado / TLS, frecuente con un proxy corporativo	Configura `NODE_EXTRA_CA_CERTS` con la ruta del archivo del certificado de la CA y reinicia Claude Code.
`400` que menciona un campo no reconocido, como `Extra inputs are not permitted`	Añade `"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"` a `env` y reinicia Claude Code por completo. Si el error persiste, contacta con soporte.
Contexto demasiado largo durante una sesión extensa	Ejecuta `/compact` para comprimir la sesión.

Funciones no disponibles con una API Key

El control remoto (Remote Control) y la entrada de voz requieren iniciar sesión con una cuenta de claude.ai. No están disponibles al usar una BetterToken API Key y una Base URL personalizada. Es una limitación del cliente Claude Code y no afecta a las conversaciones habituales de programación.

Configuración avanzada

Para administrar varias configuraciones desde una aplicación, consulta CC Switch.

Preguntas relacionadas

Detalles técnicos

Protocolo y endpoint

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