Claude Code

Claude Code se comunica con el endpoint de Inferray compatible con Anthropic, así que no necesita ningún adaptador — con dos variables, se enruta a través de tu saldo de Inferray en lugar de tu suscripción de Claude.

Define las variables

export ANTHROPIC_BASE_URL="https://api.inferray.com"
export ANTHROPIC_AUTH_TOKEN="inferray_..."

La URL base no lleva /v1: Claude Code agrega /v1/messages por su cuenta.

ANTHROPIC_AUTH_TOKEN envía tu key como Authorization: Bearer, que es lo que lee Inferray. ANTHROPIC_API_KEY también funciona — envía la key como x-api-key, que Inferray también acepta —, pero requiere una aprobación única en una sesión interactiva, así que el auth token es la opción más cómoda.

Hazlo persistente

Los exports del shell solo aplican a esa terminal y a lo que lances desde ella. Para que todas las sesiones se enruten a través de Inferray, pon los mismos valores en el bloque env de ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.inferray.com",
    "ANTHROPIC_AUTH_TOKEN": "inferray_..."
  }
}

Un valor del archivo de configuración tiene prioridad sobre un export del shell de la misma variable.

Para la extensión de VS Code, defínelas en su lugar en la propia configuración de usuario de VS Code — la extensión verifica las credenciales antes de iniciarse, así que este es el único lugar que lee de forma confiable:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.inferray.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "inferray_..." }
  ]
}

Elige el modelo

Asigna a ANTHROPIC_MODEL cualquier id de modelo del catálogo — incluidos los que no son de Claude, ya que todos los modelos responden en el endpoint de Messages.

export ANTHROPIC_MODEL="claude-opus-4-8"

El selector /model de Claude Code muestra sus propios nombres integrados. También puede descubrir los modelos de un gateway, algo que Inferray puede responder porque sirve GET /v1/models — pero esas entradas tienen el formato de OpenAI, así que ANTHROPIC_MODEL sigue siendo la forma confiable de fijar un modelo.

Comprueba que funciona

Envía una solicitud directamente al endpoint antes de abrir el agente, para que un fallo apunte a la configuración en lugar de a la herramienta:

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-opus-4-8", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Una respuesta que empieza con {"id":"msg_ significa que la URL y la key funcionan. Un 401 significa que la key fue rechazada. Un 402 significa que tu saldo es demasiado bajo — recarga y vuelve a intentarlo.

Después inicia claude desde el mismo shell y ejecuta /status: una línea Anthropic base URL que muestre api.inferray.com confirma que las solicitudes se están enrutando aquí.

Mientras las variables estén definidas

Tu inicio de sesión de claude.ai se mantiene guardado pero sin usarse, y sus límites de uso no aplican — en su lugar, la sesión se cobra a tu saldo de Inferray. Elimina las variables y Claude Code vuelve a la suscripción.