--add-dir | Fügen Sie zusätzliche Arbeitsverzeichnisse hinzu, in denen Claude Dateien lesen und bearbeiten kann. Gewährt Dateizugriff; Claude Code erkennt die meisten .claude/-Konfigurationen aus diesen Verzeichnissen nicht. Validiert, dass jeder Pfad als Verzeichnis existiert. Sie können die meisten Netzwerkpfade nicht hinzufügen, wie 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. Mit --print kann der Wert stattdessen der Pfad zu einer JSON-Datei sein, die das Objekt enthält; die Dateiform erfordert Claude Code v2.1.281 oder später. Claude Code validiert das JSON beim Start und beendet sich bei einem ungültigen Wert; siehe Invalid --agents configuration für die Meldung und für die Flags 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 | "Bash(git log *)" "Bash(git diff *)" "Read" |
--append-subagent-system-prompt | Hängen Sie benutzerdefinierten Text an das 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 hängen 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 Flags 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 | Hängen Sie benutzerdefinierten Text an das 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 hängen 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 den Flag ü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 | Minimaler Modus: Überspringen Sie die automatische Erkennung von Hooks, Skills, benutzerdefinierten Befehlen, Subagenten, installierten Plugins, MCP-Servern, automatischem Speicher und CLAUDE.md, damit skriptgesteuerte Aufrufe schneller starten. Skills in einem Verzeichnis, das Sie mit --add-dir übergeben, werden immer noch geladen. Claude hat Zugriff auf Bash-, Dateilesungs- und Dateibearbeitungs-Tools. 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 statt einer Claude-Sitzung auszuführen, oder mit --agent, um einen bestimmten Subagenten auszuführen. Überprüft Workspace-Vertrauen für das Verzeichnis, bevor es startet. 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-Browser-Integration für Web-Automatisierung und Tests | claude --chrome |
--cloud | Mit einer Task-Beschreibung erstellen Sie eine neue Cloud-Sitzung. Mit einer Sitzungs-ID (session_... oder cse_...) oder einer claude.ai/code-URL, reihen Sie stattdessen eine Nachricht in diese bestehende Sitzung ein, mit -p. Siehe Senden Sie eine Folgenachricht. | 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 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, bleibt der Modus bestehen, wenn der Supervisor die Sitzung neu startet | claude --dangerously-skip-permissions |
--debug | Aktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung, wie 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 |
--desktop | Öffnen Sie die Claude Desktop-App im aktuellen Verzeichnis und beenden Sie sich, ohne eine Sitzung im Terminal zu starten. Fügen Sie --continue oder --resume mit einer Sitzungs-ID hinzu, um diese Sitzung stattdessen in Desktop zu öffnen. --resume akzeptiert hier nur eine Sitzungs-ID, keine Namen oder Transkriptpfade. Akzeptiert keinen Prompt und keine anderen Flags außer --verbose und den --debug-Flags, da die App die Sitzung selbst startet. Verfügbar auf macOS und x64 Windows, wenn Sie mit einem Claude-Abonnement angemeldet sind. Erfordert Claude Code v2.1.285 oder später | claude --desktop |
--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 jedes Tool, und "mcp__*" entfernt jedes MCP-Tool. Eine scoped-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 --environment-Dispatch-Verhalten für Dispatch-Verhalten und die Flag-Kombinationen, 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 benutzerspezifische Kontexte, wie z. B. den Speicherort des automatischen Speichers, aus dem System-Prompt in die erste Benutzernachricht. Verbessert die Prompt-Cache-Wiederverwendung über verschiedene Benutzer und Maschinen, die die gleiche Task 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 skriptgesteuerte, 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 dieser 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 |
--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 diesen Flag lässt Claude Code den Text und die Thinking-Blöcke eines Subagenten weg, der im Vordergrund läuft. Erfordert --print und --output-format stream-json. Claude Code leitet auch Nachrichten von verschachtelten Subagenten weiter, wobei parent_tool_use_id auf die ID des Agent- oder Skill-Tool-Aufrufs gesetzt wird, der jeden startet; 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 auf 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 mit der IDE beim Start, 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 diesen Flag nicht. Einige Hook-Ereignisse, wie Notification, SessionEnd, PreCompact und PostCompact, erzeugen niemals ein hook_started-Ereignis, auch nicht mit diesem Flag. 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 aus früheren Läufen wiederhergestellt nicht zur Obergrenze. Sobald die Ausgaben die Obergrenze erreichen, schlägt das Spawnen eines weiteren 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 diesen Flag mit -p übergeben, wartet Claude Code darauf, dass noch ausstehende Server verbunden werden, bevor der erste Turn ausgeführt wird, bis zum MCP_TIMEOUT-Startup-Timeout, 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-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 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, 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 diesen Flag oder --dangerously-skip-permissions startet eine neue Sitzung im Berechtigungsmodus, der in welcher Berechtigungsmodus eine Sitzung startet beschrieben ist, was auch abdeckt, in welchem Modus ein -p-Lauf startet | 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-Startup-Timeout, 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 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" |
--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 Deaktivieren Sie Berechtigungsaufforderungen in unbeaufsichtigten Läufen. 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. Jeder Flag nimmt einen Pfad. Wiederholen Sie den Flag 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 für diese Sitzung nur ab. Wiederholen Sie den Flag 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 | Geben Sie die Antwort ohne interaktiven Modus aus (siehe Agent SDK-Dokumentation für Details zur programmatischen Verwendung). Für --resume bei einer Hintergrund-Sitzung, die noch läuft, siehe Eine laufende Hintergrund-Sitzung fortsetzen | 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 bestehenden 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 zur Bestätigung auf stdout 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 .jsonl ü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. Das Fortsetzen einer noch laufenden Sitzung öffnet diese Sitzung in diesem Terminal über claude attach, und ein Prompt, den Sie in der Befehlszeile übergeben, geht an sie als ihr nächster Turn. Vor v2.1.285 lehnte Claude Code ab und gab stattdessen den claude attach-Befehl aus | 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, Status-Zeile und Datei-Vorschlagsbefehle, 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, Status-Zeile und Datei-Vorschlagsbefehle; verwaltete Plugins, verwaltete Skills, verwaltete CLAUDE.md und richtliniengesteuerter MCP-Server werden nicht geladen. 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). Siehe Agent-Ansicht und Agent-Teams für die Sitzungen, die Sie von dieser aus starten und die Liste erben | 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 der Flag 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 den --append-system-prompt-Text ü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. Überschreibt die teammateMode-Einstellung für diese Sitzung. Siehe Wählen Sie einen Anzeigemodus | claude --teammate-mode auto |
--tmux | Erstellen Sie eine Tmux-Sitzung für den Worktree. Erfordert --worktree. Verwendet native iTerm2-Panes, 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. Der Flag beeinflusst nicht MCP-Tools; 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-für-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 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 zu holen und den Worktree davon zu verzweigen. Das Verzweigen von einem GitLab-Merge-Request erfordert Claude Code v2.1.233 oder später | claude -w feature-auth |
