¿Qué es Claude Code Router?
Claude Code Router (CCR) ejecuta un gateway local con el que hablan los agentes de programación en lugar de la API de un proveedor. Detrás se configuran proveedores como OpenAI, Gemini, OpenRouter, DeepSeek, Moonshot, Z.AI y Mistral, además de reglas de enrutado, reintentos, modelos de reserva y rotación de claves.
Empezó como una forma de usar Claude Code con otros modelos y ahora también da servicio a Codex, OpenCode, Kimi CLI, Grok CLI, Kilo Code y otros. Se distribuye como aplicación de escritorio Electron, como CLI de npm (Node.js 22 o posterior) o en Docker. El gateway escucha en 127.0.0.1:3456 y registra por petición la ruta, la latencia, los tokens y el coste estimado.
Es un proyecto mantenido en gran parte por una sola persona y financiado con donaciones; la v3.1.3 salió el 9 de octubre de 2026.
¿Merece la pena Claude Code Router?
CCR hace lo que promete: un único endpoint local al que puede apuntar cualquiera de diez agentes, con el proveedor, el modelo y la cadena de reserva elegidos detrás. Con unas 37.800 estrellas en GitHub es el router autoalojado más adoptado para Claude Code, y la v3.1.3, del 9 de octubre de 2026, añadió un catálogo de modelos que se actualiza cada hora desde la CDN del proyecto.
El argumento económico es real. Anthropic cobra Claude Sonnet 5.5 a 2 $ por millón de tokens de entrada y 10 $ por millón de salida; DeepSeek cobra V4.1 Flash a 0,15 $ y 0,60 $ en horas valle. Una sesión larga de agente que lee 2 millones de tokens y escribe 100.000 cuesta unos 5 $ con Sonnet y menos de 0,40 $ con Flash, antes de caché. Enviar al modelo barato solo las llamadas en segundo plano y de resumen conserva la mayor parte de ese ahorro.
La pega son la calidad y el soporte. Los prompts y el formato de edición de Claude Code están ajustados para Claude, y guías de la comunidad informan de más ediciones fallidas con DeepSeek, Qwen o GLM. La documentación de gateways de Anthropic dice claramente que no da soporte a enrutar Claude Code a modelos que no sean Claude a través de ningún gateway, y que un gateway que no reenvíe las nuevas funciones de las peticiones las rompe, así que cada versión de Claude Code es una ocasión para que algo deje de funcionar.
La seguridad merece más atención de la que suele recibir una herramienta local. CCR guarda todas las claves de proveedor, puede importar el estado de sesión del navegador, y su guía de Docker advierte de que el mapeo por defecto del puerto 3458 escucha en todas las interfaces. Un aviso de agosto de 2025 mostró un fallo de CORS que podía filtrar claves a otros sitios web, corregido en la v1.0.34. Con 1.159 incidencias y pull requests abiertas frente a un único mantenedor principal, es una herramienta para el portátil de una persona más que para un despliegue en empresa, donde LiteLLM o el propio gateway de Anthropic ofrecen registros de auditoría y credenciales por usuario.
Dónde se gana su sitio
Un desarrollador autónomo que paga de su bolsillo el uso de API de Claude Code
Reducir la factura de tokens en sesiones largas de refactorización
Envía las peticiones en segundo plano y de contexto largo a DeepSeek V4.1 Flash, a 0,15 $ por millón de tokens de entrada en horas valle, y deja el modelo principal en Claude. El ahorro puede superar el 90% en las llamadas enrutadas, a costa de más ediciones fallidas cuando el modelo barato hace cambios reales.
Una ingeniera de un contratista de defensa con una estación de trabajo aislada de la red
Usar la interfaz de Claude Code con un modelo local para que ningún código salga de la máquina
Apunta un proveedor personalizado a un servidor local compatible con OpenAI, como Ollama o vLLM, y aplica el perfil de Claude Code. No se factura nada, pero hay que contar con que la actualización horaria del catálogo de modelos desde models.ccrdesk.top falle sin conexión, y la calidad de las ediciones depende por completo del modelo local.
Un jefe de equipo que prueba varios agentes con cinco desarrolladores
Comparar Codex, OpenCode y Claude Code con los mismos proveedores sin reconfigurar cada máquina
Una sola instancia de CCR guarda las claves y da a cada desarrollador una clave de cliente CCR con límites de tokens; los registros muestran el coste por petición. Sirve para una prueba, pero no hay SSO ni registro de auditoría central, que un despliegue en toda la empresa necesitaría.
Antes de decidirte
- Puesta en marcha
- Descarga la aplicación de escritorio para macOS, Windows o Linux, o npm install -g @musistudio/claude-code-router (Node.js 22+) y ejecuta ccr ui. Añade un proveedor y una clave, arranca el servidor en 127.0.0.1:3456 y aplica un perfil de agente; en minutos tienes la primera petición enrutada.
- Integraciones
- Agentes: Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode y WorkBuddy. Protocolos: OpenAI Chat y Responses, Anthropic Messages, Gemini, además de presets para OpenRouter, DeepSeek, SiliconFlow, Moonshot, Mistral, Z.AI y Bailian. Añade búsqueda web, herramientas MCP y visión a los modelos que no las tienen.
- Datos y privacidad
- Los prompts van al proveedor al que enrutes, con las condiciones de retención de ese proveedor. CCR guarda las claves de proveedor, las claves de cliente y los registros de peticiones en archivos SQLite locales, y descarga su catálogo de modelos de models.ccrdesk.top al arrancar y cada hora. Un aviso publicado: una mala configuración de CORS que podía exponer claves, corregida en la v1.0.34.
- Coste a escala
- Gratis bajo MIT; pagas directamente a los proveedores. Claude Sonnet 5.5 cuesta 2 $/10 $ por millón de tokens de entrada/salida frente a 0,15 $/0,60 $ de DeepSeek V4.1 Flash en horas valle, así que el ahorro depende de cuántas peticiones te atrevas a apartar de Claude.
- Límites
- Sin soporte de Anthropic, y las actualizaciones de Claude Code pueden romper el paso de peticiones hasta que CCR se ponga al día. 1.159 incidencias y pull requests abiertas, muchas sobre parámetros de proveedores concretos. Poner CCR detrás de otro proxy hace que los fallos sean difíciles de rastrear.
Lo bueno
- Diez agentes y una docena de protocolos de proveedor detrás de un endpoint
- Fallbacks, reintentos y grupos de credenciales
- Registros de coste, tokens y latencia por petición
- Claves de cliente con caducidad y límites de tokens
Lo malo
- Anthropic no da soporte al enrutado a modelos que no son Claude
- Los modelos que no son Claude fallan más ediciones de Claude Code
- El puerto por defecto de Docker escucha en todas las interfaces
- 1.159 incidencias abiertas para un proyecto casi de un solo mantenedor
Ideal para
Desarrolladores que quieren usar Claude Code u otros agentes con modelos más baratos o locales.
Alternativas a Claude Code Router
Claude Code Router: preguntas frecuentes
- ¿Merece la pena Claude Code Router?
- Una centralita local capaz para usar agentes de programación con modelos más baratos, siempre que aceptes que Anthropic no dará soporte al resultado y que las ediciones serán peores. Le damos un 4.0 sobre 5.
- ¿Cuánto cuesta Claude Code Router?
- Gratuito y de código abierto (MIT). Pagas a cada proveedor de modelos al que enrutes.
- ¿Qué inconvenientes tiene Claude Code Router?
- Anthropic no da soporte al enrutado a modelos que no son Claude; los modelos que no son Claude fallan más ediciones de Claude Code; el puerto por defecto de Docker escucha en todas las interfaces; 1.159 incidencias abiertas para un proyecto casi de un solo mantenedor.
- ¿Para quién es Claude Code Router?
- Desarrolladores que quieren usar Claude Code u otros agentes con modelos más baratos o locales.
- ¿Cuánto cuesta Claude Code Router para un equipo o en producción?
- Gratis bajo MIT; pagas directamente a los proveedores. Claude Sonnet 5.5 cuesta 2 $/10 $ por millón de tokens de entrada/salida frente a 0,15 $/0,60 $ de DeepSeek V4.1 Flash en horas valle, así que el ahorro depende de cuántas peticiones te atrevas a apartar de Claude.
- ¿Es Claude Code Router seguro para los datos de la empresa?
- Los prompts van al proveedor al que enrutes, con las condiciones de retención de ese proveedor. CCR guarda las claves de proveedor, las claves de cliente y los registros de peticiones en archivos SQLite locales, y descarga su catálogo de modelos de models.ccrdesk.top al arrancar y cada hora. Un aviso publicado: una mala configuración de CORS que podía exponer claves, corregida en la v1.0.34.
- ¿Cuáles son las mejores alternativas a Claude Code Router?
- Las alternativas más cercanas que hemos analizado son ccusage, Codex plugin for Claude Code y rtk (Rust Token Killer).
Respuestas comprobadas el 26 oct 2026.