Proxy-Zugangsdaten in Visual Studio Code konfigurieren

So konfigurieren Sie Proxy-Zugangsdaten in Visual Studio Code

Proxy-Einstellungen in VS Code können an drei verschiedenen Stellen scheitern: im Editor selbst, in einer Erweiterung oder in einem Tool, das über das integrierte Terminal gestartet wird. Diese Trennung ist wichtig. Ein Browser kann funktionieren, während der Editor trotzdem einen 407-Fehler ausgibt oder eine Erweiterungsseite nicht laden will. Welche Lösung hilft, hängt davon ab, wo die Anfrage beginnt.

1. Prüfen Sie, ob VS Code selbst oder eine Erweiterung den Proxy benötigt

Beginnen Sie mit einem einfachen Test: Scheitert VS Code schon, bevor Sie das Terminal öffnen? Wenn die Erweiterungsansicht nicht geladen werden kann, liegt das Problem wahrscheinlich beim Editor. Wenn Git erst fehlschlägt, nachdem Sie im Terminal einen Befehl ausgeführt haben, ist VS Code möglicherweise in Ordnung und stattdessen die Shell das Problem. Kurzer Test, großer Hinweis.

Achten Sie auf die Quelle der Anfrage. VS Code kann Netzwerkaufrufe für Erweiterungen, Updates, die Synchronisierung von Einstellungen und Anmeldeaufforderungen ausführen. Erweiterungen können außerdem ihre eigenen Dienste ansprechen. Ein Linter, eine Remote-Development-Erweiterung oder ein KI-Helfer kann die Proxy-Einstellungen des Editors ignorieren und eigenen Regeln folgen. Deshalb kann dasselbe Netzwerk in einem Bereich funktionieren und in einem anderen fehlschlagen, selbst auf demselben Rechner.

Wenn Sie sich einen breiteren Überblick über Proxy-Verhalten verschaffen möchten, ist der Leitfaden zu Best Practices für Proxy-Authentifizierung nützlich. Hier ist die Aufgabe aber enger gefasst: Finden Sie heraus, welche Komponente tatsächlich blockiert ist. Ein fehlgeschlagener Download reicht schon, um zu wissen, wo Sie als Nächstes suchen müssen.

2. Ermitteln Sie die genauen Proxy-Details, bevor Sie Einstellungen ändern

Bevor Sie irgendetwas ändern, sammeln Sie Host, Port und Authentifizierungsmethode des Proxys. Raten Sie nicht. Ein Host wie proxy.example.com und ein Port wie 8080 sind nicht austauschbar mit einem SOCKS-Endpunkt oder einem Unternehmensgateway, das Benutzername und Passwort erwartet. Wenn Sie ein Feld vergessen, kann VS Code die Einstellung zwar übernehmen, sich aber trotzdem nicht verbinden.

Fragen Sie nach dem exakten Format, das Ihr Netzwerkteam verwendet. Manche Proxys wollen nur Host und Port. Andere erwarten Zugangsdaten in der URL. Manche Teams ändern die Zugangsdaten regelmäßig, andere nicht. Ein einziger Tippfehler beim Passwort kann wie ein Netzwerkausfall aussehen – und das passiert leider sehr häufig.

Wenn Sie noch verschiedene Proxy-Typen vergleichen, kann der Leitfaden zu SOCKS5-Proxy vs. HTTP-Proxy helfen, Übertragung und Authentifizierung zu trennen. Für VS Code ist hier nur der exakte Wert wichtig, den der Proxy erwartet. Ein falscher Port bricht die Verbindung genauso schnell wie ein falsches Passwort.

3. Legen Sie Proxy-Zugangsdaten in den Benutzer- oder Arbeitsbereichseinstellungen von VS Code fest

Öffnen Sie die Einstellungen in VS Code und suchen Sie nach „Proxy“. Der übliche Ort sind die Benutzereinstellungen, wobei ein Arbeitsbereich diese für ein einzelnes Projekt überschreiben kann. Dieser Unterschied ist wichtig, wenn ein Repository einen Proxy braucht und ein anderes nicht. Eine Einstellung im falschen Geltungsbereich kann stundenlang für Rätselraten sorgen.

