Source: https://aiprimetech.io/pt/guides/claude-code-configuration-network/ [Início](/pt/) › [Claude Code](/pt/claude-code/) › [Guia em chinês](/pt/claude-code/) › Configuração e proxy [Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/pt/claude-code/) Atualizado em 11 de outubro de 2026 # Configuração do Claude Code: como usar na China, proxy e endereço da API, variáveis de ambiente comuns Toda a configuração do Claude Code se resume a algumas variáveis de ambiente e dois arquivos. O ponto mais importante para usuários na China: ele permite personalizar o endereço da API, portanto não é necessário usar VPN nem ter uma conta estrangeira; basta apontar o endereço para um gateway compatível com a interface da Anthropic. ## Pontos principais - ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY: aponte para o gateway; duas linhas bastam, sem necessidade de VPN. - HTTPS_PROXY / HTTP_PROXY: configure apenas se a sua rede realmente precisar de um proxy. - ANTHROPIC_DEFAULT_SONNET_MODEL e outras variáveis fixam um modelo específico para cada categoria. - /status mostra o endereço, a chave e o modelo atualmente em uso — consulte isso primeiro ao investigar a configuração. ## 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. ## Experimente gratuitamente primeiro Novas contas que usarem o código promocional CLAUDECODE no cadastro recebem $5 de saldo de API, sem precisar vincular um cartão — suficiente para usar o Claude Code durante uma noite. Os mesmos modelos Claude, com apenas duas linhas de variáveis de ambiente para fazer a troca. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Cadastre-se com o código promocional CLAUDECODE](/register?promo=CLAUDECODE) ## Perguntas frequentes É possível usar o Claude Code na China? Sim. O Claude Code permite personalizar o endereço da API (ANTHROPIC_BASE_URL). Ao apontar para este gateway, é possível conectar-se diretamente de redes na China, sem VPN, conta estrangeira ou cartão bancário.Como configurar um proxy no Claude Code? Basta definir as variáveis de ambiente HTTPS_PROXY / HTTP_PROXY. Porém, depois de apontar para o gateway, a maioria dos usuários não precisa de proxy.É preciso acrescentar /v1 a ANTHROPIC_BASE_URL? Não. O SDK acrescenta /v1/messages automaticamente; uma camada extra resulta em 404. ## Execute o Claude Code no gateway Os mesmos modelos, duas linhas de variáveis de ambiente, créditos recarregados por 7.69231 vezes o valor nominal, ou escolha um plano ilimitado. Novas contas que usarem o código promocional CLAUDECODE recebem $5 de saldo de API.[Obter chave de API](/register?promo=CLAUDECODE) [Ver planos](/pt/plans/) 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. ## Mais guias do Claude Code [Como usar o Claude Code: da instalação ao uso diário](/pt/claude-code/)[Guia de instalação do Claude Code: download, instalação e verificação, com três métodos à escolha](/pt/claude-code/install/)[Como usar o Claude Code: da primeira sessão ao fluxo de trabalho diário](/pt/claude-code/tutorial/)[Preços do Claude Code: como funciona a cobrança, se é possível usar gratuitamente, como se cadastrar e economizar](/pt/claude-code/pricing/)