Usa tu clave en Claude Code

Instala la CLI, apunta ANTHROPIC_BASE_URL a OLETOKEN y elige un modelo, además de la extensión de VS Code y la solución de problemas.

Claude Code es el agente de programación de Anthropic (CLI más la extensión de VS Code) y habla el protocolo Anthropic Messages. Apúntalo a OLETOKEN y usará tu clave y tu cuota de modelos de OLETOKEN: no necesitas una cuenta de Anthropic.

Antes de empezar

Has creado una clave de API y has guardado la clave completa.
Has elegido un ID de modelo de Claude en el catálogo de modelos (por ejemplo claude-sonnet-5).
Tienes Node.js y npm instalados.

Configuración

La configuración vive en el bloque env de ~/.claude/settings.json. La CLI y la extensión de VS Code comparten este archivo, así que configurarlo una vez cubre ambos casos; además es más fiable que exportar variables en el shell, porque VS Code no siempre hereda el entorno de tu shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<your-base-url>",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Variable	Significado
`ANTHROPIC_BASE_URL`	Solo el host, sin `/v1`: la CLI añade `/v1/messages` por su cuenta, y si lo incluyes devuelve 404
`ANTHROPIC_AUTH_TOKEN`	Tu clave de OLETOKEN, enviada como `Authorization: Bearer`
`ANTHROPIC_MODEL`	ID del modelo predeterminado
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Modelo usado para tareas ligeras (generación de títulos, etc.); apuntarlo al mismo modelo evita 404 cuando la puerta de enlace no tiene un modelo haiku

Instalar y lanzar:

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

El diálogo Inicio rápido de la página de claves de API ofrece la descarga de este mismo script de configuración con tu clave, tu modelo y tu Base URL ya rellenados.

Las variables de entorno también funcionan

Si prefieres no tocar settings.json, exporta las mismas variables desde el perfil de tu shell (normalmente ~/.zshrc en macOS y ~/.bashrc en Linux) y vuelve a abrir el terminal:

export ANTHROPIC_BASE_URL="https://<your-base-url>"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Cuando ambas están definidas, gana el bloque env de ~/.claude/settings.json.

Solución de problemas

Síntoma	Causa y solución
401	Clave incorrecta o deshabilitada; asegúrate de que es una clave de OLETOKEN y de que está en `ANTHROPIC_AUTH_TOKEN`
404	`ANTHROPIC_BASE_URL` incluye `/v1` (o una ruta más larga): deja solo el host
Model not found	`ANTHROPIC_MODEL` no es un modelo de los que aparecen en este sitio; copia el ID del catálogo de modelos
Insufficient balance	Recarga primero
Cambiar de modelo sobre la marcha	Ejecuta `/model` dentro de la sesión

Da a cada caso de uso su propia clave (una para la CLI, otra para el editor) con un límite de gasto, para que una filtración solo te cueste ese importe.