> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Terminal

> Verwenden Sie das erweiterte Terminal von Windsurf mit Command-Modus, Cascade-Integration, Turbo-Modus für die automatische Ausführung sowie Allow- und Deny-Listen zur Befehlssteuerung.

<div id="command-in-the-terminal">
  # Command im Terminal
</div>

Verwenden Sie die [Command](/de/command/windsurf-overview)-Funktion im Terminal (`Cmd/Ctrl+I`), um aus natürlichsprachigen Eingaben die korrekte CLI-Syntax zu generieren.

<Frame style={{ border: 'none', background: 'none' }}>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf-terminal-command.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=b03f1498ac0b7dc344270f975f9a234f" width="980" height="164" data-path="assets/windsurf-terminal-command.png" />
</Frame>

<div id="send-terminal-selection-to-cascade">
  # Terminalauswahl an Cascade senden
</div>

Markiere einen Abschnitt der Stacktrace-Ausgabe und drücke `Cmd/Ctrl+L`, um ihn an Cascade zu senden. Diese Auswahl kannst du in deiner nächsten Eingabe referenzieren.

<Frame style={{ border: 'none', background: 'none' }}>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf-terminal-selection-mention.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=0f8b76d17cdd96983010e88d9dadf265" width="744" height="144" data-path="assets/windsurf-terminal-selection-mention.png" />
</Frame>

<div id="mention-your-terminal">
  # Dein Terminal @erwähnen
</div>

Chatte in Cascade über deine aktiven Terminal-Sitzungen.

<Frame>
  <video autoPlay muted loop playsInline src="https://mintcdn.com/codeium/vRt4FQOyBeZpD2Pu/assets/terminal-at-mention.mp4?fit=max&auto=format&n=vRt4FQOyBeZpD2Pu&q=85&s=bf7766fe81e0847d7f58d4126980fe64" data-path="assets/terminal-at-mention.mp4" />
</Frame>

<div id="auto-executed-cascade-commands">
  # Automatisch ausgeführte Cascade-Befehle
</div>

Cascade kann mit Zustimmung der Nutzerin oder des Nutzers eigenständig Terminalbefehle ausführen. Du kannst konfigurieren, wie Cascade mit der Befehlsausführung umgeht – über vier unterschiedliche Stufen der automatischen Ausführung – und bestimmte Terminalbefehle können über Allow- und Deny-Listen automatisch zugelassen oder abgelehnt werden.

<div id="auto-execution-levels">
  ## Auto-Ausführungsstufen
</div>

Windsurf bietet vier Stufen der automatischen Befehlsausführung, mit denen du steuern kannst, wie Cascade Terminalbefehle ausführt:

| Stufe             | Beschreibung                                                                                                                                                                                                                                                                                            |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Deaktiviert**   | Die Autoausführung ist vollständig deaktiviert. Alle Befehle erfordern eine manuelle Bestätigung vor der Ausführung.                                                                                                                                                                                    |
| **Nur Allowlist** | Nur Befehle, die mit Einträgen in deiner Allowlist übereinstimmen, können automatisch ausgeführt werden. Alle anderen Befehle erfordern eine manuelle Bestätigung.                                                                                                                                      |
| **Auto**          | Cascade nutzt sein Urteilsvermögen, um zu bestimmen, ob ein Befehl sicher automatisch ausgeführt werden kann. Befehle, die als potenziell riskant eingestuft werden, erfordern weiterhin deine Bestätigung. Diese Funktion ist nur für Nachrichten verfügbar, die mit Premium-Modellen gesendet werden. |
| **Turbo**         | Alle Befehle werden sofort automatisch ausgeführt, außer denen in deiner Denylist.                                                                                                                                                                                                                      |

Du kannst deine bevorzugte Autoausführungsstufe über das Windsurf Settings-Panel in der unteren rechten Ecke des Editors auswählen.

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/cascade-turbo-mode.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=8860ea8311000ae2cc440cef26560620" width="680" height="60" data-path="assets/windsurf/cascade/cascade-turbo-mode.png" />
</Frame>

<div id="admin-controlled-maximum-level-teams-enterprise">
  ### Vom Admin gesteuerte maximale Stufe (Teams & Enterprise)
</div>

Für Teams- und Enterprise-Nutzer können Administratoren eine maximal zulässige Auto-Execution-Stufe für ihre Organisation festlegen. Diese Einstellung beschränkt, welche Stufen für Teammitglieder verfügbar sind, und ermöglicht es Admins, Sicherheitsrichtlinien durchzusetzen, während die Nutzer innerhalb dieser Grenzen dennoch flexibel bleiben.

Wenn ein Admin eine maximale Stufe festlegt, können Nutzer jede Stufe bis einschließlich dieser Maximalstufe auswählen. Wenn ein Admin beispielsweise das Maximum auf „Auto“ setzt, können Nutzer zwischen Disabled, Allowlist Only oder Auto wählen, den Turbo-Modus jedoch nicht aktivieren.

