Claude Code unterstützt Standard-HTTP/HTTPS-Proxy-Konfigurationen über Umgebungsvariablen. Dies ermöglicht es Ihnen, den gesamten Claude Code-Verkehr über die Proxy-Server Ihrer Organisation zu leiten, um Sicherheit, Compliance und Überwachung zu gewährleisten.

Grundlegende Proxy-Konfiguration

Umgebungsvariablen

Claude Code respektiert Standard-Proxy-Umgebungsvariablen:

# HTTPS-Proxy (empfohlen)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP-Proxy (falls HTTPS nicht verfügbar)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Code unterstützt derzeit nicht die NO_PROXY-Umgebungsvariable. Der gesamte Verkehr wird über den konfigurierten Proxy geleitet.

Claude Code unterstützt keine SOCKS-Proxies.

Authentifizierung

Grundlegende Authentifizierung

Wenn Ihr Proxy eine grundlegende Authentifizierung erfordert, fügen Sie die Anmeldedaten in die Proxy-URL ein:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

Vermeiden Sie es, Passwörter in Skripten fest zu kodieren. Verwenden Sie stattdessen Umgebungsvariablen oder sichere Anmeldedatenspeicherung.

Für Proxies, die erweiterte Authentifizierung (NTLM, Kerberos, etc.) erfordern, erwägen Sie die Verwendung eines LLM Gateway-Dienstes, der Ihre Authentifizierungsmethode unterstützt.

SSL-Zertifikatsprobleme

Wenn Ihr Proxy benutzerdefinierte SSL-Zertifikate verwendet, können Zertifikatsfehler auftreten.

Stellen Sie sicher, dass Sie den korrekten Zertifikatsbündel-Pfad festlegen:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

Netzwerkzugangsanforderungen

Claude Code benötigt Zugang zu den folgenden URLs:

  • api.anthropic.com - Claude API-Endpunkte
  • statsig.anthropic.com - Telemetrie und Metriken
  • sentry.io - Fehlerberichterstattung

Stellen Sie sicher, dass diese URLs in Ihrer Proxy-Konfiguration und Firewall-Regeln auf der Whitelist stehen. Dies ist besonders wichtig bei der Verwendung von Claude Code in containerisierten oder eingeschränkten Netzwerkumgebungen.

Zusätzliche Ressourcen