Zum Hauptinhalt springen

​
Allgemeine FAQ

Warte zunächst ein paar Minuten auf die Aktualisierung. Wenn das nicht hilft, melde dich auf der Windsurf-Website ab, starte dein IDE neu und melde dich anschließend wieder bei Windsurf an. Achte außerdem darauf, dass du die neueste Version von Windsurf installiert hast.
Du kannst deinen kostenpflichtigen Tarif kündigen, indem du zu deinem Profil gehst: Klicke oben rechts auf dein Symbol auf der Windsurf-Website.Um dein Pro-Abonnement zu kündigen, navigiere in der linken Navigation zur Seite Billing und klicke auf „Cancel Plan“.Um dein Teams-Abonnement zu kündigen, navigiere in der linken Navigation zur Seite Manage Team und klicke auf „Cancel Plan“.
Wie auf unserer Sicherheitsseite beschrieben, kannst du die Telemetrie für Code-Snippets in deinen Kontoeinstellungen deaktivieren. Weitere Informationen findest du in unseren Nutzungsbedingungen.
Du kannst dein Konto löschen, indem du in deinen Kontoeinstellungen nach unten scrollst und auf „Delete Account“ klickst.
Wenn du Mitglied einer Organisation bist, wende dich bitte an deine Administratorin bzw. deinen Administrator.
Du kannst für Funktionen abstimmen, kommentieren und Wünsche in unserem Feature-Request-Forum einreichen.Du kannst uns auch auf Twitter/X kontaktieren! @windsurf

​
Ich stoße auf Rate-Limit-Probleme

Wir unterliegen Rate Limits und erreichen leider gelegentlich die Kapazitätsgrenzen der Premium-AI-Modelle, mit denen wir arbeiten. Wir arbeiten aktiv daran, diese Limits zu erhöhen und unsere vorhandene Kapazität fair zu verteilen! Das wird nicht dauerhaft ein Problem sein. Wenn dieser Fehler auftritt, warten Sie bitte kurz und versuchen Sie es erneut.

​
Pylance oder Pyright funktioniert nicht / Python-Syntaxhervorhebung ist fehlerhaft oder unzureichend

Wir haben eine Pyright-Erweiterung speziell für Windsurf entwickelt. Suchen Sie nach „Windsurf Pyright“ oder fügen Sie @id:codeium.windsurfPyright in die Erweiterungssuche ein.

​
Wie lade ich Diagnose-Logs herunter, um sie an das Windsurf‑Supportteam zu senden?

Sie können Diagnose-Logs herunterladen, indem Sie zum Cascade-Panel gehen, oben rechts auf die drei Punkte klicken und dann auf „Download Diagnostics“ klicken.

​
Unter macOS sehe ich ein Pop-up: „Windsurf“ ist beschädigt und kann nicht geöffnet werden.

Dieses Pop-up entsteht durch einen Fehlalarm in den macOS-Sicherheitsfunktionen. In der Regel lässt sich das beheben, indem Sie zu „Systemeinstellungen -> Datenschutz & Sicherheit“ gehen und für Windsurf auf „Zulassen“ oder „Trotzdem öffnen“ klicken. Wenn das nicht funktioniert oder nicht möglich ist, versuchen Sie Folgendes:
  1. Stellen Sie sicher, dass sich Windsurf im Ordner /Applications befindet und dass Sie es von dort aus starten.
  2. Prüfen Sie Ihren Prozessortyp: Wenn Ihr Mac einen Intel-Chip hat, stellen Sie sicher, dass Sie die Intel-Version haben. Bei Apple Silicon (z. B. M1, M2 oder M3) stellen Sie sicher, dass Sie die Apple‑Silicon‑Version haben. Sie können den Prozessortyp auf der Mac-Download-Seite auswählen.
  3. Laden Sie das DMG erneut herunter und installieren Sie es von der offiziellen Download-Seite neu, da die auslösende Sicherheitsfunktion meist beim Download greift.
  4. Stellen Sie sicher, dass Windsurf (und das Pop-up „Windsurf ist beschädigt“) geschlossen ist, und führen Sie xattr -c "/Applications/Windsurf.app/" aus.

​
Ich habe eine Fehlermeldung zu Updates unter Windows erhalten, oder Updates werden unter Windows nicht angezeigt.

