Repolode
Enviar
musistudio

musistudio/claude-code-router

Um gateway local de modelos que permite que Claude Code, Codex, OpenCode e outros agentes de programação compartilhem um endpoint e encaminhem solicitações a vários provedores de modelos.

Ver no GitHubSite
Estrelas
37,751
Forks
3,168
Issues abertas
1,150
Último commit
há 10 dias

O que é?

Claude Code Router (CCR) roda localmente e disponibiliza um endpoint estável ao qual agentes de programação como Claude Code, Codex, Grok CLI, Kimi CLI, OpenCode e Pi podem se conectar. Provedores, modelos, contas e regras de roteamento são gerenciados em um só lugar, evitando que cada agente precise de sua própria configuração de modelos.

As solicitações podem ser roteadas com base em condições nos headers e corpos, reescritas, repetidas ou enviadas a modelos de fallback em uma ordem definida. Pools de credenciais e rotação de chaves ajudam a manter o tráfego em funcionamento. O projeto oferece suporte a OpenAI Chat e Responses, Anthropic Messages, Gemini e muitos provedores compatíveis, como OpenRouter, DeepSeek e Mistral.

Há um app para desktop, uma CLI com interface de gerenciamento no navegador e uma opção de implantação com Docker. Os logs de solicitações mostram o provedor e o modelo resolvidos, o status, a latência, o uso de tokens e o custo estimado.

Recursos principais

  • 01Disponibiliza um endpoint local para vários agentes de programação e clientes de API.
  • 02Roteia solicitações com base em condições, prefixos e reescritas, com novas tentativas e fallbacks em uma ordem definida.
  • 03Gerencia provedores e contas com pools de credenciais e rotação de chaves.
  • 04Registra o provedor e o modelo resolvidos, a latência, os tokens e o custo estimado de cada solicitação.
  • 05Oferece um app para desktop, uma CLI do npm com interface web e implantação com Docker.

Casos de uso

  • Usar Claude Code ou Codex com um provedor de modelos que não seja Anthropic ou OpenAI.
  • Recorrer a modelos de backup quando um provedor limita a taxa de solicitações ou apresenta erros.
  • Compartilhar um conjunto de chaves de provedores entre vários agentes de programação na máquina de um desenvolvedor.
  • Acompanhar o uso de tokens e os custos em diferentes agentes de programação.

Início rápido

  1. 1

    Instale o npm CLI (requer Node.js 22 ou superior)

    npm install -g @musistudio/claude-code-router
  2. 2

    Inicie a interface de gerenciamento

    ccr ui
  3. 3

    Abra a interface, adicione um provider, inicie o Server e aplique um Agent Profile; o gateway é executado em http://127.0.0.1:3456

Antes de usar

  • Você precisa das suas próprias chaves de API ou contas de provider para encaminhar as solicitações.
  • A exposição remota do Docker exige uma configuração cuidadosa de segurança antes do uso.

Tópicos

#llm-gateway#claude-code#ai-agent#model-routing#llm-proxy#coding-assistant#openai-compatible

Perguntas frequentes

O que é claude-code-router?
Um gateway local de modelos que permite que Claude Code, Codex, OpenCode e outros agentes de programação compartilhem um endpoint e encaminhem solicitações a vários provedores de modelos. Claude Code Router (CCR) roda localmente e disponibiliza um endpoint estável ao qual agentes de programação como Claude Code, Codex, Grok CLI, Kimi CLI, OpenCode e Pi podem se conectar. Provedores, modelos, contas e regras de roteamento são gerenciados em um só lugar, evitando que cada agente precise de sua própria configuração de modelos.
claude-code-router é gratuito? Qual é a licença?
claude-code-router é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-code-router ainda é mantido?
Manutenção ativa. O último commit de claude-code-router foi em 10 de out. de 2026.
Para que posso usar claude-code-router?
Usar Claude Code ou Codex com um provedor de modelos que não seja Anthropic ou OpenAI. Recorrer a modelos de backup quando um provedor limita a taxa de solicitações ou apresenta erros. Compartilhar um conjunto de chaves de provedores entre vários agentes de programação na máquina de um desenvolvedor. Acompanhar o uso de tokens e os custos em diferentes agentes de programação.
Como instalar claude-code-router?
Instale o npm CLI (requer Node.js 22 ou superior): npm install -g @musistudio/claude-code-router Inicie a interface de gerenciamento: ccr ui Abra a interface, adicione um provider, inicie o Server e aplique um Agent Profile; o gateway é executado em http://127.0.0.1:3456
Onde consigo claude-code-router?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/musistudio/claude-code-router

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados