Como Usar o Claude Code Grátis: Guia com OmniRouter e Modelos Locais
⚡ Resumo Rápido: O que é este tutorial?
O novo agente de terminal da Anthropic, Claude Code (@anthropic-ai/claude-code), é o assistente de desenvolvimento mais avançado do mercado. Contudo, como ele varre pastas inteiras e roda loops de execução de terminal, uma manhã inteira de trabalho pode custar de R$ 100 a R$ 300 na API da Anthropic. Neste guia detalhado, mostro como conectar o Claude Code ao OmniRouter, rodar um proxy local com rotação de chaves gratuitas e programar sem limites e sem faturas surpresa.
O que é o Claude Code e por que ele consome tantos tokens?
O Claude Code não é um chatbot de página web como o ChatGPT. Ele é um agente de engenharia de software autônomo operando diretamente no seu terminal. Quando você envia um comando como:
"Conserte o erro de autenticação JWT, crie testes automatizados com Jest e verifique se todos os testes passam."
Ele executa autonomamente as seguintes tarefas:
- Explora arquivos e pastas do seu projeto usando comandos do sistema.
- Lê o código-fonte inteiro para entender o contexto.
- Edita o código e roda testes locais diretamente no seu computador.
- Ao identificar falhas de compilação, lê os logs e corrige o próprio código até funcionar.
Cada uma dessas ações reenvia todo o histórico ao modelo de linguagem. Em poucos minutos de trabalho, você pode facilmente ultrapassar 500.000 tokens consumidos.
A Solução: O que é o OmniRouter?
O OmniRouter é uma ferramenta open-source que atua como proxy intermediário entre a sua máquina e os provedores de inteligência artificial:
- Tolerância a Falhas e Rotação Automática: Se uma chave atinge o limite de requisições por minuto (Rate Limit 429), o OmniRouter redireciona imediatamente para o próximo provedor cadastrado.
- Pool de Chaves Gratuitas: Permite agrupar camadas gratuitas de provedores como OpenRouter, Groq, Google Gemini, DeepSeek e Together AI.
- Suporte a LLMs Locais: Conecta o Claude Code a modelos rodando na sua própria placa de vídeo via Ollama com custo absolutamente zero.
Passo 1: Instalar o Claude Code
Abra o terminal no macOS, Linux ou WSL no Windows e instale o pacote global:
# Instalação do CLI oficial npm install -g @anthropic-ai/claude-code # Confirmar versão instalada claude --version
Passo 2: Iniciar o OmniRouter Localmente
Execute o proxy local na porta 8080:
# Iniciar via Docker docker run -d -p 8080:8080 --name omnirouter omniroute/omnirouter:latest # Ou iniciar diretamente com NPX npx omniroute-proxy start --port 8080
Passo 3: Conectar o Claude Code ao Proxy
Configure as variáveis de ambiente no seu terminal apontando para a porta 8080:
# Apontar a URL para o servidor local export ANTHROPIC_BASE_URL="http://localhost:8080/v1" # Chave virtual gerenciada pelo OmniRouter export ANTHROPIC_API_KEY="sk-ant-omnirouter-pool-token" # Iniciar o assistente na sua pasta de projeto claude
export no seu arquivo ~/.bashrc ou ~/.zshrc.
Como Usar Modelos 100% Locais e Gratuitos com Ollama
Se você possui um computador com GPU dedicada (NVIDIA RTX 8GB+) ou um Mac Apple Silicon (M1/M2/M3/M4), pode programar sem internet e sem gastar nenhum centavo:
# Baixar o modelo Qwen 2.5 Coder
ollama run qwen2.5-coder:7b
Deseja nosso Script de Configuração Multi-Chaves?
Cadastre seu e-mail para receber nossos arquivos de configuração prontos para o OmniRouter com suporte a 5 provedores gratuitos e reconexão automática.
Perguntas Frequentes (FAQ)
É permitido utilizar proxies locais com o Claude Code?
Sim. O Claude Code é uma aplicação CLI oficial criada para respeitar variáveis padrão como ANTHROPIC_BASE_URL, permitindo que times e engenheiros usem seus próprios servidores e proxies compatíveis.