Claude Code

Direcione o agente CLI da Anthropic para o gateway com duas variáveis de ambiente — e evite a armadilha que cobra silenciosamente da chave errada.

O Claude Code lê seu endpoint do ambiente, portanto não é necessário alterar o código. Esta é a configuração mais comum no gateway.

Configuração

Copyexport ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
claude

Isso é toda a integração. Adicione as duas linhas a ~/.zshrc ou ~/.bashrc para torná-la permanente.

Configuração por projeto

Para limitar o gateway a um repositório em vez de todo o shell, use um arquivo de configurações:

Copy{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aiprimetech.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Coloque-o em .claude/settings.json no projeto, ou em ~/.claude/settings.json para definir um padrão para todo o usuário. Adicione .claude/settings.json para .gitignore — ele contém uma chave.

Como verificar se funcionou

Copy"c"># 1. the gateway answers and the key is valid
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

"c"># 2. start Claude Code and confirm usage appears in your dashboard
claude

Se as requisições não aparecerem no painel, elas estão indo para outro lugar — quase sempre por causa da armadilha de ANTHROPIC_API_KEY descrita acima.

Como escolher um modelo

Copyclaude --model claude-opus-4-8

Qualquer ID de Modelos funciona. Opus para refatorações difíceis, Sonnet para o trabalho diário — consulte Controle de custos para entender por que essa escolha tem tanto peso na sua conta.

Como manter o custo sob controle

• O Claude Code reenvia o conteúdo dos arquivos e os resultados das ferramentas a cada turno — sessões longas ficam mais caras de forma não linear. Use /clear entre tarefas sem relação entre si.
• Saídas grandes de ferramentas (uma consulta com 500 linhas, um log completo de compilação) tornam-se contexto permanente. Filtre a saída com head sempre que possível.
• O cache de prompts ajuda mais neste caso porque o prompt do sistema e as definições das ferramentas permanecem estáveis entre os turnos.