Administratoren können diese Einstellung im <a href="https://windsurf.com/team/settings" target="_blank">Admin Portal</a> unter Team Settings konfigurieren.

<div id="team-wide-command-lists-teams-enterprise">
  ### Teamweite Befehlslisten (Teams & Enterprise)
</div>

Administratoren können **teamweite Allow- und Denylisten** für Terminalbefehle konfigurieren, die für alle Teammitglieder gelten. Diese Listen gelten zusätzlich zu den individuellen Allow-/Denylisten der einzelnen Benutzer.

| List Type     | Behavior                                                                                                                                                             |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Allowlist** | Befehle, die Einträgen in dieser Liste entsprechen, werden automatisch ohne Benutzerbestätigung ausgeführt (wenn die Autoausführung für den Benutzer aktiviert ist). |
| **Denylist**  | Befehle, die Einträgen in dieser Liste entsprechen, erfordern immer eine Benutzerfreigabe vor der Ausführung, unabhängig von den Benutzereinstellungen.              |

**Wesentliche Funktionsweise:**

* **Team- und Benutzerkonfigurationen werden zusammengeführt**: Teamweite Listen werden mit den individuellen Allow-/Denylisten der Benutzer kombiniert, die in den Windsurf-Einstellungen konfiguriert sind. Ein Befehl, der entweder der Team- oder der Benutzer-Allowlist entspricht, wird automatisch ausgeführt (sofern er nicht durch eine Denylist blockiert wird).
* Die **Denylist hat Vorrang** vor der Allowlist – wenn ein Befehl beiden Listen entspricht (auf Team- oder Benutzerebene), ist eine Freigabe erforderlich.

Um teamweite Befehlslisten zu konfigurieren, wechseln Sie zum <a href="https://windsurf.com/team/settings" target="_blank">Admin-Portal</a> → Team Settings → Terminal Commands → **Manage Lists**.

<div id="allow-list">
  ### Allowlist
</div>

Eine Allowlist definiert eine Liste von Terminalbefehlen, die immer automatisch ausgeführt werden. Wenn Sie beispielsweise `git` hinzufügen, akzeptiert Cascade stets `git add -A`.

Die Einstellung kann über die Befehlspalette → Open Settings (UI) → nach `windsurf.cascadeCommandsAllowList` gesucht werden.

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/allow-list.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=be27cab4ada44ba016f41cf7d943ae20" width="2098" height="770" data-path="assets/windsurf/cascade/allow-list.png" />
</Frame>

<div id="deny-list">
  ### Denylist
</div>

Eine Denylist definiert eine Reihe von Terminalbefehlen, die niemals automatisch ausgeführt werden. Wenn Sie zum Beispiel `rm` hinzufügen, fragt Cascade stets um Erlaubnis, bevor `rm index.py` ausgeführt wird.

Die Einstellung finden Sie über Befehlspalette → Open Settings (UI) → Search for `windsurf.cascadeCommandsDenyList`.

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/deny-list.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=83f5c447deeb931e68781fbd6cb89733" width="2090" height="624" data-path="assets/windsurf/cascade/deny-list.png" />
</Frame>

<div id="dedicated-terminal">
  # Dediziertes Terminal
</div>

Seit Wave 13 hat Windsurf ein dediziertes Terminal für Cascade eingeführt, um Befehle unter macOS auszuführen.
Dieses dedizierte Terminal ist getrennt von deinem Standardterminal und verwendet *immer* `zsh` als Shell.

<Frame>
  <img style={{ maxHeight: "350px" }} src="https://mintcdn.com/codeium/qV7Je1rddINQc1la/assets/windsurf/dedicated-terminal.png?fit=max&auto=format&n=qV7Je1rddINQc1la&q=85&s=8de2c0092ba68abc3c44f39868ec7db5" width="1248" height="430" data-path="assets/windsurf/dedicated-terminal.png" />
</Frame>

Das dedizierte Terminal *verwendet* deine zsh-Konfiguration, sodass Aliases und Umgebungsvariablen aus `.zshrc` und anderen zsh-spezifischen Dateien zur Verfügung stehen.

Wenn du eine andere Shell als `zsh` verwendest und möchtest, dass Windsurf dieselben Umgebungsvariablen nutzt, empfehlen wir dir, eine gemeinsame Konfigurationsdatei zu erstellen, die von beiden Shells eingelesen (gesourct) werden kann.

<div id="troubleshooting">
  ### Fehlerbehebung
</div>

Wenn Sie Probleme mit dem dedizierten Terminal haben, können Sie wieder auf das Legacy-Terminal umstellen, indem Sie die Option „Legacy Terminal Profile“ in den Windsurf-Einstellungen aktivieren.
