Design wechseln

Cursor Proxy Netzwerkprobleme: Proxy, Diagnose und HTTP/2 beheben

Unten rechts im Cursor-Editor dreht sich seit fünf Minuten ein kleiner Ladekreis. Sie schreiben gerade Code, plötzlich bricht die KI-Verbindung ab – die Meldung lautet „Network request failed”. Im Browser läuft YouTube butterweich, und ping Google zeigt nur 20 ms Latenz.

Am nächsten Tag im Firmennetzwerk: IT hat mehrere Proxy-Ebenen eingerichtet, Cursor startet gar nicht erst. Im Fehlerlog tauchen ERR_HTTP2_PROTOCOL_ERROR, ECONNREFUSED und certificate verify failed auf – jedes einzeln bekannt, zusammen völlig unverständlich.

Drei volle Tage habe ich damit verbracht: GitHub Issues, Discord-Kanäle, dubiose „Ultimate Fixes” – bis klar wurde: Cursor-Netzwerkprobleme haben nicht eine einzige Ursache, sondern vier Fallen, die sich überlagern: Proxy, HTTP/2, Zertifikate und DNS.

Dieser Artikel wurde im Juni 2026 anhand der aktuellen Cursor-Dokumentation aktualisiert. Starten Sie mit Cursor Settings > Network und den Diagnoseergebnissen, dann folgen Proxy, HTTP/2-Kompatibilitätsmodus, Zertifikate und DNS.

Ein leicht übersehener Punkt vorweg: Viele tragen die richtige Proxy-Adresse ein, und Cursor verbindet sich trotzdem nicht. Der Grund ist, dass http.proxySupport standardmäßig auf override steht. In diesem Modus nutzt Cursor nur den http.proxy aus der settings.json, der System-Proxy wird ignoriert, und bei einer Neuinstallation ist dieser Wert leer. Dazu gibt es weiter unten einen eigenen Abschnitt; merken Sie es sich erst einmal.

Nach der Netzwerkbehebung folgen meist diese Schritte

Erst wenn die Verbindung steht, geht es weiter: Fehlermeldungen prüfen, Pro-Upgrade abwägen oder das Free-Kontingent optimieren.

Erst die Diagnose, dann die Konfiguration: In drei Schritten zur Ursache

Bei Netzwerkproblemen fangen viele sofort an, Proxy zu ändern, Zertifikate zu löschen oder neu zu installieren. Am Ende ist nichts gelöst – die Umgebung nur chaotischer.

Mein Rat: Nehmen Sie sich fünf Minuten, um die eigentliche Ursache zu finden.

Schritt 1: Liegt es an Cursor oder an Ihrem Netzwerk?

Terminal öffnen, drei Befehle ausführen:

# Basisnetzwerk testen
ping api.openai.com

# DNS-Auflösung testen
nslookup api.openai.com

# HTTPS-Verbindung testen
curl -I https://api.openai.com

Ping klappt, aber curl schlägt fehl? Dann sind es meist Proxy oder Zertifikat. Ping geht gar nicht? Dann liegt das Problem in der Netzwerkschicht – nicht bei Cursor.

Schritt 2: Cursor-Fehlerlog lesen

Diesen Schritt überspringen viele – dabei steht dort alles schwarz auf weiß.

  • Windows: %APPDATA%\Cursor\logs\main.log
  • macOS: ~/Library/Application Support/Cursor/logs/main.log
  • Linux: ~/.config/Cursor/logs/main.log

Mit einem Texteditor öffnen und nach ERROR oder WARN suchen. Häufige Meldungen:

  • ECONNREFUSED → Proxy falsch konfiguriert oder Proxy-Server down
  • ERR_HTTP2_PROTOCOL_ERROR → HTTP/2-Inkompatibilität (besonders tückisch)
  • certificate verify failed → SSL-Zertifikatsproblem
  • ETIMEDOUT → Timeout, evtl. langsames DNS oder Netzwerksperre

Schritt 3: Prüfen, ob die Cursor-Proxy-Einstellungen greifen

Cursor basiert auf Electron – die Proxy-Konfiguration folgt nicht automatisch dem System-Proxy. So testen Sie:

  1. Cursor-Einstellungen öffnen (Ctrl+, oder Cmd+,)
  2. Nach proxy suchen
  3. Prüfen, ob http.proxy und https.proxy leer sind