Die häufige Einstellung ist der Proxy-Endpunkt des Editors, und in vielen Fällen geben Sie ihn direkt in der Einstellungsoberfläche oder in settings.json ein. Wenn Ihr Proxy Authentifizierung verlangt, müssen Sie möglicherweise auch Einstellungen zu Zertifikatsbehandlung, strengem SSL-Verhalten oder Erweiterungs-Downloads aktivieren oder anpassen. Prüfen Sie die aktuellen Einstellungen, statt einen veralteten Blogbeitrag aus dem Jahr 2021 zu kopieren. Genau hier ist es oft sinnvoll, VS Code Proxy Zugangsdaten konfigurieren mit Blick auf den konkreten Anwendungsfall zu erledigen, statt pauschal an allen Stellen zu ändern.

Verwenden Sie die Benutzereinstellungen, wenn der Proxy für Ihr gesamtes Konto gelten soll. Verwenden Sie die Arbeitsbereichseinstellungen, wenn nur eine Codebasis einen anderen Weg braucht. Diese Trennung übersieht man leicht, und sie kann später viel Rätselarbeit ersparen. Ein Projekt in einem Unternehmensnetzwerk braucht möglicherweise den Proxy, während ein privates Nebenprojekt ihn nie sehen sollte.

Fügen Sie keine zufälligen Werte in unpassende Felder ein. Wenn ein Feld für eine Proxy-URL gedacht ist, gehört dort eine Proxy-URL hinein. Wenn ein Feld für einen erweiterungsspezifischen Endpunkt gedacht ist, lassen Sie den Editor-Proxy in Ruhe. Saubere Konfiguration schlägt Improvisation.

4. Formatieren Sie die Proxy-Adresse korrekt, wenn Benutzername und Passwort erforderlich sind

Wenn ein Proxy Zugangsdaten direkt in der Adresse erwartet, enthält das Format normalerweise Benutzername, Passwort, Host und Port in einem String. Das klingt einfach, bis das Passwort Sonderzeichen enthält. Doppelpunkt, At-Zeichen oder Raute können die Auswertung der Adresse verändern, und dann kann VS Code den Wert als fehlerhaft statt als authentifiziert behandeln.

An diesem Punkt wird Visual Studio Code Proxy Authentifizierung einrichten mehr als nur „Host in eine Einstellungsdatei eintragen“. Wenn Ihr Passwort Symbole enthält, kann eine Prozentkodierung nötig sein. Ein Passwort, das im Browser-Prompt funktioniert, kann fehlschlagen, wenn es in einer URL steht. Das ist kein Eigenart von VS Code, sondern ein Formatproblem.

Eine praktische Regel hilft: Wenn der Proxy-Administrator Ihnen eine vollständige authentifizierte URL gegeben hat, verwenden Sie genau dieses Format. Wenn Ihnen getrennte Felder gegeben wurden, improvisieren Sie nicht und setzen Sie sie nicht ohne Prüfung der erwarteten Syntax zusammen. Ein einziger fehlender Schrägstrich kann die Anfrage ruinieren.

Wenn Sie zwischen Proxy-Typen für ein Projekt wählen, das VS Code und externe Tools verwendet, liefert der Artikel über den authentifizierten SOCKS5-Proxy hilfreichen Hintergrund zu zugangsgeschütztem Zugriff. Hier ist vor allem Genauigkeit gefragt. Die URL muss zum Proxy passen, nicht zu Ihrer Erinnerung.

5. Wenden Sie dieselben Proxy-Zugangsdaten auch im integrierten Terminal und in gestarteten Tools an

VS Code kann ins Netzwerk gelangen, während das Terminal es nicht kann. Das passiert häufig. Der Editor hat möglicherweise eine Proxy-Einstellung, aber das integrierte Terminal führt Shell-Befehle aus, und diese Befehle lesen vielleicht andere Umgebungsvariablen oder eine ganz andere Konfigurationsdatei. Git, npm, pip, Maven und curl sind typische Beispiele.

