Claude Code com um URL base personalizado
Defina estas quatro variáveis na shell, ou no bloco env de ~/.claude/settings.json, e o Claude Code passa a funcionar com modelos Claude através da sua chave AIGROW.
Já tem um código? Resgate-o em Acesso à API e depois crie uma chave.
Shell, antes de iniciar o claude
export ANTHROPIC_BASE_URL="https://aigrow.gg"
export ANTHROPIC_AUTH_TOKEN="ag_your_key_here"
export ANTHROPIC_MODEL="claude-opus-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5.5"Substitua ag_your_key_here por uma chave de Acesso à API.
Onde fica a definição
- macOS e Linux
~/.claude/settings.json- Windows
%USERPROFILE%\.claude\settings.json- Apenas um projeto
.claude/settings.local.json- Extensão do VS Code
claudeCode.environmentVariables
Ou guarde-o no settings.json
O Claude Code lê o bloco env do seu ficheiro de definições em cada arranque, por isso a configuração mantém-se num novo terminal. Um valor aqui prevalece sobre um export da shell. Não coloque a chave no .claude/settings.json de um projeto, que se destina a ser enviado para o repositório.
{
"env": {
"ANTHROPIC_BASE_URL": "https://aigrow.gg",
"ANTHROPIC_AUTH_TOKEN": "ag_your_key_here",
"ANTHROPIC_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5.5"
}
}Que modelo usar
Introduza o id exatamente como está escrito aqui.
- Claude Opus 5.5
claude-opus-5.5 - ANTHROPIC_MODEL, o modelo com que trabalha. A opção predefinida em todos os blocos desta página. Contexto: 1 000 000 tokens.
- Claude Sonnet 5.5
claude-sonnet-5.5 - ANTHROPIC_DEFAULT_HAIKU_MODEL, para títulos, resumos e outras chamadas em segundo plano. Por predefinição, o Claude Code envia-as para um modelo Haiku, que o endpoint não serve. Como modelo principal, é o que custa menos numa sessão longa, porque as suas leituras de cache são as mais baratas aqui. Contexto: 1 000 000 tokens.
- Claude Fable 5.1
claude-fable-5.1 - Custa mais por token do que o Opus. Compare os dois no ranking de programação antes de mudar. Contexto: 1 000 000 tokens.
A lista de preços tem todos os ids e a respetiva taxa de crédito, os preços da API do Claude indicam os preços de tabela e o ranking de programação compara os modelos em prompts de programação.
Verifique se funciona
Primeiro a chave isolada, depois o Claude Code com ela.
A chave
Peça a lista de modelos. Requer uma chave válida e não custa nada.
curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"{
"object": "list",
"data": [
{ "id": "claude-opus-5.5", "object": "model", ... },
{ "id": "claude-fable-5.1", "object": "model", ... },
{ "id": "gpt-6-astra", "object": "model", ... },
{ "id": "claude-sonnet-5.5", "object": "model", ... },
{ "id": "gpt-6.1-sol", "object": "model", ... },
{ "id": "grok-4.7", "object": "model", ... },
...
],
"has_more": false
}Claude Code
Execute um prompt a partir da shell. Dentro de uma sessão, /status mostra o URL base e a origem da chave.
claude -p "Reply with the word ready"readyQuando falha
Primeiro os erros do Claude Code, depois as respostas que o endpoint dá a qualquer ferramenta.
- 404 em todos os pedidos
- O URL base termina em /v1. O Claude Code acrescenta /v1/messages por si, por isso ANTHROPIC_BASE_URL é https://aigrow.gg sem nada depois.
- 400 sobre um campo desconhecido
- Defina CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 e inicie de novo. O Claude Code deixa então de enviar os seus campos de pedido experimentais.
- Pede-lhe que aprove uma chave de API
- Definiu ANTHROPIC_API_KEY, que é enviada como cabeçalho x-api-key e exige a sua aprovação uma vez. Aprove-a, ou use ANTHROPIC_AUTH_TOKEN como no bloco, que é enviado como cabeçalho Bearer sem pedir confirmação.
- Continua a usar o seu login do Claude
- Execute /status. Se não mostrar nenhum URL base personalizado, as variáveis não chegaram ao Claude Code: exporte-as na shell a partir da qual inicia o claude, ou coloque-as no bloco env do settings.json.
- A minha ferramenta indica 401 ou erro de autenticação
- A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.
- Recebo 402 ou uma mensagem sobre crédito
- O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.
- Aparece 404 ou Unknown model
- O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.
- Os pedidos são rejeitados com 429
- A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.
- O modelo está indisponível neste momento
- Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.
- Recebo um 502 ou 503
- Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.
O que não funciona através da AIGROW
GPT e Grok. O Claude Code foi concebido para modelos Claude, por isso defina aqui apenas ids de Claude e use uma das outras ferramentas desta página para o resto.
Remote Control e ditado por voz. Exigem um login do Claude e ficam desativados com uma chave de gateway.
Tamanho de contexto para um id que o Claude Code não reconhece. O Claude Code considera 200 000 tokens, pelo que uma sessão pode ser compactada mais cedo do que o modelo necessita.
Contagens exatas de tokens antes de um pedido. O endpoint não tem rota de contagem de tokens, por isso o Claude Code estima por si próprio o tamanho de um prompt.
Pesquisa web em tempo real dentro do modelo. Uma ferramenta de pesquisa web enviada num pedido é respondida com o que o modelo já sabe, sem resultados em tempo real. Uma ferramenta que obtém páginas na sua própria máquina continua a funcionar.
Qualquer endpoint além destes três: /v1/messages, /v1/chat/completions e /v1/models. A Responses API, os embeddings e a contagem de tokens respondem 404.
Campos de router como models, route, provider e plugins. São descartados, por isso um pedido vai sempre para o único modelo que indica.
Quanto custa um mês de Claude Code
Um programador a trabalhar o dia todo, com a maior parte de cada pedido lida da cache de prompts, ao preço de tabela e através de crédito. Mude o modelo para comparar.
Claude Opus 5.5, Agente de programação: $214.20 por mês ao preço de tabela, $100.80 com crédito AIGROW, menos $113.40 (53%).
Perguntas sobre o Claude Code e uma API personalizada
- O Claude Code funciona com um URL base personalizado?
- Sim. Defina ANTHROPIC_BASE_URL como https://aigrow.gg e ANTHROPIC_AUTH_TOKEN com a sua chave, e o Claude Code envia todos os pedidos para esse endereço em vez de para a Anthropic. A extensão do VS Code lê as mesmas definições.
- O ANTHROPIC_BASE_URL deve terminar em /v1?
- Não. O Claude Code acrescenta /v1/messages por si, por isso o valor é https://aigrow.gg. Com /v1 no final, todos os pedidos vão para /v1/v1/messages e falham com um erro 404.
- ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY?
- Qualquer uma funciona com uma chave AIGROW. O ANTHROPIC_AUTH_TOKEN é enviado como cabeçalho Bearer, sem pedir confirmação. O ANTHROPIC_API_KEY é enviado como x-api-key e, numa sessão interativa, o Claude Code pede-lhe que o aprove uma vez.
- Posso usá-lo só num projeto?
- Sim. Coloque o bloco env em .claude/settings.local.json na raiz do projeto. O Claude Code lê-o apenas nesse projeto, e o ficheiro não se destina a ser enviado para o repositório.
- O Claude Agent SDK funciona da mesma forma?
- Sim, com as mesmas variáveis passadas na sua opção env. Em TypeScript, essa opção substitui o ambiente, por isso inclua process.env nela com spread; em Python, ClaudeAgentOptions(env=...) acrescenta ao ambiente existente.
- Como volto à minha subscrição do Claude?
- Remova as variáveis do seu shell e do bloco env de settings.json e depois inicie o claude novamente. Sem URL base definido, ele usa o seu login do Claude.
Fontes: Claude Code LLM gateway · Claude Code Connect a gateway · Claude Code Settings. Consultado em 21 de outubro de 2026.
Configurar outra ferramenta
- ClineProtocolo OpenAI
O fornecedor OpenAI Compatible, quatro campos no ecrã de definições.
- Roo CodeProtocolo OpenAI
O fornecedor OpenAI Compatible, os mesmos campos do Cline.
- Kilo CodeProtocolo OpenAI
Um fornecedor personalizado no separador Providers; a lista de modelos preenche-se sozinha.
- ContinueProtocolo OpenAI
Uma entrada models no config.yaml, com provider openai e um apiBase.
- AiderProtocolo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, depois openai/ antes do ID do modelo.
- OpenCodeProtocolo OpenAI
Um bloco provider no opencode.json e a chave através de /connect.
- ZedProtocolos Anthropic e OpenAI
Um fornecedor compatível com Anthropic para Claude, um compatível com OpenAI para GPT e Grok.
- GooseProtocolo OpenAI
O fornecedor OpenAI com OPENAI_HOST, ou um ficheiro de fornecedor personalizado.
- Vercel AI SDKProtocolos Anthropic e OpenAI
O fornecedor OpenAI Compatible para todos os modelos, ou o fornecedor Anthropic para o Claude.
- OpenAI Agents SDKProtocolo OpenAI
O seu próprio cliente AsyncOpenAI, mudado para chat completions, com o tracing desativado.
- LangChainProtocolos Anthropic e OpenAI
ChatOpenAI com base_url para todos os modelos, ou ChatAnthropic para o Claude.
O guia da API inclui os SDKs, o curl, os endpoints e os limites de utilização.
Cole o bloco e o Claude Code passa a funcionar com o seu crédito.
Compre um pacote de crédito, resgate o código do seu email em Acesso à API, crie uma chave e coloque-a no lugar de ag_your_key_here.