ROTEIE A CAMADA DE MODELO

TL;DR — npm install -g @musistudio/claude-code-router, escreve um ~/.claude-code-router/config.json mínimo, sobe com ccr code ao invés de claude. Cinco minutos do zero ao primeiro turn roteado.

▸ Instalar

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

# verifica
ccr --version

▸ Localização da config

A config fica em ~/.claude-code-router/config.json (atenção: não em ~/.config/ — erro comum). Cria o diretório se ele não existir.

▸ Uma config mínima — DeepSeek pra tudo

{
  "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"
  }
}

▸ Subir — três caminhos

• ccr code — sobe o router E lança o Claude Code num único comando. O caminho mais simples.
• ccr start e depois claude — roda o proxy como processo separado, usa o binário claude normal. Útil quando várias instâncias de CC compartilham o mesmo router.
• eval "$(ccr activate)" — exporta ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, NO_PROXY no seu shell. Depois disso, qualquer claude rodado nesse shell usa o router até você sair.

▸ Verifica se tá funcionando

# em outro terminal, com o CCR rodando
curl -s http://127.0.0.1:3456/health
# → {"ok":true}

# na sua sessão do CC
/cost
# → olha o campo "model"; se aparecer "deepseek-chat" ao invés de
#   um nome de modelo Anthropic, você tá roteado.

▸ Outros comandos CLI úteis

• ccr ui — editor web de config em http://127.0.0.1:3456/ui. Mais fácil que editar JSON na mão.
• ccr model — picker interativo de modelo pra sessão atual (sobrescreve o Router.default).
• ccr stop — mata o proxy.

TL;DR — o CCRouter classifica cada request entrando numa das seis rotas e mapeia a rota pra um par provider+modelo. default é o fallback; as outras cinco disparam em features observáveis do request.

▸ As seis rotas — quando cada uma dispara

▸ Um bloco 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"
}

Lê como cascata: o que for pesado/raciocínio fica nos modelos premium; rotina e trabalho em massa vai pro caminho barato; long-context vai pro modelo com a maior janela.

▸ O campo longContextThreshold

Um campo numérico no objeto Router — a contagem de tokens acima da qual a rota longContext dispara. Default 60000. Abaixa pra (40000) se quiser viesar pro modelo long-context mais cedo, sobe se chamadas pra Gemini estão comendo seu budget em requests de tamanho de fronteira.

▸ Config de provider — anatomia

{
  "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
}

O campo name é o que você referencia no bloco Router (ex.: "longContext": "gemini,gemini-2.5-pro" — a vírgula separa nome do provider e nome do modelo).

▸ Onze transformers built-in

deepseek, gemini, openrouter, groq, maxtoken (limita tokens de output), tooluse (reescreve tool calls), reasoning (trata reasoning_content), sampling (altera temperature/top_p), enhancetool, cleancache, vertex-gemini. Aplica no nível do provider via transformer.use, ou escopa a modelos específicos via transformer.<model-name>.use.