AgentRouter para Claude Code · Master Guide

O que o AgentRouter faz

Ele ocupa o meio do caminho entre sua ferramenta de AI coding e os modelos disponíveis no serviço.

Em vez de cada aplicativo conversar diretamente com um provedor diferente, você configura um endereço base e uma API Key do AgentRouter. A ferramenta cliente continua sendo Claude Code, Claude Desktop, Cline, Roo Code ou outra compatível; o AgentRouter funciona como camada de acesso e roteamento.

Cliente

Onde você trabalha

Terminal, VS Code, aplicativo desktop ou outro agente de codificação.

Gateway

Onde a conexão passa

AgentRouter autentica a requisição, aplica a rota compatível e contabiliza o consumo.

Protocolo

Como eles se entendem

Anthropic Compatible para Claude; OpenAI Compatible para GPT e similares.

Modelo

Quem gera a resposta

O Model ID disponível para sua API Key, copiado do painel atual da plataforma.

Jaya Roberta interagindo com painéis tecnológicos laranja

Leitura visual

O AgentRouter é a ponte, não o destino.

A ferramenta onde você trabalha continua sendo Claude Code, VS Code ou Claude Desktop. O AgentRouter fica no meio, autenticando e encaminhando a chamada.

A frase que evita metade dos erros

Você não instala o AgentRouter dentro do Claude. Você aponta o Claude Code para o endpoint Anthropic-compatible do AgentRouter.

Dois protocolos. Dois endpoints.

A barra /v1 não é decoração. Ela informa qual família de API a ferramenta deve usar.

Claude · Anthropic Compatible

Sem /v1

Use com Claude Code, Claude Desktop Gateway e perfis Anthropic.

https://co.agentrouter.org

GPT e compatíveis · OpenAI Compatible

Com /v1

Use com clientes configurados explicitamente no formato OpenAI Compatible.

https://co.agentrouter.org/v1

Jaya Roberta em cenário tecnológico com mascotes Claude e interfaces laranja — Protocolo certoAnthropic e OpenAI-compatible não são a mesma estrada.

Regra de bolso

Claude usa o endpoint Anthropic-compatible sem /v1. Clientes OpenAI-compatible usam a rota com /v1.

Não misture protocolo e endpoint.

Claude via Anthropic com /v1 tende a retornar 404. Um cliente OpenAI Compatible sem /v1 tende a chamar uma rota inexistente.

Ferramenta	Protocolo	Base URL	Credencial
Claude Code CLI	Anthropic	`https://co.agentrouter.org`	AgentRouter API Key
Claude Code para VS Code	Anthropic	`https://co.agentrouter.org`	AgentRouter API Key
Claude Desktop	Gateway / bearer	`https://co.agentrouter.org`	AgentRouter API Key
Perfil OpenAI Compatible	OpenAI	`https://co.agentrouter.org/v1`	AgentRouter API Key

Conta, créditos e API Key

Antes de abrir o terminal, organize a credencial que atravessará todas as ferramentas.

Entre pela página oficial.

Acesse o AgentRouter e faça o cadastro pelo método disponível para sua região e campanha.

Confirme o saldo no próprio painel.

Vídeos citam bônus de inscrição e indicação, mas esses valores são promocionais.

Crie uma API Key identificável.

Use um nome como claude-code-notebook-pessoal.

Copie e guarde imediatamente.

Use um gerenciador de senhas. Não envie a chave por mensagem ou captura de tela.

Veja os modelos vinculados à sua Key.

Copie o Model ID exatamente como aparece. Catálogo e sufixos variam.

Correção dos materiais antigos

Alguns tutoriais mostram “System Access Token” e a variável CLAUDE_CODE_AGENT_ROUTER_TOKEN. O guia oficial atual orienta usar a API Key em ANTHROPIC_AUTH_TOKEN, junto de ANTHROPIC_BASE_URL e ANTHROPIC_MODEL.

Arquivo visual

Os materiais que originaram este guia.

Foram preservados como apoio didático. As instruções técnicas do texto prevalecem quando houver divergência de versão.

Guia mestre visual do AgentRouter no Claude Code — Créditos, CLI e integração visual.

Claude Code no terminal

Este é o caminho mais direto e o melhor ponto de partida para validar a conexão.

1. Pré-requisito e instalação

