ClaudeGate: el proxy para Claude Code que usa Ox Alpha

En pocas palabras: ClaudeGate es un gateway open source (licencia MIT) creado por Santosh Prasad Verma que conecta la CLI de Claude Code con modelos de OpenRouter como Ox Alpha y DeepSeek V4-Pro. Corre local en el puerto 8082, convierte las llamadas de Anthropic al formato OpenAI y no exige suscripción.

Santosh Prasad Verma publicó en GitHub ClaudeGate, un proxy para Claude Code open source que conecta la CLI de Anthropic con modelos de OpenRouter como Ox Alpha y DeepSeek. El gateway traduce en tiempo real las llamadas del esquema de Anthropic al formato OpenAI, corre en tu máquina y trae failover automático entre más de 24 proveedores.

ClaudeGate es un gateway escrito en Python con FastAPI que escucha en el puerto 8082 de localhost. Intercepta las llamadas de Claude Code hacia la API de Messages de Anthropic, las convierte a Chat Completions compatibles con OpenAI y las reenvía al proveedor que hayas configurado: DeepSeek V4-Pro, Ox Alpha, Gemini 3.1 Pro, Kimi K3 o modelos locales de Ollama, entre otros. Tiene licencia MIT, presets para 24 proveedores y no exige suscripción de Anthropic.

¿Qué es ClaudeGate y cómo se diferencia del Claude Code estándar?

Claude Code es la herramienta CLI de Anthropic para delegar tareas de programación a un agente desde la terminal, y de fábrica solo conversa con los endpoints comerciales de la empresa. ClaudeGate se mete en el medio como traductor: recibe el esquema de Anthropic (/v1/messages y /count_tokens), lo convierte a Chat Completions estilo OpenAI y se lo entrega al proveedor que vos quieras.

Ponele que ya usás Claude Code todos los días. Tu flujo no cambia: escribís claude, pedís cosas, el agente edita archivos. Lo único que cambia es quién piensa detrás. El pipeline interno del gateway pasa por cuatro etapas: validación de auth en tiempo constante, sanitizador de datos sensibles, convertidor de protocolos (herramientas, mensajes y system prompts) y cliente upstream con controlador de failover. Después, un adaptador transforma los chunks de OpenAI en Server-Sent Events de Anthropic para que la CLI no note la diferencia.

Eso sí: la interfaz es la misma, el cerebro no. Y esa diferencia es justo la gracia del asunto.

¿Qué modelos podés usar con ClaudeGate y cuánto cuesta cada uno?

El repositorio trae 24 presets listos para copiar, que cubren desde gigantes comerciales hasta modelos locales. Podés apuntar a OpenRouter (Claude Opus 5, Sonnet 5, Haiku 4.5), OpenAI (GPT-5.6 Sol/Terra/Luna), DeepSeek (V4-Pro y V4-Flash), Google Gemini (3.1 Pro y 3.7 Flash), Alibaba Qwen, Moonshot Kimi K3, Mistral Large 3, Perplexity Sonar Reasoning Pro y varios más. Los locales también están: Ollama, LM Studio y vLLM para correr todo offline. Ya lo cubrimos antes en nuestra guía completa sobre Claude.

Proveedor	Modelo destacado	Costo
OpenRouter (preset ox)	Ox Alpha (“stealth”)	Gratis
DeepSeek oficial	V4-Pro / V4-Flash	Tarifa de DeepSeek
Ollama local	DeepSeek V4-Pro cuantizado, Qwen3.6-35B-A3B	Gratis, 100% offline
Nvidia Nemotron	Nemotron free tier	Gratis con límites
OpenRouter	Claude Opus 5 / Sonnet 5 / Haiku 4.5	Tarifa de OpenRouter
Google Gemini	Gemini 3.1 Pro / 3.7 Flash	Tarifa de Google

La comparación que importa: procesar los mismos tokens con DeepSeek V4-Pro cuesta una fracción de lo que sale con los planes de Anthropic. Para un equipo que quema millones de tokens por semana, esa brecha paga servidores.

¿Y Ox Alpha? Es el caso curioso del lote: un modelo de razonamiento “stealth” publicado de forma anónima en OpenRouter, sin costo y sin rostro visible (sí, en serio). DonWeb le dedicó un análisis completo. ClaudeGate incluye un script de prueba en vivo específico para él junto a Nemotron, señal de que los desarrolladores del proyecto lo usan como banco de pruebas habitual.

¿Cómo instalar ClaudeGate, el proxy para Claude Code, en tu máquina?

La instalación toma unos cinco minutos. Son cuatro pasos y una elección de proveedor.

• Cloná el repo y prepará el entorno virtual: git clone https://github.com/Santosh-Prasad-Verma/ClaudeGate.git, después python3 -m venv .venv y pip install -r requirements.txt.
• Configurá el proveedor con el wizard o un preset: python start_proxy.py --setup lanza un asistente interactivo; si preferís volar directo, --preset openrouter, --preset deepseek o --preset ox cargan la config lista.
• Probá la conexión antes de seguir: python start_proxy.py --test mide latencia y confirma que el modelo responde (la salida esperada muestra el modelo stealth/ox-alpha contra openrouter.ai).
• Levantá el gateway: python start_proxy.py deja el daemon escuchando en http://127.0.0.1:8082, y un curl http://127.0.0.1:8082/health debe devolver {“status”:”healthy”}.

