Proxys für VS Code: Einrichtung der Synchronisierung von Erweiterungen und Einstellungen über Unternehmens- oder Wohnproxies

```html

Visual Studio Code kann Erweiterungen, Einstellungen und Snippets zwischen Geräten synchronisieren – aber all das funktioniert über Microsoft-Server, die oft hinter Unternehmensfirewalls, in Büros mit strenger Filterung oder aus Regionen mit eingeschränktem Zugang nicht verfügbar sind. Das Ergebnis – der Extensions Marketplace hängt, Settings Sync verbindet sich nicht, Updates werden nicht heruntergeladen. In diesem Artikel werden wir besprechen, wie man den Proxy in VS Code richtig einrichtet, damit all diese Probleme ein für alle Mal verschwinden.

Warum VS Code ohne Proxy in einigen Netzwerken nicht funktioniert

Visual Studio Code ist nicht nur ein Texteditor. Unter der Haube greift er ständig auf externe Server zu: lädt Erweiterungsupdates von marketplace.visualstudio.com herunter, synchronisiert Einstellungen über vscode.dev und die Server von GitHub/Microsoft Account, überprüft Updates des Editors selbst und sendet Telemetrie (sofern nicht deaktiviert).

All diese Anfragen erfolgen über standardmäßige HTTPS-Verbindungen. Und hier beginnen die Probleme:

• Unternehmensnetzwerke – Systemadministratoren blockieren den direkten Zugang zum Internet und verlangen, dass der gesamte Datenverkehr über einen Unternehmensproxy-Server geleitet wird. VS Code „weiß“ davon nichts und kann sich einfach nicht verbinden.
• Bürofirewalls mit Whitelist – nur bestimmte Domains sind erlaubt, und marketplace.visualstudio.com gehört nicht zu dieser Liste.
• Regionale Einschränkungen – in einigen Ländern und Regionen ist der Zugang zu Microsoft-Diensten eingeschränkt oder instabil. Ein Proxy mit einer IP der gewünschten Region löst das Problem.
• VPN-Konflikte – einige Unternehmens-VPNs fangen den Datenverkehr ab, leiten ihn jedoch nicht korrekt weiter, wodurch VS Code die Verbindung zum Marketplace verliert.
• Instabiles Internet + Proxy mit Caching – ein Proxy-Server kann Erweiterungspakete cachen und die Installation in Teams mit langsamen Verbindungen beschleunigen.

Die Symptome all dieser Probleme sind ähnlich: Erweiterungen werden nicht installiert oder hängen beim Laden, Settings Sync gibt einen Authentifizierungsfehler oder „konnte nicht verbinden“ aus, VS Code-Updates werden nicht heruntergeladen, und im Ausgabefenster sind Fehler wie ECONNREFUSED oder ETIMEDOUT sichtbar.

Wie VS Code Proxy verarbeitet: Was wichtig ist zu wissen

VS Code basiert auf Electron, das die Chromium-Engine für Netzwerk-Anfragen verwendet. Das bedeutet, dass die Proxy-Einstellungen ähnlich wie im Browser funktionieren – der Editor unterstützt HTTP-, HTTPS- und SOCKS5-Proxys.

Es ist wichtig, die Hierarchie zu verstehen, nach der VS Code nach Proxy-Einstellungen sucht:

1. Systemproxy-Einstellungen – wenn in Windows/macOS/Linux ein Systemproxy eingerichtet ist, wird VS Code ihn automatisch übernehmen (Parameter http.systemProxy).
2. Umgebungsvariablen – HTTP_PROXY, HTTPS_PROXY, NO_PROXY – der Standardweg für Linux/macOS.
3. Einstellungen in settings.json – explizite Angabe des Proxys über die Parameter http.proxy und verwandte Optionen.
4. Command-Line-Argumente – VS Code kann direkt mit Proxy-Flags gestartet werden.

Priorität: explizite Einstellungen in settings.json überschreiben Umgebungsvariablen, die wiederum die Systemeinstellungen überschreiben. Wenn etwas nicht funktioniert – überprüfen Sie in dieser Reihenfolge.

Proxy über settings.json einrichten: Schritt für Schritt

Dies ist der zuverlässigste und empfohlene Weg. Die Einstellungen in settings.json gelten global für alle Netzwerk-Anfragen von VS Code.

Schritt 1: Öffnen Sie settings.json

Drücken Sie Ctrl+Shift+P (oder Cmd+Shift+P auf dem Mac), geben Sie „Open User Settings (JSON)“ ein und wählen Sie diesen Punkt aus. Die Datei mit den Benutzereinstellungen öffnet sich.

Schritt 2: Fügen Sie die Proxy-Parameter hinzu

Fügen Sie die erforderlichen Zeilen innerhalb des JSON-Objekts ein. Beispiele für verschiedene Proxy-Typen:

HTTP/HTTPS-Proxy (ohne Authentifizierung):

{
  "http.proxy": "http://192.168.1.100:3128",
  "http.proxyStrictSSL": false
}

HTTP/HTTPS-Proxy mit Benutzername und Passwort:

{
  "http.proxy": "http://username:password@proxy-host:3128",
  "http.proxyStrictSSL": false
}

SOCKS5-Proxy:

{
  "http.proxy": "socks5://username:password@proxy-host:1080",
  "http.proxyStrictSSL": false
}

Schritt 3: Verstehen Sie die Parameter

Parameter	Wert	Wann zu verwenden
http.proxy	Proxy-URL	Hauptparameter, erforderlich
http.proxyStrictSSL	true / false	false – wenn der Proxy ein selbstsigniertes Zertifikat verwendet
http.proxyAuthorization	Base64-String	Alternativer Weg zur Übertragung von Benutzername/Passwort
http.noProxy	Liste von Domains	Domains, die den Proxy umgehen sollen (localhost, interne Hosts)
http.systemProxy	on / off / override	Steuerung des Systemproxys (neuer Parameter in VS Code 1.87+)

Schritt 4: Starten Sie VS Code neu

Nach dem Speichern von settings.json schließen Sie VS Code vollständig und öffnen Sie es erneut. Ein partieller Neustart (Reload Window) wendet manchmal die neuen Netzwerkeinstellungen nicht an.

Proxy über Umgebungsvariablen (HTTP_PROXY / HTTPS_PROXY)

Diese Methode ist besonders praktisch auf Linux und macOS sowie in Teams, in denen der Proxy auf Systemebene konfiguriert wird und für alle Entwicklungstools gelten soll – nicht nur für VS Code, sondern auch für npm, pip, git usw.

Linux / macOS – permanente Einstellung

Fügen Sie in ~/.bashrc, ~/.zshrc oder ~/.profile Folgendes hinzu:

export HTTP_PROXY="http://username:password@proxy-host:3128"
export HTTPS_PROXY="http://username:password@proxy-host:3128"
export NO_PROXY="localhost,127.0.0.1,*.local,*.internal"

Führen Sie danach source ~/.bashrc aus (oder melden Sie sich erneut an) und starten Sie VS Code aus dem Terminal mit dem Befehl code . – die Variablen werden übernommen.

Windows – über Systemvariablen

Öffnen Sie „Systemeigenschaften“ → „Erweiterte Systemeinstellungen“ → „Umgebungsvariablen“. Fügen Sie die Variablen HTTP_PROXY und HTTPS_PROXY im Abschnitt „Benutzervariablen“ hinzu (oder „Systemvariablen“, um sie für alle Benutzer anzuwenden). Starten Sie VS Code nach dem Speichern neu.

VS Code direkt mit Proxy aus der Kommandozeile starten

Wenn Sie schnell testen müssen, ohne eine dauerhafte Einstellung vorzunehmen:

# Linux/macOS
HTTP_PROXY=http://proxy-host:3128 HTTPS_PROXY=http://proxy-host:3128 code .

# Windows PowerShell
$env:HTTP_PROXY="http://proxy-host:3128"; $env:HTTPS_PROXY="http://proxy-host:3128"; code .

Settings Sync über Proxy: Diagnose und Problemlösung

Settings Sync ist eine integrierte Funktion von VS Code, die Einstellungen, Erweiterungen, Snippets, Tastenkombinationen und Profile zwischen Geräten über ein Microsoft- oder GitHub-Konto synchronisiert. Sie funktioniert über HTTPS-Anfragen an die Server von Microsoft und GitHub, und hier ist der Proxy von entscheidender Bedeutung.

Typische Fehler von Settings Sync über Proxy

Fehler	Ursache	Lösung
„Kann keine Verbindung zum Server herstellen“	Proxy nicht konfiguriert oder blockiert	http.proxy in settings.json konfigurieren
„Authentifizierung fehlgeschlagen“	Proxy fängt das OAuth-Token ab	SSL-Inspektion für *.microsoft.com deaktivieren
„Sync ist aktiviert, synchronisiert aber nicht“	Unternehmensproxy blockiert WebSocket	Proxy mit WebSocket-Unterstützung verwenden
Synchronisierung hängt bei „Synchronisieren...“	Verbindungszeitüberschreitung über langsamen Proxy	Proxy auf schnelleren wechseln

Diagnose über Output

Öffnen Sie View → Output und wählen Sie im Dropdown-Menü „Settings Sync“ aus. Hier sind alle Verbindungsversuche und Fehlercodes sichtbar. Suchen Sie nach Zeilen mit ECONNREFUSED, 407 Proxy Authentication Required oder CERT_UNTRUSTED – jeder dieser Codes weist auf ein spezifisches Problem mit dem Proxy hin.

Wenn Sie den Fehler 407 sehen – der Proxy erfordert eine Authentifizierung, fügen Sie Benutzername und Passwort zur Proxy-URL hinzu. Wenn CERT_UNTRUSTED angezeigt wird – setzen Sie "http.proxyStrictSSL": false oder fügen Sie das Root-Zertifikat der Unternehmens-CA hinzu.

Domains, die für Settings Sync zugänglich sein müssen

Stellen Sie sicher, dass die folgenden Hosts über Ihren Proxy zugänglich sind:

• login.microsoftonline.com – Authentifizierung über Microsoft Account
• github.com – Authentifizierung über GitHub
• api.github.com – GitHub API für die Synchronisierung über Gist
• vscode.dev – Synchronisierungsdienst von VS Code
• *.vscode-cdn.net – CDN für VS Code-Ressourcen

Extensions Marketplace: Warum Erweiterungen nicht installiert werden und wie man das behebt

Der Marketplace von VS Code funktioniert über die Domain marketplace.visualstudio.com und die CDN-Server von Microsoft. Wenn der Proxy richtig konfiguriert ist, funktioniert die Installation von Erweiterungen nahtlos. Aber es gibt einige spezifische Probleme.

Erweiterung wird installiert, funktioniert aber nicht

Viele Erweiterungen führen beim Start eigene Netzwerk-Anfragen durch – beispielsweise um Sprachserver (LSP), binäre Abhängigkeiten oder Datenbankupdates herunterzuladen. Diese Anfragen erfolgen über Node.js innerhalb der Erweiterung und unterliegen den Proxy-Einstellungen von VS Code, aber nur, wenn die Erweiterung mit den Variablen HTTP_PROXY entwickelt wurde.

Wenn die Erweiterung dennoch hinter dem Proxy nicht funktioniert – überprüfen Sie die Dokumentation. Viele beliebte Erweiterungen haben eigene Proxy-Einstellungen. Zum Beispiel:

• Python (Pylance/Pylint) – verwendet die systemweiten Umgebungsvariablen
• ESLint, Prettier – funktionieren lokal, Proxy ist nicht erforderlich
• GitHub Copilot – benötigt Zugriff auf api.github.com, übernimmt den Proxy aus settings.json
• Remote - SSH – Proxy ist für den SSH-Tunnel erforderlich, wird separat in der SSH-Konfiguration eingerichtet
• Docker – verwendet den systemweiten Proxy des Docker-Daemons

Erweiterungen manuell installieren (offline)

Wenn der Proxy nicht verfügbar oder instabil ist, können Erweiterungen manuell über eine .vsix-Datei installiert werden. Laden Sie die Erweiterungsdatei von marketplace.visualstudio.com auf einem Gerät mit Internetzugang herunter und installieren Sie sie dann in VS Code: Extensions → ··· → Install from VSIX.

Welchen Proxy-Typ für VS Code wählen

Die Wahl des Proxy-Typs hängt von der Aufgabe ab. Lassen Sie uns die Hauptoptionen im Hinblick auf die Entwicklung betrachten.

Proxy-Typ	Geschwindigkeit	Zuverlässigkeit	Wann geeignet für VS Code
Rechenzentrums-Proxys	⚡ Hoch	✅ Stabil	Umgehung von Unternehmensbeschränkungen, Herunterladen von Erweiterungen, CI/CD-Pipelines
Residential Proxys	🔄 Mittel	✅ Hohe Vertrauenswürdigkeit	Zugang zu geo-geschützten Ressourcen, Tests aus einer bestimmten Region
Mobile Proxys	🔄 Mittel	✅ Maximale Vertrauenswürdigkeit	Selten für VS Code benötigt, aber nützlich bei der Entwicklung mobiler Anwendungen mit Geotests
Unternehmensproxy (Squid, ISA)	⚡ Hoch	⚠️ Abhängig von den Einstellungen	Büroumgebung, erforderlich gemäß Unternehmensrichtlinien

Für die meisten Entwickler, die einfach Unternehmensbeschränkungen umgehen oder aus einem Land mit instabilem Zugang zu Microsoft-Servern arbeiten müssen, sind Rechenzentrums-Proxys die optimale Wahl – sie sind schnell, stabil und gut geeignet für technische Aufgaben wie das Herunterladen von Paketen und die Synchronisierung von Einstellungen.

Wenn die Aufgabe jedoch darin besteht, eine Anwendung aus einer bestimmten geografischen Region zu testen (zum Beispiel zu überprüfen, wie Ihr Dienst für Benutzer in Deutschland oder den USA funktioniert), sind Residential Proxys mit echten IPs von Haushaltsnutzern des gewünschten Landes nützlich.

Unternehmensproxy mit SSL-Inspektion: Ein Sonderfall

Unternehmensproxys mit SSL-Inspektionsfunktion (man-in-the-middle) sind ein separates Problem für Entwickler. Ein solcher Proxy entschlüsselt den HTTPS-Datenverkehr, überprüft ihn und verschlüsselt ihn erneut, indem er sein eigenes Unternehmenszertifikat signiert. Infolgedessen sieht VS Code ein „unbekanntes“ Zertifikat und weigert sich zu arbeiten.

Symptome

• Fehler CERT_UNTRUSTED oder unable to verify the first certificate im Output
• Erweiterungen werden nicht installiert, obwohl der Proxy korrekt angegeben ist
• Settings Sync kann sich nicht authentifizieren
• npm und pip beschweren sich ebenfalls über Zertifikate

Lösung 1: SSL-Überprüfung deaktivieren (schnell, aber weniger sicher)

{
  "http.proxyStrictSSL": false
}

Dies ist eine schnelle Lösung, die die Überprüfung des SSL-Zertifikats des Proxys deaktiviert. Geeignet für interne Unternehmensnetzwerke, in denen der Proxy vertrauenswürdig ist.

Lösung 2: Unternehmens-CA-Zertifikat hinzufügen (richtiger Weg)

Holen Sie sich beim Systemadministrator das Unternehmens-Root-Zertifikat (Datei .pem oder .crt) und fügen Sie es in die Einstellungen ein:

{
  "http.proxy": "http://corporate-proxy:3128",
  "http.proxyStrictSSL": true,
  "http.proxyCertificates": true
}

Fügen Sie das Zertifikat auch dem Systemzertifikatsspeicher des Betriebssystems hinzu – VS Code verwendet Systemzertifikate seit Version 1.40. Unter Windows reicht es aus, das Zertifikat in die „Vertrauenswürdigen Stammzertifizierungsstellen“ über certmgr.msc zu installieren. Unter Linux fügen Sie das Zertifikat in /usr/local/share/ca-certificates/ hinzu und führen Sie update-ca-certificates aus.

Lösung 3: NODE_EXTRA_CA_CERTS-Variable

VS Code und seine Erweiterungen laufen auf Node.js, daher können zusätzliche CA-Zertifikate über eine Umgebungsvariable angegeben werden:

# Linux/macOS
export NODE_EXTRA_CA_CERTS="/path/to/corporate-ca.pem"

# Windows PowerShell
$env:NODE_EXTRA_CA_CERTS="C:\certs\corporate-ca.pem"

Checkliste: VS Code + Proxy funktioniert korrekt

Verwenden Sie diese Checkliste, um sicherzustellen, dass alles richtig konfiguriert ist, oder um schnell die Ursache eines Problems zu finden.

Fazit

Die Einrichtung eines Proxys in VS Code ist eine Aufgabe, die einmal gelöst wird und für immer von Problemen mit einem hängenden Marketplace, nicht funktionierendem Settings Sync und Erweiterungen, die keine Abhängigkeiten herunterladen können, befreit. Die wichtigsten Erkenntnisse aus diesem Artikel:

• Der zuverlässigste Weg – den http.proxy in settings.json einzutragen: funktioniert sowohl für den Editor selbst als auch für die meisten Erweiterungen.
• Umgebungsvariablen (HTTP_PROXY, HTTPS_PROXY) – praktisch für die Vereinheitlichung der Proxy-Einstellungen für die gesamte Entwicklerumgebung.
• Unternehmensproxy mit SSL-Inspektion erfordert entweder die Deaktivierung von proxyStrictSSL oder die Installation des Unternehmens-CA-Zertifikats.
• Settings Sync funktioniert über den Proxy ohne zusätzliche Einstellungen – wichtig ist, dass die Domains von Microsoft und GitHub erreichbar sind.
• Diagnose beginnt immer mit Output → Settings Sync und Output → Extensions – dort sind alle Netzwerkfehler mit Codes sichtbar.

Wenn Sie in einer Umgebung mit eingeschränktem Internetzugang arbeiten oder eine Anwendung aus einer bestimmten geografischen Region testen müssen, empfehlen wir die Verwendung von Rechenzentrums-Proxys für eine stabile und schnelle Arbeit mit Entwicklungstools – sie bieten hohe Verbindungsgeschwindigkeiten und sind hervorragend geeignet für technische Aufgaben wie das Herunterladen von Paketen, die Synchronisierung von Einstellungen und die Arbeit mit entfernten Repositories.