Inicio / Documentación / Claude Code

Claude Code

Configura el agente CLI de Anthropic para que use la pasarela mediante dos variables de entorno y evita la trampa que carga los costes a la clave equivocada sin avisar.

Claude Code lee su endpoint del entorno, por lo que no es necesario aplicar parches. Esta es la configuración más habitual en la pasarela.

Configuración

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

Eso es toda la integración. Añade ambas líneas a ~/.zshrc o ~/.bashrc para que sea permanente.

La trampa: si ANTHROPIC_API_KEY está definida en tu shell, Claude Code puede darle prioridad y facturar el uso a esa clave, ignorando silenciosamente tanto tu clave de la pasarela como cualquier suscripción Pro/Max. Ejecuta echo $ANTHROPIC_API_KEY ; si muestra algo, unset ANTHROPIC_API_KEY antes de iniciar.

Configuración por proyecto

Para limitar la pasarela a un repositorio en lugar de aplicarla a todo tu shell, usa un archivo de configuración:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Colócalo en .claude/settings.json dentro del proyecto, o en ~/.claude/settings.json para establecer una configuración predeterminada para todo el usuario. Añade .claude/settings.json a .gitignore : contiene una clave.

Comprobar que ha funcionado

"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

Si las solicitudes no aparecen en tu panel, se están enviando a otro destino; casi siempre se debe a la trampa de ANTHROPIC_API_KEY descrita anteriormente.

Elegir un modelo

claude --model claude-opus-4-8

Cualquier identificador de Modelos funciona. Opus para refactorizaciones difíciles y Sonnet para el trabajo diario; consulta Control de costes para saber por qué esa elección determina la mayor parte de tu factura.

Mantener el coste bajo control