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

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.

Todos os planos ilimitados →

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

Perguntas frequentes

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.