Claude Code

El agente de codificación en terminal oficial de Anthropic. Habla el protocolo Anthropic Messages, así que una vez que lo apuntes a Synthorai con dos variables de entorno, cada modelo Claude de tu espacio de trabajo está disponible — nada más en tu configuración cambia.

✦

Esta es la ruta de integración más popular para los equipos que quieren Claude en el terminal y facturación centralizada + límites de tasa en el gateway.

Antes de empezar

Crea una clave API en Console → API Keys. La clave completa se muestra una vez — cópiala antes de cerrar el cuadro de diálogo.

Paso 1 — Establecer variables de entorno

Claude Code lee ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY desde el entorno. Añádelas a tu perfil de shell (~/.zshrc, ~/.bashrc, o ~/.config/fish/config.fish) para que cada terminal nueva las tome.

# ~/.zshrc (or equivalent)
export ANTHROPIC_BASE_URL="https://synthorai.io"
export ANTHROPIC_API_KEY="sk-..."   # your Synthorai key

⚠

La base URL no incluye /v1 — el SDK de Anthropic añade /v1/messages internamente. Si pegaste https://synthorai.io/v1, las solicitudes llegarán a /v1/v1/messages y darán 404.

Paso 2 — Envía tu primera solicitud

# Reload env, then:
claude --model claude-sonnet-4-6 "explain this diff" < <(git diff HEAD~1)

# Or start an interactive coding session:
claude code --model claude-opus-4-6

Una respuesta exitosa imprime la salida del modelo en stdout. Si obtienes 401 la clave es incorrecta o está desactivada; si obtienes 404 el nombre del modelo no es enrutable en tu espacio de trabajo — verifica /console/pricing.

Modelos recomendados

Parámetro	Tipo	Descripción
`claude-opus-4-6`	`reasoning`	Calidad insignia. Úsalo para refactorizaciones profundas y problemas ambiguos.
`claude-sonnet-4-6`	`balanced`	Mejor relación precio/calidad para la codificación diaria y las sesiones de agente largas.
`claude-haiku-4-5`	`fast`	El más barato, el más rápido. Bueno para preguntas ad hoc conversacionales y ediciones cortas.

Solución de problemas

401 Unauthorized — la clave es incorrecta, está desactivada o ya fue revocada. Regenérala en /console/keys.

404 / «modelo no encontrado» — el modelo que pasaste a --model no está en el catálogo de canales de tu workspace. Ejecuta curl $ANTHROPIC_BASE_URL/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" para ver qué está disponible.

«Sigue llegando a api.anthropic.com» — tu shell no tomó las nuevas variables de entorno. Abre un terminal nuevo, o source ~/.zshrc.

¿Puedo usar modelos que no sean Claude a través de claude-code? — No. La CLI solo habla la API Anthropic Messages y el /v1/messages de Synthorai solo enruta a modelos Claude. Para modelos OpenAI / Gemini / Qwen usa Codex, Aider o el SDK de OpenAI directamente.

Los precios actuales por token de los tres niveles están en la Claude model price comparison.