O que é Claude Code Router?
O Claude Code Router (CCR) roda um gateway local com o qual os agentes de programação conversam em vez da API de um provedor. Por trás dele você configura provedores como OpenAI, Gemini, OpenRouter, DeepSeek, Moonshot, Z.AI e Mistral, além de regras de roteamento, novas tentativas, modelos de fallback e rotação de chaves.
Ele começou como uma forma de rodar o Claude Code em outros modelos e agora também atende Codex, OpenCode, Kimi CLI, Grok CLI, Kilo Code e outros. É distribuído como app de desktop em Electron, CLI no npm (Node.js 22 ou mais recente) ou Docker. O gateway escuta em 127.0.0.1:3456 e registra rota, latência, tokens e custo estimado de cada requisição.
É um projeto em grande parte de um único mantenedor, financiado por doações; a v3.1.3 saiu em 9 de outubro de 2026.
Claude Code Router vale a pena?
O CCR faz o que promete: um endpoint local para o qual qualquer um de dez agentes pode apontar, com provedor, modelo e cadeia de fallback escolhidos por trás. Com cerca de 37,800 estrelas no GitHub, é o roteador auto-hospedado mais adotado para o Claude Code, e a v3.1.3, de 9 de outubro de 2026, adicionou um catálogo de modelos que se atualiza a cada hora a partir da CDN do projeto.
O argumento financeiro é real. A Anthropic lista o Claude Sonnet 5.5 a $2 por milhão de tokens de entrada e $10 por milhão de saída; a DeepSeek lista o V4.1 Flash a $0.15 e $0.60 fora do horário de pico. Uma sessão longa de agente que lê 2 milhões de tokens e escreve 100,000 custa cerca de $5 no Sonnet e menos de $0.40 no Flash, antes de cache. Encaminhar só as chamadas de segundo plano e de resumo para o modelo barato preserva a maior parte dessa economia.
O porém é qualidade e suporte. Os prompts e o formato de edição do Claude Code são ajustados para o Claude, e guias da comunidade relatam mais edições falhas com DeepSeek, Qwen ou GLM. A documentação de gateways da Anthropic diz claramente que ela não dá suporte a encaminhar o Claude Code para modelos que não sejam Claude por qualquer gateway, e que um gateway que não repassa novos recursos de requisição os quebra, então cada versão do Claude Code é uma chance de algo parar de funcionar.
A segurança merece mais atenção do que uma ferramenta local costuma receber. O CCR guarda todas as chaves de provedores, pode importar estado de login do navegador, e seu guia de Docker observa que o mapeamento padrão da porta 3458 escuta em todas as interfaces. Um alerta de agosto de 2025 mostrou uma falha de CORS que podia vazar chaves para outros sites, corrigida na v1.0.34. Com 1,159 issues e pull requests abertos para um mantenedor principal, é uma ferramenta para o laptop de uma pessoa mais do que para implantação em uma empresa, onde o LiteLLM ou o próprio gateway da Anthropic oferecem logs de auditoria e credenciais por usuário.
Onde ele se destaca
Um desenvolvedor freelancer que paga do próprio bolso o uso de API do Claude Code
Reduzir a conta de tokens em sessões longas de refatoração
Encaminhar as requisições de segundo plano e de contexto longo para o DeepSeek V4.1 Flash, a $0.15 por milhão de tokens de entrada fora do pico, e manter o modelo principal no Claude. A economia pode passar de 90% nas chamadas encaminhadas, ao custo de mais edições falhas quando o modelo barato cuida de mudanças reais.
Uma engenheira de uma fornecedora da área de defesa com uma estação air-gapped
Usar a interface do Claude Code com um modelo local para que nenhum código saia da máquina
Apontar um provedor personalizado para um servidor local compatível com OpenAI, como Ollama ou vLLM, e aplicar o perfil do Claude Code. Nada é cobrado, mas é de esperar que a atualização horária do catálogo de modelos a partir de models.ccrdesk.top falhe offline, e a qualidade das edições depende inteiramente do modelo local.
Um tech lead testando vários agentes com cinco desenvolvedores
Comparar Codex, OpenCode e Claude Code nos mesmos provedores sem reconfigurar cada máquina
Uma instância do CCR guarda as chaves e emite para cada desenvolvedor uma chave de cliente do CCR com limites de tokens; os logs mostram o custo por requisição. Serve para um teste, mas não há SSO nem trilha de auditoria central, que uma implantação na empresa inteira exigiria.
Antes de decidir
- Configuração
- Baixe o app de desktop para macOS, Windows ou Linux, ou npm install -g @musistudio/claude-code-router (Node.js 22+) e rode ccr ui. Adicione um provedor e uma chave, inicie o servidor em 127.0.0.1:3456 e aplique um perfil de agente; minutos até a primeira requisição encaminhada.
- Integrações
- Agentes: Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi, ZCode e WorkBuddy. Protocolos: OpenAI Chat e Responses, Anthropic Messages, Gemini, além de presets para OpenRouter, DeepSeek, SiliconFlow, Moonshot, Mistral, Z.AI e Bailian. Acrescenta busca na web, ferramentas MCP e visão a modelos que não as têm.
- Dados e privacidade
- Os prompts vão para o provedor que você escolher, sob os termos de retenção dele. O CCR guarda chaves de provedores, chaves de cliente e logs de requisições em arquivos SQLite locais, e baixa seu catálogo de modelos de models.ccrdesk.top na inicialização e a cada hora. Um alerta publicado: uma configuração de CORS incorreta que podia expor chaves, corrigida na v1.0.34.
- Custo em escala
- Gratuito sob MIT; você paga os provedores diretamente. O Claude Sonnet 5.5 custa $2/$10 por milhão de tokens de entrada/saída contra $0.15/$0.60 do DeepSeek V4.1 Flash fora do pico, então a economia depende de quantas requisições você ousa tirar do Claude.
- Limites
- Sem suporte da Anthropic, e atualizações do Claude Code podem quebrar o repasse até o CCR se ajustar. 1,159 issues e pull requests abertos, muitos sobre parâmetros de provedores específicos. Empilhar o CCR atrás de outro proxy torna as falhas difíceis de rastrear.
O que é bom
- Dez agentes e uma dúzia de protocolos de provedores atrás de um endpoint
- Fallbacks, novas tentativas e pools de credenciais
- Logs de custo, tokens e latência por requisição
- Chaves de cliente com validade e limites de tokens
O que não é
- A Anthropic não dá suporte ao roteamento para modelos que não sejam Claude
- Modelos que não são Claude falham mais edições do Claude Code
- A porta padrão no Docker escuta em todas as interfaces
- 1,159 issues abertas para um projeto quase todo de um mantenedor
Ideal para
Desenvolvedores que querem rodar o Claude Code ou outros agentes em modelos mais baratos ou locais.
Alternativas ao Claude Code Router
Claude Code Router: perguntas frequentes
- Claude Code Router vale a pena?
- Uma central local competente para rodar agentes de programação em modelos mais baratos, desde que você aceite que a Anthropic não dará suporte ao resultado e que as edições serão piores. Damos nota 4.0 de 5.
- Quanto custa Claude Code Router?
- Gratuito e de código aberto (MIT). Você paga cada provedor de modelos para o qual encaminha.
- Quais são as desvantagens de Claude Code Router?
- A Anthropic não dá suporte ao roteamento para modelos que não sejam Claude; modelos que não são Claude falham mais edições do Claude Code; a porta padrão no Docker escuta em todas as interfaces; 1,159 issues abertas para um projeto quase todo de um mantenedor.
- Para quem Claude Code Router é indicado?
- Desenvolvedores que querem rodar o Claude Code ou outros agentes em modelos mais baratos ou locais.
- Quanto custa Claude Code Router para uma equipe ou em produção?
- Gratuito sob MIT; você paga os provedores diretamente. O Claude Sonnet 5.5 custa $2/$10 por milhão de tokens de entrada/saída contra $0.15/$0.60 do DeepSeek V4.1 Flash fora do pico, então a economia depende de quantas requisições você ousa tirar do Claude.
- Claude Code Router é seguro para dados da empresa?
- Os prompts vão para o provedor que você escolher, sob os termos de retenção dele. O CCR guarda chaves de provedores, chaves de cliente e logs de requisições em arquivos SQLite locais, e baixa seu catálogo de modelos de models.ccrdesk.top na inicialização e a cada hora. Um alerta publicado: uma configuração de CORS incorreta que podia expor chaves, corrigida na v1.0.34.
- Quais são as melhores alternativas ao Claude Code Router?
- As alternativas mais próximas que analisamos são ccusage, Codex plugin for Claude Code e rtk (Rust Token Killer).
Respostas verificadas em 26 de out. de 2026.