Use Node.js 18 ou superior e instale a versão mais recente do Claude Code.

Terminalinstalação

npm install -g @anthropic-ai/claude-code@latest
claude --version

2. Configuração temporária no macOS ou Linux

Bash / Zshválida nesta sessão

export ANTHROPIC_AUTH_TOKEN="<SUA_API_KEY_DO_AGENTROUTER>"
export ANTHROPIC_BASE_URL="https://co.agentrouter.org"
export ANTHROPIC_MODEL="<MODEL_ID_COPIADO_DO_PAINEL>"

Para persistir, acrescente as linhas ao ~/.zshrc ou ~/.bashrc e abra um novo terminal.

3. Configuração temporária no Windows PowerShell

PowerShellválida nesta janela

$env:ANTHROPIC_AUTH_TOKEN="<SUA_API_KEY_DO_AGENTROUTER>"
$env:ANTHROPIC_BASE_URL="https://co.agentrouter.org"
$env:ANTHROPIC_MODEL="<MODEL_ID_COPIADO_DO_PAINEL>"

4. Configuração persistente no Windows

PowerShellvariáveis do usuário

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<SUA_API_KEY_DO_AGENTROUTER>", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://co.agentrouter.org", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "<MODEL_ID_COPIADO_DO_PAINEL>", "User")

Feche todas as janelas do terminal e abra uma nova para carregar as variáveis.

5. Primeiro teste

Terminaldentro do projeto

cd caminho/do/seu-projeto
claude

Envie uma solicitação pequena: Leia o projeto sem alterar arquivos e responda apenas com a stack identificada.

O Claude respondeu. A autenticação e o endpoint funcionam.

A chamada apareceu no painel. O consumo passa pelo AgentRouter.

O modelo é o esperado. Você não está usando outra rota sem perceber.

Claude Code no VS Code

Use a extensão publicada pela Anthropic e injete as mesmas variáveis na configuração do editor.

Instale “Claude Code”.

No Marketplace, confirme que o publicador é Anthropic.

Abra as configurações JSON.

Use Ctrl/Cmd + Shift + P e execute “Preferences: Open User Settings (JSON)”.

Mescle a configuração.

Não apague as configurações existentes; altere apenas as chaves necessárias.

settings.jsonClaude Code para VS Code

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "<AgentRouter API Key>" },
    { "name": "ANTHROPIC_BASE_URL", "value": "https://co.agentrouter.org" },
    { "name": "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "value": "1" },
    { "name": "ANTHROPIC_MODEL", "value": "<Model ID atual>" }
  ],
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.initialPermissionMode": "default"
}

Por que o guia usa permission mode “default”?

A documentação do AgentRouter mostra acceptEdits, mas um padrão seguro não ativa edição automática para todo iniciante. Amplie a autonomia depois de compreender o alcance.

Execute “Developer: Reload Window”, abra o painel do Claude Code e repita o teste mínimo.

E no Antigravity?

O Antigravity (Google) não tem uma extensão própria do Claude Code com um bloco de configurações equivalente ao claudeCode.environmentVariablesdo VS Code. O caminho verificado é outro: o Claude Code roda como CLI dentro do terminal integrado do Antigravity, usando exatamente as mesmas variáveis do Capítulo 04 — o Antigravity funciona como ambiente hospedeiro, não como integração dedicada.

Abra o terminal integrado do Antigravity.

Mesmo terminal usado para rodar outros comandos do projeto.

Exporte as variáveis do Capítulo 04.

Use a configuração de macOS/Linux ou PowerShell, conforme o sistema operacional do Antigravity.

Rode claude normalmente.

A ferramenta se comporta como no terminal padrão — o Antigravity só hospeda a sessão.

Sem extensão dedicada

Se algum tutorial mostrar um “Antigravity settings.json” para Claude Code, trate com cautela: não é o caminho documentado hoje. Confirme sempre no painel de extensões do Antigravity antes de seguir instruções de terceiros.

Claude Desktop via Gateway

O aplicativo desktop possui uma rota própria de inferência de terceiros.

Ative o modo de desenvolvedor.

Help → Troubleshooting → Enable developer mode.

Abra a inferência de terceiros.

Developer → Configure third-party inference.

Escolha Gateway.

Base URL: https://co.agentrouter.org. API key: sua chave. Auth scheme: bearer.

