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.5claude-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.5claude-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.1claude-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"

Uma chave válida devolve a lista:

{
  "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"

Uma configuração correta imprime a resposta e termina:

ready

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