Claude Code não conecta, mas o navegador funciona? Configure o proxy do terminal

O Claude abre no navegador, mas claude no terminal dá tempo limite ou não conclui o login? Primeiro verifique se o terminal usa o proxy. Extensão do navegador, proxy do sistema e variáveis do shell são configurações diferentes.

Este guia trata da CLI independente do Claude Code, não do Claude Desktop. Você precisa cumprir os requisitos oficiais de conta e região atendida; conectar à rede não altera essas condições.

Estas configurações temporárias valem para a CLI iniciada em primeiro plano neste terminal. Para --bg ou agentes em segundo plano, siga a configuração oficial específica: o supervisor persistente não herda de forma confiável mudanças posteriores no shell.

1. Conecte o cliente primeiro

A assinatura JMS configura os nós no cliente. As solicitações percorrem este caminho:

Claude Code → porta HTTP/mixed local do cliente → nó JMS selecionado → serviço da Anthropic.

Importe sua assinatura atual em um cliente compatível com o protocolo real dos nós. A JMS mudou protocolos durante 2026; um cliente antigo exclusivo para Shadowsocks pode não funcionar. Consulte o guia VLESS/Reality ou a configuração do Clash Verge.

Encontre a porta de escuta HTTP ou mixed local e mantenha o cliente aberto. Não é a porta do servidor remoto, a URL da assinatura, o UUID nem a chave pública Reality. Restrinja a escuta ao computador local; não é preciso ativar o compartilhamento na LAN.

Segundo a documentação oficial de rede, o Claude Code aceita proxies HTTP/HTTPS, mas não SOCKS diretamente. Ative a escuta HTTP/mixed ou use outro cliente compatível.

2. Configure o terminal que vai iniciar o Claude

Faça o primeiro teste em um terminal separado. Confira localmente se existem https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY, no_proxy ou NO_PROXY. Não publique os valores: URLs de proxy podem incluir senhas.

O Claude Code usa o primeiro valor definido na ordem https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. Uma variável antiga em minúsculas pode prevalecer sobre a nova em maiúsculas. Outros programas tratam isso de outra maneira; ALL_PROXY não faz o Claude aceitar SOCKS. Guarde os valores anteriores em privado e resolva conflitos antes de sobrescrevê-los.

macOS ou Linux: Bash/Zsh

7890 é apenas um exemplo. Antes de executar, troque pela porta HTTP/mixed real do cliente:

JMS_PROXY_PORT=7890
export HTTPS_PROXY="http://127.0.0.1:${JMS_PROXY_PORT}"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,::1"
claude

Windows: PowerShell

Troque também 7890 pela porta HTTP/mixed real. Execute no PowerShell, não no Prompt de Comando:

$JmsProxyPort = 7890
$env:HTTPS_PROXY = "http://127.0.0.1:$JmsProxyPort"
$env:HTTP_PROXY = $env:HTTPS_PROXY
$env:NO_PROXY = "localhost,127.0.0.1,::1"
claude

http:// indica a conexão com o proxy local; não transforma o HTTPS do destino em HTTP sem criptografia. NO_PROXY mantém as solicitações locais diretas, ajudando o retorno do login no navegador a chegar à CLI.

As variáveis valem para o terminal atual e os processos iniciados nele. Uma sessão já aberta do Claude Code não relê mudanças posteriores no shell. Saia, configure e execute claude novamente no mesmo terminal. Só pense em salvar no perfil depois que o teste funcionar.

Em WSL, contêineres ou SSH, 127.0.0.1 é o ambiente que executa o comando, que pode não ser o computador do cliente. Verifique a conectividade sem expor o proxy à Internet.

3. Teste sem fornecer credenciais

Saia do Claude Code e execute o teste no terminal configurado. Ele usa explicitamente o proxy local e solicita o host público da API sem enviar chave de API.

macOS/Linux:

curl --proxy "$HTTPS_PROXY" --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output /dev/null --silent --show-error --write-out 'HTTP %{http_code}\n' https://api.anthropic.com/

No Windows use curl.exe, evitando o alias curl das versões antigas do PowerShell:

curl.exe --proxy $env:HTTPS_PROXY --noproxy "localhost,127.0.0.1,::1" --connect-timeout 10 --max-time 20 --output NUL --silent --show-error --write-out "HTTP %{http_code}\n" https://api.anthropic.com/

O limite é de 10 segundos para conectar e 20 para a solicitação inteira. HTTP 401, 403 ou 404 ainda podem indicar uma resposta HTTP; a raiz da API não é uma chamada autenticada ao modelo. Leia o erro: um retorno fora de 2xx não prova sozinho que o proxy falhou, e uma resposta não comprova que a conta tem acesso.

HTTP 000 com erro ou tempo limite significa que não chegou uma resposta HTTP normal. Erros de certificado exigem investigação separada. Mantenha a validação TLS: não acrescente -k nem desative a verificação. Não publique links de assinatura, códigos de login, tokens ou registros privados.

4. Escolha a próxima verificação pelo sintoma

Confira claude --version, execute claude doctor e atualize conforme seu método de instalação no guia oficial. Bugs de versão, login expirado e incidentes da plataforma podem parecer falhas de rede.

5. Remova as configurações temporárias

Se as variáveis não existiam antes do teste, remova apenas os valores adicionados:

Bash/Zsh:

unset HTTPS_PROXY HTTP_PROXY NO_PROXY JMS_PROXY_PORT

PowerShell:

Remove-Item Env:HTTPS_PROXY, Env:HTTP_PROXY, Env:NO_PROXY -ErrorAction SilentlyContinue
Remove-Variable JmsProxyPort -ErrorAction SilentlyContinue

Isso apaga os valores atuais; não restaura os valores anteriores sobrescritos. Recupere-os em privado se necessário e reinicie o Claude Code. Configurações permanentes do sistema ou do perfil precisam de revisão separada.

Escolhendo o serviço de conexão

A JMS fornece nós para um cliente compatível; cliente e terminal conectam esses nós à CLI. Não fornece assinatura da Anthropic nem garante aprovação de conta ou ausência de suspensão. O proxy local também não muda a saída de conectores MCP hospedados na nuvem.

Compare os planos e o guia de downloads com seus dispositivos e protocolos atuais. Se a configuração atender ao que você precisa, conheça a Just My Socks.

Divulgação de afiliados: podemos receber uma comissão se você comprar por esse link.