Source: https://aiprimetech.io/pt/docs/guides/claude-code/

[Início](/pt/) / [Documentação](/pt/docs/) / Claude Code 

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

 Copiar página [ Ver como Markdown](/pt/docs/guides/claude-code.md) [ Perguntar ao ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Perguntar no Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/guides/claude-code.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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. 

A armadilha: se ANTHROPIC_API_KEY estiver definida no seu shell, o Claude Code poderá dar preferência a ela e cobrar o uso dessa chave, ignorando silenciosamente tanto a chave do gateway quanto qualquer assinatura Pro/Max. Execute echo $ANTHROPIC_API_KEY — se houver qualquer saída, execute unset ANTHROPIC_API_KEY antes de iniciar. 

## 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](/pt/docs/getting-started/models/) funciona. Opus para refatorações difíceis, Sonnet para o trabalho diário — consulte [Controle de custos](/pt/docs/guides/cost-control/) 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. 

[Servidores MCPDê ferramentas reais ao Claude Code](/pt/docs/guides/mcp-servers/)[Controle de custosOnde os tokens dos agentes são gastos](/pt/docs/guides/cost-control/)[Solução de problemasQuando nada acontece](/pt/docs/guides/troubleshooting/) 

[AnteriorVisão e entrada de imagens](/pt/docs/api-reference/vision/)[PróximoCursor](/pt/docs/guides/cursor/)