Sind sie leer, obwohl lokal ein Proxy läuft (Clash, V2Ray, Shadowsocks)? Dann nutzt Cursor keinen Proxy – logische Folge: keine Verbindung.

Vier Wege zur Proxy-Konfiguration

Proxy-Probleme sind der häufigste Grund für Cursor-Netzwerkausfälle. Viele wissen nicht: Cursor unterstützt vier verschiedene Proxy-Methoden – für unterschiedliche Szenarien.

Vor der Proxy-Konfiguration eine Sache prüfen: steht proxySupport auf override?

Wenn Ihr lokaler Proxy (Clash / V2Ray) läuft, der Browser sauber tunnelt, Cursor aber trotzdem nicht verbindet, tragen Sie nicht vorschnell eine Adresse ein. Cursor erbt von VS Code die Einstellung http.proxySupport mit vier Modi:

  • off: kein Proxy
  • on: liest immer den System-Proxy
  • fallback: prüft zuerst http.proxy in der settings.json, fällt bei leerem Wert auf den System-Proxy zurück
  • override: nutzt nur den http.proxy aus der settings.json und ignoriert den System-Proxy

Genau hier liegt die Falle: http.proxySupport steht standardmäßig auf override, http.proxy ist standardmäßig leer. Beides zusammen bedeutet, dass Cursor weder Ihre eingetragene Adresse (es gibt keine) noch den System-Proxy liest – es verbindet sich ungeschützt, also scheitern Login und KI-Requests.

Die Lösung ist einfach: Einstellungen öffnen (Ctrl+,), nach proxy support suchen und Http: Proxy Support von override auf on oder fallback ändern, dann Cursor neu starten. Wenn Cursor nur dem System-Proxy folgen soll, reicht oft diese eine Änderung; die vier Methoden unten sind für alle, die feiner steuern wollen.

Variante 1: Proxy-Adresse direkt in den Einstellungen (am einfachsten)

Szenario: Sie haben eine feste Proxy-Adresse (z. B. firmeninterner HTTP-Proxy)

Schritte:

  1. Cursor-Einstellungen öffnen
  2. Nach proxy suchen
  3. http.proxy eintragen: http://127.0.0.1:7890 (Ihre Adresse und Ihr Port)

Fallstricke:

  • Mit Benutzername/Passwort: http://username:[email protected]:7890
  • HTTPS-Proxy separat unter https.proxy – sonst läuft nur HTTP über den Proxy
  • Clash nutzt oft Port 7890, V2Ray 10808 – nicht verwechseln

Variante 2: Umgebungsvariablen (für Terminal-Start)

Szenario: Sie starten Cursor aus dem Terminal oder wechseln temporär den Proxy

Windows (PowerShell):

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
cursor

macOS/Linux:

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
cursor

Vorteil: Keine globale Konfiguration – nach Schließen des Terminals ist alles wieder weg.

Variante 3: System-Proxy automatisch erkennen (Unternehmen)

Szenario: IT hat PAC-Datei oder transparenten Proxy eingerichtet

Cursor kann den System-Proxy lesen – standardmäßig ist das aus. So aktivieren:

  1. Cursor-Startkonfiguration finden

    • Windows: Desktop-Verknüpfung → Rechtsklick → Eigenschaften → Ziel
    • macOS: /Applications/Cursor.app/Contents/Info.plist bearbeiten
  2. Startparameter hinzufügen: --proxy-auto-detect

Cursor liest dann automatisch die System-Proxy-Einstellungen – manuelle Adresseingabe entfällt.

Variante 4: Zertifikatsfehler erzwingen ignorieren (nicht empfohlen, wirkt aber)

Szenario: Firmen-Proxy entschlüsselt HTTPS per MITM → Zertifikatsprüfung schlägt fehl

Ernste Warnung: Sicherheit sinkt deutlich – nur vorübergehend nutzen!

Startparameter: --ignore-certificate-errors

Vollständiger Befehl (Windows):

& "C:\Users\IhrBenutzername\AppData\Local\Programs\Cursor\Cursor.exe" --ignore-certificate-errors

Damit prüft Cursor SSL-Zertifikate nicht mehr – viele Firmen-Proxy-Probleme verschwinden. Letztes Mittel – wenn möglich vermeiden.

Die HTTP/2-Falle: Warum der Browser geht, Cursor aber nicht?

Symptom: Browser erreicht die OpenAI-API problemlos, curl liefert Daten – Cursor meldet ERR_HTTP2_PROTOCOL_ERROR.

