SpyBara
Go Premium

cli-reference.md 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC

This page contains 5 additions and 3 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

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 auto-mode reset Stellen Sie die Standard-Auto-Modus Konfiguration wieder her, indem Sie den autoMode Abschnitt aus Ihrer Benutzereinstellungsdatei entfernen. Fordert zur Bestätigung auf, bevor geschrieben wird; übergeben Sie -y/--yes, um die Eingabeaufforderung zu überspringen. Regeln aus verwalteten Einstellungen oder dem --settings Flag gelten weiterhin. Erfordert Claude Code v2.1.212 oder später. Siehe Überprüfen Sie die Standardwerte und Ihre effektive Konfiguration claude auto-mode reset --yes
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 import [source] Starten Sie eine interaktive Sitzung, die /import ausführt, um Konfiguration von anderen Coding-Agenten in Claude Code zu bringen. Akzeptiert die gleichen --dry-run und --yes Optionen wie der Befehl. Nicht verfügbar auf Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry oder Claude Platform auf AWS. Auch nicht verfügbar, wenn Sie Feature-Flag-Abruf deaktivieren. Erfordert Claude Code v2.1.213 oder später claude import codex --dry-run
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. Nach dem Stoppen des Servers können Sie die Sitzungen, die er bedient hat, zurückbringen. Siehe Sitzungen nach dem Stoppen des Servers fortsetzen 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. Wenn die Entfernung über das Worktree der Sitzung abgelehnt wird und ein zweites claude rm kann es beheben, gibt die Ablehnung das genaue Flag und den Wert aus, die übergeben werden sollen: --discard-unpushed <commit>@<worktree-id> verwirft ein Worktree, das nicht gepushte Commits zusammen mit diesen Commits hat, und --force-remove-worktree <worktree-id> löscht ein Worktree-Verzeichnis, das git oder der WorktreeRemove Hook nicht entfernen konnte. --discard-unpushed erfordert Claude Code v2.1.260 oder später, und --force-remove-worktree erfordert v2.1.268 oder später. Das Konversationstranskript bleibt auf Ihrem lokalen Computer erhalten und ist über claude --resume verfügbar claude rm 7c5dcf5d
claude self-hosted-runner Starten Sie einen Runner-Prozess, der diese Maschine oder diesen Container bei einer selbstgehosteten Umgebung registriert und Claude Code Cloud-Sitzungen auf Ihrer Infrastruktur hostet. Führen Sie claude self-hosted-runner setup für eine geführte Operator-Anleitung aus, claude self-hosted-runner doctor, um einen bereitgestellten Runner zu diagnostizieren, und claude self-hosted-runner orchestrator, um On-Demand-Runner zu spawnen. Erfordert Claude Code v2.1.224 oder später claude self-hosted-runner setup
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 45-Minuten-Standard zu überschreiben. Verwenden Sie --post auf einem github.com Pull-Request-Ziel, um die fertigen Ergebnisse als einen einfachen Kommentar von Ihrem GitHub-Konto auf dem PR zu posten. --no-post ist die Standardeinstellung. --post und --no-post erfordern Claude Code v2.1.227 oder später. Siehe Ergebnisse auf den Pull Request posten 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 Befehlszeilenflaggen an. claude --help listet nicht alle Flaggen auf, daher bedeutet das Fehlen einer Flagge in --help nicht, dass sie nicht verfügbar ist.

