Claude Code

Cómo configurar la API Key y el Base URL en Claude Code

Conecta Claude Code con tu BetterToken API Key, la Base URL BetterToken y el Model ID que quieras usar.

Respuesta rápida

Cuando configures una API de terceros en Claude Code, confirma primero que el endpoint sea compatible con Anthropic. En esta documentación, Claude Code usa https://bettertoken.ai. No añadas /v1.

Para el acceso general a Claude API, los modelos disponibles y las opciones de inicio, consulta la página de Claude API de BetterToken. Esta FAQ solo explica cómo configurar una API Key existente de BetterToken en Claude Code mediante la Base URL y variables de entorno.

La API Key autentica la solicitud. El Base URL indica a Claude Code dónde enviar las solicitudes al modelo. Ambos deben pertenecer al mismo proveedor y protocolo.

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.

Cuándo es importante

Quieres que Claude Code use un API gateway personalizado
Tienes una API Key, pero no sabes qué Base URL usar
Claude Code muestra un error de autenticación o endpoint
Estás eligiendo entre https://bettertoken.ai y https://bettertoken.ai/v1

Conceptos principales

Campo	Significado
API Key	Credencial para las solicitudes a la API del modelo
Base URL	Dirección de la API a la que se envían las solicitudes
API compatible con Anthropic	Endpoint que sigue las convenciones de solicitud de Anthropic o Claude
API compatible con OpenAI	Endpoint que sigue las convenciones de OpenAI y que suelen usar Codex, Cursor y Cline
Model ID	Nombre del modelo o valor de mapeo que solicita la herramienta

Configuración recomendada

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.

{
  "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.

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

Errores comunes

Añadir /v1 al Base URL de Claude Code.
Cambiar la API Key, pero dejar las solicitudes dirigidas al endpoint predeterminado.
Introducir un endpoint compatible con OpenAI en los campos de Claude Code compatibles con Anthropic.
Definir variables de entorno antiguas en un perfil de shell que sustituyen la configuración nueva.

Acerca de BetterToken

BetterToken proporciona dos tipos de endpoint: https://bettertoken.ai, compatible con Anthropic para Claude Code, y https://bettertoken.ai/v1, compatible con OpenAI para Codex y otras herramientas externas.

Puedes gestionar API Keys, saldo e historial de uso en un único panel, pero Claude Code sigue necesitando solicitudes con formato compatible con Anthropic.