Tutorial de Claude Code Router: conecta Claude Code a DeepSeek, Gemini o cualquier modelo
El router de código abierto mantiene la experiencia de Claude Code, pero envía cada petición a modelos más baratos: DeepSeek, Kimi, Gemini o un modelo local de Ollama. Instálalo con npm, configura los proveedores en la consola ccr ui, define rutas por escenario y ejecuta una tarea real para comprobarlo. 15 pasos con capturas.
En resumen: qué hace Claude Code Router
- Claude Code Router (CCR) es un proxy gratuito de código abierto: Claude Code conserva su interfaz, prompt de sistema y herramientas, pero las llamadas al modelo van a lo que tú configures: DeepSeek, Kimi K2, Gemini, OpenRouter o un modelo local de Ollama.
- La instalación es un solo comando de npm (npm install -g @musistudio/claude-code-router) y la consola web ccr ui edita ~/.claude-code-router/config.json por ti, sin tocar JSON a mano.
- El enrutado es por escenario: default, background, think (razonamiento del Plan Mode), longContext (se activa sola al pasar el umbral de 60.000 tokens) y webSearch reciben cada uno su propio modelo.
- ccr code abre una sesión enrutada con la URL base apuntando a http://127.0.0.1:3456; el comando claude sigue funcionando igual. Peculiaridad conocida: /cost se queda en $0, así que controla el gasto en el panel del proveedor.
Claude Code Router: Use Gemini 2.5 Pro FREE API in Claude Code
Vídeo original:AI With Nathan10:52
claude-code-router — official README
Datos del producto:musistudio on GitHubDocs
Los pasos y capturas siguen el vídeo; los nombres de campos de config.json, los roles del router y el comportamiento de los transformers están cotejados con el README oficial.
Las imágenes son capturas del vídeo de origen con su crédito, cada una enlazada a su marca de tiempo. El texto de esta guía es original, no una transcripción.
Configura Claude Code Router paso a paso
1 · Apunta Claude Code a modelos más baratos
- 1
Por qué Claude Code necesita un router
Claude Code está atado a los modelos Claude, y son caros: Opus 4.1 cuesta oficialmente $15 por millón de tokens de entrada y $75 por millón de salida. Claude Code Router (CCR), un proyecto de código abierto, conserva la experiencia de Claude Code pero enruta cada petición al modelo que elijas: DeepSeek, Kimi, Gemini o un modelo local de Ollama.
Los precios de lista de Anthropic antes del cambio: esa es la factura que CCR evita.Ver en 0:30 - 2
Instala Claude Code y después el router
CCR asume que Claude Code ya está instalado: npm install -g @anthropic-ai/claude-code. Luego instala el router: npm install -g @musistudio/claude-code-router. Tu configuración de proveedores vivirá en ~/.claude-code-router/config.json.
Las dos instalaciones de npm del README oficial: el router nunca sustituye a Claude Code.Ver en 3:36 - 3
Deja que npm termine la instalación global
npm descarga las dependencias del router (ver un aviso de deprecación de node-domexception es normal). Al terminar, el comando ccr queda disponible en cualquier lugar.
npm descargando paquetes durante la instalación global de @musistudio/claude-code-router.Ver en 3:49
2 · Añade proveedores en la consola ccr ui
- 4
Abre la consola de configuración con ccr ui
En lugar de editar JSON a mano, ejecuta ccr ui. Se abre una pestaña del navegador en 127.0.0.1:3456: los proveedores se gestionan a la izquierda, la sección Router asigna modelos a los escenarios a la derecha y debajo quedan los Custom Transformers.
Primer arranque de la consola ccr ui: proveedores vacíos y ranuras del router a la espera.Ver en 4:08 - 5
Añade un proveedor desde una plantilla
Pulsa Add Provider y elige una plantilla: el vídeo usa OpenRouter, y también hay presets para deepseek, gemini, dashscope, modelscope, siliconflow y volcengine. La plantilla rellena la URL de la API y una lista de modelos por defecto; el transformer puede quedar vacío.
Plantillas de proveedores en ccr ui: eliges una y la URL y los modelos se rellenan solos.Ver en 4:30 - 6
Pega la API key y elige tus modelos
Tres campos importan de verdad: la URL de la API (ya rellena), la clave secreta y la lista de modelos. El vídeo añade DeepSeek R1 y Kimi K2 bajo OpenRouter y guarda: el proveedor aparece en el panel izquierdo, listo para asignar.
El formulario Edit Provider: URL, clave y modelos; todo lo demás puede quedar por defecto.Ver en 4:53 - 7
Deja que los transformers resuelvan las diferencias de API
Los transformers reescriben las peticiones y respuestas para que las API de terceros sigan siendo compatibles con Claude Code. CCR trae valores por defecto razonables: por ejemplo, un transformer deepseek para api.deepseek.com y uno tooluse para deepseek-chat, así que rara vez escribirás el tuyo.
Ejemplos de transformers globales y por modelo del README, incluido el ajuste predefinido de DeepSeek.Ver en 3:54 - 8
Añade una clave gratuita de Gemini para el razonamiento
Añade un segundo proveedor con la plantilla de Gemini y crea una API key gratuita en Google AI Studio (Get API key → Create API key). Pégala y guarda: en breve asignarás este proveedor a las ranuras de razonamiento, contexto largo y búsqueda web.
Creando la API key gratuita de Gemini en Google AI Studio para el proveedor de CCR.Ver en 5:45
3 · Define las reglas de enrutado
- 9
Entiende los cinco roles del router
default atiende las tareas generales (y todo lo que no asignes). background ejecuta trabajos en segundo plano: aquí un modelo pequeño o local ahorra coste. think cubre el razonamiento pesado como el Plan Mode. longContext se activa automáticamente al pasar longContextThreshold (60.000 tokens por defecto), y webSearch necesita un modelo que admita la función: en OpenRouter añade :online al nombre del modelo. /model cambia de modelo en mitad de la sesión.
El objeto Router del README: cada rol, el umbral de 60K y el sufijo :online.Ver en 1:06 - 10
Asigna un modelo a cada escenario
En la sección Router, elige entre los modelos de tus proveedores guardados: el vídeo pone DeepSeek R1 como default, Kimi K2 para el uso general, Gemini 2.5 Pro (ventana de 1M de tokens) para longContext y el rápido Gemini Flash para webSearch. Pulsa Save and Restart arriba a la derecha al terminar.
Rellenando la ranura Default con deepseek/deepseek-r1-0528 del proveedor guardado.Ver en 5:15 - 11
Inicia la sesión enrutada con ccr code
De vuelta en el terminal, ejecuta ccr code. La pantalla de bienvenida de Claude Code muestra Overrides (via env) — API Base URL http://127.0.0.1:3456 — la prueba de que las peticiones pasan por el router. El comando claude normal sigue abriendo una sesión sin enrutar, sin necesidad de desinstalar nada.
El bloque Overrides en la pantalla de bienvenida: tu tráfico pasa por el proxy local de CCR.Ver en 6:45
4 · Ejecuta una tarea real y verifícala
- 12
Dale una tarea de programación real
Escribe tu prompt como siempre: el vídeo pide un juego rompe-ladrillos de neón con animaciones modernas. Claude Code planifica una lista de tareas y la ejecuta paso a paso con los modelos enrutados. Espera detalles cosméticos: el contador de tokens de entrada puede quedarse en cero.
Claude Code avanzando por su lista de tareas mientras CCR enruta las llamadas al modelo.Ver en 7:06 - 13
Revisa el resultado terminado
El agente cierra con un resumen de características — efectos visuales, diseño adaptable, controles, mecánicas de juego — y los archivos quedan en tu proyecto (index.html, style.css, script.js). Abre el HTML en el navegador y pruébalo tú mismo.
Resumen final de Claude Code para el juego rompe-ladrillos de neón.Ver en 7:30 - 14
Verifica el uso real en el panel del proveedor
La página Your Activity de OpenRouter es la fuente de la verdad: muestra las llamadas enrutadas — peticiones repetidas de Kimi K2 y la llamada a DeepSeek — con recuentos de tokens y gasto. Así confirmas que CCR realmente usa tus modelos más baratos.
Uso de OpenRouter tras la sesión: los modelos enrutados aparecen con recuentos reales de peticiones.Ver en 7:45 - 15
Conoce las asperezas antes de confiar en él
Ejecuta /cost en una sesión enrutada y verás $0.0000, con el uso por modelo mostrando claude-sonnet a cero: la contabilidad de costes aún no está conectada a proveedores externos. El enrutado funciona bien; de momento controla el gasto en el panel del proveedor.
La conocida carencia de /cost en sesiones enrutadas: los paneles del proveedor son tu medidor real.Ver en 9:25