Volume 01 · Master Guide · v1.0

AgentRouter para Claude Code.

Da conta ao primeiro projeto funcionando, com o protocolo certo, a chave certa e uma explicação que não começa no meio.

Uma rota clara entre ferramenta e modelo.

Revisado em 30/07/2026 Windows · macOS · Linux Leitura aproximada: 28 min
Promoções e catálogo mudam.Valores de créditos, bônus, modelos e preços exibidos em vídeos ou materiais antigos devem ser confirmados no painel da sua conta.
01

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.

Astrolábio gravado com três discos em fases da lua, símbolo do consumo acompanhado
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.

02

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
Três fios de cores diferentes trançados em um único nó em forma de bússola
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.

FerramentaProtocoloBase URLCredencial
Claude Code CLIAnthropichttps://co.agentrouter.orgAgentRouter API Key
Claude Code para VS CodeAnthropichttps://co.agentrouter.orgAgentRouter API Key
Claude DesktopGateway / bearerhttps://co.agentrouter.orgAgentRouter API Key
Perfil OpenAI CompatibleOpenAIhttps://co.agentrouter.org/v1AgentRouter API Key
03

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.

Mapa da configuração

Do cadastro ao primeiro prompt.

O caminho verificado em quatro paradas. Cada uma entrega uma peça que a seguinte usa.

  1. ContaCadastro no painel oficial do AgentRouter.Saldo conferido no painel
  2. API KeyCriada com nome identificável e guardada em gerenciador de senhas.ANTHROPIC_AUTH_TOKEN
  3. Endereço e modeloEndpoint compatível com Anthropic e o Model ID copiado do painel.ANTHROPIC_BASE_URL · ANTHROPIC_MODEL
  4. Primeiro promptTerminal aberto na pasta do projeto, comando claude.Mesma key no VS Code via settings.json
04

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.
05

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.

06

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.

07

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.

08

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.

Cofre botânico com tampa de folhas e uma chave com raízes, símbolo da guarda da API Key
Segurança não é rodapé. É parte da configuração.
09

Troubleshooting

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

SintomaCausa provávelO que verificar
401 ou invalid API keyChave incorreta, revogada ou não carregadaRecrie a variável, abra novo terminal e confira a chave.
404Endpoint ou protocolo misturadoClaude sem /v1; OpenAI Compatible com /v1.
model not foundModel ID antigo ou indisponívelCopie novamente o ID da página de modelos.
Claude pede login AnthropicExtensão não recebeu as variáveisRevise disableLoginPrompt e recarregue a janela.
claude: command not foundInstalação global fora do PATHReinstale, confira Node/npm e reabra o terminal.
Funciona no terminal, falha no VS CodeEditor usa ambiente próprioConfigure claudeCode.environmentVariables.
10

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.

11

Fontes e notas de revisão

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

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 pé, de regata estampada, com o pôr do sol de Brasília ao fundo
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