Source: https://aiprimetech.io/es/blog/claude-code-router/ Sep 17, 2026 · 8 min · Código abierto # Claude Code Router: ejecuta Claude Code con otros modelos (y cuándo una pasarela resulta más sencilla) A Por [AI Prime Tech](https://aiprimetech.io/es/) · Con asistencia de IA Claude Code Router te permite conectar Claude Code con otros modelos mediante una pasarela local que gestiona la selección de proveedores, la adaptación de protocolos y el enrutamiento. Esta guía abarca la instalación, los perfiles de agentes, las alternativas de respaldo y la integración con OpenCode Go disponible en v3.1.1 a fecha del 17 de septiembre de 2026. También aprenderás cuándo una pasarela alojada requiere menos pasos de configuración local. ## Qué hace Claude Code Router Claude Code Router de musistudio, a menudo abreviado como CCR, se describe como una «pasarela local de modelos y un plano de control para agentes de programación». Proporciona un endpoint local estable para Claude Code y otros clientes, con credenciales de proveedores, reglas de enrutamiento, reintentos, alternativas de respaldo ordenadas y registros de solicitudes. El [v3.1.1 README](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/README.md) indica compatibilidad con los formatos OpenAI Chat y Responses, Anthropic Messages y Gemini Generate Content e Interactions. La adaptación de protocolos es lo que permite ejecutar Claude Code con otros modelos a través de CCR. CCR tiene licencia MIT, con derechos de autor de musistudio de 2025, y se suministra «TAL CUAL». El permiso para usar el software no hace que la inferencia del proveedor sea gratuita. Los cargos y las cuotas de los proveedores siguen siendo independientes; los precios históricos de los proveedores y las cuotas en dólares de OpenCode Go no se han verificado para esta fecha de publicación. ### La versión relevante de Claude Code Router 3.1 La versión 3.1.1 se publicó el 16 de septiembre de 2026. Añade compatibilidad nativa con la importación local de OpenCode Go, muestra los intentos fallidos individuales de la pasarela y corrige los precios de uso de los modelos enrutados. La versión también acepta --daemon en start y serve, corrige el proceso de trabajo del cuerpo de los registros de la interfaz de Docker y proporciona compilaciones para macOS Apple Silicon e Intel, un instalador para Windows y una AppImage para Linux. La configuración que se muestra a continuación utiliza la distribución de npm y la documentación fijada en v3.1.1. ## Instala CCR y conecta Claude Code La distribución de npm requiere Node.js 22 o posterior. La [guía de la CLI fijada a esa versión](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/docs/src/content/docs/en/guides/cli.md) documenta estos comandos: ``` npm install -g @musistudio/claude-code-router ccr --help ccr ui ``` Para iniciar sin abrir un navegador: ``` ccr ui --no-open ``` La interfaz de administración y la pasarela de modelos tienen direcciones predeterminadas distintas: | Componente | Dirección predeterminada | Propósito | Interfaz de administración | http://127.0.0.1:3458 | Configurar proveedores, perfiles y enrutamiento | Pasarela de modelos | http://127.0.0.1:3456 | Recibir solicitudes de modelos de los clientes Tener claras estas funciones ayuda a comprobar dónde falló una conexión. Que la página de administración funcione no demuestra por sí solo que la pasarela de modelos haya aceptado su configuración. ### Añade un proveedor y una clave de cliente Abre Proveedores → Añadir proveedor, elige una opción predefinida u Otro / endpoint de API personalizado, e introduce el endpoint y la clave de API. CCR detecta los protocolos y los modelos; Configuración avanzada te permite seleccionar un protocolo manualmente. Usa Comprobar conexión para probar el proveedor. Esto envía una solicitud real, por lo que puede consumir tokens o parte de la cuota de solicitudes del proveedor. Crea una clave de cliente de CCR en Claves de API para las solicitudes de modelos. Esa clave es independiente del token de la interfaz de administración/RPC: trata el acceso de los clientes y el acceso de administración como elementos de configuración distintos. ### Crea un perfil de Claude Code En Configuración del agente, crea un perfil habilitado para Claude Code, selecciona un modelo como Provider/modely guárdalo. Para un perfil llamado «Claude Code - Trabajo», inicia con: ``` ccr "Claude Code - Work" ``` Los comandos de inicio generados por la aplicación de escritorio utilizan ccr-app. La [guía de perfiles de Claude Code](https://raw.githubusercontent.com/musistudio/claude-code-router/v3.1.1/docs/src/content/docs/en/configuration/agents/claude-code.md) distingue dos ámbitos: - Solo al abrir desde CCR aplica la configuración a los inicios desde CCR. - Predeterminado del sistema también afecta a los inicios directos de Claude Code. Los perfiles permiten configurar sustituciones para Fable, Opus, Sonnet y Haiku. Verifica la selección activa con /modely luego consulta los Registros de solicitudes de CCR para ver las solicitudes que pasan por la pasarela. Ten a mano la [guía de modelos de Claude Code](/es/claude-code/models/) al planificar esas selecciones. ## Configura el enrutamiento, los reintentos y las alternativas de respaldo Las reglas de enrutamiento de CCR pueden inspeccionar request.header y request.bodyy pueden reescribir request.body.model. Esto te permite controlar la selección del modelo según la solicitud entrante, más allá del modelo elegido en un perfil de agente. La configuración de alternativas de respaldo utiliza mode, modelsy retryCount. Los tres modos son off, retryy model-chain. | Comportamiento | Respuestas pertinentes | Efecto operativo | Reintento | 408, 409, 429 y 5xx | Reintenta las solicitudes tras fallos que cumplen los criterios | Destinos de respaldo | Cualquier 4xx o 5xx | Puede trasladar una solicitud a otro modelo configurado | Gestión de la espera | Positivo Retry-After, cuando está presente | Utiliza el tiempo de espera indicado para el reintento | Espera predeterminada entre reintentos | Cuando no se aplica ningún valor positivo de Retry-After se aplica | Comienza en un segundo, con un límite de 30 segundos por intento La distinción entre los criterios para un reintento y los criterios para recurrir a una alternativa de respaldo es importante. Una respuesta que no cumple los criterios para un reintento puede cumplir los criterios para un destino de respaldo. ### Comprueba qué modelo atendió realmente la solicitud Una cadena de modelos puede cambiar el modelo que finalmente atiende una solicitud. Los registros de CCR muestran el proveedor y el modelo finales, así que utiliza esos registros al comprobar comportamientos o consumos inesperados. Empieza con un perfil cuyo proveedor y modelo puedas identificar. Añade reglas de enrutamiento y destinos de respaldo de forma deliberada y luego comprueba el destino final tras ponerlos a prueba. Esto facilita relacionar un cambio en las respuestas o en el patrón de costes con la configuración de enrutamiento. La versión 3.1.1 también muestra los intentos fallidos individuales de la pasarela. Esos registros ayudan a distinguir una respuesta final satisfactoria de los intentos que la precedieron. ## Usa la importación de OpenCode Go en v3.1.1 La versión v3.1.1 de Claude Code Router de musistudio añade compatibilidad nativa con la importación local de OpenCode Go. La integración separa Zen, identificado como opencode, de Go, identificado como opencode-go, incluidas sus credenciales y los identificadores de modelos que comparten. El importador lee la configuración de OpenCode, auth.jsony los metadatos de modelos almacenados en caché. OPENCODE_API_KEY se aplica a ambos servicios; OPENCODE_GO_API_KEY proporciona una configuración específica para Go que prevalece sobre la general. El descubrimiento filtra los modelos por protocolo y concilia los metadatos almacenados en caché con los resultados en tiempo real de /models . ### Por qué importa la cabecera de sesión El [PR de integración de OpenCode Go](https://github.com/musistudio/claude-code-router/pull/1786) indica que las solicitudes a https://opencode.ai/zen/go/v1 requieren x-opencode-session. Sin ella, el endpoint devuelve 400 MissingSessionID. CCR selecciona el valor de sesión en este orden: configuración explícita, una cabecera explícita del cliente, cabeceras de sesión de Claude, metadata.user_idy, por último, un valor de respaldo estable para el proceso. La inyección de la cabecera se limita al endpoint oficial de Go. Esto explica por qué introducir solo un endpoint y una credencial puede no ser suficiente para Go. Su requisito de sesión forma parte de la integración del proveedor. ### Actualizar el descubrimiento y consultar los límites de uso Si la importación de Go no está disponible, conecta OpenCode Go en OpenCode, actualiza su caché local de modelos y vuelve a realizar la detección en CCR. CCR obtiene los datos de uso de GET https://opencode.ai/zen/go/v1/usage y muestra los porcentajes restantes para períodos de cinco horas, semanales y mensuales. La documentación fijada no especifica asignaciones en dólares. Interpreta esos valores como porcentajes restantes para los períodos indicados; no representan un saldo monetario. ## Diagnosticar la conexión por etapas El material de resolución de problemas de CCR aborda solicitudes que omiten el enrutamiento, fallos de autenticación, modelos ausentes, selecciones de modelo inesperadas, aumentos repentinos de costes, tiempos de espera agotados y trazas de agentes ausentes. Una secuencia de diagnóstico útil sigue la solicitud desde la configuración de inicio hasta su proveedor final. ### Claude Code omite CCR Comprueba que el perfil de Agent Config previsto esté habilitado y que hayas iniciado el cliente mediante él. Un perfil configurado como Solo al abrir desde CCR limita su configuración a los inicios mediante CCR; los inicios directos se ven afectados cuando se selecciona Predeterminado del sistema . Usa /model y los registros de solicitudes de CCR conjuntamente para verificar la configuración. La [referencia de la CLI de Claude Code](/es/claude-code/cli/) ofrece una referencia más amplia para trabajar con el cliente. ### Errores de autenticación o modelos ausentes Para los errores 401/403, revisa las credenciales de cada capa pertinente: la clave API del proveedor, la clave de cliente de CCR para las solicitudes de modelos y el token de administración independiente. Estas credenciales cumplen funciones distintas. Para model not found, revisa los modelos detectados, el protocolo seleccionado y la selección de proveedor y modelo del perfil. Con OpenCode Go, actualiza la caché local y vuelve a realizar la detección si la importación no está disponible. ### Fallos de inicio y tiempos de espera agotados La versión 3.1.1 aumenta el tiempo de aceptación de la configuración del gateway de cinco segundos a 30 segundos. Esto resuelve los casos en los que la interfaz de administración se inicia, pero el gateway falla cuando el sistema está bajo carga, especialmente en Windows. CCR_GATEWAY_CONFIG_TIMEOUT_MS sustituye el tiempo de espera. Los valores no válidos o inferiores a 1,000 milisegundos hacen que se use el valor predeterminado. La configuración se encuentra en ~/.claude-code-router en macOS/Linux y en %APPDATA%\claude-code-router en Windows. Entre los archivos pertinentes se incluyen config.sqlite, el archivo generado gateway.config.jsony service.json. Los comandos del servicio incluyen ccr start, ccr stopy, en primer plano, ccr serve. ## Cuándo resulta más sencillo un gateway alojado CCR encaja en flujos de trabajo que necesitan administración local de proveedores, enrutamiento basado en solicitudes, conjuntos de credenciales o cadenas de respaldo explícitas. Un gateway alojado puede reducir los pasos de configuración local cuando tu objetivo inmediato es conectar Claude Code a un servicio de destino. El anuncio de OpenRouter del [4 de agosto de 2026](https://openrouter.ai/blog/announcements/ori-harness/) documenta estos ajustes de conexión: ``` ANTHROPIC_BASE_URL=https://openrouter.ai/api ANTHROPIC_AUTH_TOKEN= ANTHROPIC_API_KEY= ``` El anuncio también especifica ajustes adicionales de modelos y funciones. Estas tres variables son los ajustes de conexión, no una configuración completa para todos los modelos. OpenRouter advierte que la mayoría de los modelos abiertos no admiten la búsqueda de herramientas, por lo que los ajustes varían según el modelo. Su CLI Ori automatiza la configuración mediante: ``` ori login ori claude ``` Los mismos flujos de trabajo también pueden ejecutarse a través de un gateway de API como AI Prime Tech, un servicio independiente sin afiliación con Anthropic ni OpenAI; consulta la guía sobre [cómo usar Claude Code con una clave de API](/es/learn/claude-code-api-key-setup/). Elige según los controles que necesites. CCR ofrece un lugar local para administrar rutas, inspeccionar intentos y configurar alternativas de respaldo; el enfoque alojado documentado elimina la necesidad de operar CCR localmente. ## Puntos clave - Claude Code Router conecta Claude Code y otros clientes con proveedores mediante un endpoint local estable con adaptación de protocolos. - La distribución de npm requiere Node.js 22+, y la interfaz de administración y el gateway de modelos usan puertos predeterminados distintos. - El alcance de Agent Config determina si un perfil se aplica solo a los inicios mediante CCR o también a los inicios directos. - Las alternativas de respaldo pueden cambiar el modelo que atiende la solicitud; consulta los registros de solicitudes para conocer el proveedor y el modelo finales. - v3.1.1 añade la importación de OpenCode Go con credenciales independientes y la gestión de la cabecera de sesión obligatoria. - Un gateway alojado puede reducir la configuración local cuando no necesitas los controles de enrutamiento local de CCR. ## Preguntas frecuentes ### ¿Claude Code Router es gratuito? Claude Code Router tiene licencia MIT, que concede permiso para usar el software. Esto no implica que la inferencia de los proveedores sea gratuita, y aquí no se verifican los precios históricos de los proveedores ni las asignaciones en dólares de OpenCode Go. ### ¿Puedo usar Claude Code con otros modelos mediante CCR? Sí. CCR ofrece adaptación de protocolos y selección de proveedor y modelo, y sus perfiles de Claude Code permiten seleccionar un modelo como Provider/model. Los formatos de los proveedores compatibles incluyen OpenAI Chat/Responses, Anthropic Messages y Gemini Generate Content/Interactions. ### ¿Qué cambió en Claude Code Router 3.1.1? Publicada el 16 de septiembre de 2026, v3.1.1 añade compatibilidad nativa con la importación local de OpenCode Go, visibilidad de cada intento fallido y precios de uso corregidos para los modelos enrutados. También aumenta el tiempo de aceptación de la configuración del gateway a 30 segundos y acepta --daemon en start y serve. ### ¿Por qué OpenCode Go devuelve MissingSessionID? El endpoint oficial de OpenCode Go requiere la cabecera x-opencode-session y devuelve 400 MissingSessionID cuando no está presente. La integración de Go de CCR selecciona un valor de sesión siguiendo un orden de prioridad definido e inyecta la cabecera solo para el endpoint oficial de Go. [Claude](/es/blog/tag/claude/)[Programación](/es/blog/tag/coding/)[Código abierto](/es/blog/tag/open-source/) A [AI Prime Tech](https://aiprimetech.io/es/) AI Prime Tech publica este blog. Los artículos se redactan con asistencia de IA; comprueba los detalles específicos de cada versión, como los identificadores de modelos, los precios y los límites, en la documentación oficial antes de basarte en ellos. Obtén acceso más económico a la API de Claude Una sola clave de API para Claude Opus 5.5, Sonnet 5, Haiku 4.5 y Fable 5.1, además de GPT-6 modelos. Pago por uso, sin suscripción. [Obtén tu clave de API →](/register) AI Prime Tech es una pasarela de API independiente de terceros. Claude™ y Anthropic® son marcas comerciales de Anthropic, PBC. No se implica ninguna afiliación ni respaldo.