ENRUTA LA CAPA DE MODELO

TL;DR — npm install -g @musistudio/claude-code-router, escribe un ~/.claude-code-router/config.json mínimo, levanta con ccr code en vez de claude. Cinco minutos de cero al primer turn enrutado.

▸ Instalar

# install global
npm install -g @musistudio/claude-code-router

# verifica
ccr --version

▸ Ubicación de la config

La config vive en ~/.claude-code-router/config.json (atención: no en ~/.config/ — typo común). Crea el directorio si no existe.

▸ Una config mínima — DeepSeek para todo

{
  "LOG": false,
  "API_TIMEOUT_MS": 600000,
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/v1/chat/completions",
      "api_key": "sk-...your-deepseek-key...",
      "models": ["deepseek-chat", "deepseek-reasoner"],
      "transformer": { "use": ["deepseek"] }
    }
  ],
  "Router": {
    "default":     "deepseek,deepseek-chat",
    "background":  "deepseek,deepseek-chat",
    "think":       "deepseek,deepseek-reasoner",
    "longContext": "deepseek,deepseek-chat",
    "webSearch":   "deepseek,deepseek-chat"
  }
}

▸ Levantar — tres caminos

• ccr code — arranca el router Y lanza Claude Code de una. El camino más simple.
• ccr start y después claude — corre el proxy como proceso separado, usa el binario claude normal. Útil cuando varias instancias de CC comparten un router.
• eval "$(ccr activate)" — exporta ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, NO_PROXY en tu shell. Después de esto, cualquier invocación de claude en ese shell usa el router hasta que salgas.

▸ Verificá que funciona

# en otra terminal, con CCR corriendo
curl -s http://127.0.0.1:3456/health
# → {"ok":true}

# en tu sesión de CC
/cost
# → mirá el campo "model"; si dice "deepseek-chat" en vez de
#   un nombre de modelo Anthropic, estás enrutado.

▸ Otros comandos CLI útiles

• ccr ui — editor web de config en http://127.0.0.1:3456/ui. Más fácil que editar JSON a mano.
• ccr model — picker interactivo de modelo para la sesión actual (overridea el Router.default).
• ccr stop — mata el proxy.

TL;DR — CCRouter clasifica cada request entrante en una de seis rutas y mapea la ruta a un par provider+modelo. default es el fallback; las otras cinco disparan en features observables del request.

▸ Las seis rutas — cuándo dispara cada una

▸ Un bloque Router multi-provider

"Router": {
  "default":     "anthropic,claude-sonnet-4-6",
  "background":  "deepseek,deepseek-chat",
  "think":       "deepseek,deepseek-reasoner",
  "longContext": "gemini,gemini-2.5-pro",
  "longContextThreshold": 60000,
  "webSearch":   "openrouter,perplexity/sonar-pro",
  "image":       "anthropic,claude-sonnet-4-6"
}

Lee como cascada: cualquier cosa pesada/razonamiento se queda en modelos premium; rutina y trabajo en masa va al camino barato; long-context va al modelo con la ventana más grande.

▸ El campo longContextThreshold

Un campo numérico en el objeto Router — el conteo de tokens sobre el cual la ruta longContext dispara. Default 60000. Bajalo (40000) si querés sesgar hacia el modelo long-context antes, subilo si las llamadas a Gemini se están comiendo tu budget en requests de tamaño de frontera.

▸ Config de provider — anatomía

{
  "name": "gemini",                                       // unique slug
  "api_base_url": "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions",
  "api_key": "AIza...your-key...",
  "models": ["gemini-2.5-pro", "gemini-2.5-flash"],       // models you'll route to
  "transformer": { "use": ["gemini"] }                    // request/response adapter
}

El campo name es lo que referenciás en el bloque Router (ej: "longContext": "gemini,gemini-2.5-pro" — la coma separa el nombre del provider del nombre del modelo).

▸ Once transformers built-in

deepseek, gemini, openrouter, groq, maxtoken (limita tokens de output), tooluse (reescribe tool calls), reasoning (maneja reasoning_content), sampling (altera temperature/top_p), enhancetool, cleancache, vertex-gemini. Aplicá a nivel provider vía transformer.use, o escopá a modelos específicos vía transformer.<model-name>.use.