Guia do Claude Code Router 2026: Direcione Solicitações para Qualquer Modelo de IA

Claude Code Router é um proxy de código aberto que roteia Claude Code para qualquer LLM (DeepSeek, Gemini, Ollama, OpenRouter). Guia de configuração mais créditos grátis.

Claude CodeClaude Code RouterLLM GatewayMulti-ModelAI Perks
Author Avatar
Andrew
AI Perks Team
12,377

Quick Answer

Claude Code Router é um proxy local de código aberto que intercepta requisições do Claude Code e as direciona para qualquer provedor de LLM (Anthropic, OpenRouter, DeepSeek, Ollama, Gemini e mais de 8 outros). Instale via npm e configure regras de roteamento por tipo de tarefa. Combine com créditos gratuitos da Anthropic e OpenAI no valor de US$ 1.500 a mais de US$ 75.000 via getaiperks.com.

AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

AI Perks Cards

O que é o Claude Code Router?

Claude Code Router é um gateway proxy de código aberto que se situa entre o Claude Code e qualquer fornecedor de LLM. Ele se vincula a uma porta local (geralmente 127.0.0.1:3456) e permite rotear diferentes tipos de solicitações do Claude Code para diferentes modelos - Claude para algumas tarefas, DeepSeek ou Gemini para outras, Ollama local para operações baratas.

O resultado: custos de API mais baixos, sem dependência de um único fornecedor e roteamento inteligente por tipo de tarefa. E quando você combina o Claude Code Router com créditos gratuitos da Anthropic e OpenAI no valor de US$ 1.500 a US$ 75.000+ do AI Perks, você obtém o melhor de cada fornecedor sem custo.


Economize seu orçamento em créditos de IA

Pesquisar ofertas para
OpenAI
OpenAI,
Anthropic
Anthropic,
Lovable
Lovable,
Notion
Notion

Promova seu SaaS

Alcance mais de 90.000 fundadores globalmente que procuram ferramentas como a sua

Inscrever-se agora

Por que Usar o Claude Code Router

O Claude Code, por padrão, envia todas as solicitações para a API Claude da Anthropic. Isso é bom se você tiver um orçamento ilimitado para Claude - mas em 2026, três razões tornam um roteador multi-modelo atraente:

RazãoSem RoteadorCom Roteador
Otimização de custoTodas as tarefas em Sonnet 4.6 ($3/$15)Tarefas baratas → DeepSeek ($0.14/$0.28)
Evitar limites de taxaAtingir limites da Anthropic → bloqueadoFailover automático para outros fornecedores
Pontos fortes específicos do fornecedorApenas ClaudeUsar Gemini para visão, GPT para código, etc.
Privacidade/execução localApenas na nuvemRoteie tarefas sensíveis para Ollama local

Para desenvolvedores que executam cargas de trabalho pesadas do Claude Code, o Claude Code Router pode reduzir os custos de API em 50-99%, dependendo da estratégia de roteamento.


AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

AI Perks Cards

Fornecedores Suportados no Claude Code Router

FornecedorPontos FortesNível de Preço
Anthropic (padrão)Melhor qualidade de codificaçãoPremium
OpenRouterMais de 200 modelos, uma única APIVariável
DeepSeekRaciocínio barato (R1, V3)Ultra-barato
GeminiLongo contexto, visãoNível gratuito + pago barato
OllamaLocal, privado, gratuito$0 (seu hardware)
OpenAI (GPT-5, GPT-4.1)Forte capacidade geralPremium
VolcEngine / SiliconFlowProvedores chineses rápidosBarato
DashScope (Alibaba Qwen)Fortes modelos abertosBarato
ModelScopeHospedagem de modelos de código abertoVariável

O roteamento multi-fornecedor é o recurso matador. Uma única sessão do Claude Code pode usar 3-5 fornecedores diferentes de forma transparente com base em regras de roteamento.


Como Instalar o Claude Code Router

Pré-requisitos

  • Claude Code instalado (npm install -g @anthropic-ai/claude-code@latest)
  • Node.js 18 ou posterior
  • Chaves de API para pelo menos um fornecedor não-Anthropic (ou Ollama rodando localmente)

Instalar via npm

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

Ou via GitHub

git clone https://github.com/musistudio/claude-code-router
cd claude-code-router
npm install
npm run build

Configurando o Claude Code Router

O roteador usa um arquivo de configuração JSON em ~/.claude-code-router/config.json:

{
  "Providers": [
    {
      "name": "anthropic",
      "api_key": "sk-ant-...",
      "api_base": "https://api.anthropic.com"
    },
    {
      "name": "deepseek",
      "api_key": "sk-deepseek-...",
      "api_base": "https://api.deepseek.com"
    },
    {
      "name": "openrouter",
      "api_key": "sk-or-...",
      "api_base": "https://openrouter.ai/api/v1"
    }
  ],
  "Router": {
    "default": "anthropic,claude-sonnet-4-6",
    "background": "deepseek,deepseek-chat",
    "reasoning": "deepseek,deepseek-r1",
    "longContext": "gemini,gemini-2.5-pro"
  }
}

O que Cada Categoria de Roteamento Faz

CategoriaQuando UsadoModelo Recomendado
defaultPrompts padrãoClaude Sonnet 4.6 (qualidade)
backgroundTarefas automáticas, resumosDeepSeek Chat (barato)
reasoningResolução de problemas complexosDeepSeek R1 ou Claude Opus
longContextGrandes bases de códigoGemini 2.5 Pro (contexto de 1M)

Você pode adicionar regras de roteamento personalizadas com base na contagem de tokens, tipo de tarefa ou qualquer lógica que você escrever em JavaScript.


Iniciando o Claude Code Router

Execute o serviço do roteador:

ccr start

Em seguida, configure o Claude Code para usar o roteador:

export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
claude

Agora, cada solicitação do Claude Code flui através do roteador e é roteada para o provedor apropriado de acordo com sua configuração.


Economia de Custo com o Claude Code Router

Uma estratégia de roteamento do mundo real pode dividir o tráfego da seguinte forma:

Tipo de Tarefa% do TráfegoFornecedorCusto por 1 Milhão de Tokens
Codificação padrão40%Claude Sonnet 4.6$3 / $15
Tarefas em segundo plano30%DeepSeek Chat$0.14 / $0.28
Leituras de longo contexto20%Gemini 2.5 Pro$1.25 / $5
Privacidade local10%Ollama (local)$0

Comparativo de Custo Mensal (Usuário Pesado, 100 Milhões de Tokens/Mês)

ConfiguraçãoCusto Mensalvs Apenas Anthropic
Todo Claude Sonnet 4.6$1.500 - $1.800Linha de base
Roteamento Inteligente (acima)$300 - $500Economia de 70-80%
Roteador + Créditos Gratuitos$0 - $50Economia de 97-100%

Combinado com créditos gratuitos via AI Perks, o roteador pode reduzir seus custos reais para perto de zero.


Exemplos de Regras de Roteamento

Roteamento por Contagem de Tokens

"Router": {
  "default": "anthropic,claude-sonnet-4-6",
  "longContext": "gemini,gemini-2.5-pro",
  "tokenThreshold": 50000
}

Quando uma solicitação excede 50.000 tokens de entrada, ela é roteada para a janela de contexto de um milhão de tokens do Gemini em vez do Claude.

Roteamento por Tipo de Tarefa

"Router": {
  "default": "anthropic,claude-sonnet-4-6",
  "background": "deepseek,deepseek-chat",
  "vision": "gemini,gemini-2.5-pro"
}

Tarefas em segundo plano vão para o DeepSeek barato, tarefas de visão vão para o Gemini, tarefas normais permanecem no Claude.

Roteamento de Código Sensível para Ollama Local

"Router": {
  "default": "anthropic,claude-sonnet-4-6",
  "private": "ollama,llama-3.3-70b"
}

Marque prompts sensíveis com metadados para roteá-los para o Ollama local, evitando qualquer transmissão na nuvem.


Por que Claude Code Router + Créditos Gratuitos é a Configuração Definitiva

O roteador por si só reduz custos. Combine-o com créditos gratuitos e o custo cai para zero, preservando a qualidade do Claude onde ele importa.

Programas de Crédito Gratuito que Potencializam o Roteador

Fonte de CréditoCréditos DisponíveisUsado Para
Anthropic Claude (Direto)$1.000 - $25.000Rotas padrão + de raciocínio
OpenAI (GPT-5, GPT-4.1)$500 - $50.000Rotas alternativas de codificação
Google Cloud Vertex (Gemini)$1.000 - $25.000Rotas de longo contexto
AWS Activate (Bedrock - Claude)$1.000 - $100.000Acesso de backup ao Claude
Microsoft Founders Hub$500 - $1.000Acesso ao Azure OpenAI