Zum Beispiel:
Updates sind deaktiviert, weil Sie die Benutzerinstallation von Windsurf als Administrator ausführen.
Windsurf kann nicht automatisch aktualisiert werden, wenn es als Administrator ausgeführt wird. Bitte starten Sie Windsurf mit Benutzerrechten neu, um zu aktualisieren.

​
Unter macOS schlägt Remote SSH mit „Undefined error: 0“ fehl, aber SSH funktioniert im Terminal

Wenn Remote SSH in Windsurf sofort fehlschlägt, während dieselbe SSH-Verbindung im Terminal, in VS Code oder in anderen Anwendungen funktioniert, wird dies in der Regel dadurch verursacht, dass macOS den lokalen Netzwerkzugriff von Windsurf blockiert. Im Ausgabeprotokoll von Remote - SSH (View → Output → Remote - SSH) sehen Sie: 
debug1: Connecting to <hostname> port 22.
ssh: connect to host <hostname> port 22: Undefined error: 0
gefolgt von SSH server closed unexpectedly. Error code: 255. Die Meldung Undefined error: 0 (anstatt “Connection refused” oder “Network unreachable”) ist der entscheidende Hinweis — dies ist der Fehler, den macOS zurückgibt, wenn einer Anwendung unter Datenschutz & Sicherheit keine Berechtigung für das lokale Netzwerk erteilt wurde. So beheben Sie das Problem:
  1. Öffnen Sie System Settings → Privacy & Security → Local Network.
  2. Suchen Sie Windsurf in der Liste und aktivieren Sie den Schalter.
  3. Starten Sie Windsurf neu und versuchen Sie erneut, die Verbindung herzustellen.
Wenn Windsurf nicht in der Liste „Local Network“ erscheint, versuchen Sie zunächst, eine SSH-Verbindung aus Windsurf heraus zu starten, um die macOS-Berechtigungsabfrage auszulösen. Wenn die Abfrage zuvor abgelehnt wurde und der Schalter nicht erscheint, führt das Löschen und erneute Installieren von Windsurf dazu, dass die Abfrage beim nächsten Start erneut angezeigt wird.

​
Welche Domains sollte ich für Netzwerkfilter/Firewalls, VPNs oder Proxys auf die Allowlist setzen?

Wenn Sie Netzwerkfilter, Firewalls oder VPN-Dienste verwenden oder in Umgebungen mit eingeschränktem Netzwerkzugang arbeiten, können Verbindungsprobleme mit Windsurf auftreten. Um einen reibungslosen Betrieb sicherzustellen, setzen Sie bitte die folgenden Domains in Ihrer Netzwerkkonfiguration auf die Allowlist:
  • *.codeium.com
  • *.windsurf.com
  • *.codeiumdata.com

​
Unter Linux startet Windsurf stillschweigend nicht oder stürzt beim Start ab

Dies liegt meist an einem Berechtigungsproblem in Electron, das auch VSCode betrifft, und ist zu erwarten, wenn das Tarball unter Linux verwendet wird. Am einfachsten beheben Sie das, indem Sie Folgendes ausführen: 
            sudo chown root:root /path/to/windsurf/chrome-sandbox
            sudo chmod 4755 /path/to/windsurf/chrome-sandbox
Anschließend sollten Sie Windsurf starten können. Sie können auch einfach windsurf mit dem Flag --no-sandbox ausführen, auch wenn wir das nicht empfehlen. Falls das fehlschlägt, versuchen Sie Folgendes.

​
Ich erhalte die Fehlermeldung „Windsurf failed to start“

Warnung: Durch das Löschen dieser Ordner werden Ihr Gesprächsverlauf und Ihre lokalen Einstellungen entfernt!
Löschen Sie den folgenden Ordner: Windows: C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade Linux/Mac: ~/.codeium/windsurf/cascade und starten Sie die IDE neu.

​
Mein Cascade-Panel wird leer

Bitte kontaktieren Sie uns, wenn das passiert! Eine Bildschirmaufnahme wäre sehr hilfreich. Häufig lässt sich das Problem beheben, indem Sie Ihren Chat-Verlauf löschen (~/.codeium/windsurf/cascade).

