--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 |
--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 | 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-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 |
--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 | Starten Sie die Sitzung als Hintergrund-Agent und kehren Sie sofort zurück. Gibt die Sitzungs-ID und Verwaltungsbefehle aus. Kombinieren Sie mit --agent, um einen bestimmten Subagenten auszuführen | 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 |
--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 | 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 | Tools, die aus dem Kontext des Modells entfernt werden und nicht verwendet werden können | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort | Legen Sie die Aufwandsstufe für die aktuelle Sitzung fest. Optionen: low, medium, high, xhigh, max; verfügbare Stufen hängen vom Modell ab. Ü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" |
--fallback-model | Aktivieren Sie automatisches Fallback auf ein angegebenes Modell, wenn das Standardmodell überlastet ist. Tritt in Kraft im Print-Modus (-p) und in Hintergrund-Sitzungen, die nicht-interaktiv ausgeführt werden; wird in einer interaktiven Sitzung ignoriert | claude -p --fallback-model sonnet "query" |
--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 alle Hook-Lebenszyklusereignisse in den Ausgabestrom ein. Erfordert --output-format stream-json | claude -p --output-format stream-json --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 --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 -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 | 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 oder opus) oder den vollständigen Namen eines Modells fest. Überschreibt die model Einstellung und ANTHROPIC_MODEL | claude --model claude-sonnet-4-6 |
--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 oder bypassPermissions. Ü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 -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" |
--remote | Erstellen Sie eine neue Web-Sitzung auf claude.ai mit der bereitgestellten Aufgabenbeschreibung | 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 --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. Schließt Sitzungen ein, die dieses Verzeichnis mit /add-dir hinzugefügt haben | claude --resume auth-refactor |
--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: auto (Standard), in-process oder tmux. Überschreibt die teammateMode Einstellung für diese Sitzung. Siehe Anzeigemodus wählen | claude --teammate-mode in-process |
--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" | 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 |