Total potencial: US$ 4.000 a mais de US$ 201.000 em créditos gratuitos em todos os fornecedores

AI Perks cobre todos os programas, para que seu Claude Code Router possa puxar de várias fontes de crédito gratuitas.


Passo a Passo: Configurar Roteador + Créditos Gratuitos

Passo 1: Obter Créditos Gratuitos em Vários Fornecedores

Assine o AI Perks e inscreva-se nos programas de crédito Anthropic, OpenAI e Google Cloud de maior valor.

Passo 2: Instalar o Claude Code Router

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

Passo 3: Configurar Roteamento Multi-Fornecedor

Edite ~/.claude-code-router/config.json com as chaves de API de cada fornecedor (todas alimentadas por créditos gratuitos).

Passo 4: Iniciar o Roteador

ccr start

Passo 5: Apontar o Claude Code para o Roteador

export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
claude

Passo 6: Monitorar e Otimizar

Observe quais rotas consomem mais créditos. Ajuste as regras de roteamento para maximizar o uso de créditos gratuitos e minimizar os gastos pagos.


Perguntas Frequentes

O Claude Code Router é gratuito?

Sim, o Claude Code Router é de código aberto e gratuito para instalar. Você paga apenas pelos provedores de API subjacentes para os quais ele roteia. Com créditos gratuitos via AI Perks, toda a configuração pode rodar a $0 em custos de API por meses ou anos.

O Claude Code Router funciona com o Claude Code oficial da Anthropic?

Sim. O Claude Code Router intercepta as solicitações da CLI oficial do Claude Code, definindo ANTHROPIC_BASE_URL para o endereço local do roteador. O roteador então encaminha as solicitações para o provedor configurado para aquele tipo de tarefa.

Qual é a diferença entre Claude Code Router e LiteLLM?

O Claude Code Router é construído especificamente para o Claude Code com roteamento ciente de tarefas. O LiteLLM é um gateway LLM mais geral que funciona com qualquer cliente. Ambos podem servir a propósitos semelhantes; o Claude Code Router tem uma integração mais estreita com os padrões de solicitação específicos do Claude Code.

Posso usar o Claude Code Router para código sensível à privacidade?

Sim. Configure regras de roteamento para enviar prompts sensíveis para Ollama local ou modelos auto-hospedados. Prompts públicos/não sensíveis são roteados para provedores de nuvem. Isso oferece assistência de codificação com qualidade Claude sem expor código privado a APIs externas.

Quanto o Claude Code Router pode me economizar?

As economias típicas variam de 50-99% dos custos de API, dependendo da sua estratégia de roteamento. Roteamento de tarefas em segundo plano para DeepSeek (cerca de 50x mais barato que Claude Opus) é o maior redutor de custos. Combinado com créditos gratuitos via AI Perks, os custos reais podem cair para $0.

O Claude Code Router funciona com o OpenRouter?

Sim, o OpenRouter é um dos provedores suportados. O OpenRouter dá acesso a mais de 200 modelos através de uma única API, então adicioná-lo ao Claude Code Router efetivamente desbloqueia todos os modelos no OpenRouter (incluindo modelos gratuitos como variantes do Llama).

O Claude Code Router está pronto para produção?

É um projeto comunitário, não oficialmente suportado pela Anthropic. A qualidade é sólida para uso pessoal/em equipe, mas não testada em escala empresarial. Para produtos de IA de produção, considere gateways específicos como LiteLLM ou Portkey, juntamente com créditos gratuitos do AI Perks.


Reduza os Custos do Claude Code em 99% com o Roteador + Créditos Gratuitos

O Claude Code Router por si só economiza 50-99%. Combinado com créditos gratuitos da Anthropic, OpenAI e Google Cloud, seu custo efetivo do Claude Code cai para zero. AI Perks fornece:

  • $1.000-$25.000+ em créditos Anthropic gratuitos
  • $500-$50.000+ em créditos OpenAI gratuitos
  • $1.000-$25.000+ em créditos Google Cloud
  • Mais de 200 benefícios adicionais para startups

Inscreva-se em getaiperks.com →


Roteie de forma inteligente. Não pague nada. Obtenha créditos de IA gratuitos em getaiperks.com.

AI Perks

O AI Perks oferece acesso a descontos exclusivos, créditos e ofertas em ferramentas de IA, serviços em nuvem e APIs para ajudar startups e desenvolvedores a economizar.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.