Como usar Claude Code sem depender do LLM da Anthropic

Por que querer fugir do LLM da Anthropic?

Embora o Claude Code seja otimizado para os modelos da Anthropic, há situações em que você pode precisar de mais flexibilidade: evitar interrupções, controlar melhor o orçamento ou obter métricas detalhadas de uso. A OpenRouter oferece uma camada de roteamento que resolve tudo isso, permitindo que o Claude Code continue funcionando mesmo quando a API da Anthropic está indisponível.

Passo a passo rápido

  1. Instale o Claude Code – basta rodar curl -fsSL https://claude.ai/install.sh | bash (ou o script para PowerShell no Windows).
  2. Configure as variáveis de ambiente para apontar para a OpenRouter:
    export OPENROUTER_API_KEY="<seu‑api‑key>"
    export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
    export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
    export ANTHROPIC_API_KEY=""   # essencial: vazio

    Adicione essas linhas ao seu ~/.bashrc, ~/.zshrc ou ao arquivo de perfil da sua shell.

  3. Reinicie o terminal (ou execute source ~/.bashrc) para que as variáveis entrem em vigor.
  4. Inicie uma sessão no diretório do seu projeto: cd /caminho/do/projeto && claude.
  5. Verifique a conexão usando o comando interno /status. Você deverá ver algo como:
    Auth token: ANTHROPIC_AUTH_TOKEN
    Anthropic base URL: https://openrouter.ai/api

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 interface da API da Anthropic. A OpenRouter então roteia sua requisição para um dos provedores Anthropic disponíveis (primeiro‑party, Bedrock, Vertex etc.), aplicando fail‑over automático caso algum esteja fora ou limitado.

Benefícios principais

  • Alta disponibilidade: se um endpoint Anthropic falhar, a OpenRouter redireciona para outro sem interrupções.
  • Controle de orçamento: defina limites de gasto e distribua créditos entre equipes diretamente no dashboard da OpenRouter.
  • Visibilidade e métricas: acompanhe token usage, custos por modelo e tempo real de processamento.

Modelos e “Fast Mode”

Você pode escolher explicitamente qual modelo usar para cada tipo de tarefa via variáveis de ambiente:

export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-opus-4.7"

Para acelerar respostas, o Claude Code tem o comando /fast. Basta habilitar o modo rápido na OpenRouter com:

export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1

O custo será multiplicado conforme a tarifação da Anthropic para “fast mode”.

Dicas de troubleshooting

  • Erro de autenticação: certifique‑se de que ANTHROPIC_API_KEY está **vazio** (“”), não apenas não definido.
  • Limite de contexto: divida tarefas grandes ou reinicie a sessão.
  • Privacidade: a OpenRouter não grava seu código a menos que você habilite explicitamente o logging de prompts.

Pronto para começar?

Com apenas algumas linhas de configuração, seu Claude Code ficará resiliente, econômico e monitorado. Experimente agora e dê um salto de produtividade sem depender exclusivamente dos servidores da Anthropic!

Posts Similares

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *