Configuração do Claude Code: como usar na China, proxy e endereço da API, variáveis de ambiente comuns

Uso na China: aponte para o gateway, sem VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Assim como o SDK oficial, o Claude Code lê estas duas variáveis. As solicitações são enviadas ao gateway em vez de api.anthropic.com, permitindo conexão direta a partir de redes na China. Informe apenas o domínio, sem /v1. Após configurar, reabra o terminal e, dentro da sessão, use /status para confirmar. A extensão do VS Code e o aplicativo para desktop leem o ambiente do shell a partir do qual foram iniciados. Depois de alterar a configuração, feche completamente o editor e inicie-o a partir de um novo terminal.

Quando é necessário usar um proxy

Somente quando a conexão da sua rede com o próprio gateway for instável. A configuração é igual à de outras ferramentas de linha de comando:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Se /login apresentar tempo limite excedido no login OAuth ("tempo limite de 15000ms excedido"), provavelmente é um problema de proxy ou DNS; fazer login com uma chave de API permite dispensar completamente o OAuth.

Configuração de modelos

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

O Claude Code trabalha com categorias (Sonnet / Opus / Haiku); estas três variáveis determinam qual modelo específico corresponde a cada categoria. A categoria Haiku é mais importante do que parece: o Claude Code a usa para pequenas tarefas em cada sessão, e apontá-la para um modelo barato pode gerar uma boa economia. O gateway oferece atualmente 33 IDs de modelos Claude, que podem ser selecionados em/model .

Onde ficam os arquivos de configuração

• CLAUDE.md(na raiz do projeto) — memória do projeto: comandos de compilação e teste, convenções;CLAUDE.local.md contém anotações pessoais e não é incluído no repositório.
• .claude/settings.json(projeto) / ~/.claude/settings.json(global) — permissões, hooks, variáveis de ambiente, statusLine.
• .claude/agents/ — definições de subagentes;.claude/skills/ e ~/.claude/skills/ — habilidades.
• .mcp.json — configuração de servidores MCP compartilhada pelo projeto.

Solução de erros de configuração

• 404 e os logs mostram /v1/v1/messages → foi acrescentado indevidamente a BASE_URL /v1。
• 401 / chave inválida → a chave não corresponde ao endereço: o endereço do gateway deve ser usado com uma chave do gateway.
• Você fez login no Max, mas está sendo cobrado por token → ainda existe ANTHROPIC_API_KEY no ambiente; a chave tem prioridade sobre o login. Se não quiser usá-la, remova-a com unset.
• Modelo inexistente → esse ID não está na lista /v1/models do endpoint atual.
• Após alterar settings.json, o programa fecha ao iniciar → erro de sintaxe em JSON (vírgula extra); verifique com uma ferramenta de validação.

Custos

Ao apontar para o gateway, a cobrança também muda: os créditos são vendidos por 7.69231 vezes o valor nominal, e $13 rendem $100 em créditos; para uso intensivo, há planos ilimitados a partir de $0.80. Veja os detalhes na página de preços.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.