Claude Code verbindet sich nicht, obwohl der Browser funktioniert? Terminal-Proxy einrichten

Claude öffnet sich im Browser, doch claude im Terminal läuft in einen Timeout oder schließt die Anmeldung nicht ab? Prüfen Sie zuerst, ob das Terminal den Proxy überhaupt nutzt. Browser-Erweiterung, Systemproxy und Shell-Umgebung sind getrennte Einstellungen.

Diese Anleitung gilt für die eigenständige Claude-Code-CLI, nicht für Claude Desktop. Ein berechtigtes Konto und ein offiziell unterstützter Standort bleiben Voraussetzung. Eine funktionierende Verbindung ersetzt diese Bedingungen nicht.

Diese temporären Einstellungen gelten für eine im Vordergrund aus diesem Terminal gestartete CLI. Für --bg oder Hintergrundagenten gilt die offizielle separate Konfiguration: Ihr dauerhafter Supervisor übernimmt spätere Shell-Änderungen nicht zuverlässig.

1. Zuerst den Proxy-Client verbinden

Das JMS-Abonnement konfiguriert die Knoten im Client. Anfragen nehmen diesen Weg:

Claude Code → lokaler HTTP/mixed-Listener des Clients → ausgewählter JMS-Knoten → Anthropic-Dienst.

Importieren Sie Ihr aktuelles Abonnement in einen Client, der das tatsächliche Knotenprotokoll unterstützt. JMS hat 2026 Protokolle geändert; ein alter reiner Shadowsocks-Client ist möglicherweise ungeeignet. Lesen Sie zunächst die VLESS/Reality-Fehlersuche oder die Clash-Verge-Anleitung.

Suchen Sie den lokalen HTTP- oder mixed-Port und lassen Sie den Client laufen. Gemeint sind weder der entfernte Serverport noch Abonnement-URL, UUID oder öffentlicher Reality-Schlüssel. Der Listener sollte nur lokal erreichbar sein; eine LAN-Freigabe ist dafür unnötig.

Laut offizieller Netzwerkdokumentation unterstützt Claude Code HTTP/HTTPS-Proxys, jedoch SOCKS nicht direkt. Aktivieren Sie einen HTTP/mixed-Listener oder verwenden Sie einen passenden Client.

2. Den Proxy im startenden Terminal setzen

Nutzen Sie für den ersten Test ein separates Terminal. Prüfen Sie lokal, ob https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY, all_proxy, ALL_PROXY, no_proxy oder NO_PROXY bereits gesetzt sind. Veröffentlichen Sie keine Werte: Proxy-URLs können Passwörter enthalten.

Claude Code verwendet den ersten gesetzten Wert in der Reihenfolge https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY. Ein alter kleingeschriebener Wert kann den neuen großgeschriebenen übersteuern. Andere Werkzeuge behandeln Variablen anders; ALL_PROXY bedeutet nicht, dass Claude SOCKS unterstützt. Bewahren Sie vorhandene Werte privat auf und lösen Sie Konflikte vor dem Überschreiben.

macOS oder Linux: Bash/Zsh

7890 ist nur ein Beispiel. Ersetzen Sie die Zahl vor der Ausführung durch den tatsächlichen HTTP/mixed-Port Ihres Clients:

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

Ersetzen Sie auch hier 7890 durch den tatsächlichen HTTP/mixed-Port. Verwenden Sie PowerShell, nicht die Eingabeaufforderung:

$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:// beschreibt die Verbindung zum lokalen Proxy und macht aus dem HTTPS-Ziel keine unverschlüsselte HTTP-Verbindung. NO_PROXY hält lokale Anfragen direkt, damit etwa der Browser-Anmelderückruf die CLI erreicht.

Die Variablen gelten für dieses Terminal und daraus gestartete Prozesse. Eine laufende Claude-Code-Sitzung liest spätere Shell-Änderungen nicht erneut ein. Beenden Sie sie, setzen Sie die Variablen und starten Sie claude im selben Terminal. Dauerhafte Profileinträge sollten erst nach erfolgreichem Test folgen.

In WSL, Containern oder SSH bezeichnet 127.0.0.1 die Umgebung des Befehls, nicht unbedingt den Rechner mit dem Client. Prüfen Sie die Erreichbarkeit, ohne den Proxy öffentlich freizugeben.

3. Die Verbindung ohne Zugangsdaten testen

Beenden Sie Claude Code und führen Sie den passenden Test im konfigurierten Terminal aus. Er nutzt ausdrücklich den lokalen Proxy und fragt den öffentlichen API-Host ohne API-Schlüssel ab.

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/

Unter Windows vermeidet curl.exe den curl-Alias älterer PowerShell-Versionen:

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/

Der Verbindungsaufbau darf höchstens 10 Sekunden, die gesamte Anfrage höchstens 20 Sekunden dauern. Auch HTTP 401, 403 oder 404 können zeigen, dass eine HTTP-Antwort eingetroffen ist. Das API-Stammverzeichnis ist kein authentifizierter Modellaufruf. Prüfen Sie die Fehlermeldung: Nicht-2xx beweist keinen Proxy-Ausfall, und irgendeine Antwort bestätigt nicht die Kontoberechtigung.

HTTP 000 mit Verbindungsfehler oder Timeout bedeutet, dass keine normale HTTP-Antwort vorlag. Zertifikatsfehler müssen gesondert untersucht werden. Lassen Sie die TLS-Prüfung aktiv: kein -k und keine abgeschaltete Zertifikatskontrolle. Veröffentlichen Sie weder Abonnement-URLs noch Anmeldecodes, Tokens oder private Diagnoseprotokolle.

4. Passend zum Symptom weiterprüfen

Prüfen Sie claude --version, führen Sie claude doctor aus und aktualisieren Sie passend zur Installation nach der offiziellen Anleitung. Versionsfehler, abgelaufene Anmeldungen und Plattformstörungen können wie Netzwerkfehler aussehen.

5. Temporäre Einstellungen entfernen

Falls die Variablen vor dem Test nicht existierten, entfernen Sie nur die hinzugefügten Werte:

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

Dies löscht die aktuellen Werte; überschriebene frühere Werte werden nicht wiederhergestellt. Stellen Sie diese bei Bedarf privat wieder her und starten Sie Claude Code neu. Dauerhafte System- oder Profileinstellungen sind getrennt zu prüfen.

Einen Verbindungsdienst auswählen

JMS liefert Knoten für einen kompatiblen Client; Client und Terminaleinstellungen verbinden die CLI damit. Ein Anthropic-Abonnement, Kontozulassung oder Schutz vor Sperrung sind nicht enthalten oder garantiert. Ein lokaler Proxy verändert auch nicht den Ausgang eines cloudbasierten MCP-Connectors.

Vergleichen Sie die Tarife und die Client-Downloads mit Ihren Geräten und aktuellen Protokollen. Bei passendem Bedarf können Sie Just My Socks ansehen.

Affiliate-Hinweis: Bei einem Kauf über diesen Link können wir eine Provision erhalten.