Claude Code con cualquier modelo: configurar un endpoint propio

Claude Code es el agente de programación de línea de comandos de Anthropic. Habla con un único endpoint, /v1/messages en formato Anthropic Messages, y permite cambiar la URL base. Si lo apuntas a GetVibe API, la misma CLI puede usar Claude Opus 5.5, Claude Sonnet 5 o un modelo que no es de Claude, todo con una sola clave prepago.

Paso 1: settings.json

Instala Claude Code (npm install -g @anthropic-ai/claude-code, Node.js 22+) y crea o edita ~/.claude/settings.json. En Windows el archivo es %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-...",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": ""
  }
}

Dos detalles importan:

• ANTHROPIC_API_KEY debe ser una cadena vacía, no faltar. Si falta, Claude Code ignora la URL base y va directo a Anthropic.
• La URL base no lleva /v1. Claude Code añade /v1/messages por su cuenta, así que https://getvibeapi.com/v1 duplicaría la ruta.

Ejecuta claude y escribe /status. La línea de la URL base de Anthropic debe mostrar https://getvibeapi.com.

Paso 2: elegir los modelos

Claude Code tiene tres ranuras de modelo: Opus, Sonnet y Haiku. Por defecto usa la ranura Sonnet para la mayoría de las tareas y la ranura Haiku para operaciones rápidas. Cada ranura es una variable de entorno, y su valor puede ser cualquier ID de modelo de nuestro catálogo que acepte el formato Messages:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-pv-...",
    "ANTHROPIC_BASE_URL": "https://getvibeapi.com",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL":   "claude-opus-5.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL":  "claude-haiku-4.5"
  }
}

Para usar el agente con un modelo más económico, pon su ID en la ranura Sonnet, por ejemplo deepseek-v4.1-flash o gemini-3.8-flash. Usa los IDs exactos del catálogo: los nombres de snapshots fechados de Anthropic, como claude-haiku-4-5-20251001, no se resuelven.

Qué modelos funcionan en Claude Code

No todos los modelos del catálogo aceptan el formato Anthropic Messages. El catálogo público en https://getvibeapi.com/api/catalog marca cada modelo con anthropicFormat. Donde vale true, el modelo funciona por /v1/messages. En el momento de escribir esto, eso incluye:

Los modelos GPT-6 (Luna, Sol, Astra) no aceptan el formato Messages y se rechazan en /v1/messages. Para usarlos en un agente de terminal, usa Codex CLI, que habla la Responses API, o cualquier herramienta con URL base compatible con OpenAI (consulta la lista de integraciones).

Problemas frecuentes

• 401: revisa el valor de ANTHROPIC_AUTH_TOKEN y que ANTHROPIC_API_KEY sea "".
• Las solicitudes siguen yendo a Anthropic: ANTHROPIC_API_KEY no está definida como cadena vacía.
• No se leen las variables: settings.json es más fiable que los perfiles del shell, sobre todo en Windows.
• Modelo no disponible: el ID está mal escrito, está retirado o no está en formato Messages. Compruébalo en la página de modelos.

Mantén bajo el coste

Los agentes de programación reenvían en cada turno un prefijo largo que casi no cambia. Los modelos Claude solo usan caché cuando la solicitud lleva un punto de corte cache_control. Si Claude Code no lo envía, la pasarela lo añade por ti. La entrada en caché se factura a una fracción del precio de entrada. La guía de caché y nuestro artículo sobre prompt caching explican cómo mantener estable el prefijo.

La referencia completa está en la guía de Claude Code y en Messages y Responses. Pagas por token desde un saldo prepago. No hay suscripción.