⚠️ Por que Configurar TODOS os Slots
Claude Code foi projetado para trabalhar com múltiplos modelos simultaneamente. O modelo principal responde suas perguntas, mas modelos em background fazem tarefas internas que você não vê diretamente.
🚨 Alerta Crítico
Se você não configurar todos os slots de modelo, pode ser cobrado sem perceber. Claude Code usa Haiku para tarefas internas — se ANTHROPIC_DEFAULT_HAIKU_MODEL não estiver configurado, ele tentará usar o Haiku real da Anthropic diretamente, gerando cobranças.
✗ Configuração Incompleta
- ✗Configura apenas ANTHROPIC_MODEL
- ✗Esquece HAIKU, SONNET, OPUS separados
- ✗Haiku de background usa modelo pago
- ✗Cobranças aparecem no dashboard
✓ Configuração Completa
- ✓Todos os 8 slots configurados com :free
- ✓Haiku, Sonnet, Opus → mesmo modelo :free
- ✓Background tasks usam modelo gratuito
- ✓Custo total = $0 no dashboard
📋 Variáveis Obrigatórias
São 8 variáveis necessárias para garantir que todos os caminhos do Claude Code usem modelos gratuitos:
Variáveis e suas funções
| Variável | Função |
|---|---|
| ANTHROPIC_BASE_URL | Redireciona chamadas para o OpenRouter |
| ANTHROPIC_AUTH_TOKEN | Sua API key do OpenRouter (sk-or-...) |
| ANTHROPIC_API_KEY | Deixar vazio — evita conflito com Anthropic |
| ANTHROPIC_MODEL | Modelo principal para respostas |
| ANTHROPIC_DEFAULT_SONNET_MODEL | Slot "Sonnet" para tarefas médias |
| ANTHROPIC_DEFAULT_OPUS_MODEL | Slot "Opus" para tarefas complexas |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | Slot "Haiku" para tarefas rápidas/background |
| ANTHROPIC_SMALL_FAST_MODEL | Modelo leve para operações rápidas |
| CLAUDE_CODE_SUBAGENT_MODEL | Modelo para subagentes e tarefas paralelas |
🐧 Configuração Linux/Mac
No Linux e Mac, use o comando export para definir variáveis de ambiente. Para uso temporário (sessão atual), execute no terminal. Para uso permanente, adicione ao arquivo de perfil do seu shell.
🐧 Script Completo Linux/Mac
Cole este bloco no terminal ou adicione ao ~/.bashrc / ~/.zshrc:
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="sk-or-sua-chave-aqui"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="qwen/qwen3-coder:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen/qwen3-coder:free"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen/qwen3-coder:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen/qwen3-coder:free"
export ANTHROPIC_SMALL_FAST_MODEL="qwen/qwen3-coder:free"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen/qwen3-coder:free"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude💡 Para Configuração Permanente
Adicione os exports ao arquivo de perfil do seu shell e recarregue:
# Adicionar ao arquivo de perfil
nano ~/.bashrc # para bash
nano ~/.zshrc # para zsh
# Recarregar sem reiniciar terminal
source ~/.bashrc
source ~/.zshrc🪟 Configuração Windows
No Windows, use setx no PowerShell para definir variáveis permanentes. Após executar setx, você precisa abrir um novo terminal para que as variáveis entrem em vigor.
🪟 Script Completo Windows PowerShell
setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
setx ANTHROPIC_AUTH_TOKEN "sk-or-sua-chave-aqui"
setx ANTHROPIC_API_KEY ""
setx ANTHROPIC_MODEL "qwen/qwen3-coder:free"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "qwen/qwen3-coder:free"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "qwen/qwen3-coder:free"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "qwen/qwen3-coder:free"
setx ANTHROPIC_SMALL_FAST_MODEL "qwen/qwen3-coder:free"
setx CLAUDE_CODE_SUBAGENT_MODEL "qwen/qwen3-coder:free"⚠️ Atenção Windows
Após executar os comandos setx, feche e reabra o PowerShell. As variáveis só ficam disponíveis em novos terminais. Alternativamente, use System Properties → Advanced → Environment Variables para configurar pela interface gráfica.
💾 settings.json — Método Recomendado
O arquivo ~/.claude/settings.json é o método mais robusto para configurar o Claude Code. Funciona em todos os sistemas operacionais, não interfere com variáveis do shell do sistema, e é fácil de manter.
💾 ~/.claude/settings.json Completo
Crie ou edite o arquivo em ~/.claude/settings.json com este conteúdo:
{
"env": {
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_AUTH_TOKEN": "sk-or-sua-chave-aqui",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_MODEL": "qwen/qwen3-coder:free",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen/qwen3-coder:free",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen/qwen3-coder:free",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen/qwen3-coder:free",
"ANTHROPIC_SMALL_FAST_MODEL": "qwen/qwen3-coder:free",
"CLAUDE_CODE_SUBAGENT_MODEL": "qwen/qwen3-coder:free",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}💡 Vantagens do settings.json
- ✓Funciona em Linux, Mac e Windows sem adaptação
- ✓Não interfere com outras ferramentas do sistema
- ✓Fácil de versionar e compartilhar (sem a chave de API)
- ✓Não requer restart de terminal após mudanças
🔍 Verificando no Dashboard
Após configurar, faça um teste com o Claude Code e depois acesse o dashboard do OpenRouter para confirmar que todas as chamadas foram feitas ao modelo :free com custo $0.
Faça uma pergunta simples
Abra o Claude Code e faça uma pergunta de teste: claude "olá, qual modelo você é?"
Acesse o dashboard de atividade
Vá para openrouter.ai/activity e verifique as últimas chamadas.
Confirme custo $0
Todas as chamadas devem mostrar o modelo com sufixo :free e custo $0.00. Se aparecer outro modelo ou custo >$0, há alguma variável não configurada.
✅ Configuração Confirmada
Dashboard mostrando qwen/qwen3-coder:free com custo $0 em todas as linhas? Configuração perfeita. Você pode usar o Claude Code sem preocupações com cobranças.
✅ Resumo do Módulo 4.2
Próximo Módulo:
4.3 — 🏆 Melhores Modelos Gratuitos — benchmarks e guia de quando usar cada modelo