SpyBara
Go Premium

cli-reference.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

68 added, 68 removed.

2026
Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

CLI-Referenz

Vollständige Referenz für die Claude 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
claude Interaktive Sitzung starten claude
claude "query" Interaktive Sitzung mit initialem Prompt starten claude "explain this project"
claude -p "query" Abfrage über SDK, dann beenden claude -p "explain this function"
cat file | claude -p "query" Weitergeleitete Inhalte verarbeiten cat logs.txt | claude -p "explain"
claude -c Letzte Konversation im aktuellen Verzeichnis fortsetzen claude -c
claude -c -p "query" Fortsetzen über SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Sitzung nach ID oder Name fortsetzen claude -r "auth-refactor" "Finish this PR"
claude update Auf neueste Version aktualisieren claude update
claude gateway Starten Sie den selbstgehosteten Claude Apps Gateway Server für Administratoren, die SSO und Richtlinien vor Claude Code auf Amazon Bedrock, Google Cloud's Agent Platform oder Microsoft Foundry bereitstellen. Erfordert --config, das auf eine gateway.yaml verweist. Verfügbar in Claude Code v2.1.195 und später. claude gateway --config gateway.yaml
claude 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 claude install stable
claude 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 Claude-Abonnements anzumelden claude auth login --console
claude auth logout Abmelden von Ihrem Anthropic-Konto claude auth logout
claude auth status Authentifizierungsstatus als JSON anzeigen. Verwenden Sie --text für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nicht claude auth status
claude agents Öffnen Sie die Agent-Ansicht, um parallele Hintergrundsitzungen zu überwachen und zu versenden. Verwenden Sie --cwd <path>, 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 festzulegen. Akzeptiert --settings, --add-dir, --plugin-dir und --mcp-config wie der oberste claude-Befehl. Das Öffnen der Agent-Ansicht erfordert ein interaktives Terminal claude agents --json
claude attach <id> Verbinden Sie sich mit einer Hintergrundsitzung in diesem Terminal claude attach 7c5dcf5d
claude auto-mode defaults Drucken Sie die integrierten Auto-Modus Klassifiziererregeln als JSON. Verwenden Sie claude auto-mode config, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigen. --label <prefix> druckt nur die Regeln, deren Bezeichnung mit diesem Präfix beginnt, Groß- und Kleinschreibung wird nicht beachtet. Erfordert Claude Code v2.1.208 oder später claude auto-mode defaults --label 'Git Destructive'
claude daemon status Drucken Sie den Hintergrund-Sitzungs-Supervisor Status, Version, Socket-Verzeichnis und Worker-Anzahl für Diagnosen. Beendet mit 1, wenn der Supervisor nicht läuft claude daemon status
claude daemon stop --any Stoppen Sie den Hintergrund-Sitzungs-Supervisor 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 zu erholen claude daemon stop --any --keep-workers
claude 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 aus claude doctor
claude logs <id> Drucken Sie die aktuelle Ausgabe aus einer Hintergrundsitzung claude logs 7c5dcf5d
claude mcp Model Context Protocol (MCP) Server konfigurieren Siehe die Claude Code MCP-Dokumentation.
claude mcp login <name> Führen Sie den OAuth-Fluss eines konfigurierten MCP-Servers aus, ohne das interaktive /mcp-Panel zu öffnen. Funktioniert für HTTP-, SSE- und claude.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 Claude Code v2.1.186 oder später. Siehe Authentifizierung über die Befehlszeile claude mcp login sentry
claude mcp logout <name> Löschen Sie gespeicherte OAuth-Anmeldedaten für einen MCP-Server. Erfordert Claude Code v2.1.186 oder später claude mcp logout sentry
claude plugin Verwalten Sie Claude Code Plugins. Alias: claude plugins. Siehe Plugin-Referenz für Unterbefehle claude plugin install code-review@claude-plugins-official
claude project purge [path] Löschen Sie alle lokalen Claude Code-Status für ein Projekt: Transkripte, Aufgabenlisten, Debug-Protokolle, Datei-Bearbeitungsverlauf, Prompt-Verlaufszeilen und den Projekteintrag in ~/.claude.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 claude project purge ~/work/repo --dry-run
claude remote-control Starten Sie einen Remote Control Server, um Claude Code von Claude.ai oder der Claude App zu steuern. Läuft im Server-Modus (keine lokale interaktive Sitzung). Siehe Server-Modus-Flags claude remote-control --name "My Project"
claude respawn <id> Starten Sie eine Hintergrundsitzung neu, ob laufend oder gestoppt, mit ihrer Konversation intakt. Verwenden Sie --all, um jede laufende Sitzung neu zu starten, z. B. um eine aktualisierte Claude Code Binärdatei zu verwenden claude respawn 7c5dcf5d
claude rm <id> Entfernen Sie eine Hintergrundsitzung aus der Liste. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über claude --resume verfügbar claude rm 7c5dcf5d
claude 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 Claude-Abonnement. Siehe Generieren Sie ein langlebiges Token claude setup-token
claude stop <id> Stoppen Sie eine Hintergrundsitzung. Akzeptiert auch claude kill claude stop 7c5dcf5d
claude ultrareview [target] Führen Sie ultrareview 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 <minutes>, um das 30-Minuten-Standard zu überschreiben claude ultrareview 1234 --json

