Como usar Claude Code sem depender do LLM da Anthropic

O Claude Code é uma ferramenta de linha de comando da Anthropic que permite delegar tarefas de programação diretamente ao Claude — escrever, revisar, refatorar e depurar código sem sair do terminal. Por padrão, ele usa a API da Anthropic para funcionar. Mas existe uma forma de configurá-lo para funcionar através de um intermediário chamado OpenRouter, o que traz vantagens concretas em disponibilidade, custo e controle.

O que é a OpenRouter?

A OpenRouter é uma plataforma que funciona como uma camada intermediária entre você e vários provedores de modelos de linguagem — Anthropic, OpenAI, Google, Meta, entre outros. Em vez de acessar a API de cada provedor separadamente, você acessa um único endpoint da OpenRouter, e ela cuida de rotear sua requisição para o modelo e provedor corretos.

No caso do Claude Code, a OpenRouter consegue imitar exatamente a interface da API da Anthropic. Isso significa que você pode redirecionar o Claude Code para a OpenRouter sem modificar o software em si — apenas algumas variáveis de ambiente são suficientes.

Por que querer fugir do LLM da Anthropic?

Embora o Claude Code seja otimizado para os modelos da Anthropic, há situações em que mais flexibilidade faz diferença:

• Alta disponibilidade: a API da Anthropic pode ter instabilidades pontuais. A OpenRouter faz fail-over automático entre provedores (incluindo Bedrock da AWS e Vertex do Google), garantindo que sua sessão continue mesmo quando um endpoint específico está fora.
• Controle de orçamento: a OpenRouter permite definir limites de gasto, monitorar consumo por equipe e distribuir créditos — funcionalidades que a API direta da Anthropic não oferece nativamente.
• Métricas detalhadas: você consegue ver token usage, custo por modelo e latência em tempo real através do dashboard da OpenRouter.
• Experimentação com modelos: a OpenRouter dá acesso a modelos de outros provedores, permitindo comparar resultados sem trocar de ferramenta.

Passo a passo: configurando o Claude Code com OpenRouter

1. Instale o Claude Code — basta rodar no terminal:

   curl -fsSL https://claude.ai/install.sh | bash

   No Windows, existe um script equivalente para PowerShell.

2. Crie uma conta na OpenRouter em openrouter.ai e gere uma API key no painel.
3. Configure as variáveis de ambiente para redirecionar o Claude Code:

   export OPENROUTER_API_KEY="<sua-api-key>"
   export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
   export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
   export ANTHROPIC_API_KEY=""   # essencial: deve ficar vazio

   Adicione essas linhas ao seu ~/.zshrc ou ~/.bashrc para que sejam aplicadas automaticamente em toda sessão nova.

4. Reinicie o terminal (ou execute source ~/.zshrc) para aplicar as variáveis.
5. Inicie o Claude Code no diretório do seu projeto:

   cd /caminho/do/projeto && claude

6. Verifique a conexão com o comando interno /status. Você deve ver:

   Auth token: ANTHROPIC_AUTH_TOKEN
   Anthropic base URL: https://openrouter.ai/api

   Se aparecer essa saída, está funcionando corretamente.

O que acontece nos bastidores?

Ao apontar ANTHROPIC_BASE_URL para https://openrouter.ai/api, o Claude Code conversa com a OpenRouter usando exatamente a mesma estrutura de chamadas da API da Anthropic. A OpenRouter, por sua vez, roteia sua requisição para um dos provedores disponíveis — Anthropic diretamente, AWS Bedrock, Google Vertex, ou outros — aplicando fail-over automático se algum estiver indisponível ou com limitação de taxa.

Do ponto de vista do Claude Code, nada muda: ele continua enviando e recebendo mensagens no formato que conhece. A diferença está em quem processa a requisição e como o tráfego é gerenciado.

Escolhendo modelos específicos

Você pode definir explicitamente qual modelo usar para cada tipo de tarefa:

export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4-5"

O Claude Code usa modelos diferentes dependendo da complexidade da tarefa — Haiku para operações simples, Sonnet para tarefas intermediárias e Opus para raciocínio mais complexo. Ao definir essas variáveis, você controla exatamente qual versão é usada em cada caso.

Para acelerar respostas com o “Fast Mode”, habilite com:

export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1

Dicas de troubleshooting

Erro de autenticação ao iniciar: a causa mais comum é ANTHROPIC_API_KEY não estar vazio. Ele deve ser explicitamente definido como string vazia (""), não apenas não declarado.

Limite de contexto atingido: sessões longas com muito código podem atingir o limite de tokens do modelo. Divida a tarefa em partes menores ou reinicie a sessão com /clear.

Respostas mais lentas do que o esperado: o roteamento adicional da OpenRouter pode introduzir alguns milissegundos a mais de latência. Em uso normal isso é imperceptível, mas em sessões muito intensas pode ser notado.

Preocupações com privacidade: a OpenRouter não armazena o conteúdo dos seus prompts por padrão. O logging de prompts é uma opção que precisa ser habilitada explicitamente no painel — não acontece automaticamente.

Perguntas frequentes

Preciso pagar tanto para a Anthropic quanto para a OpenRouter?
Não. Quando você usa a OpenRouter como intermediário, paga apenas para a OpenRouter. Ela cobra pelo uso dos modelos e repassa o custo para o provedor. Você não precisa ter uma conta ativa na API da Anthropic.

O custo é maior do que acessar a API da Anthropic diretamente?
A OpenRouter cobra uma margem pequena sobre o preço base do modelo. Em geral a diferença é mínima, e as funcionalidades de controle de orçamento e fail-over justificam o custo adicional para uso profissional ou em equipe.

Posso usar modelos de outros provedores (como GPT-4 ou Gemini) com o Claude Code?
Tecnicamente sim, mas com limitações. O Claude Code foi projetado para os modelos Claude e assume comportamentos específicos deles. Usar modelos de outros provedores pode funcionar para tarefas simples, mas pode gerar inconsistências em fluxos mais complexos.

Isso funciona com o plano gratuito do Claude Code?
Não — para usar variáveis de ambiente e apontar para a OpenRouter, você precisa estar usando o Claude Code via API, não pelo plano de assinatura padrão. A configuração descrita aqui é para acesso via API key.

Conclusão

Com apenas algumas linhas de configuração, o Claude Code passa a ser mais resiliente, controlado e monitorado. A OpenRouter funciona como um intermediário transparente que adiciona disponibilidade, visibilidade e flexibilidade sem exigir mudanças no fluxo de trabalho.

Se você usa o Claude Code com frequência ou em contexto profissional, vale a pena experimentar essa configuração — especialmente pelo controle de orçamento e pelo fail-over automático que evita interrupções inesperadas.