​
Terminalsitzung scheint in Cascade festzustecken

Wenn ein Terminalbefehl im Terminal fertig ausgeführt wurde, Cascade die Sitzung aber weiterhin als laufend oder festhängend anzeigt, kann dies verschiedene Ursachen haben: Standard-Terminalprofil nicht gesetzt Dies kann daran liegen, dass das Standard-Terminalprofil nicht explizit festgelegt wurde. Um dies zu beheben, können Sie das Standard-Terminalprofil in Ihren Editor-Einstellungen festlegen. Öffnen Sie die Einstellungsoberfläche (Cmd/Ctrl + ,), suchen Sie nach „terminal default profile“ und setzen Sie den passenden Wert für Ihr Betriebssystem. Alternativ können Sie Folgendes zu Ihrer settings.json hinzufügen: Für macOS: 
"terminal.integrated.defaultProfile.osx": "zsh"
Unter Windows: 
"terminal.integrated.defaultProfile.windows": "PowerShell"
Für Linux: 
"terminal.integrated.defaultProfile.linux": "bash"
Ersetzen Sie den Wert durch Ihre bevorzugte Shell (z. B. bash, zsh, PowerShell, Command Prompt usw.). Angepasste zsh-Themes In einigen Fällen kann ein stark angepasstes zsh-Theme (zum Beispiel Themes von Oh My Zsh, Powerlevel10k oder anderen Prompt-Frameworks) ebenfalls dazu führen, dass Cascade weiterhin denkt, ein Befehl würde noch laufen, obwohl er bereits beendet ist. Um zu überprüfen, ob dies die Ursache ist:
  1. Öffnen Sie Ihre Datei ~/.zshrc in einem Texteditor.
  2. Deaktivieren Sie Ihr Theme vorübergehend, indem Sie die Zeilen auskommentieren, die es setzen oder laden, zum Beispiel ZSH_THEME="...", source ~/.p10k.zsh oder eval "$(oh-my-posh init zsh)".
  3. Speichern Sie die Datei, starten Sie Windsurf neu (oder öffnen Sie ein neues Terminal in Windsurf) und führen Sie erneut einen Befehl aus.
Wenn die Terminalsitzung in Cascade nicht mehr festzustecken scheint, können Sie entweder dauerhaft ein einfacheres Theme in ~/.zshrc verwenden oder eine separate, minimale zsh-Konfiguration erstellen, die nur vom Windsurf-Terminal genutzt wird. So können Ihre anderen Terminals weiterhin das komplexere Theme verwenden. Systemd-Terminal-Kontext-Tracking (Linux) Auf einigen neueren Linux-Distributionen (berichtet ab Fedora 43 und höher) kann die Shell-Startkette (~/.bashrc → /etc/bashrc → /etc/profile.d/80-systemd-osc-context.sh) das systemd-”Terminal-Kontext-Tracking” aktivieren, bei dem OSC-3008-Escape-Sequenzen über PS0 oder PROMPT_COMMAND ausgegeben werden. Diese zusätzlichen Steuersequenzen können die Ausgabeanalyse von Cascade stören, sodass ein Befehl so erscheint, als wäre er hängen geblieben, oder dazu führen, dass erfasste Ausgaben fehlen oder abgeschnitten wirken – obwohl das Terminal sie korrekt anzeigt. Um dieses Problem zu umgehen, verhindern Sie, dass die OSC-Kontextsequenzen im Cascade-Terminal ausgegeben werden, indem Sie /etc/bashrc nicht mehr in Ihrer ~/.bashrc einbinden oder eine minimale Shell-Konfigurationsdatei erstellen, die nur für Windsurf/Cascade verwendet wird.

​
Docker-Container im Remote Explorer bei Verwendung von WSL nicht sichtbar

Beim Herstellen einer Verbindung zu Docker-Containern innerhalb von WSL kann es vorkommen, dass im Remote-Explorer-Fenster keine verfügbaren Container zum Verbinden angezeigt werden, sodass Benutzer auf den Workaround über die Befehlspalette angewiesen sind. Verwenden Sie Cmd+P (macOS) oder Ctrl+P (Windows) → “Dev Containers: Attach to Running Container”, um die vollständige Liste der laufenden Container anzuzeigen.