Si sos del team contenedores, hay Dockerfile y docker-compose.yml con health-check incluido, sobre una imagen base Python slim multi-stage. Y si querés dejarlo corriendo las 24 horas para un equipo en vez de tu notebook, un VPS de donweb.com cumple de sobra para un servicio tan liviano.

¿Cómo conecto Claude Code CLI al gateway de ClaudeGate?

Hay dos caminos. El permanente modifica ~/.claude/settings.json para que todas las sesiones futuras pasen por el proxy; el temporal exporta variables en la terminal activa y muere cuando cerrás la pestaña.

{
 "env": {
 "ANTHROPIC_BASE_URL": "http://127.0.0.1:8082",
 "ANTHROPIC_API_KEY": "la-key-de-tu-proveedor"
 }
}

Para la opción de sesión, exportá esas mismas variables en el shell antes de ejecutar claude. Después, el flujo diario es el de siempre: levantás el daemon en una terminal, abrís otra, entrás a la carpeta de tu proyecto, escribís claude, le pedís que agregue autenticación JWT a un módulo y que corra los tests unitarios, y el agente lee archivos, edita código y ejecuta comandos bash como si nada hubiera cambiado, porque para vos no cambió nada: las operaciones de sistema de archivos y los comandos de terminal se traducen en ambos sentidos a function calls de OpenAI.

¿Y si mañana querés volver a Anthropic oficial? Borrás dos líneas del settings.json y listo. Sin drama. Complementá con cómo elegir entre Sonnet y Opus.

¿Es seguro ClaudeGate? Qué pasa con tu código y tus credenciales

El proyecto trae varias capas de protección pensadas para quien manda código a terceros. La principal es el sanitizador de secretos: activando SANITIZE_SECRETS=true, el gateway revisa cada prompt saliente y borra claves de AWS, PATs de GitHub, tokens de OpenAI y llaves SSH privadas antes de que abandonen tu computadora.

• Redacción de credenciales con regex: el motor detecta patrones de tokens y los reemplaza antes del envío upstream.
• Autenticación en tiempo constante: la validación de la API key evita fugas por timing attacks en el endpoint local.
• Limpieza de razonamiento interno: los bloques de pensamiento de modelos tipo DeepSeek R1/V4 se depuran del historial para que los turnos siguientes no revienten con errores de esquema.
• Validador de IP y logging estructurado: el gateway filtra conexiones y registra actividad de forma legible.

Ojo con un matiz: Ox Alpha corre en la nube de OpenRouter, así que tus prompts salen de tu máquina hacia servidores externos. Si trabajás con código bajo NDA, el camino limpio es Ollama local, donde ningún byte sale de tu máquina. La documentación de integración de Claude Code en OpenRouter detalla también qué información viaja en cada request.

¿Qué pasa si falla el proveedor principal mientras programás?

ClaudeGate detecta errores transitorios del upstream (HTTP 503, HTTP 429 de rate limit y timeouts de conexión) y redirige la petición a un proveedor de respaldo sin tirar tu sesión activa. El ejemplo del README: si OpenRouter empieza a rechazar requests, el tráfico salta a Groq o directo a tu Ollama local.

¿Y tu conversación con el agente? Sigue como si nada. Ni un token se pierde en el medio.

Sumale un socket keep-alive extendido a 600 segundos (10 minutos), calibrado para que la conexión no se corte durante esas pausas largas en las que estás pensando qué pedirle después. Trae también un script de verificación, verify_failover.py, que simula cortes del proveedor primario para comprobar el relevo antes de confiarle tu jornada laboral.

¿Para quién conviene un proxy como ClaudeGate?

Para cualquiera que quiera la experiencia agéntica de Claude Code sin casarse con la facturación de Anthropic. Cuatro perfiles encajan clarísimo: Te puede servir nuestra cobertura de explicaciones simples dentro de Claude Code.

• Equipos con presupuesto acotado: una startup con USD 200 mensuales de presupuesto IA rinde mucho más con DeepSeek V4-Pro que quemando esa cifra en pocos días de modelos premium.
• Freelancers con código de clientes: si firmaste acuerdos de confidencialidad, Ollama local te da el flujo agéntico con cero datos saliendo de tu máquina.
• Fans del razonamiento extendido: los presets de DeepSeek y Kimi K3 exponen modelos pensados para cadenas de razonamiento largas.
• Empresas con despliegues privados: hay presets para Azure OpenAI y Amazon Q vía Kiro Bridge en entornos corporativos.

Ejemplo concreto: un dev freelance que factura proyectos en Python puede pasar su semana típica de refactors y tests al preset deepseek.env y cerrar el mes gastando una fracción de la suscripción equivalente, manteniendo idéntica interfaz de terminal.

