O Claude Code não liga, mas o navegador funciona? Configurar o proxy do terminal

O Claude abre no navegador, mas claude no terminal excede o tempo de espera ou não conclui a autenticação? Confirme primeiro se o terminal utiliza o proxy. A extensão do navegador, o proxy do sistema e as variáveis da shell são definições diferentes.

Este guia destina-se à CLI autónoma do Claude Code, não ao Claude Desktop. Tem de cumprir as condições oficiais da conta e da região suportada; uma ligação funcional não altera esses requisitos.

Estas definições temporárias aplicam-se à 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 fiável alterações posteriores da shell.

1. Ligar primeiro o cliente

A subscrição JMS configura os nós no cliente. Os pedidos seguem este percurso:

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

Importe a subscrição atual num cliente compatível com o protocolo efetivo dos nós. A JMS alterou protocolos em 2026; um cliente antigo apenas para Shadowsocks pode deixar de servir. Consulte a resolução de problemas VLESS/Reality ou o guia do Clash Verge.

Identifique a porta de escuta HTTP ou mixed local e mantenha o cliente em execução. Não se trata da porta do servidor remoto, do URL da subscrição, do UUID ou da chave pública Reality. Restrinja a escuta ao computador local; não precisa de ativar a partilha na LAN.

A documentação oficial de rede indica que o Claude Code suporta proxies HTTP/HTTPS, mas não SOCKS diretamente. Ative a escuta HTTP/mixed ou escolha um cliente compatível.

2. Configurar o terminal que irá iniciar o Claude

Use um terminal separado para o primeiro teste. Confirme 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: os URL de proxy podem conter palavras-passe.

O Claude Code escolhe o primeiro valor definido na ordem https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. Um valor antigo em minúsculas pode prevalecer sobre o novo em maiúsculas. Outros programas aplicam regras diferentes; ALL_PROXY não faz o Claude aceitar SOCKS. Guarde os valores antigos em privado e resolva conflitos antes de os substituir.

macOS ou Linux: Bash/Zsh

7890 é apenas um exemplo. Substitua-o pela porta HTTP/mixed real do cliente antes de executar:

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

Substitua também 7890 pela porta HTTP/mixed real. Execute no PowerShell, não na Linha de Comandos:

$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:// descreve a ligação ao proxy local; não transforma o HTTPS do destino em HTTP sem encriptação. NO_PROXY mantém diretos os pedidos locais, ajudando o retorno da autenticação do navegador a chegar à CLI.

As variáveis aplicam-se ao terminal atual e aos processos que inicia. Uma sessão do Claude Code já aberta não relê alterações posteriores da shell. Termine-a, configure as variáveis e execute claude no mesmo terminal. Só torne as definições permanentes depois de o teste funcionar.

Em WSL, contentores ou SSH, 127.0.0.1 identifica o ambiente que executa o comando, que pode não ser o computador do cliente. Confirme a acessibilidade sem expor o proxy à Internet.

3. Testar sem enviar credenciais

Saia do Claude Code e execute o teste no terminal configurado. Este usa explicitamente o proxy local e contacta o anfitrião público da API, sem 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, utilize curl.exe para evitar o alias curl de 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 tempo de ligação é limitado a 10 segundos e o pedido completo a 20 segundos. HTTP 401, 403 ou 404 podem significar que chegou uma resposta HTTP; a raiz da API não é uma chamada autenticada ao modelo. Leia o erro: um código fora de 2xx não prova uma falha do proxy, e uma resposta não confirma os direitos da conta.

HTTP 000 com erro ou tempo esgotado significa que não chegou uma resposta HTTP normal. Investigue os erros de certificado separadamente. Mantenha a verificação TLS: não acrescente -k nem desative a validação. Não publique URL de subscrição, códigos de autenticação, tokens ou registos privados.

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

Consulte claude --version, execute claude doctor e atualize pelo método adequado à instalação no guia oficial. Erros de versão, autenticação expirada e incidentes da plataforma podem parecer falhas de rede.

5. Remover as definições temporárias

Se estas variáveis não existiam antes do teste, elimine 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

Isto elimina os valores atuais; não recupera os valores antigos que foram substituídos. Reponha-os em privado, se necessário, e reinicie o Claude Code. As definições permanentes do sistema ou dos perfis exigem verificação separada.

Escolher um serviço de ligação

A JMS fornece nós para um cliente compatível; o cliente e o terminal ligam-nos à CLI. Não fornece uma subscrição Anthropic nem garante aprovação de contas ou ausência de suspensão. Um proxy local também não altera a saída de conectores MCP alojados na nuvem.

Compare os planos e o guia de transferências com os seus dispositivos e protocolos atuais. Se esta configuração lhe for útil, consulte a Just My Socks.

Divulgação de afiliação: podemos receber uma comissão se efetuar uma compra através desta ligação.