Setzen Sie Proxy-Variablen dort, wo Ihre Shell sie sieht. Auf vielen Systemen sind das HTTP_PROXY, HTTPS_PROXY und manchmal auch die Kleinbuchstaben-Varianten. Tools, die im Terminal gestartet werden, folgen diesen Variablen oft, bevor sie irgendetwas anderes prüfen. Ein Paketinstallationsfehler mit Anmeldeaufforderung weist meist auf die Shell und nicht auf den Editor hin.

Git kann außerdem eine eigene Proxy-Konfiguration speichern. npm kann eigene Registry- und Proxy-Einträge verwenden. Ein Tool kann die anderen ohne Warnung ignorieren. Deshalb sollten Sie Editor und Terminal getrennt testen und nicht annehmen, dass eine Einstellung alles abdeckt. Zwei Prüfungen, zwei mögliche Fehlerquellen. Wenn Sie die Ursachen systematisch trennen, lassen sich auch VS Code 407 Proxy Fehler beheben, ohne an der falschen Stelle zu suchen.

Wenn Ihr Team auch verstehen möchte, welcher Proxy-Endpunkt für Shell-Tools zu verwenden ist, kann der Leitfaden zu Proxy-Portnummern für Web Scraping bei der Portauswahl und verwandten Prüfungen helfen. Das Muster ist hier dasselbe: Wenn das Terminal auf den falschen Port zeigt, schlägt die Authentifizierung fehl, selbst wenn die Proxy-Zugangsdaten korrekt sind.

6. Schließen Sie lokale oder interne Adressen vom Proxy-Routing aus

Nicht jede Adresse sollte über den Proxy laufen. Lokale Dienste wie localhost und 127.0.0.1 sollten ihn normalerweise umgehen. Das gilt auch für private Intranet-Hosts, interne Paketquellen und lokale Testserver. Wenn Sie diese über den Proxy schicken, kann sich die Anfrage verlangsamen oder komplett scheitern.

Verwenden Sie No-Proxy-Einstellungen, wo Ihre Tools das unterstützen. Viele Umgebungen akzeptieren eine Liste von Hosts, Domains oder IP-Bereichen, die den Proxy überspringen sollen. Diese Liste ist wichtiger, als viele denken. Ein lokaler API-Server auf Port 3000 ist keine öffentliche Website und sollte auf Ihrem Laptop keinen Proxy brauchen, um zu antworten. Kleine Regel, große Wirkung.

Nehmen Sie interne Namen ebenfalls in die Ausnahmeliste auf. Ein Hostname mit der Endung .corp oder ein privates Subnetz wie 10.x.x.x kann über einen externen Proxy absichtlich nicht erreichbar sein. Wenn VS Code bei einem lokalen Dienst endlos lädt, prüfen Sie, ob die Anfrage den umständlicheren Weg nimmt.

Für eine allgemeinere Betrachtung von Ausschlusslogik bietet der Artikel darüber, wie man die eigene IP-Adresse verbirgt, nützlichen Kontext. Hier ist der Punkt aber einfacher: Schicken Sie privaten Datenverkehr nicht dorthin, wo er nicht hingehört. Der Proxy sollte öffentlichen Verkehr abdecken, nicht Ihren eigenen Rechner.

7. Prüfen Sie, ob VS Code Erweiterungsdienste und entfernte Ressourcen erreichen kann

Sobald die Einstellungen gesetzt sind, testen Sie die relevanten Pfade. Öffnen Sie die Erweiterungsansicht und versuchen Sie, eine Paketseite zu laden. Melden Sie sich an, wenn Ihr Workflow das erfordert. Prüfen Sie, ob Updates angezeigt werden. Wenn Ihr Team entfernte Repositories oder Dokumentationsbereiche direkt im Editor nutzt, öffnen Sie auch einen davon. Die Idee ist zu bestätigen, dass authentifizierter Zugriff dort funktioniert, wo VS Code tatsächlich Anfragen stellt.

Achten Sie auf Fehlermuster. Eine 407-Antwort weist meist auf Probleme mit der Proxy-Authentifizierung hin. Ein Timeout kann bedeuten, dass Host oder Port falsch sind. Eine Zertifikatswarnung kann darauf hindeuten, dass der Proxy den Verkehr abfängt und der Editor der Zertifikatskette noch nicht vertraut. Jedes Symptom deutet auf eine andere Lösung, also behandeln Sie sie nicht als dasselbe Problem.