¿Qué limitaciones tiene ClaudeGate que debés conocer?

El proxy es sólido, pero los modelos que enchufás atrás no todos están a la altura. Un modelo abierto chico puede fallar en function calling de múltiples pasos donde Claude nativo brilla, y ahí la culpa no es del traductor sino del cerebro. Para trabajo agéntico serio, elegí modelos fuertes: V4-Pro, Sonnet 5 o Gemini 3.1 Pro.

Otros puntos: Ox Alpha es experimental y su disponibilidad depende de OpenRouter; cada proveedor aplica sus propios rate limits; Ollama pide hardware decente (GPU recomendada para V4-Pro cuantizado); la traducción de protocolo agrega una latencia adicional por llamada; y nada de esto aplica a la web de Claude.ai, solo a la CLI y a apps que usen el SDK de Anthropic.

Qué está confirmado y qué todavía no

Todo esto figura en el README y se verifica en el repositorio: gateway FastAPI en puerto 8082, 24 presets de proveedores, sanitizador de secretos con SANITIZE_SECRETS, failover ante 503/429/timeout, keep-alive de 10 minutos, licencia MIT y soporte Docker Compose.

Lo pendiente: benchmarks independientes que comparen la calidad agéntica de estos modelos contra Claude nativo en tareas reales, mediciones oficiales de latencia y tracción de comunidad más allá del autor (es un proyecto individual, sin empresa detrás). Tomalo como herramienta prometedora con poco historial. Lo explicamos a fondo en integrarlo con Make.com sin API key.

Errores comunes al configurar el proxy para Claude Code

Estos son los tropiezos típicos y cómo zafarlos:

• Arrancar claude con el gateway apagado: la CLI tira errores de conexión crípticos. Chequeá siempre curl http://127.0.0.1:8082/health antes de abrir una sesión larga.
• Dejar SANITIZE_SECRETS en false: tus claves AWS o PATs de GitHub viajan al proveedor tal cual están en el código. Activá la variable desde el día uno.
• Mezclar configuración de sesión con permanente: exportaste las variables en una terminal y ejecutaste claude desde otra; el tráfico siguió yendo a Anthropic y pagaste de más. Elegí un solo método.
• Usar modelos chicos para tareas agénticas: un modelo de 7B se pierde en cadenas de function calling de cinco pasos. Reservalos para consultas simples y usá V4-Pro para refactors completos.

Preguntas Frecuentes

¿Qué es ClaudeGate y para qué sirve?

ClaudeGate es un proxy local open source que convierte las llamadas de la API de Anthropic al formato OpenAI para usar Claude Code CLI con cualquier proveedor de modelos. Sirve para correr el agente de código de Anthropic con DeepSeek, Ox Alpha, Gemini, Kimi o modelos locales de Ollama sin contratar la nube de Anthropic.

¿Puedo usar Ox Alpha gratis en Claude Code con ClaudeGate?

Sí. Ox Alpha está disponible sin costo en OpenRouter y ClaudeGate incluye el preset ox.env para activarlo en un comando. El repo trae un script de prueba en vivo dedicado a este modelo junto a Nemotron.

¿Necesito una suscripción de Anthropic para usar ClaudeGate?

No. Alcanza con una API key del proveedor que vayas a usar: OpenRouter, DeepSeek, Groq u otro. La key que envía Claude Code se valida localmente en el gateway, que hace de puerta entre la CLI y el upstream.

¿Qué pasa si el proveedor principal falla mientras uso Claude Code?

ClaudeGate redirige las peticiones a un proveedor backup ante errores HTTP 503, 429 o timeouts, sin interrumpir la sesión. Podés encadenar OpenRouter como principal y Ollama local como último recurso, y probar el comportamiento con el script verify_failover.py incluido.

¿ClaudeGate sirve solo para Claude Code o también con otros clientes?

El README indica compatibilidad con la CLI, con aplicaciones que usan el SDK de Anthropic y menciona a Cursor entre los destinos posibles. El requisito es que el cliente hable el protocolo de la API de Messages de Anthropic, porque eso es lo que el gateway traduce.

Conclusión

ClaudeGate le saca a Claude Code el candado del ecosistema Anthropic: mismo flujo de terminal, cerebro a elección y factura a medida. Para quien miraba la CLI desde afuera por costo o privacidad, la barrera bajó muchísimo. Mi sugerencia práctica: probalo un fin de semana con el preset de OpenRouter y Ox Alpha (gratis, ideal para experimentar), y si te convence, migrá la carga seria a DeepSeek V4-Pro con un Ollama local como red de seguridad. Es un proyecto joven y sin respaldo corporativo, así que guardá plan B, pero como puerta de entrada al mundo agéntico sin suscripciones es de lo más interesante que apareció en 2026.

Fuentes

• GitHub – Repositorio oficial de ClaudeGate (documentación técnica, presets y scripts de verificación)
• Blog de DonWeb – Ox Alpha, el modelo anónimo gratis de OpenRouter
• OpenRouter – Documentación de integración con Claude Code
• lgallardo.com – Guía previa sobre routers alternativos para Claude Code