← Torna alla base di conoscenza

Claude Code non si connette ma il browser funziona? Configura il proxy del terminale

Sun Oct 25 2026

Claude si apre nel browser, ma claude nel terminale va in timeout o non completa l’accesso? Controlla prima che il terminale utilizzi davvero il proxy. Estensione del browser, proxy di sistema e variabili della shell sono impostazioni diverse.

Questa guida riguarda la CLI autonoma di Claude Code, non Claude Desktop. Restano necessari un account idoneo e una posizione ufficialmente supportata: la connessione non modifica questi requisiti.

Queste impostazioni temporanee valgono per la CLI avviata in primo piano da questo terminale. Per --bg o gli agenti in background, segui la configurazione ufficiale dedicata: il supervisore persistente non eredita in modo affidabile le modifiche successive della shell.

1. Collegare prima il client

L’abbonamento JMS configura i nodi del client. Il percorso effettivo delle richieste è:

Claude Code → porta HTTP/mixed locale del client → nodo JMS selezionato → servizio Anthropic.

Importa l’abbonamento attuale in un client compatibile con il protocollo effettivo dei nodi. JMS ha cambiato protocolli nel 2026; non presumere che un vecchio client solo Shadowsocks funzioni ancora. Consulta la guida VLESS/Reality o la configurazione di Clash Verge.

Individua la porta di ascolto HTTP o mixed locale e lascia il client in esecuzione. Non è la porta del server remoto, l’URL dell’abbonamento, l’UUID o la chiave pubblica Reality. Limita l’ascolto al computer locale: non serve abilitare la condivisione LAN.

La documentazione di rete ufficiale conferma il supporto HTTP/HTTPS, ma non SOCKS diretto. Abilita un listener HTTP/mixed o scegli un client compatibile.

2. Impostare il terminale che avvierà Claude

Per il primo test usa un terminale separato. Controlla localmente se esistono https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY, no_proxy o NO_PROXY. Non pubblicarne i valori: gli URL dei proxy possono contenere password.

Claude Code sceglie il primo valore impostato nell’ordine https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. Un vecchio valore minuscolo può prevalere sul nuovo maiuscolo. Altri strumenti seguono regole diverse; ALL_PROXY non rende SOCKS compatibile con Claude. Conserva privatamente i valori precedenti e risolvi i conflitti prima di sovrascriverli.

macOS o Linux: Bash/Zsh

7890 è solo un esempio. Sostituiscilo con la porta HTTP/mixed effettiva del client prima di eseguire:

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

Sostituisci anche qui 7890 con la porta HTTP/mixed effettiva. Usa PowerShell, non il Prompt dei comandi:

$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:// descrive il collegamento al proxy locale e non converte l’HTTPS della destinazione in HTTP in chiaro. NO_PROXY mantiene dirette le richieste locali, aiutando il callback del browser a raggiungere la CLI.

Le variabili valgono per questo terminale e i processi che avvia. Claude Code già aperto non rilegge le modifiche successive della shell. Esci, imposta le variabili e riavvia claude nello stesso terminale. Non modificare subito i profili permanenti.

In WSL, container o SSH, 127.0.0.1 indica l’ambiente che esegue il comando, non necessariamente il computer del client. Verifica la raggiungibilità senza esporre il proxy su Internet.

3. Verificare senza inviare credenziali

Esci da Claude Code ed esegui il test nel terminale configurato. Usa esplicitamente il proxy locale e contatta l’host API pubblico senza inviare chiavi 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/

Su Windows usa curl.exe, evitando l’alias curl delle versioni meno recenti di 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/

Il limite è di 10 secondi per la connessione e 20 per l’intera richiesta. HTTP 401, 403 o 404 possono indicare che è arrivata una risposta HTTP: la radice dell’API non è una chiamata autenticata al modello. Leggi l’errore: un codice non-2xx non dimostra da solo un guasto del proxy e una risposta non certifica l’accesso dell’account.

HTTP 000 con errore o timeout indica l’assenza di una normale risposta HTTP. Gli errori di certificato richiedono un controllo distinto. Mantieni la verifica TLS: non aggiungere -k e non disattivare i controlli. Non condividere pubblicamente URL di abbonamento, codici di accesso, token o registri privati.

4. Scegliere il controllo in base al sintomo

SintomoControllo successivo
Connessione locale rifiutataClient aperto, porta HTTP/mixed e host corretti
Timeout o connessione reimpostataRegistri del client, nodo, DNS, firewall e percorso
Accesso dal browser riuscito, CLI bloccataCallback locale, NO_PROXY, riavvio e guida ufficiale all’accesso
HTTP 401/403 in una richiesta autenticataMetodo di accesso, credenziali, criteri dell’organizzazione e regione supportata
HTTP 429 o limite di utilizzoQuota e frequenza delle richieste; cambiare nodo non aumenta la quota
Più dispositivi falliscono insiemeVerificare lo stato di Anthropic prima di cambiare impostazioni

Controlla claude --version, esegui claude doctor e aggiorna secondo il metodo di installazione nella guida ufficiale. Bug, accessi scaduti e incidenti della piattaforma possono sembrare guasti di rete.

5. Rimuovere le impostazioni temporanee

Se le variabili non esistevano prima del test, rimuovi solo i valori aggiunti:

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

Questo elimina i valori attuali, senza ripristinare quelli precedenti sovrascritti. Ripristinali privatamente se necessario e riavvia Claude Code. Le impostazioni permanenti di sistema o dei profili vanno controllate separatamente.

Scegliere un servizio di connessione

JMS offre nodi a un client compatibile; client e terminale collegano poi la CLI. Non fornisce un abbonamento Anthropic né garantisce approvazione dell’account o assenza di sospensioni. Il proxy locale non cambia l’uscita dei connettori MCP ospitati nel cloud.

Valuta i piani e la guida ai download in base a dispositivi e protocolli attuali. Se la configurazione fa al caso tuo, scopri Just My Socks.

Affiliazione: potremmo ricevere una commissione per gli acquisti effettuati tramite questo link.