Nicht sofort als „Versionsbug” einordnen. Zuerst mit Cursor Network Diagnostics prüfen, ob es wirklich ein HTTP/2-Kompatibilitätsproblem ist, dann HTTP/1.1 testen.

Bevorzugte Lösung: HTTP/2-Kompatibilität in Cursor setzen

  1. Cursor-Einstellungen öffnen
  2. Zu Network wechseln
  3. Run Diagnostics ausführen
  4. Wenn Diagnose oder Logs auf HTTP/2 zeigen: Disable HTTP/2 aktivieren oder HTTP Compatibility Mode auf HTTP/1.1 setzen
  5. Cursor vollständig beenden und neu starten, nicht nur das Fenster schließen

Wer die Oberfläche nicht jedes Mal öffnen möchte, setzt es direkt in der settings.json:

{
  "cursor.general.disableHttp2": true
}

Das ist ein offiziell unterstützter Schlüssel mit derselben Wirkung wie der Schalter Disable HTTP/2, und er steht direkt bei Ihren Proxy-Schlüsseln. Nur auf älteren Versionen, die weder den Schalter noch diesen Schlüssel kennen, greifen Sie auf den Startparameter cursor --disable-http2 zurück.

DNS wechseln: HTTP/2-Fehler sind manchmal ein Routing-Problem

Manche HTTP/2-Fehler entstehen gar nicht in Cursor, sondern an dem Knoten, zu dem Ihr DNS auflöst. Bestimmte DNS-Dienste lösen die Cursor-API-Domains zu einem Cloudflare-Knoten auf, an dem der Handshake fehlschlägt und ein SSL handshake-Fehler entsteht. Mehrere Nutzer im offiziellen Forum berichten, dass HTTP/2 wieder funktionierte, nachdem sie das System-DNS auf Cloudflare (1.1.1.1) oder Google (8.8.8.8) umgestellt hatten. Wenn das Deaktivieren von HTTP/2 spürbar langsamer ist und Sie nicht dauerhaft bei HTTP/1.1 bleiben wollen, wechseln Sie zuerst das DNS und aktivieren HTTP/2 noch einmal.

Fallback: Proxy-Software anpassen (Beispiel Clash)

Clash-Konfiguration (config.yaml) öffnen, in den Proxy-Regeln ergänzen:

proxies:
  - name: "Ihr Proxy-Name"
    type: http
    server: 127.0.0.1
    port: 7890
    http-version: "1.1"  # HTTP/1.1 erzwingen

Clash und Cursor neu starten. Wenn die HTTP/2-Aushandlung in der Proxy-Kette die Ursache war, werden Requests meist stabiler. Falls nicht, zurück zu Diagnose und Logs statt weitere Flags zu stapeln.

Unternehmensnetzwerk: Die Komplettlösung

Firmennetze sind am unangenehmsten: Pflicht-Proxy, SSL-MITM, Firewall, internes DNS – jedes einzelne kann Cursor lahmlegen.

Hier eine Konfiguration, die in Unternehmensumgebungen zuverlässig funktioniert:

Checkliste (der Reihe nach)

1. Proxy-Informationen von IT holen

  • Proxy-Server und Port (z. B. proxy.company.com:8080)
  • Benutzername/Passwort nötig?
  • PAC-Auto-Konfiguration?
  • SSL-Entschlüsselung? Dann Root-Zertifikat anfordern

2. Cursor-Proxy konfigurieren

In settings.json ergänzen:

{
  "http.proxy": "http://username:[email protected]:8080",
  "https.proxy": "http://username:[email protected]:8080",
  "http.proxySupport": "override",
  "http.proxyStrictSSL": false,
  "cursor.general.disableHttp2": true
}

Drei Hinweise: Wenn Sie http.proxy von Hand eingetragen haben, ist http.proxySupport auf override am saubersten, weil Cursor dann ausschließlich über diesen Firmen-Proxy läuft. Bei SSL-MITM müssen Sie "http.proxyStrictSSL": false setzen. Und da Firmen-Proxies HTTP/2 meist blockieren, spart "cursor.general.disableHttp2": true hier eine Runde Fehlersuche.

3. Firmen-Root-Zertifikat importieren

Ohne Import bei SSL-Entschlüsselung: dauerhaft certificate verify failed.

Windows:

  1. Root-Zertifikat (.crt oder .cer) doppelklicken
  2. „Zertifikat installieren” → „Lokaler Computer” → „Vertrauenswürdige Stammzertifizierungsstellen”