Flag Beschreibung Beispiel
--add-dir Fügen Sie zusätzliche Arbeitsverzeichnisse hinzu, damit Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; Claude Code erkennt die meisten .claude/-Konfigurationen aus diesen Verzeichnissen nicht automatisch. Validiert, dass jeder Pfad als Verzeichnis existiert. Sie können die meisten Netzwerkpfade nicht hinzufügen, z. B. \\server\share. Um diese Verzeichnisse über Sitzungen hinweg beizubehalten, legen Sie permissions.additionalDirectories in den Einstellungen fest claude --add-dir ../apps ../lib
--advisor <model> Aktivieren Sie das serverseitige Advisor-Tool für diese Sitzung mit einem Modellalias, fable, opus oder sonnet, oder einer vollständigen Modell-ID. Hat Vorrang vor der advisorModel-Einstellung für die Sitzung. fable erfordert Fable-Zugriff 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. Akzeptiert die für CLI-definierte Subagenten aufgelisteten Felder. Claude Code validiert das JSON beim Start und beendet sich bei einem ungültigen Wert; siehe Invalid --agents configuration für die Nachricht und für die Flaggen und Umgebungsvariablen, die die Validierung überspringen. Die Validierung erfordert Claude Code v2.1.242 oder später claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Fügen Sie bypassPermissions zum Shift+Tab-Moduszyklus hinzu, ohne darin zu starten. 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 Berechtigungsaufforderung ausgeführt werden. Siehe Berechtigungsregelsyntax für Musterabgleich. Um einzuschränken, welche Tools verfügbar sind, verwenden Sie stattdessen --tools. Wenn Sie eines der Task-Tracking-Tools hier benennen, aktiviert Claude Code die Sitzung auch dafür "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Fügen Sie benutzerdefinierten Text am Ende des System-Prompts jedes Subagenten an, einschließlich verschachtelter Subagenten, mit Ausnahme eines abgespaltenen Subagenten, der den eigenen Prompt der Konversation wiederverwendet. 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-subagent-system-prompt-file Laden Sie Text aus einer Datei und fügen Sie ihn an Subagenten-System-Prompts an. Eine Alternative zu --append-subagent-system-prompt für Text, der zu lang ist, um ihn in der Befehlszeile zu übergeben. Die beiden Flaggen können nicht kombiniert werden. Gilt nur im nicht-interaktiven Modus mit -p. Erfordert Claude Code v2.1.261 oder später claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Fügen Sie benutzerdefinierten Text am Ende des Standard-System-Prompts an claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Laden Sie zusätzlichen System-Prompt-Text aus einer Datei und fügen Sie ihn an den Standard-Prompt an claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Legen Sie das Auto-Compact-Fenster für diese Sitzung fest, ohne Ihre gespeicherten Einstellungen zu ändern. Akzeptiert die gleichen Werte wie /autocompact; dieser Abschnitt behandelt die Wertformen und was die Flagge überschreibt. Erfordert Claude Code v2.1.221 oder später claude --autocompact 500k
--ax-screen-reader Rendern Sie bildschirmleserfreundliche Ausgabe: flacher Text ohne dekorative Rahmen oder Animationen. Erzwingt den klassischen Renderer, daher hat die tui-Einstellung keine Auswirkung; angehängte Hintergrund-Sitzungen werden immer noch im Vollbildmodus gerendert. 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 Minimalmodus: Überspringen Sie die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagenten, Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit Skriptaufrufe schneller starten. Skills in einem Verzeichnis, das Sie mit --add-dir übergeben, werden immer noch geladen. 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üsselbenutzer) 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 statt 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 Anthropic-Authentifizierung über claude.ai oder einen Console-API-Schlüssel claude --channels plugin:my-notifier@my-marketplace
--chrome Aktivieren Sie Chrome-Browserintegration für Webautomatisierung und Tests claude --chrome
--cloud Mit einer Aufgabenbeschreibung erstellen Sie eine neue Cloud-Sitzung. Mit einer Sitzungs-ID (session_... oder cse_...) oder einer claude.ai/code-URL fügen Sie stattdessen eine Nachricht in diese vorhandene Sitzung ein, mit -p. Siehe Folgenachricht senden. claude --cloud "Fix the login bug"
--continue, -c Laden Sie die neueste Konversation im aktuellen Verzeichnis, einschließlich einer Hintergrund-Sitzung, die beendet wurde; das Öffnen beendeter Hintergrund-Sitzungen erfordert Claude Code v2.1.257 oder später. Überspringt Sitzungen, die mit claude -p oder dem Agent SDK erstellt wurden, und Sitzungen, deren erster Prompt /loop war. claude -p --continue umfasst -p-, SDK- und /loop-Sitzungen. Umfasst Sitzungen, die dieses Verzeichnis mit /add-dir hinzugefügt haben claude --continue
--dangerously-load-development-channels Aktivieren Sie Kanäle, die nicht auf der genehmigten Zulassungsliste stehen, 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, bleibt der Modus bestehen, wenn der Supervisor die Sitzung neu startet claude --dangerously-skip-permissions
--debug Aktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung, z. B. --debug='mcp,startup' oder --debug='!1p'. Der Filter bindet nur in der =-Form; ein durch Leerzeichen getrennter Filter aktiviert den Debug-Modus ohne Filterung claude --debug='mcp,startup'
--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 Claudes Kontext: "Edit" entfernt Edit, "*" entfernt alle Tools, und "mcp__*" entfernt alle MCP-Tools. Eine bereicherte Regel wie Bash(rm *) lässt das Tool verfügbar und lehnt nur Aufrufe ab, die wie geschrieben übereinstimmen. Eine Regel, die EndConversation benennt, kann es nicht entfernen, während ein anderes Tool verbleibt "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Legen Sie die Anstrengungsstufe für die aktuelle Sitzung fest. Optionen: low, medium, high, xhigh, max, oder ultracode. Verfügbare Stufen hängen vom Modell ab. ultracode fordert xhigh-Anstrengung mit ultracode an und erfordert Claude Code v2.1.203 oder später. Überschreibt die modelSettings- und effortLevel-Einstellungen für diese Sitzung und bleibt nicht bestehen claude --effort high
--enable-auto-mode Entfernt in v2.1.111. Der Auto-Modus ist jetzt standardmäßig im Shift+Tab-Zyklus; verwenden Sie --permission-mode auto, um darin zu starten claude --permission-mode auto
--environment <environment-id> Erstellen Sie eine neue Cloud-Sitzung, die in der selbstgehosteten Umgebung mit der angegebenen ID ausgeführt wird. Umgebungs-IDs beginnen mit ccpool_. Siehe Dispatch-Verhalten von --environment für Dispatch-Verhalten und die Flaggenkombinationen, die es ablehnt. Erfordert Claude Code v2.1.224 oder später claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Verschieben Sie maschinenspezifische Abschnitte aus dem System-Prompt (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-System-Prompt; 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 statt 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 oder nicht verfügbar ist, z. B. 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 diese Flagge ü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
--forward-subagent-text Geben Sie Subagenten-Text und Thinking-Blöcke im Ausgabestrom als assistant- und user-Nachrichten mit parent_tool_use_id gesetzt aus, damit Sie das Transkript jedes Subagenten rekonstruieren können. Ohne diese Flagge lässt Claude Code den Text und die Thinking-Blöcke eines Subagenten weg, der im Vordergrund ausgeführt wird. Erfordert --print und --output-format stream-json. Claude Code leitet auch Nachrichten von verschachtelten Subagenten weiter und setzt parent_tool_use_id auf die ID des Agent- oder Skill-Tool-Aufrufs, der jeden spawnt; dies erfordert Claude Code v2.1.219 oder später, und Nachrichten von Subagenten, die ein abgespaltener Skill spawnt, und von verschachtelten abgespaltenen Skills erfordern v2.1.275 oder später. Die CLAUDE_CODE_FORWARD_SUBAGENT_TEXT-Umgebungsvariable aktiviert das gleiche Verhalten. Erfordert Claude Code v2.1.211 oder später claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Öffnen Sie die Sitzungsauswahl gefiltert nach Sitzungen, 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 und beenden Sie sich dann, ohne eine Konversation zu starten claude --init-only
--include-hook-events Beziehen Sie Hook-Lebenszyklusereignisse in den Ausgabestrom ein. SessionStart- und Setup-Hook-Ereignisse sind immer enthalten und benötigen diese Flagge nicht. Einige Hook-Ereignisse wie Notification, SessionEnd, PreCompact und PostCompact erzeugen niemals ein hook_started-Ereignis, auch nicht mit dieser Flagge. Für diese Ereignisse gibt Claude Code immer noch hook_progress aus, während ein Command-Hook, der länger als eine Sekunde läuft, Ausgabe erzeugt, und gibt hook_response nur aus, wenn ein Hook, der im Hintergrund läuft, beendet wird. Erfordert --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Beziehen 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 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 soll, bevor gestoppt wird (nur Print-Modus). Ausgaben von Subagenten zählen zur Obergrenze. Wenn Sie zu einer Konversation mit --continue oder --resume zurückkehren, zählen Gesamtsummen wiederhergestellt aus früheren Läufen nicht dazu. Sobald die Ausgaben die Obergrenze erreichen, schlägt das Spawnen eines anderen Subagenten mit Budget limit reached fehl, und Claude Code stoppt Hintergrund-Subagenten, die noch laufen; die Obergrenzendurchsetzungsverhalten erfordern Claude Code v2.1.217 oder später claude -p --max-budget-usd 5.00 "query"
--max-turns Begrenzen Sie die Anzahl der agentengesteuerten Turns (nur Print-Modus). Beendet sich mit einem Fehler, wenn die Grenze erreicht wird. Standardmäßig keine Grenze. Mit --input-format stream-json bleibt eine Nachricht, die noch in die Warteschlange eingereiht ist, wenn die Grenze einen Turn beendet, in der Warteschlange und startet einen neuen Turn mit seiner eigenen Grenze claude -p --max-turns 3 "query"
--mcp-config Laden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt). Wenn Sie diese Flagge mit -p übergeben, wartet Claude Code darauf, dass noch ausstehende Server verbunden werden, bevor der erste Turn ausgeführt wird, bis zum MCP_TIMEOUT-Starttimeout, standardmäßig 30 Sekunden; ein Server mit einer zwischengespeicherten Tool-Liste überspringt das Warten und verbindet sich bei der ersten Verwendung. Das Warten erfordert Claude Code v2.1.221 oder später claude --mcp-config ./mcp.json
--model Legt das Modell für die aktuelle Sitzung mit einem Modellalias wie sonnet, opus, haiku oder fable oder einem vollständigen Modellnamen 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. In einer interaktiven Sitzung, wenn eine andere Live-Sitzung auf dieser Maschine bereits den Namen verwendet, wendet Claude Code eine Variante davon an.

