Source: https://aiprimetech.io/pt/claude-code/openrouter/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › OpenRouter

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# Como usar o OpenRouter no Claude Code (e quando não usar)

As pessoas direcionam o Claude Code ao OpenRouter por dois motivos diferentes: pagar pelo Claude por meio de uma conta que já têm ou executar modelos de outros fornecedores dentro do Claude Code. Ambos funcionam, com ressalvas que vale a pena conhecer antes de dedicar uma tarde a eles.

## TLDR
- Opção 1: endpoint do OpenRouter compatível com a Anthropic via ANTHROPIC_BASE_URL + sua chave do OpenRouter — apenas modelos Claude, preço de tabela mais a taxa do OpenRouter.
- Opção 2: claude-code-router entre o Claude Code e o provedor — qualquer modelo do OpenRouter por tarefa, ao custo de um proxy local e peculiaridades ocasionais nas chamadas de ferramentas.
- Os modelos que não são Claude lidam de maneira desigual com o esquema de ferramentas do Claude Code; espere mais tentativas.
- Se você só quer Claude, um gateway Claude é mais barato que o OpenRouter: os mesmos modelos a 7.69231× o valor nominal, em vez do preço de tabela mais uma taxa.

## Opção 1: direcione o Claude Code diretamente ao OpenRouter 

O OpenRouter disponibiliza um endpoint Messages compatível com a Anthropic, além de sua API no estilo da OpenAI. O Claude Code só precisa da URL base e de uma chave, então a configuração usa as mesmas duas variáveis que você usaria para qualquer gateway — consulte a documentação do OpenRouter para obter o caminho base atual caso o indicado abaixo tenha mudado: 

```
export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-or-...     # your OpenRouter key
claude --model anthropic/claude-sonnet-5   # OpenRouter's model id format
```

Os IDs dos modelos seguem a nomenclatura vendor/model do OpenRouter, que também é o que você coloca nas variáveis de cada nível (ANTHROPIC_DEFAULT_SONNET_MODEL e outras semelhantes). Execute /status para confirmar o endpoint e /model para alternar. A cobrança é a do OpenRouter: o preço de tabela do modelo mais a taxa de plataforma do OpenRouter sobre os créditos, então essa opção custa um pouco *mais* do que usar a Anthropic diretamente — seu objetivo é a conveniência e uma única conta, não o preço. 

## Opção 2: claude-code-router para modelos que não são Claude 

claude-code-router é um proxy local que recebe as solicitações do Claude Code e encaminha cada uma a um provedor escolhido por regra — padrão, segundo plano, raciocínio, contexto longo. Configure o OpenRouter como provedor com sua chave, escolha os modelos para cada rota e inicie com ccr code. É assim que as pessoas executam modelos com pesos abertos ou de outros fornecedores dentro do Claude Code. 

```
// ~/.claude-code-router/config.json (excerpt)
{
  "Providers": [{
    "name": "openrouter",
    "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
    "api_key": "sk-or-...",
    "models": ["anthropic/claude-sonnet-5", "google/gemini-2.5-pro", "deepseek/deepseek-chat"]
  }],
  "Router": { "default": "openrouter,anthropic/claude-sonnet-5", "background": "openrouter,deepseek/deepseek-chat" }
}
```

O que falha: o ciclo de execução do agente do Claude Code depende do formato de uso de ferramentas da Anthropic, e o roteador precisa traduzi-lo para modelos no estilo da OpenAI. Modelos robustos dão conta; os menores deixam de fazer chamadas de ferramentas, inventam caminhos de arquivos ou ignoram o protocolo de permissões, e a sessão se degrada em sucessivas tentativas. Mantenha as rotas *default* e *think* em um modelo Claude e use as outras para tarefas em segundo plano, e você terá uma boa configuração. 

## Quanto custa, com franqueza 
- OpenRouter direto: preço de tabela da Anthropic + taxa do OpenRouter. Conveniente, nunca mais barato que a Anthropic.
- claude-code-router + OpenRouter: o custo dos modelos usados em cada rota; a economia vem de enviar tarefas em segundo plano para modelos baratos, não de o Claude ser mais barato.
- Gateway do Claude (este site): os mesmos modelos Claude, cobrados pelas tarifas de tabela usando créditos comprados com 87% de desconto sobre o valor nominal ($13 → $100 de uso), ou um plano ilimitado com preço fixo a partir de $1. GPT-6 / GPT-5.x também estão disponíveis, por meio do grupo Codex. 

## Se você só quer Claude, dispense o OpenRouter 

A maioria das pessoas que busca por "OpenRouter no Claude Code" quer uma de duas coisas: gastar menos com o Claude ou uma forma de pagar sem uma conta no console da Anthropic. O OpenRouter resolve a segunda e piora a primeira. Um gateway resolve ambas — as mesmas duas variáveis, sem proxy: 

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude
```

E as duas opções podem ser combinadas: defina este gateway como um provedor do tipo Anthropic em claude-code-router e direcione os níveis Claude para ele, enquanto envia tarefas em segundo plano para outros provedores. O guia do ecossistema aborda o roteador com mais profundidade. 

 | Plano | Duração | Preço

 | Ilimitado por 1 hora | 1 hora | $1

 | Ilimitado por 24 horas | 24 horas | $10

 | Ilimitado por 1 semana | 1 semana | $49

 | Ilimitado por 15 dias | 15 dias | $89

[Todos os planos ilimitados →](/pt/plans/)

## Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE)

## Perguntas frequentes

O Claude Code pode usar o OpenRouter?

Sim — diretamente pelo endpoint do OpenRouter compatível com a Anthropic (modelos Claude), ou por meio de claude-code-router para qualquer modelo do OpenRouter. Defina ANTHROPIC_BASE_URL e sua chave do OpenRouter para a opção direta.O OpenRouter é mais barato para o Claude Code?

Não. O OpenRouter cobra o preço de tabela da Anthropic mais sua própria taxa. A economia só vem de direcionar tarefas em segundo plano para modelos mais baratos que não sejam Claude, ou de usar um gateway Claude que vende os mesmos modelos abaixo do preço de tabela.Quais modelos funcionam melhor no Claude Code pelo OpenRouter?

Os modelos Claude, como seria de esperar — o ciclo de execução do agente foi construído em torno do formato de ferramentas da Anthropic. Outros modelos robustos funcionam com o roteador; os menores têm dificuldade com chamadas de ferramentas.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/)

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

## Mais guias do Claude Code

[Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes](/pt/claude-code/subagents/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)