macOS:

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain firmen-root.crt

4. Startskript mit Parameter-Kombination

Skript anlegen (Windows .bat, macOS/Linux .sh):

Windows (start-cursor.bat):

@echo off
set HTTP_PROXY=http://proxy.company.com:8080
set HTTPS_PROXY=http://proxy.company.com:8080
start "" "C:\Users\IhrBenutzername\AppData\Local\Programs\Cursor\Cursor.exe" --proxy-auto-detect --disable-http2

macOS/Linux (start-cursor.sh):

#!/bin/bash
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
/Applications/Cursor.app/Contents/MacOS/Cursor --proxy-auto-detect --disable-http2

Cursor künftig nur noch über dieses Skript starten – nicht über das Icon.

5. Verbindung testen

Cursor starten, Entwicklertools öffnen (Ctrl+Shift+I oder Cmd+Option+I), Tab „Network”, der KI eine Frage stellen – Requests sollten normal zurückkommen.

Immer noch Fehler? Log-Datei (Pfade oben) öffnen, neueste Meldung lesen, Schritte von vorne durchgehen.

Fazit

Cursor-Netzwerkprobleme lassen sich auf vier Fallen reduzieren:

  1. Proxy wird ignoriert → zuerst prüfen, ob http.proxySupport auf override steht, dann http.proxy und Umgebungsvariablen
  2. HTTP/2-Konflikt → zuerst Disable HTTP/2 oder HTTP Compatibility Mode: HTTP/1.1 in den Network-Einstellungen setzen, bei Bedarf DNS wechseln
  3. SSL-Zertifikat → Root-Zertifikat importieren oder Prüfung vorübergehend deaktivieren
  4. Unternehmensnetzwerk → Kombination: Proxy + Zertifikat + Startparameter

Drei Tage habe ich gebraucht, weil diese Probleme gleichzeitig auftreten können. Proxy gefixt – HTTP/2 meckert noch. HTTP/2 aus – Zertifikat kaputt. Zertifikat drin – DNS löst nicht auf … jedes Mal schien es gelöst, nur der Fehler wechselte.

Rückblickend: Mit der Reihenfolge in diesem Artikel wäre eine halbe Stunde genug gewesen.

Logs nicht ignorieren. Bei jedem Problem zuerst den neuesten ERROR im Log suchen – 90 % der Antworten stehen dort. Die restlichen 10 %: Log mitnehmen zu GitHub Issues oder Discord – so kann anderen schneller geholfen werden.

Netzwerkprobleme sind kein Drama – chaotisches Herumprobieren schon. Hoffentlich sparen Sie sich die 72 Stunden.

Offizielle Quellen und nächste Schritte

Cursor-Netzwerkprobleme: Vollständiger Troubleshooting-Ablauf

Von Basisnetzwerk-Tests bis zur Unternehmensumgebung – komplette Lösung

Estimated time: PT30M

  1. 1

    Step 1: Schritt 1: Ursache schnell eingrenzen

    Mit drei Befehlen die Netzwerkverbindung prüfen:
  2. 2

    Step 2: Schritt 2: Proxy konfigurieren (eine von vier Varianten)

    Zuerst proxySupport prüfen: nach proxy support suchen. Steht Http: Proxy Support auf dem Standard override und ist http.proxy leer, ignoriert Cursor den System-Proxy. Auf on oder fallback ändern, dann folgt Cursor dem System-Proxy.
  3. 3

    Step 3: Schritt 3: HTTP/2-Protokollkonflikt beheben

    Bei ERR_HTTP2_PROTOCOL_ERROR im Log – diese Reihenfolge:
  4. 4

    Step 4: Schritt 4: Unternehmensnetzwerk vollständig einrichten

    Informationen von IT:
  5. 5

    Step 5: Schritt 5: Verbindung prüfen und überwachen

    Verbindung testen:

FAQ

