Claude Code no usa el endpoint de chat de OpenAI. Envía solicitudes Anthropic Messages a /v1/messages, por lo que su URL base y sus credenciales deben usar la configuración de Anthropic de Claude Code. GetVibe admite el formato Messages para modelos específicos del catálogo; GPT-6 Luna, GPT-6 Sol y GPT-6.1 Sol no son compatibles con esta ruta de CLI. Esta guía sigue la configuración de Claude Code de GetVibe y la referencia de endpoints personalizados existente.
Instala y configura Claude Code
Instala la CLI con Node.js 22 o posterior:
npm install -g @anthropic-ai/claude-code
mkdir -p ~/.claudeEdita ~/.claude/settings.json y usa exactamente los campos siguientes. La URL base intencionalmente no incluye /v1; Claude Code añade /v1/messages. El valor vacío de ANTHROPIC_API_KEY es importante: sin él, Claude Code puede preferir su autenticación directa normal de Anthropic en lugar del endpoint personalizado.
{
"apiKeyHelper": "echo $GETVIBE_API_KEY",
"env": {
"ANTHROPIC_BASE_URL": "https://getvibeapi.com",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
}
}Establece la clave en el shell antes de iniciar Claude Code: export GETVIBE_API_KEY='your-dashboard-key'. Esa es la variable de entorno que usan los archivos de integración de GetVibe. El archivo de configuración hace referencia a la variable; no debe contener la clave real. Evita poner una credencial directa de Anthropic en este perfil, porque la precedencia de credenciales puede evitar el endpoint personalizado.
Verifica el endpoint antes de otorgar acceso de escritura
Inicia claude en un repositorio desechable y ejecuta /status. La URL base de Anthropic debería ser https://getvibeapi.com. Primero haz una pregunta de solo lectura; después solicita una pequeña edición e inspecciona el diff. Si la solicitud todavía se envía directamente a Anthropic, comprueba que ANTHROPIC_API_KEY sea una cadena vacía y que el helper pueda leer GETVIBE_API_KEY. Si ves un /v1/v1/messages duplicado, elimina /v1 de la URL base.
¿Qué modelos funcionan mediante Messages?
La guía de integración actual de GetVibe incluye Claude Opus 5.5, Claude Sonnet 5, DeepSeek V4.1 Flash, Gemini 3.8 Flash, GLM-5.3 y Kimi K3 como ejemplos compatibles con la ruta Anthropic Messages. Consulta el catálogo de modelos actual antes de cambiar un slot; la compatibilidad de protocolo depende del modelo. GPT-6 Luna, GPT-6 Sol y GPT-6.1 Sol no funcionan mediante el endpoint Messages de Claude Code. Usa Codex CLI para esos modelos compatibles con Responses. La instantánea pública del catálogo consultada el 3 de octubre de 2026 muestra Sonnet 5.5 a $0.168 entrada · $0.84 salida por 1M de tokens por millón de tokens; el precio mostrado se mantiene actualizado.
Asigna los slots de modelos intencionalmente
Claude Code admite slots para Opus, Sonnet y Haiku. El ejemplo de configuración de GetVibe elige los IDs actuales para esos slots y usa CLAUDE_CODE_SUBAGENT_MODEL para el trabajo de subagentes. Cambia un slot a la vez. Después de reiniciar la CLI, pregunta a /status qué modelo está activo y ejecuta un prompt de prueba inocuo. No supongas que un modelo de OpenAI pertenece a un slot de Claude: el protocolo y el manejo de la familia de modelos son diferentes.
Para calcular los costos, compara Sonnet y Opus en la misma tarea, con la misma instantánea del repositorio, los mismos permisos y la misma solicitud de salida. Registra todos los turnos del agente y los pasos de reparación. El precio actual de Sonnet 5.5 se muestra como $0.168 entrada · $0.84 salida por 1M de tokens por millón de tokens de entrada y salida. La fecha de la instantánea del catálogo es el 3 de octubre de 2026; usa la página del modelo enlazada al presupuestar una sesión nueva.
Mantén bajo control las sesiones largas
Las sesiones de agente generan contexto repetido. Mantén las instrucciones concisas, excluye los artefactos de compilación y los directorios de dependencias incluidas, y evita pedirle al agente que vuelva a leer archivos grandes cuando sea suficiente con una lista de archivos concreta. Las solicitudes de Claude pueden usar puntos de interrupción de caché; GetVibe documenta el comportamiento del almacenamiento en caché en la documentación de caching. Mantén estable el prefijo y revisa los campos de uso para comprobar si la entrada almacenada en caché realmente se informa. No consideres que una tasa de caché teórica más baja supone un ahorro hasta que la sesión muestre lecturas de caché.
Define un límite claro para la tarea, usa los prompts de permisos normales y revisa los comandos y diffs. Un precio bajo por token no hace seguro un comando de shell peligroso. Para comparaciones de benchmark reproducibles, usa el mismo modo de permisos y el mismo acceso a herramientas para cada modelo.
Fallos comunes de configuración
- 401: verifica
GETVIBE_API_KEY, la salida del helper y queANTHROPIC_API_KEYesté vacío. - El tráfico evita GetVibe: revisa las credenciales en el perfil de tu shell y verifica la URL base mediante
/status. - Modelo no disponible: copia un ID actual exacto y verifica la compatibilidad con Messages en su página del modelo.
- URL incorrecta: establece el dominio raíz sin
/v1; Claude Code añade el sufijo de la ruta.
Establece una línea base de costos
Antes del despliegue, ejecuta una tarea corta y un cambio realista en varios archivos. Registra el ID del modelo, el uso de entrada y salida, las lecturas de caché si se informan, el tiempo transcurrido y si las pruebas pasan. Mantén la clave en un gestor de secretos y configura una alerta interna. Estas observaciones le dan al equipo una línea base real del costo por cambio, en lugar de asumir que todas las sesiones de programación consumen el mismo contexto. El precio actual se puede consultar en la página del modelo Sonnet 5.5.
Mantén explícitos los slots de modelos
Claude Code tiene slots para Opus, Sonnet y Haiku. Configura solo los slots que tu equipo planea usar y confirma la opción activa con /status después de cambiar la configuración. El nombre de un slot de Claude no es un adaptador de protocolo: un modelo exclusivo de OpenAI no se volverá compatible con Messages por asignarlo al slot de Sonnet.
Mide el almacenamiento en caché en una sesión real
Ejecuta una tarea corta y otra en varios archivos con las mismas instrucciones estables. Compara el uso de lecturas de caché en los turnos posteriores y registra el costo total de la sesión. Mantén los permisos, la instantánea del repositorio y el slot del modelo sin cambios entre pruebas repetidas; de lo contrario, la comparación no podrá determinar si una diferencia de costo provino del almacenamiento en caché, de llamadas adicionales a herramientas o de una tarea diferente.
Protege las ediciones y las credenciales
Usa un worktree desechable para la primera tarea con escritura habilitada, revisa los comandos y diffs, y conserva las credenciales en un secreto administrado por el shell. Si una clave llega al historial de la terminal o a un archivo de configuración compartido, rótala. Estos límites sencillos permiten que los desarrolladores exploren el agente sin dar a cada prompt acceso a datos de producción ni a un árbol de trabajo sin revisar.