/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-Browserintegration 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 macht 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 Berechtigungsmodus aus, den die UI als Manual 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. Ohne diese Flagge oder --dangerously-skip-permissions startet eine neue Sitzung im Berechtigungsmodus, der in welcher Berechtigungsmodus eine Sitzung startet beschrieben ist. Für -p ist das default, wenn nichts konfiguriert ist 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 der MCP-Server dieses Tools verbunden wird, bevor der erste Turn ausgeführt wird, bis zum MCP_TIMEOUT-Starttimeout, standardmäßig 30 Sekunden.

Das Prompt-Tool kann ein MCP-Tool, das als Benutzerinteraktion erfordernd gekennzeichnet ist, nicht genehmigen: Claude Code konvertiert ein allow-Ergebnis dafür in eine Ablehnung. Diese Einschränkung erfordert Claude Code v2.1.199 oder später		 claude -p --permission-prompt-tool mcp_auth_tool "query"
--permission-prompts Legen Sie fest, wer Berechtigungsaufforderungen im Print-Modus beantwortet. Mit dem Standard host sendet Claude Code sie an den Agent SDK-Host oder das --permission-prompt-tool-Tool. Übergeben Sie none, wenn niemand antworten kann, und Claude Code lehnt sie stattdessen ab. Siehe Berechtigungsaufforderungen in unbeaufsichtigten Läufen ausschalten. Erfordert Claude Code v2.1.259 oder später claude -p --permission-prompts none "query"
--plugin-dir Laden Sie ein Plugin aus einem Verzeichnis oder .zip-Archiv, oder mehrere aus einem Ordner von Plugins, nur für diese Sitzung. Jede Flagge nimmt einen Pfad. Wiederholen Sie die Flagge für mehr Pfade: --plugin-dir A --plugin-dir B.zip. Das Übergeben eines Ordners von Plugins erfordert Claude Code v2.1.265 oder später claude --plugin-dir ./my-plugin
--plugin-url Rufen Sie ein Plugin .zip-Archiv von einer URL ab, nur für diese Sitzung. Wiederholen Sie die Flagge für mehrere Plugins, oder übergeben Sie durch Leerzeichen getrennte URLs in einem einzelnen angeführten Wert claude --plugin-url https://example.com/plugin.zip
--print, -p Drucken Sie die Antwort ohne interaktiven Modus (siehe Agent SDK-Dokumentation für Details zur programmatischen Verwendung) claude -p "query"
--prompt-suggestions Geben Sie eine prompt_suggestion-Nachricht mit einem vorhergesagten nächsten Benutzer-Prompt nach jedem Turn aus, der einen erzeugt; sehr kurze Konversationen können keine erzeugen. Erfordert --print, --output-format stream-json und --verbose. Siehe Prompt-Vorschläge claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> Mit --environment basieren Sie den Checkout der neuen Sitzung auf einer benannten Ref anstelle des lokalen HEAD claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Veralteter Alias für --cloud, einschließlich der vorhandenen Sitzungsform claude --remote "Fix the login bug"
--remote-control, --rc Starten Sie eine interaktive Sitzung mit Remote Control aktiviert, damit Sie sie auch von claude.ai oder der Claude-App aus steuern können. Übergeben Sie optional einen Namen für die Sitzung 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. Legen Sie CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX für den gleichen Effekt fest 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
--restricted Starten Sie im eingeschränkten Modus. Verwenden Sie ihn, wenn ein Evaluierungs-Harness claude auf einer gemeinsamen Maschine antreibt und Claude Code keine Befehle ausführen oder die Benutzer- und Projekteinstellungen dieser Maschine lesen darf. Claude Code entfernt die integrierten Tools, die Befehle oder Code ausführen, und WebFetch, es sei denn, Sie benennen sie einzeln in --tools, nicht durch die default-Voreinstellung. Es beschränkt auch die integrierten Datei-Tools auf die Arbeitsverzeichnisse, lädt nur verwaltete Einstellungen und --settings, lehnt bypassPermissions ab, und lehnt ab, Cloud-Sitzungen zu erstellen. Erfordert Claude Code v2.1.248 oder später claude --restricted -p "query"
--resume, -r Setzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung zu wählen. Anstelle einer ID können Sie den absoluten Pfad zur Transkriptdatei einer Sitzung übergeben. Die Auswahl und Namenssuche umfassen Sitzungen, die dieses Verzeichnis mit /add-dir hinzugefügt haben. Wenn Sie eine Sitzungs-ID übergeben, durchsucht Claude Code das aktuelle Projektverzeichnis und seine Git-Worktrees, dann jedes andere Projekt auf dieser Maschine. Vor v2.1.223 deckte die ID-Suche nur das aktuelle Projektverzeichnis und seine Git-Worktrees ab. Hintergrund-Sitzungen erscheinen 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 Tastenbindungen, Statusleisten- und Dateivorschlagsbefehle, LSP-Server und automatischer Speicher werden nicht geladen. Authentifizierung, Modellauswahl, integrierte Tools und Berechtigungen funktionieren normal, was sich von --bare unterscheidet. Die Richtlinie für verwaltete Einstellungen gilt immer noch, einschließlich richtliniengesteuerter Hooks, Statusleiste und Dateivorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server nicht. Nützlich, um zu überprüfen, ob eine Anpassung das auslöst, was automatisches Modell-Fallback 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 ein Inline-JSON-String. 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. Die Datei muss eine reguläre Datei sein, nicht größer als 2 MiB. Siehe Einstellungspriorität claude --settings ./settings.json
--strict-mcp-config Verwenden Sie nur MCP-Server aus --mcp-config, ignorieren Sie alle anderen MCP-Konfigurationen. Siehe Exklusive Kontrolle mit managed-mcp.json für das, was die Flagge unter einer verwalteten MCP-Datei tut claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Ersetzen Sie den gesamten System-Prompt durch benutzerdefinierten Text claude --system-prompt "You are a Python expert"
--system-prompt-file Laden Sie den System-Prompt aus einer Datei, ersetzen Sie den Standard-Prompt claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Übergeben Sie off, um den System-Prompt bei jeder Anfrage neu zu erstellen, anstatt den Prompt aufgezeichnet bei der ersten Anfrage der Konversation wiederzuverwenden, z. B. während Sie die Formulierung über --continue-Läufe hinweg iterieren. Erfordert Claude Code v2.1.257 oder später claude --system-prompt-snapshot off
--teleport Setzen Sie eine Cloud-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). Ü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 den Standard-Satz, oder Tool-Namen wie "Bash,Edit,Read". Auf macOS, Linux und WSL lässt der Standard-Satz Glob und Grep weg, wie unter Glob-Tool-Verhalten beschrieben. Wenn Sie eines der Task-Tracking-Tools hier benennen, aktiviert Claude Code die Sitzung auch dafür. Die Flagge beeinflusst MCP-Tools nicht; um diese auch zu verweigern, verwenden Sie --disallowedTools "mcp__*". Eine Liste, die EndConversation auslässt, entfernt es nicht; "" entfernt es nur, wenn keine MCP-Tools verbleiben 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 unter <repo>/.claude/worktrees/<name>. Wenn Sie keinen Namen angeben, generiert Claude Code einen. Übergeben Sie #<number>, eine GitHub-Pull-Request-URL oder eine GitLab-Merge-Request-URL, um diesen PR oder MR von origin abzurufen und den Worktree davon zu verzweigen. Das Verzweigen von einer GitLab-Merge-Request erfordert Claude Code v2.1.233 oder später claude -w feature-auth