Aplique e reinicie.

Use Apply locally e Relaunch now. Depois selecione um modelo disponível.

Modelos, saldo e consumo

O melhor modelo é o menor capaz de entregar o nível de qualidade que a tarefa exige.

Tarefas leves

Economia como padrão

Formatação, documentação e pequenos ajustes raramente exigem o modelo mais caro.

Tarefas complexas

Suba o modelo com intenção

Arquitetura, refatorações amplas e investigação difícil justificam mais capacidade.

Como o catálogo é vinculado à sua API Key e pode mudar, este guia não cristaliza uma lista de nomes. Consulte a página de modelos antes de copiar qualquer Model ID de vídeo, print ou postagem.

Regra operacional Jay.AI

Faça o primeiro teste com uma requisição pequena, confira log e custo, e só então entregue ao agente uma tarefa longa.

Segurança sem teatro

Uma API Key é uma credencial de consumo. Quem a obtém pode usar seu saldo e agir dentro das permissões concedidas.

Guarde a chave em gerenciador de senhas ou variável de ambiente.

Nunca coloque a chave em arquivo versionado, prompt ou screenshot.

Inclua .env* no .gitignore.

Crie chaves diferentes por máquina ou finalidade quando o painel permitir.

Revogue imediatamente qualquer chave exposta.

No computador corporativo, confirme as regras internas antes de enviar código ou dados.

Ambiente corporativo

Créditos pessoais e uma integração funcional não significam autorização institucional. Use apenas em projetos e equipamentos permitidos.

Retrato editorial de Jaya Roberta para a seção de segurança — Segurança não é rodapé. É parte da configuração.

Troubleshooting

Quase todo erro pertence a uma destas camadas: instalação, variável, protocolo, modelo ou permissão.

Sintoma	Causa provável	O que verificar
`401` ou invalid API key	Chave incorreta, revogada ou não carregada	Recrie a variável, abra novo terminal e confira a chave.
`404`	Endpoint ou protocolo misturado	Claude sem `/v1`; OpenAI Compatible com `/v1`.
model not found	Model ID antigo ou indisponível	Copie novamente o ID da página de modelos.
Claude pede login Anthropic	Extensão não recebeu as variáveis	Revise `disableLoginPrompt` e recarregue a janela.
claude: command not found	Instalação global fora do PATH	Reinstale, confira Node/npm e reabra o terminal.
Funciona no terminal, falha no VS Code	Editor usa ambiente próprio	Configure `claudeCode.environmentVariables`.

Perguntas frequentes

As dúvidas que aparecem quando o tutorial acaba e a vida real começa.

O AgentRouter substitui o Claude Code?

Não. Claude Code é o cliente/agente; AgentRouter é a camada de acesso aos modelos.

Preciso de assinatura Claude Pro ou Max?

Na configuração por gateway, o consumo passa pela API Key e pelo saldo do AgentRouter, não pela assinatura de chat.

Posso usar a mesma Key em mais de uma ferramenta?

A documentação atual informa que sim e que a cota é unificada. Para rastreabilidade, pode valer separar chaves por finalidade.

Onde entra o Antigravity?

Use o terminal integrado do Antigravity para executar Claude Code com as mesmas variáveis. Trate o Antigravity como ambiente hospedeiro.

Os US$ 175 são garantidos?

Não devem ser tratados como garantia permanente. Confirme elegibilidade, valor e validade no painel no momento do cadastro.

Fontes e notas de revisão

A tecnologia muda. Um bom guia deixa pegadas para que você saiba de onde cada decisão veio.

AgentRouter · Guia oficial de integração AgentRouter · Documentação de ferramentas AgentRouter · Página de entrada

v1.0 · 30/07/2026

Primeira publicação

Endpoints, API Key, CLI, VS Code, Desktop, segurança e diagnóstico.

Política de atualização

O que revisar primeiro

Base URL, variáveis, catálogo de modelos, promoções e telas do painel.

Jaya Roberta em retrato claro com caneca

Nota da Jaya

Uma boa configuração devolve foco.

O objetivo não é decorar variáveis. É criar uma base confiável para que a tecnologia pare de ocupar o centro da cena e volte a servir ao trabalho.

@jayaroberta.ai

AgentRouter para Claude Code.