Probieren Sie eine bekannte funktionierende Ressource und eine weniger übliche. So erhalten Sie zwei Datenpunkte. Wenn beide laden, sind Sie wahrscheinlich fertig. Wenn eine funktioniert und die andere nicht, liegt das Problem möglicherweise in einer Erweiterungseinstellung und nicht in der Haupt-Proxy-Konfiguration. Das passiert öfter, als es sollte.

Für Teams, die in großem Umfang auf Erweiterungs-Downloads angewiesen sind, überschneiden sich Fragen zu Endpunktvertrauen und Zugangsdaten mit einer umfassenderen Proxy-Planung. Der Artikel wie man ein VPN auswählt kann helfen, diese weitergehende Infrastrukturentscheidung einzuordnen. Der eigentliche VS-Code-Test bleibt aber einfach: Kann der Editor das laden, was er braucht, ohne erneut nachzufragen?

8. Beheben Sie fehlgeschlagene Authentifizierung und Probleme mit gespeicherten Zugangsdaten

Wenn der Proxy die Verbindung weiterhin ablehnt, beseitigen Sie zuerst die offensichtlichen Fehler. Prüfen Sie Benutzername, Passwort, Host und Port erneut. Entfernen Sie zusätzliche Leerzeichen. Bestätigen Sie, dass das Passwort korrekt kodiert ist, falls es Sonderzeichen enthält. Starten Sie dann VS Code neu.

Gespeicherte Geheimnisse können ebenfalls Verwirrung stiften. Wenn VS Code ein altes Passwort gespeichert hat, sendet der Editor es möglicherweise weiter, selbst nachdem Sie die Einstellungsdatei geändert haben. Löschen Sie den alten Eintrag aus dem Passwortmanager, dem Anmeldedatenspeicher oder dem Einstellungs-Cache Ihres Systems. Ein veraltetes Geheimnis kann das gesamte Setup kaputt halten.

Achten Sie auch auf doppelte Proxy-Werte. Ein Proxy kann in VS Code, im Terminalprofil, in der Git-Konfiguration und in den eigenen Einstellungen einer Erweiterung gesetzt sein. Wenn zwei davon sich widersprechen, kann das Tool fehlschlagen, obwohl jeder Wert für sich plausibel aussieht. Das ist der unangenehme Teil: Die „richtige“ Antwort kann trotzdem verlieren, wenn sie am falschen Ort gespeichert ist.

Setzen Sie eine Ebene nach der anderen zurück. Entfernen Sie zuerst die VS-Code-Proxy-Einstellung und testen Sie dann. Stellen Sie sie anschließend wieder her und entfernen Sie die Shell-Proxy-Variablen, dann testen Sie erneut. Prüfen Sie danach Git oder npm. Dieser schrittweise Ansatz ist langsamer, zeigt aber, welche Ebene den falschen Wert trägt. Wenn der Editor erst funktioniert, nachdem Sie ein altes Geheimnis entfernt haben, haben Sie den Übeltäter gefunden.

Wenn die Authentifizierung danach immer noch fehlschlägt, fragen Sie nach, ob sich die Richtlinien des Proxy-Dienstes geändert haben. Manche Systeme verlangen ein anderes Benutzernamenformat, einen neuen Realm oder eine IP-Freigabeliste. Das ist kein VS-Code-Fehler, sondern eine Richtlinienänderung, und dafür muss der Betreiber des Proxys die aktuelle Regelung bestätigen.

Eine letzte Prüfung hilft, wenn sonst alles richtig aussieht: Öffnen Sie die JSON-Einstellungen und suchen Sie nach allen Proxy-bezogenen Einträgen. Zählen Sie sie. Wenn Sie drei verschiedene Proxy-Werte sehen, ist einer davon wahrscheinlich veraltet. Wenn Sie keine sehen, wird der Proxy noch aus der Umgebung übernommen. Beides kommt vor, und beides lässt sich beheben.