Wenn Sie einen Unterbefehl falsch eingeben, schlägt Claude Code die nächste Übereinstimmung vor und beendet sich, ohne eine Sitzung zu starten. Zum Beispiel gibt claude udpate Did you mean claude update? aus.

Ab v2.1.199 führt claude --dangerously-skip-permissions daemon <subcommand> den daemon Unterbefehl aus. Frühere Versionen behandelten daemon <subcommand> 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 claude 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 Claude Code mit diesen Befehlszeilenflags an. claude --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 Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; die meisten .claude/ Konfigurationen werden nicht erkannt aus diesen Verzeichnissen. Validiert, dass jeder Pfad als Verzeichnis existiert. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, setzen Sie permissions.additionalDirectories in den Einstellungen claude --add-dir ../apps ../lib
--advisor <model> Aktivieren Sie das serverseitige Advisor-Tool für diese Sitzung mit einem Modell-Alias: opus, sonnet oder fable (v2.1.170+), oder eine vollständige Modell-ID. Hat Vorrang vor der advisorModel-Einstellung für die Sitzung claude --advisor opus
--agent Geben Sie einen Agent für die aktuelle Sitzung an (überschreibt die agent-Einstellung) claude --agent my-custom-agent
--agents Definieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Verwendet die gleichen Feldnamen wie Subagent Frontmatter, plus ein prompt-Feld für die Anweisungen des Agenten claude --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 claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Tools, die ohne Aufforderung zur Berechtigung ausgeführt werden. Siehe Berechtigung Regelsyntax 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 Fügen Sie benutzerdefinierten Text am Ende des Systemprompts jedes Subagenten an, einschließlich verschachtelter Subagenten. Gilt nur im nicht-interaktiven Modus mit -p. Erfordert Claude Code v2.1.205 oder später claude -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 claude --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 claude --append-system-prompt-file ./extra-rules.txt
--ax-screen-reader Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, sodass die tui Einstellung für die Sitzung keine Auswirkung hat. Hat Vorrang vor CLAUDE_AX_SCREEN_READER und der axScreenReader Einstellung. Erfordert Claude Code v2.1.181 oder später claude --ax-screen-reader
--bare Minimaler Modus: Überspringen Sie die automatische Erkennung von Hooks, Skills, Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit Skriptaufrufe schneller starten. Claude hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungstools. Setzt CLAUDE_CODE_SIMPLE. Siehe Bare-Modus claude --bare -p "query"
--betas Beta-Header, die in API-Anfragen einbezogen werden sollen (nur API-Schlüssel-Benutzer) claude --betas interleaved-thinking
--bg, --background Starten Sie die Sitzung als Hintergrund-Agent 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 Claude-Sitzung auszuführen, oder mit --agent, um einen bestimmten Subagenten auszuführen. Kann nicht mit -p/--print kombiniert werden; siehe die Fehlerreferenz claude --bg "investigate the flaky test"
--channels (Forschungsvorschau) MCP-Server, deren Kanal Benachrichtigungen Claude in dieser Sitzung abhören sollte. Durch Leerzeichen getrennte Liste von plugin:<name>@<marketplace> Einträgen. Erfordert Claude.ai-Authentifizierung claude --channels plugin:my-notifier@my-marketplace
--chrome Aktivieren Sie Chrome-Browser-Integration für Web-Automatisierung und Tests claude --chrome
--cloud Erstellen Sie eine neue Web-Sitzung auf claude.ai mit der bereitgestellten Aufgabenbeschreibung claude --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 claude --continue
--dangerously-load-development-channels Aktivieren Sie Kanäle, die sich nicht auf der genehmigten Zulassungsliste befinden, für die lokale Entwicklung. Akzeptiert plugin:<name>@<marketplace> und server:<name> Einträge. Fordert zur Bestätigung auf claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Überspringen Sie Berechtigungsaufforderungen. Entspricht --permission-mode bypassPermissions. Siehe Berechtigungsmodi für das, was dies überspringt und nicht überspringt. Für Sitzungen, die mit --bg gestartet wurden, wird der Modus beibehalten, wenn der Supervisor die Sitzung neu startet claude --dangerously-skip-permissions
--debug Aktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung (zum Beispiel "api,hooks" oder "!statsig,!file") claude --debug "api,mcp"
--debug-file <path> Schreiben Sie Debug-Protokolle in einen bestimmten Dateipfad. Aktiviert implizit den Debug-Modus. Hat Vorrang vor CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--disable-slash-commands Deaktivieren Sie alle Skills und Befehle für diese Sitzung claude --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 für die aktuelle Sitzung fest. Optionen: low, medium, high, xhigh, max oder }ultracode. Verfügbare Stufen hängen vom Modell ab. ultracode startet die Sitzung mit xhigh Aufwand und ultracode aktiviert, und erfordert Claude Code v2.1.203 oder später. Überschreibt die effortLevel Einstellung für diese Sitzung und wird nicht beibehalten claude --effort high
--enable-auto-mode Entfernt in v2.1.111. Auto-Modus ist jetzt standardmäßig im Shift+Tab Zyklus; verwenden Sie --permission-mode auto, um darin zu starten claude --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 claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Führen Sie einen Shell-Befehl als PTY-gestützten Hintergrund-Job anstelle einer Claude-Sitzung aus. Verwenden Sie mit --bg, um von der Shell aus zu starten claude --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. Um eine Kette über Sitzungen hinweg beizubehalten, verwenden Sie die fallbackModel-Einstellung, die dieses Flag überschreibt claude --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) claude --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 Claude den Pull Request erstellt claude --from-pr 123
--ide Verbinden Sie sich automatisch beim Start mit der IDE, wenn genau eine gültige IDE verfügbar ist claude --ide
--init Führen Sie Setup Hooks mit dem init Matcher vor der Sitzung aus (nur Print-Modus) claude -p --init "query"
--init-only Führen Sie Setup und SessionStart Hooks aus, dann beenden Sie ohne eine Konversation zu starten claude --init-only
--include-hook-events Schließen Sie Hook-Lebenszyklusereignisse von jedem Hook-Ereignis in den Ausgabestrom ein. SessionStart und Setup Hook-Ereignisse sind immer enthalten und benötigen dieses Flag nicht. Erfordert --output-format stream-json claude -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 claude -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) claude -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. Claude 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 claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Führen Sie Setup Hooks mit dem maintenance Matcher vor der Sitzung aus (nur Print-Modus) claude -p --maintenance "query"
--max-budget-usd Maximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden kann, bevor gestoppt wird (nur Print-Modus) claude -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. Mit --input-format stream-json bleibt eine Nachricht, die gesendet wird, während Claude 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 Claude Code diese Nachricht claude -p --max-turns 3 "query"
--mcp-config Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt) claude --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 Einstellung und ANTHROPIC_MODEL claude --model claude-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 claude --resume <name> fortsetzen.

