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.
Como você usa o Claude Code com o OpenRouter?
Defina a URL base como https://openrouter.ai/api, coloque sua chave de API do OpenRouter em ANTHROPIC_AUTH_TOKEN e deixe ANTHROPIC_API_KEY em branco. Assim, o Claude Code se comunica diretamente com o OpenRouter, sem proxy local, e cobra dos seus créditos do OpenRouter.
Esta é a configuração descrita no guia oficial do OpenRouter para o Claude Code. Segundo o próprio guia, o Claude Code fala seu protocolo nativo diretamente com o OpenRouter, e nenhum servidor proxy local é necessário. Essa é a principal diferença em relação a ferramentas como o Claude Code Router, que executam um proxy na sua máquina (veja nosso guia do Claude Code Router se preferir essa rota).
O restante deste artigo aborda as variáveis exatas, onde colocá-las, as ressalvas que o OpenRouter informa, quanto custa e como os créditos gratuitos podem pagar por isso.
Principais Créditos de IA para Startups
Candidate-se diretamente por meio destes programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegível para startups em estágio inicial
Claude (via program) $100,000
Elegível para startups em estágio inicial
OpenAI (via program) $2,500
Elegível para startups em estágio inicial
Anthropic $20,000
Elegível para startups em estágio inicial
AWS $300,000
Elegível para startups em estágio inicial
Google Cloud $350,000
Elegível para startups em estágio inicial
Quais variáveis de ambiente o OpenRouter precisa?
Três variáveis fazem o trabalho. O guia pede a URL completa da API do OpenRouter, incluindo o protocolo, então um nome de host simples não funciona.
| Variável | Valor | Motivo |
|---|---|---|
| ANTHROPIC_BASE_URL | https://openrouter.ai/api | Envia o tráfego do Claude Code para o OpenRouter |
| ANTHROPIC_AUTH_TOKEN | Sua chave de API do OpenRouter | Autentica no OpenRouter |
| ANTHROPIC_API_KEY | String vazia | Deixada em branco explicitamente para evitar conflitos |
A URL base é a parte que as pessoas mais erram ao pesquisar uma resposta para claude code base url openrouter. Use https://openrouter.ai/api exatamente assim, com https:// no início.
Deixar ANTHROPIC_API_KEY em branco é importante porque o Claude Code lê as duas variáveis. Se ainda houver uma chave antiga da Anthropic definida, ela pode entrar em conflito com o token do OpenRouter.
Onde você deve colocar as variáveis e onde não deve?
Você tem dois lugares compatíveis e um lugar que não funciona.
Opção 1: seu perfil de shell. O OpenRouter recomenda essa opção para persistência. Adicione as variáveis ali e depois recarregue seu shell. O guia é direto sobre o recarregamento: se você pulá-lo, continuará testando o ambiente antigo e concluirá, de forma errada, que a configuração está quebrada.
Opção 2: um arquivo de configurações no nível do projeto. Você também pode usar .claude/settings.local.json na raiz do seu projeto. Isso mantém a configuração restrita a um único projeto.
Não use um arquivo .env. O guia diz para não colocar essas variáveis em um arquivo .env no nível do projeto, porque o instalador nativo do Claude Code não lê arquivos .env padrão.
Mais uma armadilha: se sua chave do OpenRouter estiver em outra variável à qual ANTHROPIC_AUTH_TOKEN faz referência, defina-a antes de ela ser usada. Caso contrário, a autenticação falha. O guia sugere um arquivo que carregue mais cedo, como ~/.zshenv para o zsh.
Principais Créditos de IA para Startups
Candidate-se diretamente por meio destes programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegível para startups em estágio inicial
Claude (via program) $100,000
Elegível para startups em estágio inicial
OpenAI (via program) $2,500
Elegível para startups em estágio inicial
Anthropic $20,000
Elegível para startups em estágio inicial
AWS $300,000
Elegível para startups em estágio inicial
Google Cloud $350,000
Elegível para startups em estágio inicial
Como fazer a configuração, passo a passo?
Passo 1: Obtenha créditos pelo AI Perks
O Claude Code via OpenRouter é cobrado a partir dos seus créditos do OpenRouter, então comece encontrando créditos gratuitos. O Guia AI Perks lista créditos do OpenRouter de até $3,000, além de créditos da Anthropic que você pode usar se trouxer sua própria chave. Consulte o catálogo para ver valores e detalhes antes de gastar seu próprio dinheiro.
Passo 2: Crie uma chave de API do OpenRouter
Gere uma chave nas configurações da sua conta do OpenRouter. Esse é o valor que vai em ANTHROPIC_AUTH_TOKEN.
Passo 3: Adicione as variáveis
Coloque a URL base, o token de autenticação e o ANTHROPIC_API_KEY em branco no seu perfil de shell ou em .claude/settings.local.json. Não use um arquivo .env. Depois, recarregue seu shell.
Passo 4: Execute /logout se necessário
Se você já fez login no Claude Code com uma conta da Anthropic, execute /logout uma vez para remover a sessão em cache. Em seguida, feche e reabra o claude para que ele carregue as novas variáveis. Se você nunca fez login com a Anthropic, pode pular esta etapa.
Passo 5: Verifique com /status
Execute /status dentro do Claude Code para confirmar a conexão. Depois, verifique seu painel do OpenRouter: o uso, incluindo os tokens de raciocínio, aparece ali.
Quais ressalvas o OpenRouter informa?
O guia é claro sobre os limites, e eles afetam a forma como você deve configurar as coisas.
- Somente Anthropic de primeira parte. O Claude Code com o OpenRouter só tem funcionamento garantido com o provedor de primeira parte da Anthropic. Para máxima compatibilidade, o OpenRouter recomenda tornar a Anthropic 1P o provedor de maior prioridade.
- Outros modelos podem falhar. O Claude Code é otimizado para os modelos da Anthropic e pode não funcionar corretamente com outros provedores. Trate modelos que não são da Anthropic como um experimento, não como padrão.
- Premissa da janela de contexto. O Claude Code assume uma janela de contexto de 200k, a menos que o nome do modelo termine em
[1m]. - Failover. As solicitações passam automaticamente por failover entre vários provedores da Anthropic quando roteadas pelo OpenRouter.
- Privacidade. O OpenRouter não registra seus prompts com código-fonte, a menos que você opte por registrar prompts nas configurações da sua conta.
Essa primeira ressalva é o motivo pelo qual as buscas por "claude code openrouter gratuito" exigem cuidado. O OpenRouter oferece modelos gratuitos, mas eles têm limites, e o Claude Code só tem funcionamento garantido na Anthropic de primeira parte. Os modelos gratuitos são limitados a 20 solicitações por minuto e 50 por dia, passando para 1.000 por dia depois que você comprar pelo menos $10 em créditos. Veja nosso guia do nível gratuito do OpenRouter para o detalhamento completo.
Principais Créditos de IA para Startups
Candidate-se diretamente por meio destes programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegível para startups em estágio inicial
Claude (via program) $100,000
Elegível para startups em estágio inicial
OpenAI (via program) $2,500
Elegível para startups em estágio inicial
Anthropic $20,000
Elegível para startups em estágio inicial
AWS $300,000
Elegível para startups em estágio inicial
Google Cloud $350,000
Elegível para startups em estágio inicial
Você pode usar o modo rápido pelo OpenRouter?
Sim, mas apenas em condições específicas. O modo rápido da Anthropic oferece saída até 2,5x mais rápida a um preço premium, acima das taxas padrão de tokens do modelo Opus subjacente.
| Requisito | Detalhe |
|---|---|
| Modelos | Claude Opus 4.6, 4.7, 4.8 e Claude Opus 5 |
| Versão do Claude Code | v2.1.96 ou mais recente |
| Variável de ambiente | CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1 para usar /fast |
| Provedor | Somente Anthropic de primeira parte |
| Configuração do modelo | Fixe a variável do Opus em um ID específico, como anthropic/claude-opus-5 |
O modo rápido é servido somente pelo provedor de primeira parte da Anthropic, já que outros provedores, como Amazon Bedrock e Google Vertex, não o suportam. Para realmente usá-lo, fixe a variável do modelo Opus em um ID específico do Opus, em vez do alias mais recente. O guia não publica aqui o multiplicador premium, então verifique as taxas atuais antes de depender dele.
Quanto custa o Claude Code no OpenRouter em comparação com a Anthropic direta?
O OpenRouter não aplica markup sobre a inferência. A inferência é cobrada pelo preço de tabela do provedor em todos os planos. A taxa é cobrada quando você compra créditos, nunca em solicitações individuais.
Veja a que valor a taxa equivale numa compra de créditos de $10:
| Compra de créditos | Taxa | Taxa sobre $10 |
|---|---|---|
| Não cripto, Padrão | 5,5%, mínimo de $0.80 | $0.80 (5,5% de $10 são $0.55, abaixo do mínimo, então vale o mínimo) |
| Cripto | 5,0% fixos, sem mínimo | $0.50 (5,0% de $10) |
| Não cripto, Empresarial | 8% | $0.80 (8% de $10) |
Portanto, a comparação honesta é esta: o preço por token é o preço de tabela do provedor, e o OpenRouter adiciona uma taxa de compra por cima. Pagar diretamente à Anthropic evita essa taxa. Em troca, você obtém uma única chave, um único painel e failover entre provedores da Anthropic.
Os preços por token de cada modelo não são publicados na página de preços do OpenRouter. Eles precisam ser lidos a partir da API de modelos. Para os números da própria Anthropic, veja nossa análise de preços da API do Claude.
Como o BYOK muda a conta?
Os planos Padrão e Empresarial incluem $25,000 por mês de inferência ao preço de tabela via BYOK (traga sua própria chave), sem taxa do OpenRouter. Acima dessa cota, o OpenRouter cobra 5% do que a solicitação custaria ao preço de tabela, descontados dos seus créditos.
Com o BYOK, você controla os limites de taxa e os custos pela sua própria conta no provedor. É aí que os créditos gratuitos de fornecedores se tornam úteis: se a sua conta no provedor tiver créditos, seu uso do Claude Code pode consumi-los, sujeito às próprias condições de crédito desse fornecedor.
Principais Créditos de IA para Startups
Candidate-se diretamente por meio destes programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegível para startups em estágio inicial
Claude (via program) $100,000
Elegível para startups em estágio inicial
OpenAI (via program) $2,500
Elegível para startups em estágio inicial
Anthropic $20,000
Elegível para startups em estágio inicial
AWS $300,000
Elegível para startups em estágio inicial
Google Cloud $350,000
Elegível para startups em estágio inicial
Quais créditos gratuitos podem cobrir seu uso do Claude Code?
Estes são os valores do catálogo mais relevantes para executar o Claude Code. Os detalhes, e o que cada benefício envolve, estão no catálogo do AI Perks.
| Empresa | Créditos gratuitos | Como obter |
|---|---|---|
| OpenRouter | Até $3,000 | Obter este benefício |
| Anthropic (direto) | $20,000 | Obter este benefício |
| Claude via parceiros | Até $100,000 | Obter este benefício |
| AWS (Amazon Bedrock) | $300,000 | Obter este benefício |
Total das quatro linhas: $3,000 + $20,000 + $100,000 + $300,000 = até $423,000 em créditos listados.
O catálogo também lista créditos da OpenAI, Google Cloud, Azure OpenAI, Mistral AI, Together AI, Cerebras e Novita AI. Eles são úteis principalmente se você quiser testar modelos que não são da Anthropic, lembrando o aviso do OpenRouter de que o Claude Code pode não funcionar corretamente com eles. Para o lado da Anthropic especificamente, leia nosso guia sobre uma chave gratuita de API da Anthropic e veja o catálogo para os valores maiores de créditos do Claude.
Perguntas frequentes
O Claude Code precisa de um proxy local para funcionar com o OpenRouter?
Não. O OpenRouter afirma que o Claude Code fala seu protocolo nativo diretamente com o OpenRouter, e nenhum servidor proxy local é necessário. Você apenas define variáveis de ambiente. Uma ferramenta baseada em proxy, como o Claude Code Router, é uma abordagem diferente, útil quando você quer regras de roteamento personalizadas entre muitos modelos.
Por que o Claude Code ainda usa meu antigo login da Anthropic?
Provavelmente você tem uma sessão em cache. Execute /logout uma vez e depois feche e reabra o claude para que ele leia as novas variáveis. Confirme também que você recarregou o shell depois de editar o perfil e que ANTHROPIC_API_KEY está em branco. Verifique o resultado com /status.
Posso usar o Claude Code com o OpenRouter gratuitamente?
Em parte. Novos usuários do OpenRouter recebem uma pequena cota gratuita, e existem modelos gratuitos com limites de 20 solicitações por minuto e 50 por dia. Mas o Claude Code só tem funcionamento garantido no provedor de primeira parte da Anthropic. Para uso real, consulte os créditos gratuitos listados em getaiperks.com.
O OpenRouter cobra algo extra por solicitação para modelos Claude?
Não. A inferência é cobrada pelo preço de tabela do provedor, e a taxa do OpenRouter se aplica quando você compra créditos: 5,5% no Padrão e 8% no Empresarial. As compras não cripto têm mínimo de $0.80, e as compras em cripto têm taxa fixa de 5,0%. Compare isso com pagar diretamente à Anthropic usando os créditos da Anthropic no catálogo.
Posso usar créditos gratuitos da Anthropic pelo OpenRouter?
Pelo BYOK, você conecta sua própria chave de provedor e os custos passam pela sua conta no provedor. Os planos Padrão e Empresarial incluem uma cota mensal de BYOK de $25,000 sem taxa do OpenRouter. Para encontrar créditos da Anthropic de até $100,000 via parceiros, veja o catálogo em AI Perks.
Por que a janela de contexto do meu Claude Code é de 200k?
O Claude Code assume uma janela de contexto de 200k, a menos que o nome do modelo termine em [1m]. Se você quiser que o Claude Code trate a janela como maior, o nome do modelo precisa carregar esse sufixo. O guia não publica mais detalhes sobre quais modelos oferecem suporte a isso.
Principais Créditos de IA para Startups
Candidate-se diretamente por meio destes programas verificados.
OpenRouter Up to $3,000 + 0% fees for 12 months
Elegível para startups em estágio inicial
Claude (via program) $100,000
Elegível para startups em estágio inicial
OpenAI (via program) $2,500
Elegível para startups em estágio inicial
Anthropic $20,000
Elegível para startups em estágio inicial
AWS $300,000
Elegível para startups em estágio inicial
Google Cloud $350,000
Elegível para startups em estágio inicial
Pronto para financiar sua configuração do Claude Code?
A configuração leva minutos. O custo é a parte que vale a pena planejar: créditos do OpenRouter, créditos da Anthropic e créditos de nuvem estão todos organizados em um só catálogo, então você pode associar os créditos certos ao seu uso antes de pagar o preço de tabela.
Obtenha créditos gratuitos de IA em getaiperks.com →
Navegue pelo catálogo completo de créditos gratuitos de IA em getaiperks.com e execute o Claude Code com créditos que você não pagou.
