> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# CLI-Referenz
> Vollständige Referenz für die Fuxi Code Befehlszeilenschnittstelle, einschließlich Befehle und Flags.
CLI-Befehle
Sie können Sitzungen starten, Inhalte weiterleiten, Gespräche fortsetzen und Updates verwalten mit diesen Befehlen:
| Befehl | Beschreibung | Beispiel |
| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |
| `fuxi` | Interaktive Sitzung starten | `fuxi` |
| `fuxi "query"` | Interaktive Sitzung mit initialem Prompt starten | `fuxi "explain this project"` |
| `fuxi -p "query"` | Abfrage über SDK, dann beenden | `fuxi -p "explain this function"` |
| `cat file \| fuxi -p "query"` | Weitergeleitete Inhalte verarbeiten | `cat logs.txt \| fuxi -p "explain"` |
| `fuxi -c` | Letzte Konversation im aktuellen Verzeichnis fortsetzen | `fuxi -c` |
| `fuxi -c -p "query"` | Fortsetzen über SDK | `fuxi -c -p "Check for type errors"` |
| `fuxi -r "" "query"` | Sitzung nach ID oder Name fortsetzen | `fuxi -r "auth-refactor" "Finish this PR"` |
| `fuxi update` | Auf neueste Version aktualisieren | `fuxi update` |
| `fuxi gateway` | Starten Sie den selbstgehosteten [Fuxi Apps Gateway](/de/fuxi-apps-gateway) Server für Administratoren, die SSO und Richtlinien vor Fuxi Code auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry bereitstellen. Erfordert `--config`, das auf eine [`gateway.yaml`](/de/fuxi-apps-gateway-config) verweist. Verfügbar in Fuxi Code v2.1.195 und später. | `fuxi gateway --config gateway.yaml` |
| `fuxi install [version]` | Installieren oder neu installieren Sie die native Binärdatei. Akzeptiert eine Version wie `2.1.118`, oder `stable` oder `latest`. Siehe [Installieren Sie eine bestimmte Version](/de/setup#install-a-specific-version) | `fuxi install stable` |
| `fuxi auth login` | Melden Sie sich bei Ihrem Anthropic-Konto an. Verwenden Sie `--email`, um Ihre E-Mail-Adresse vorauszufüllen, `--sso`, um SSO-Authentifizierung zu erzwingen, und `--console`, um sich mit der Anthropic Console für API-Nutzungsabrechnung anstelle eines Fuxi-Abonnements anzumelden | `fuxi auth login --console` |
| `fuxi auth logout` | Abmelden von Ihrem Anthropic-Konto | `fuxi auth logout` |
| `fuxi auth status` | Authentifizierungsstatus als JSON anzeigen. Verwenden Sie `--text` für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht | `fuxi auth status` |
| `fuxi agents` | Öffnen Sie die [Agent-Ansicht](/de/agent-view), um parallele Hintergrundsitzungen zu überwachen und zu versenden. Verwenden Sie `--cwd `, um nur Sitzungen anzuzeigen, die in diesem Verzeichnis gestartet wurden, oder `--json`, um Live-Sitzungen als JSON-Array zum Scripting auszugeben (`--json --all` schließt auch abgeschlossene Hintergrundsitzungen ein). Übergeben Sie `--permission-mode`, `--model`, `--effort` oder `--agent`, um [Standardwerte für versendete Sitzungen](/de/agent-view#permission-mode-model-and-effort) festzulegen. Akzeptiert `--settings`, `--add-dir`, `--plugin-dir` und `--mcp-config` wie der oberste `fuxi`-Befehl. Das Öffnen der Agent-Ansicht erfordert ein interaktives Terminal | `fuxi agents --json` |
| `fuxi attach ` | Verbinden Sie sich mit einer [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) in diesem Terminal | `fuxi attach 7c5dcf5d` |
| `fuxi auto-mode defaults` | Drucken Sie die integrierten [Auto-Modus](/de/permission-modes#eliminate-prompts-with-auto-mode) Klassifiziererregeln als JSON. Verwenden Sie `fuxi auto-mode config`, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen | `fuxi auto-mode defaults > rules.json` |
| `fuxi daemon status` | Drucken Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) Status, Version, Socket-Verzeichnis und Worker-Anzahl für Diagnosen. Beendet mit 1, wenn der Supervisor nicht läuft | `fuxi daemon status` |
| `fuxi daemon stop --any` | Stoppen Sie den Hintergrund-Sitzungs-[Supervisor](/de/agent-view#the-supervisor-process) und die Sitzungen, die er hostet. Übergeben Sie `--keep-workers`, um Hintergrundsitzungen laufen zu lassen, damit sich der nächste Supervisor mit ihnen verbindet. `--any` bestätigt das Stoppen eines On-Demand-Supervisors, was die Standardeinstellung ist. Verwenden Sie dies, um sich von einem [nicht reagierenden Supervisor](/de/agent-view#agent-view-says-the-background-service-did-not-respond) zu erholen | `fuxi daemon stop --any --keep-workers` |
| `fuxi doctor` | Drucken Sie schreibgeschützte Installations- und Einstellungsdiagnosen vom Terminal aus, ohne eine Sitzung zu starten, einschließlich Installationsintegrität, Validierungsfehlern in der Einstellungsdatei und Remote Control-Berechtigung. Für die In-Session-Setup-Überprüfung, die auch Fixes anwenden kann, führen Sie [`/doctor`](/de/commands#all-commands) aus | `fuxi doctor` |
| `fuxi logs ` | Drucken Sie die aktuelle Ausgabe aus einer [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) | `fuxi logs 7c5dcf5d` |
| `fuxi mcp` | Model Context Protocol (MCP) Server konfigurieren | Siehe die [Fuxi Code MCP-Dokumentation](/de/mcp). |
| `fuxi mcp login ` | {/* min-version: 2.1.186 */}Führen Sie den OAuth-Fluss eines konfigurierten MCP-Servers aus, ohne das interaktive `/mcp`-Panel zu öffnen. Funktioniert für HTTP-, SSE- und fuxi.ai-Connector-Server. Fügen Sie `--no-browser` über SSH hinzu, um die Autorisierungs-URL auszudrucken, anstatt einen Browser zu öffnen, und fügen Sie dann die Umleitungs-URL an der Eingabeaufforderung ein. Erfordert Fuxi Code v2.1.186 oder später. Siehe [Authentifizierung über die Befehlszeile](/de/mcp#authenticate-from-the-command-line) | `fuxi mcp login sentry` |
| `fuxi mcp logout ` | {/* min-version: 2.1.186 */}Löschen Sie gespeicherte OAuth-Anmeldedaten für einen MCP-Server. Erfordert Fuxi Code v2.1.186 oder später | `fuxi mcp logout sentry` |
| `fuxi plugin` | Verwalten Sie Fuxi Code [Plugins](/de/plugins). Alias: `fuxi plugins`. Siehe [Plugin-Referenz](/de/plugins-reference#cli-commands-reference) für Unterbefehle | `fuxi plugin install code-review@fuxi-plugins-official` |
| `fuxi project purge [path]` | Löschen Sie alle lokalen Fuxi Code-Status für ein Projekt: Transkripte, Aufgabenlisten, Debug-Protokolle, Datei-Bearbeitungsverlauf, Prompt-Verlaufszeilen und den Projekteintrag in `~/.fuxi.json`. Lassen Sie `[path]` weg, um aus einer interaktiven Liste auszuwählen. Flags: `--dry-run` zum Vorschau, `-y`/`--yes` zum Überspringen der Bestätigung, `-i`/`--interactive` zum Bestätigen jedes Elements, `--all` für jedes Projekt. Siehe [Lokale Daten löschen](/de/fuxi-directory#clear-local-data) | `fuxi project purge ~/work/repo --dry-run` |
| `fuxi remote-control` | Starten Sie einen [Remote Control](/de/remote-control) Server, um Fuxi Code von Fuxi.ai oder der Fuxi App zu steuern. Läuft im Server-Modus (keine lokale interaktive Sitzung). Siehe [Server-Modus-Flags](/de/remote-control#start-a-remote-control-session) | `fuxi remote-control --name "My Project"` |
| `fuxi respawn ` | Starten Sie eine [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) neu, ob laufend oder gestoppt, mit ihrer Konversation intakt. Verwenden Sie `--all`, um jede laufende Sitzung neu zu starten, z. B. um eine aktualisierte Fuxi Code Binärdatei zu verwenden | `fuxi respawn 7c5dcf5d` |
| `fuxi rm ` | Entfernen Sie eine [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell) aus der Liste. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über `fuxi --resume` verfügbar | `fuxi rm 7c5dcf5d` |
| `fuxi setup-token` | Generieren Sie ein langlebiges OAuth-Token für CI und Skripte. Gibt das Token auf dem Terminal aus, ohne es zu speichern. Erfordert ein Fuxi-Abonnement. Siehe [Generieren Sie ein langlebiges Token](/de/authentication#generate-a-long-lived-token) | `fuxi setup-token` |
| `fuxi stop ` | Stoppen Sie eine [Hintergrundsitzung](/de/agent-view#manage-sessions-from-the-shell). Akzeptiert auch `fuxi kill` | `fuxi stop 7c5dcf5d` |
| `fuxi ultrareview [target]` | Führen Sie [ultrareview](/de/ultrareview#run-ultrareview-non-interactively) nicht interaktiv aus. Gibt Ergebnisse auf stdout aus und beendet sich mit 0 bei Erfolg oder 1 bei Fehler. Verwenden Sie `--json` für die rohe Nutzlast und `--timeout `, um das 30-Minuten-Standard zu überschreiben | `fuxi ultrareview 1234 --json` |
Wenn Sie einen Unterbefehl falsch eingeben, schlägt Fuxi Code die nächste Übereinstimmung vor und beendet sich, ohne eine Sitzung zu starten. Zum Beispiel gibt `fuxi udpate` `Did you mean fuxi update?` aus.
{/* min-version: 2.1.199 */}Ab v2.1.199 führt `fuxi --dangerously-skip-permissions daemon ` den `daemon` Unterbefehl aus. Frühere Versionen behandelten `daemon ` als den Prompt für eine neue interaktive Sitzung, sodass der Unterbefehl nie ausgeführt wurde, wenn das Flag zuerst kam, ein häufiges Setup, wenn `fuxi` mit dem Flag aliasiert ist. Nur ein führendes `--dangerously-skip-permissions` oder `--allow-dangerously-skip-permissions` leitet auf diese Weise zu `daemon` weiter; jedes andere führende Flag startet immer noch eine interaktive Sitzung.
CLI-Flags
Passen Sie das Verhalten von Fuxi Code mit diesen Befehlszeilenflags an. `fuxi --help` listet nicht jedes Flag auf, daher bedeutet das Fehlen eines Flags in `--help` nicht, dass es nicht verfügbar ist.
| Flag | Beschreibung | Beispiel |
| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |
| `--add-dir` | Zusätzliche Arbeitsverzeichnisse hinzufügen, auf die Fuxi Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; die meisten `.fuxi/` Konfigurationen werden [nicht erkannt](/de/permissions#additional-directories-grant-file-access-not-configuration) aus diesen Verzeichnissen. Validiert, dass jeder Pfad als Verzeichnis existiert. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, setzen Sie [`permissions.additionalDirectories`](/de/settings#permission-settings) in den Einstellungen | `fuxi --add-dir ../apps ../lib` |
| `--advisor ` | Aktivieren Sie das serverseitige [Advisor-Tool](/de/advisor) für diese Sitzung mit einem Modell-Alias: `opus`, `sonnet` oder `fable` ({/* min-version: 2.1.170 */}v2.1.170+), oder eine vollständige Modell-ID. Hat Vorrang vor der `advisorModel`-Einstellung für die Sitzung | `fuxi --advisor opus` |
| `--agent` | Geben Sie einen Agent für die aktuelle Sitzung an (überschreibt die `agent`-Einstellung) | `fuxi --agent my-custom-agent` |
| `--agents` | Definieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Verwendet die gleichen Feldnamen wie Subagent [Frontmatter](/de/sub-agents#supported-frontmatter-fields), plus ein `prompt`-Feld für die Anweisungen des Agenten | `fuxi --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |
| `--allow-dangerously-skip-permissions` | Fügen Sie `bypassPermissions` zum `Shift+Tab` Modus-Zyklus hinzu, ohne damit zu beginnen. Ermöglicht es Ihnen, in einem anderen Modus wie `plan` zu beginnen und später zu `bypassPermissions` zu wechseln. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `fuxi --permission-mode plan --allow-dangerously-skip-permissions` |
| `--allowedTools`, `--allowed-tools` | Tools, die ohne Aufforderung zur Berechtigung ausgeführt werden. Siehe [Berechtigung Regelsyntax](/de/settings#permission-rule-syntax) für Musterabgleich. Um einzuschränken, welche Tools verfügbar sind, verwenden Sie stattdessen `--tools` | `"Bash(git log *)" "Bash(git diff *)" "Read"` |
| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}Fügen Sie benutzerdefinierten Text am Ende des Systemprompts jedes [Subagenten](/de/sub-agents) an, einschließlich verschachtelter Subagenten. Gilt nur im nicht-interaktiven Modus mit `-p`. Erfordert Fuxi Code v2.1.205 oder später | `fuxi -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |
| `--append-system-prompt` | Fügen Sie benutzerdefinierten Text am Ende des Standard-Systemprompts an | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Laden Sie zusätzlichen Systemprompt-Text aus einer Datei und fügen Sie ihn zum Standard-Prompt an | `fuxi --append-system-prompt-file ./extra-rules.txt` |
| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, sodass die [`tui`](/de/settings#available-settings) Einstellung für die Sitzung keine Auswirkung hat. Hat Vorrang vor [`FUXI_AX_SCREEN_READER`](/de/env-vars) und der [`axScreenReader`](/de/settings#available-settings) Einstellung. Erfordert Fuxi Code v2.1.181 oder später | `fuxi --ax-screen-reader` |
| `--bare` | Minimaler Modus: Überspringen Sie die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatischem Speicher und FUXI.md, damit Skriptaufrufe schneller starten. Fuxi hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungstools. Setzt [`FUXI_CODE_SIMPLE`](/de/env-vars). Siehe [Bare-Modus](/de/headless#start-faster-with-bare-mode) | `fuxi --bare -p "query"` |
| `--betas` | Beta-Header, die in API-Anfragen einbezogen werden sollen (nur API-Schlüssel-Benutzer) | `fuxi --betas interleaved-thinking` |
| `--bg`, `--background` | Starten Sie die Sitzung als [Hintergrund-Agent](/de/agent-view) und kehren Sie sofort zurück. Gibt die Sitzungs-ID und Verwaltungsbefehle aus. Kombinieren Sie mit `--exec`, um einen Shell-Befehl als Hintergrund-Job anstelle einer Fuxi-Sitzung auszuführen, oder mit `--agent`, um einen bestimmten Subagenten auszuführen. {/* min-version: 2.1.198 */}Kann nicht mit `-p`/`--print` kombiniert werden; siehe die [Fehlerreferenz](/de/errors#command-line-errors) | `fuxi --bg "investigate the flaky test"` |
| `--channels` | (Forschungsvorschau) MCP-Server, deren [Kanal](/de/channels) Benachrichtigungen Fuxi in dieser Sitzung abhören sollte. Durch Leerzeichen getrennte Liste von `plugin:@` Einträgen. Erfordert Fuxi.ai-Authentifizierung | `fuxi --channels plugin:my-notifier@my-marketplace` |
| `--chrome` | Aktivieren Sie [Chrome-Browser-Integration](/de/chrome) für Web-Automatisierung und Tests | `fuxi --chrome` |
| `--cloud` | Erstellen Sie eine neue [Web-Sitzung](/de/fuxi-code-on-the-web) auf fuxi.ai mit der bereitgestellten Aufgabenbeschreibung | `fuxi --cloud "Fix the login bug"` |
| `--continue`, `-c` | Laden Sie die letzte Konversation im aktuellen Verzeichnis. Schließt Sitzungen ein, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben | `fuxi --continue` |
| `--dangerously-load-development-channels` | Aktivieren Sie [Kanäle](/de/channels-reference#test-during-the-research-preview), die sich nicht auf der genehmigten Zulassungsliste befinden, für die lokale Entwicklung. Akzeptiert `plugin:@` und `server:` Einträge. Fordert zur Bestätigung auf | `fuxi --dangerously-load-development-channels server:webhook` |
| `--dangerously-skip-permissions` | Überspringen Sie Berechtigungsaufforderungen. Entspricht `--permission-mode bypassPermissions`. Siehe [Berechtigungsmodi](/de/permission-modes#skip-all-checks-with-bypasspermissions-mode) für das, was dies überspringt und nicht überspringt | `fuxi --dangerously-skip-permissions` |
| `--debug` | Aktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung (zum Beispiel `"api,hooks"` oder `"!statsig,!file"`) | `fuxi --debug "api,mcp"` |
| `--debug-file ` | Schreiben Sie Debug-Protokolle in einen bestimmten Dateipfad. Aktiviert implizit den Debug-Modus. Hat Vorrang vor `FUXI_CODE_DEBUG_LOGS_DIR` | `fuxi --debug-file /tmp/fuxi-debug.log` |
| `--disable-slash-commands` | Deaktivieren Sie alle Skills und Befehle für diese Sitzung | `fuxi --disable-slash-commands` |
| `--disallowedTools`, `--disallowed-tools` | Ablehnungsregeln. Ein bloßer Tool-Name entfernt die entsprechenden Tools aus dem Kontext des Modells: `"Edit"` entfernt Edit, `"*"` entfernt jedes Tool und `"mcp__*"` entfernt jedes MCP-Tool. Eine scoped Regel wie `Bash(rm *)` lässt das Tool verfügbar und lehnt nur übereinstimmende Aufrufe ab | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |
| `--effort` | Legen Sie die [Aufwandsstufe](/de/model-config#adjust-effort-level) für die aktuelle Sitzung fest. Optionen: `low`, `medium`, `high`, `xhigh`, `max` oder {/* min-version: 2.1.203 */}}`ultracode`. Verfügbare Stufen hängen vom Modell ab. `ultracode` startet die Sitzung mit `xhigh` Aufwand und [ultracode](/de/workflows#let-fuxi-decide-with-ultracode) aktiviert, und erfordert Fuxi Code v2.1.203 oder später. Überschreibt die [`effortLevel`](/de/settings#available-settings) Einstellung für diese Sitzung und wird nicht beibehalten | `fuxi --effort high` |
| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Entfernt in v2.1.111. Auto-Modus ist jetzt standardmäßig im `Shift+Tab` Zyklus; verwenden Sie `--permission-mode auto`, um darin zu starten | `fuxi --permission-mode auto` |
| `--exclude-dynamic-system-prompt-sections` | Verschieben Sie maschinenspezifische Abschnitte aus dem Systemprompt (Arbeitsverzeichnis, Umgebungsinformationen, Speicherpfade, Git-Repo-Flag) in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über verschiedene Benutzer und Maschinen hinweg, die die gleiche Aufgabe ausführen. Gilt nur mit dem Standard-Systemprompt; wird ignoriert, wenn `--system-prompt` oder `--system-prompt-file` gesetzt ist. Verwenden Sie mit `-p` für Skript-, Multi-Benutzer-Workloads | `fuxi -p --exclude-dynamic-system-prompt-sections "query"` |
| `--exec` | Führen Sie einen Shell-Befehl als PTY-gestützten Hintergrund-Job anstelle einer Fuxi-Sitzung aus. Verwenden Sie mit `--bg`, um von der Shell aus zu starten | `fuxi --bg --exec 'pytest -x'` |
| `--fallback-model` | Aktivieren Sie automatisches Fallback auf das angegebene Modell oder die angegebenen Modelle, wenn das primäre Modell überlastet ist oder nicht verfügbar ist, zum Beispiel ein veraltetes Modell. Akzeptiert eine durch Kommas getrennte Liste, die der Reihe nach versucht wird. Siehe [Fallback-Modellketten](/de/model-config#fallback-model-chains). Um eine Kette über Sitzungen hinweg beizubehalten, verwenden Sie die [`fallbackModel`-Einstellung](/de/settings#available-settings), die dieses Flag überschreibt | `fuxi --fallback-model sonnet,haiku` |
| `--fork-session` | Erstellen Sie beim Fortsetzen eine neue Sitzungs-ID, anstatt die ursprüngliche wiederzuverwenden (verwenden Sie mit `--resume` oder `--continue`) | `fuxi --resume abc123 --fork-session` |
| `--from-pr` | Setzen Sie Sitzungen fort, die mit einem bestimmten Pull Request verknüpft sind. Akzeptiert eine PR-Nummer, eine GitHub oder GitHub Enterprise PR URL, eine GitLab Merge Request URL oder eine Bitbucket Pull Request URL. Sitzungen werden automatisch verknüpft, wenn Fuxi den Pull Request erstellt | `fuxi --from-pr 123` |
| `--ide` | Verbinden Sie sich automatisch beim Start mit der IDE, wenn genau eine gültige IDE verfügbar ist | `fuxi --ide` |
| `--init` | Führen Sie [Setup Hooks](/de/hooks#setup) mit dem `init` Matcher vor der Sitzung aus (nur Print-Modus) | `fuxi -p --init "query"` |
| `--init-only` | Führen Sie [Setup](/de/hooks#setup) und `SessionStart` Hooks aus, dann beenden Sie ohne eine Konversation zu starten | `fuxi --init-only` |
| `--include-hook-events` | Schließen Sie alle Hook-Lebenszyklusereignisse in den Ausgabestrom ein. Erfordert `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-hook-events "query"` |
| `--include-partial-messages` | Schließen Sie partielle Streaming-Ereignisse in die Ausgabe ein. Erfordert `--print` und `--output-format stream-json` | `fuxi -p --output-format stream-json --verbose --include-partial-messages "query"` |
| `--input-format` | Geben Sie das Eingabeformat für den Print-Modus an (Optionen: `text`, `stream-json`) | `fuxi -p --output-format json --input-format stream-json` |
| `--json-schema` | Erhalten Sie validierte JSON-Ausgabe, die einem JSON-Schema entspricht, nachdem der Agent seinen Workflow abgeschlossen hat (nur Print-Modus). Siehe [strukturierte Ausgaben](/de/agent-sdk/structured-outputs). {/* min-version: 2.1.205 */}Fuxi Code beendet sich mit einem Fehler bei einem ungültigen Schema und akzeptiert das `format` Schlüsselwort als Anmerkung ohne clientseitige Validierung. Vor v2.1.205 erzeugte ein ungültiges Schema unstrukturierte Ausgabe ohne Fehler, und Schemas mit `format` wurden als ungültig behandelt | `fuxi -p --json-schema '{"type":"object","properties":{...}}' "query"` |
| `--maintenance` | Führen Sie [Setup Hooks](/de/hooks#setup) mit dem `maintenance` Matcher vor der Sitzung aus (nur Print-Modus) | `fuxi -p --maintenance "query"` |
| `--max-budget-usd` | Maximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden kann, bevor gestoppt wird (nur Print-Modus) | `fuxi -p --max-budget-usd 5.00 "query"` |
| `--max-turns` | Begrenzen Sie die Anzahl der agentic Turns (nur Print-Modus). Beendet mit einem Fehler, wenn das Limit erreicht wird. Standardmäßig kein Limit. {/* min-version: 2.1.205 */}Mit `--input-format stream-json` bleibt eine Nachricht, die gesendet wird, während Fuxi arbeitet, in der Warteschlange und wird als eigener Turn mit eigenem Limit ausgeführt, wenn das Limit den aktuellen beendet. Vor v2.1.205 verwarf Fuxi Code diese Nachricht | `fuxi -p --max-turns 3 "query"` |
| `--mcp-config` | Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt) | `fuxi --mcp-config ./mcp.json` |
| `--model` | Legt das Modell für die aktuelle Sitzung mit einem Alias für das neueste Modell (`sonnet`, `opus`, `haiku` oder `fable`) oder den vollständigen Namen eines Modells fest. Überschreibt die [`model`](/de/settings#available-settings) Einstellung und [`ANTHROPIC_MODEL`](/de/model-config#environment-variables) | `fuxi --model fuxi-sonnet-5` |
| `--name`, `-n` | Legen Sie einen Anzeigenamen für die Sitzung fest, der in `/resume` und der Terminalleiste angezeigt wird. Sie können eine benannte Sitzung mit `fuxi --resume ` fortsetzen.
[`/rename`](/de/commands) ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an | `fuxi -n "my-feature-work"` |
| `--no-chrome` | Deaktivieren Sie [Chrome-Browser-Integration](/de/chrome) für diese Sitzung | `fuxi --no-chrome` |
| `--no-session-persistence` | Deaktivieren Sie die Sitzungspersistenz, sodass Sitzungen nicht auf der Festplatte gespeichert werden und nicht fortgesetzt werden können. Nur Print-Modus. Die [`FUXI_CODE_SKIP_PROMPT_HISTORY`](/de/env-vars) Umgebungsvariable bewirkt das Gleiche in jedem Modus | `fuxi -p --no-session-persistence "query"` |
| `--output-format` | Geben Sie das Ausgabeformat für den Print-Modus an (Optionen: `text`, `json`, `stream-json`) | `fuxi -p "query" --output-format json` |
| `--permission-mode` | Beginnen Sie in einem angegebenen [Berechtigungsmodus](/de/permission-modes). Akzeptiert `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` oder {/* min-version: 2.1.200 */}}`manual` als Alias für `default`. Der `manual` Alias wählt den Modus aus, den die Benutzeroberfläche als Manuell kennzeichnet und erfordert Fuxi Code v2.1.200 oder später; `fuxi --help` listet ihn anstelle von `default` auf, und beide Werte funktionieren. Überschreibt `defaultMode` aus Einstellungsdateien | `fuxi --permission-mode plan` |
| `--permission-prompt-tool` | Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. {/* min-version: 2.1.199 */}Ab v2.1.199 kann das Prompt-Tool ein MCP-Tool, das als [Benutzerinteraktion erforderlich](/de/mcp#require-approval-for-a-specific-tool) gekennzeichnet ist, nicht genehmigen: ein `allow` Ergebnis für eines wird in eine Ablehnung umgewandelt | `fuxi -p --permission-prompt-tool mcp_auth_tool "query"` |
| `--plugin-dir` | Laden Sie ein Plugin aus einem Verzeichnis oder `.zip` Archiv nur für diese Sitzung. Jedes Flag nimmt einen Pfad auf. Wiederholen Sie das Flag für mehrere Plugins: `--plugin-dir A --plugin-dir B.zip` | `fuxi --plugin-dir ./my-plugin` |
| `--plugin-url` | Rufen Sie ein Plugin `.zip` Archiv von einer URL nur für diese Sitzung ab. Wiederholen Sie das Flag für mehrere Plugins, oder übergeben Sie durch Leerzeichen getrennte URLs in einem einzelnen Wert in Anführungszeichen | `fuxi --plugin-url https://example.com/plugin.zip` |
| `--print`, `-p` | Geben Sie die Antwort ohne interaktiven Modus aus (siehe [Agent SDK-Dokumentation](/de/agent-sdk/overview) für Details zur programmatischen Verwendung) | `fuxi -p "query"` |
| `--prompt-suggestions` | Geben Sie eine `prompt_suggestion` Nachricht nach jedem Turn mit einem vorhergesagten nächsten Benutzer-Prompt aus. Erfordert `--print`, `--output-format stream-json` und `--verbose`. Siehe [Prompt-Vorschläge](/de/interactive-mode#prompt-suggestions) | `fuxi -p --prompt-suggestions --output-format stream-json --verbose "query"` |
| `--remote` | Veralteter Alias für `--cloud` | `fuxi --remote "Fix the login bug"` |
| `--remote-control`, `--rc` | Starten Sie eine interaktive Sitzung mit aktiviertem [Remote Control](/de/remote-control#start-a-remote-control-session), sodass Sie sie auch von fuxi.ai oder der Fuxi App aus steuern können. Optional einen Namen für die Sitzung übergeben | `fuxi --remote-control "My Project"` |
| `--remote-control-session-name-prefix ` | Präfix für automatisch generierte [Remote Control](/de/remote-control) Sitzungsnamen, wenn kein expliziter Name gesetzt ist. Standardmäßig der Hostname Ihrer Maschine, was Namen wie `myhost-graceful-unicorn` erzeugt. Setzen Sie `FUXI_REMOTE_CONTROL_SESSION_NAME_PREFIX` für den gleichen Effekt | `fuxi remote-control --remote-control-session-name-prefix dev-box` |
| `--replay-user-messages` | Geben Sie Benutzernachrichten von stdin auf stdout zurück zur Bestätigung aus. Erfordert `--input-format stream-json` und `--output-format stream-json` | `fuxi -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |
| `--resume`, `-r` | Setzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung auszuwählen. Die Auswahl und Namenssuche schließen Sitzungen ein, die dieses Verzeichnis mit `/add-dir` hinzugefügt haben; das Übergeben einer Sitzungs-ID durchsucht nur das aktuelle Projektverzeichnis und seine Git Worktrees. Ab v2.1.144 erscheinen [Hintergrund-Sitzungen](/de/agent-view) in der Auswahl mit `bg` gekennzeichnet | `fuxi --resume auth-refactor` |
| `--safe-mode` | {/* min-version: 2.1.169 */}Starten Sie mit allen Anpassungen deaktiviert, um eine fehlerhafte Konfiguration zu beheben: FUXI.md, Skills, Plugins, Hooks, MCP-Server, benutzerdefinierte Befehle und Agenten, Ausgabestile, Workflows, benutzerdefinierte Designs, benutzerdefinierte Tastenkombinationen, Statusleiste und Dateivorschlag-Befehle, LSP-Server und Auto-Memory werden nicht geladen. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal, was sich von [`--bare`](/de/headless#start-faster-with-bare-mode) unterscheidet. Die verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtliniengesteuerter Hooks, Statusleiste und Dateivorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete FUXI.md und richtliniengesteuerter MCP-Server nicht. Nützlich, um zu überprüfen, ob eine Anpassung das [automatische Fallback von Fable 5](/de/model-config#automatic-model-fallback) auslöst. Setzt [`FUXI_CODE_SAFE_MODE`](/de/env-vars) | `fuxi --safe-mode` |
| `--session-id` | Verwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein) | `fuxi --session-id "550e8400-e29b-41d4-a716-446655440000"` |
| `--setting-sources` | Durch Kommas getrennte Liste von Einstellungsquellen zum Laden (`user`, `project`, `local`) | `fuxi --setting-sources user,project` |
| `--settings` | Pfad zu einer Einstellungs-JSON-Datei oder eine JSON-Zeichenkette. Werte, die Sie hier setzen, überschreiben die gleichen Schlüssel in Ihren `settings.json` Dateien für diese Sitzung. Schlüssel, die Sie weglassen, behalten ihre dateigestützten Werte. Siehe [Einstellungspriorität](/de/settings#settings-precedence) | `fuxi --settings ./settings.json` |
| `--strict-mcp-config` | Verwenden Sie nur MCP-Server aus `--mcp-config`, ignorieren Sie alle anderen MCP-Konfigurationen | `fuxi --strict-mcp-config --mcp-config ./mcp.json` |
| `--system-prompt` | Ersetzen Sie den gesamten Systemprompt durch benutzerdefinierten Text | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Laden Sie den Systemprompt aus einer Datei, ersetzen Sie den Standard-Prompt | `fuxi --system-prompt-file ./custom-prompt.txt` |
| `--teleport` | Setzen Sie eine [Web-Sitzung](/de/fuxi-code-on-the-web) in Ihrem lokalen Terminal fort | `fuxi --teleport` |
| `--teammate-mode` | Legen Sie fest, wie [Agent-Team](/de/agent-teams) Teamkollegen angezeigt werden: `in-process` (Standard), `auto`, `tmux` oder {/* min-version: 2.1.186 */}}`iterm2` (hinzugefügt in v2.1.186). Der Standard hat sich von `auto` in v2.1.179 geändert. Überschreibt die [`teammateMode`](/de/settings#available-settings) Einstellung für diese Sitzung. Siehe [Anzeigemodus wählen](/de/agent-teams#choose-a-display-mode) | `fuxi --teammate-mode auto` |
| `--tmux` | Erstellen Sie eine tmux-Sitzung für den Worktree. Erfordert `--worktree`. Verwendet native iTerm2-Bereiche, wenn verfügbar; übergeben Sie `--tmux=classic` für traditionelles tmux | `fuxi -w feature-auth --tmux` |
| `--tools` | Beschränken Sie, welche integrierten Tools Fuxi verwenden kann. Verwenden Sie `""`, um alle zu deaktivieren, `"default"` für alle oder Tool-Namen wie `"Bash,Edit,Read"`. MCP-Tools sind nicht betroffen; um diese auch zu verweigern, verwenden Sie `--disallowedTools "mcp__*"` oder übergeben Sie `--strict-mcp-config` ohne `--mcp-config`, sodass keine MCP-Server geladen werden | `fuxi --tools "Bash,Edit,Read"` |
| `--verbose` | Aktivieren Sie ausführliches Logging, zeigt vollständige Turn-by-Turn-Ausgabe. Überschreibt die [`viewMode`](/de/settings#available-settings) Einstellung für diese Sitzung | `fuxi --verbose` |
| `--version`, `-v` | Geben Sie die Versionsnummer aus | `fuxi -v` |
| `--worktree`, `-w` | Starten Sie Fuxi in einem isolierten [Git Worktree](/de/worktrees) bei `/.fuxi/worktrees/`. Wenn kein Name angegeben wird, wird einer automatisch generiert. Übergeben Sie `#` oder eine GitHub Pull Request URL, um diesen PR von `origin` abzurufen und den Worktree davon zu verzweigen | `fuxi -w feature-auth` |
System-Prompt-Flags
Fuxi Code bietet vier Flags zum Anpassen des Systemprompts. Alle vier funktionieren sowohl im interaktiven als auch im nicht-interaktiven Modus.
| Flag | Verhalten | Beispiel |
| :---------------------------- | :--------------------------------------- | :------------------------------------------------------ |
| `--system-prompt` | Ersetzt den gesamten Standard-Prompt | `fuxi --system-prompt "You are a Python expert"` |
| `--system-prompt-file` | Ersetzt mit Dateiinhalten | `fuxi --system-prompt-file ./prompts/review.txt` |
| `--append-system-prompt` | Fügt zum Standard-Prompt an | `fuxi --append-system-prompt "Always use TypeScript"` |
| `--append-system-prompt-file` | Fügt Dateiinhalte zum Standard-Prompt an | `fuxi --append-system-prompt-file ./style-rules.txt` |
`--system-prompt` und `--system-prompt-file` schließen sich gegenseitig aus. Die Append-Flags können mit einem der Ersetzungs-Flags kombiniert werden.
Wählen Sie basierend darauf, ob Fuxi Codes Standard-Identität noch zu Ihrer Aufgabe passt. Verwenden Sie ein Append-Flag, wenn Fuxi ein Coding-Assistent bleiben sollte, der auch Ihre zusätzlichen Regeln befolgt: Pro-Aufruf-Anweisungen, Ausgabeformatierung oder Domänenkontext für ein `-p` Skript. Das Anhängen bewahrt die Standard-Tool-Anleitung, Sicherheitsanweisungen und Coding-Konventionen, sodass Sie nur das liefern, was sich unterscheidet. Verwenden Sie ein Ersetzungs-Flag, wenn sich die Oberfläche, Identität oder das Berechtigungsmodell von Fuxi Code unterscheidet, wie ein Nicht-Coding-Agent in einer Pipeline, die kein Mensch überwacht. Das Ersetzen verwirft den gesamten Standard-Prompt, einschließlich Tool-Anleitung und Sicherheitsanweisungen, sodass Sie die Verantwortung für das übernehmen, was Ihre Aufgabe noch benötigt.
Diese Flags gelten nur für den aktuellen Aufruf. Für persistente Personas, die Sie zwischen verschiedenen Projekten wechseln und teilen können, verwenden Sie [Ausgabestile](/de/output-styles). Für Projektkonventionen, die Fuxi immer befolgen sollte, verwenden Sie [FUXI.md](/de/memory). Der [Agent SDK-Leitfaden zu Systemprompts](/de/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) behandelt die gleiche Entscheidung ausführlicher.
Siehe auch
* [Chrome-Erweiterung](/de/chrome) - Browser-Automatisierung und Web-Tests
* [Interaktiver Modus](/de/interactive-mode) - Tastenkombinationen, Eingabemodi und interaktive Funktionen
* [Schnellstart-Anleitung](/de/quickstart) - Erste Schritte mit Fuxi Code
* [Häufige Workflows](/de/common-workflows) - Erweiterte Workflows und Muster
* [Einstellungen](/de/settings) - Konfigurationsoptionen
* [Agent SDK-Dokumentation](/de/agent-sdk/overview) - Programmatische Verwendung und Integrationen