/rename ändert den Namen während der Sitzung und zeigt ihn auch in der Eingabeaufforderungsleiste an		 claude -n "my-feature-work"
--no-chrome Deaktivieren Sie Chrome-Browser-Integration für diese Sitzung claude --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 CLAUDE_CODE_SKIP_PROMPT_HISTORY Umgebungsvariable bewirkt das Gleiche in jedem Modus claude -p --no-session-persistence "query"
--output-format Geben Sie das Ausgabeformat für den Print-Modus an (Optionen: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Beginnen Sie in einem angegebenen Berechtigungsmodus. Akzeptiert default, acceptEdits, plan, auto, dontAsk, bypassPermissions oder }manual als Alias für default. Der manual Alias wählt den Modus aus, den die Benutzeroberfläche als Manuell kennzeichnet und erfordert Claude Code v2.1.200 oder später; claude --help listet ihn anstelle von default auf, und beide Werte funktionieren. Überschreibt defaultMode aus Einstellungsdateien claude --permission-mode plan
--permission-prompt-tool Geben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeiten. Claude Code wartet darauf, dass sich der MCP-Server dieses Tools verbindet, bevor der erste Turn ausgeführt wird, bis zum MCP_TIMEOUT Startup-Timeout von 30 Sekunden. Vor v2.1.206 konnte ein langsam startender Server dazu führen, dass die Ausführung mit einem Fehler beendet wird, dass das MCP-Tool nicht gefunden wurde.