System-Prompt-Flaggen

Claude Code bietet fünf Flaggen zum Anpassen des System-Prompts. Vier setzen seinen Text, und mit --system-prompt-snapshot kontrollieren Sie, ob eine Konversation den Text behält, mit dem sie begonnen hat. Alle fünf 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 an den Standard-Prompt an claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Fügt Dateiinhalte an den Standard-Prompt an claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot Mit off wird der Prompt bei jeder Anfrage neu erstellt. Mit on, dem Standard, wird ein aufgezeichneter Prompt wiederverwendet, wo Aufzeichnung gilt claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

--system-prompt und --system-prompt-file schließen sich gegenseitig aus. Die Append-Flaggen können mit einer der Ersetzungsflaggen kombiniert werden.

Wenn der Ersetzungstext Anweisungen kombiniert, die bei jedem Lauf gleich sind, mit Kontext, der sich pro Lauf ändert, fügen Sie eine Zeile ein, die nur __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ enthält, zwischen den Anweisungen und dem Kontext. Claude Code teilt den Prompt an der ersten solchen Zeile auf und entfernt diese Zeile, sodass der Teil darüber zwischengespeichert bleibt, während sich der Teil darunter ändert. Erfordert Claude Code v2.1.275 oder später. Zwischengespeichern Sie den statischen Teil eines benutzerdefinierten Prompts listet die Konfigurationen auf, wo die Aufteilung gilt.