Warum erreicht der Browser OpenAI, Cursor aber nicht?
Zwei Gründe. Erstens basiert Cursor auf Electron und liest den System-Proxy nicht automatisch, eine separate Konfiguration ist nötig. Zweitens, und subtiler, ein Standardwert: Cursors http.proxySupport steht standardmäßig auf override und nutzt dann nur den http.proxy aus der settings.json – und der ist standardmäßig leer, der System-Proxy wird also ignoriert. Folge: Der Browser läuft über den Proxy, Cursor verbindet sich direkt und scheitert. Lösung: nach proxy support suchen und Http: Proxy Support auf on oder fallback setzen oder http.proxy und https.proxy von Hand eintragen.
Ich habe einen System-Proxy konfiguriert – warum greift der Cursor proxy trotzdem nicht?
Meist liegt es an http.proxySupport. Cursor erbt die Proxy-Modi von VS Code und steht standardmäßig auf override, nutzt also nur den http.proxy aus der settings.json und ignoriert den System-Proxy; bei einer Neuinstallation ist http.proxy leer, daher wird gar kein Proxy verwendet. Einstellungen öffnen (Ctrl+,), nach proxy support suchen und Http: Proxy Support von override auf on (immer System-Proxy) oder fallback (System-Proxy, wenn http.proxy leer ist) ändern, dann Cursor neu starten. Wer feiner steuern will, lässt override und setzt http.proxy manuell.
Wie behebe ich ERR_HTTP2_PROTOCOL_ERROR?
Zuerst Cursor Settings > Network öffnen und Run Diagnostics ausführen. Wenn Diagnose oder Logs auf HTTP/2-Kompatibilität zeigen, Disable HTTP/2 aktivieren oder HTTP Compatibility Mode auf HTTP/1.1 setzen, danach Cursor vollständig neu starten. Alternativ "cursor.general.disableHttp2": true in der settings.json setzen – gleiche Wirkung, direkt neben den Proxy-Schlüsseln. Kommt der HTTP/2-Fehler mit einem SSL-Handshake-Fehler, stellen Sie das System-DNS auf Cloudflare (1.1.1.1) oder Google (8.8.8.8) um; manchmal löst das DNS zu einem problematischen Knoten auf. Der Startparameter cursor --disable-http2 ist nur ein Fallback für ältere Versionen.
Cursor meldet im Firmennetzwerk ständig Zertifikatsfehler – was tun?
Unternehmensnetze entschlüsseln HTTPS oft per SSL-MITM – Zertifikatsprüfung schlägt fehl. Korrekte Lösung: 1) Root-Zertifikat von IT (.crt/.cer); 2) in „Vertrauenswürdige Stammzertifizierungsstellen" importieren; 3) in settings.json "http.proxyStrictSSL": false setzen. Ohne Zertifikat vorübergehend --ignore-certificate-errors – unsicher, nur als Notlösung.
Proxy-Port 7890 oder 10808?
Hängt von der Proxy-Software ab. Clash: Standard HTTP-Port 7890. V2Ray/V2RayN: 10808. Shadowsocks: meist 1080 (SOCKS5). Unsicher? In den Proxy-Einstellungen „Lokaler Port" oder „Listen-Port" nachsehen. Nur SOCKS5 (z. B. 1080)? In Cursor: socks5://127.0.0.1:1080.
Konfiguration geändert, Cursor verbindet trotzdem nicht – weiter debuggen?
In dieser Reihenfolge: 1) Cursor vollständig beenden (Prozess beenden, nicht nur Fenster schließen), neu starten; 2) Proxy-Software läuft? Browser-Test; 3) Log (%APPDATA%\Cursor\logs\main.log) – neuester ERROR; 4) curl -x http://127.0.0.1:7890 https://api.openai.com; 5) Parameter kombinieren: --proxy-auto-detect --disable-http2 --ignore-certificate-errors.
Wie nutze ich ein Startskript – jedes Mal Terminal?
Nein. Skript erstellen, dann Doppelklick genügt. Windows: .bat (z. B. start-cursor.bat) auf Desktop, künftig darüber starten. macOS/Linux: .sh (start-cursor.sh), chmod +x start-cursor.sh, dann Doppelklick. Oder Desktop-Verknüpfung – wie bei einer normalen App.
Mehrere Startparameter gleichzeitig – Konflikte?
Ja, kombinierbar ohne Konflikt. Häufige Kombinationen: cursor --proxy-auto-detect --disable-http2 (Unternehmen); cursor --disable-http2 --ignore-certificate-errors (Notfall). Parameter mit Leerzeichen trennen. --ignore-certificate-errors senkt die Sicherheit – nur bei Bedarf, nicht dauerhaft.

9 Min. Lesezeit · Veröffentlicht am: 19. Jan. 2026 · Aktualisiert am: 9. Juli 2026

Ähnliche Beiträge

Kommentare

Melde dich mit GitHub an, um einen Kommentar zu hinterlassen

Easton BlogEaston Blog