Das Prompt-Tool kann ein MCP-Tool, das als Benutzerinteraktion erforderlich gekennzeichnet ist, nicht genehmigen: Claude Code konvertiert ein allow Ergebnis für eines in eine Ablehnung. Diese Einschränkung erfordert Claude Code v2.1.199 oder später		 claude -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 claude --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 claude --plugin-url https://example.com/plugin.zip
--print, -p Geben Sie die Antwort ohne interaktiven Modus aus (siehe Agent SDK-Dokumentation für Details zur programmatischen Verwendung) claude -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 claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--remote Veralteter Alias für --cloud claude --remote "Fix the login bug"
--remote-control, --rc Starten Sie eine interaktive Sitzung mit aktiviertem Remote Control, sodass Sie sie auch von claude.ai oder der Claude App aus steuern können. Optional einen Namen für die Sitzung übergeben claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Präfix für automatisch generierte Remote Control Sitzungsnamen, wenn kein expliziter Name gesetzt ist. Standardmäßig der Hostname Ihrer Maschine, was Namen wie myhost-graceful-unicorn erzeugt. Setzen Sie CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX für den gleichen Effekt claude 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 claude -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 in der Auswahl mit bg gekennzeichnet claude --resume auth-refactor
--safe-mode Starten Sie mit allen Anpassungen deaktiviert, um eine fehlerhafte Konfiguration zu beheben: CLAUDE.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 unterscheidet. Die verwaltete Einstellungsrichtlinie gilt weiterhin, einschließlich richtliniengesteuerter Hooks, Statusleiste und Dateivorschlag-Befehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server nicht. Nützlich, um zu überprüfen, ob eine Anpassung das automatische Fallback von Fable 5 auslöst. Setzt CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Verwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Durch Kommas getrennte Liste von Einstellungsquellen zum Laden (user, project, local) claude --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 claude --settings ./settings.json
--strict-mcp-config Verwenden Sie nur MCP-Server aus --mcp-config, ignorieren Sie alle anderen MCP-Konfigurationen claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Ersetzen Sie den gesamten Systemprompt durch benutzerdefinierten Text claude --system-prompt "You are a Python expert"
--system-prompt-file Laden Sie den Systemprompt aus einer Datei, ersetzen Sie den Standard-Prompt claude --system-prompt-file ./custom-prompt.txt
--teleport Setzen Sie eine Web-Sitzung in Ihrem lokalen Terminal fort claude --teleport
--teammate-mode Legen Sie fest, wie Agent-Team Teamkollegen angezeigt werden: in-process (Standard), auto, tmux oder }iterm2 (hinzugefügt in v2.1.186). Der Standard hat sich von auto in v2.1.179 geändert. Überschreibt die teammateMode Einstellung für diese Sitzung. Siehe Anzeigemodus wählen claude --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 claude -w feature-auth --tmux
--tools Beschränken Sie, welche integrierten Tools Claude 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 claude --tools "Bash,Edit,Read"
--verbose Aktivieren Sie ausführliches Logging, zeigt vollständige Turn-by-Turn-Ausgabe. Überschreibt die viewMode Einstellung für diese Sitzung claude --verbose
--version, -v Geben Sie die Versionsnummer aus claude -v
--worktree, -w Starten Sie Claude in einem isolierten Git Worktree bei <repo>/.claude/worktrees/<name>. Wenn kein Name angegeben wird, wird einer automatisch generiert. Übergeben Sie #<number> oder eine GitHub Pull Request URL, um diesen PR von origin abzurufen und den Worktree davon zu verzweigen claude -w feature-auth

System-Prompt-Flags

Claude 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 claude --system-prompt "You are a Python expert"
--system-prompt-file Ersetzt mit Dateiinhalten claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Fügt zum Standard-Prompt an claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Fügt Dateiinhalte zum Standard-Prompt an claude --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 Claude Codes Standard-Identität noch zu Ihrer Aufgabe passt. Verwenden Sie ein Append-Flag, wenn Claude 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 Claude 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. Für Projektkonventionen, die Claude immer befolgen sollte, verwenden Sie CLAUDE.md. Der Agent SDK-Leitfaden zu Systemprompts behandelt die gleiche Entscheidung ausführlicher.

Siehe auch