Wählen Sie basierend darauf, ob Claudes Standard-Identität immer noch zu Ihrer Aufgabe passt. Verwenden Sie eine Append-Flagge, 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, daher müssen Sie nur das liefern, was sich unterscheidet. Verwenden Sie eine Ersetzungsflagge, 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 lässt den gesamten Standard-Prompt fallen, einschließlich Tool-Anleitung und Sicherheitsanweisungen, daher übernehmen Sie die Verantwortung für das, was Ihre Aufgabe noch benötigt.

Für persistente Personas, die Sie zwischen ihnen wechseln und über ein Projekt hinweg teilen können, verwenden Sie Ausgabestile. Für Projektkonventionen, die Claude immer befolgen sollte, verwenden Sie CLAUDE.md. Der Agent SDK-Leitfaden zu System-Prompts behandelt die gleiche Entscheidung ausführlicher.

System-Prompt-Flaggen in fortgesetzten Konversationen

Standardmäßig erstellt Claude Code den System-Prompt einmal, bei der ersten Anfrage einer Konversation, mit dem Text aus allen angewendeten System-Prompt-Flaggen, und zeichnet ihn in der Sitzung auf. Bis die Konversation komprimiert wird, verwendet jede spätere Anfrage diesen aufgezeichneten Prompt, auch nachdem Sie zur Konversation mit --resume oder --continue zurückkehren. Wenn Sie beim späteren Start unterschiedlichen System-Prompt-Flag-Text übergeben oder keinen, tritt er in Kraft, sobald die Konversation komprimiert wird oder wenn Sie eine neue Konversation starten.

Außerhalb von Cloud-Sitzungen startet Claude Code im Bare-Modus durch Übergabe von --bare oder Setzen von CLAUDE_CODE_SIMPLE=1, die Aufzeichnung bleibt aus, es sei denn, Sie übergeben --system-prompt-snapshot on. Vor v2.1.268 erstellten Sitzungen, die Feature-Flags nicht abrufen, einschließlich Sitzungen auf Amazon Bedrock, Google Cloud's Agent Platform und Microsoft Foundry, den Prompt bei jeder Anfrage neu und --system-prompt-snapshot hatte keine Auswirkung.

Um den Prompt bei jeder Anfrage neu zu erstellen, z. B. während Sie seine Formulierung über --continue-Läufe hinweg iterieren, übergeben Sie --system-prompt-snapshot off. Vor v2.1.265 schaltete das Übergeben einer der System-Prompt-Flaggen auch die Aufzeichnung aus, es sei denn, Sie übergaben --system-prompt-snapshot on.

Siehe auch