Zum Hauptinhalt springen

CLI-Befehle

Sie können Sitzungen starten, Inhalte weiterleiten, Gespräche fortsetzen und Updates verwalten mit diesen Befehlen:
BefehlBeschreibungBeispiel
claudeInteraktive Sitzung startenclaude
claude "query"Interaktive Sitzung mit initialem Prompt startenclaude "explain this project"
claude -p "query"Abfrage über SDK, dann beendenclaude -p "explain this function"
cat file | claude -p "query"Weitergeleitete Inhalte verarbeitencat logs.txt | claude -p "explain"
claude -cLetzte Konversation im aktuellen Verzeichnis fortsetzenclaude -c
claude -c -p "query"Fortsetzen über SDKclaude -c -p "Check for type errors"
claude -r "<session>" "query"Sitzung nach ID oder Name fortsetzenclaude -r "auth-refactor" "Finish this PR"
claude updateAuf neueste Version aktualisierenclaude update
claude auth loginMelden 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 anzumeldenclaude auth login --console
claude auth logoutAbmelden von Ihrem Anthropic-Kontoclaude auth logout
claude auth statusAuthentifizierungsstatus als JSON anzeigen. Verwenden Sie --text für benutzerfreundliche Ausgabe. Beendet mit Code 0, wenn angemeldet, 1, wenn nichtclaude auth status
claude agentsAlle konfigurierten Subagenten auflisten, gruppiert nach Quelleclaude agents
claude auto-mode defaultsDrucken Sie die integrierten Auto-Modus Klassifiziererregeln als JSON. Verwenden Sie claude auto-mode config, um Ihre effektive Konfiguration mit angewendeten Einstellungen anzuzeigenclaude auto-mode defaults > rules.json
claude mcpModel Context Protocol (MCP) Server konfigurierenSiehe die Claude Code MCP-Dokumentation.
claude pluginVerwalten Sie Claude Code Plugins. Alias: claude plugins. Siehe Plugin-Referenz für Unterbefehleclaude plugin install code-review@claude-code-marketplace
claude remote-controlStarten 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-Flagsclaude remote-control --name "My Project"

CLI-Flags

Passen Sie das Verhalten von Claude Code mit diesen Befehlszeilenflags an:
FlagBeschreibungBeispiel
--add-dirZusätzliche Arbeitsverzeichnisse hinzufügen, auf die Claude zugreifen kann (validiert, dass jeder Pfad als Verzeichnis existiert)claude --add-dir ../apps ../lib
--agentGeben Sie einen Agent für die aktuelle Sitzung an (überschreibt die agent-Einstellung)claude --agent my-custom-agent
--agentsDefinieren Sie benutzerdefinierte Subagenten dynamisch über JSON. Verwendet die gleichen Feldnamen wie Subagent Frontmatter, plus ein prompt-Feld für die Anweisungen des Agentenclaude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissionsAktivieren Sie das Umgehen von Berechtigungen als Option, ohne es sofort zu aktivieren. Ermöglicht die Zusammensetzung mit --permission-mode (mit Vorsicht verwenden)claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedToolsTools, 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-promptFügen Sie benutzerdefinierten Text am Ende des Standard-Systemprompts anclaude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileLaden Sie zusätzlichen Systemprompt-Text aus einer Datei und fügen Sie ihn zum Standard-Prompt anclaude --append-system-prompt-file ./extra-rules.txt
--bareMinimaler 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-Modusclaude --bare -p "query"
--betasBeta-Header, die in API-Anfragen einbezogen werden sollen (nur API-Schlüssel-Benutzer)claude --betas interleaved-thinking
--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-Authentifizierungclaude --channels plugin:my-notifier@my-marketplace
--chromeAktivieren Sie Chrome-Browser-Integration für Web-Automatisierung und Testsclaude --chrome
--continue, -cLaden Sie die letzte Konversation im aktuellen Verzeichnisclaude --continue
--dangerously-load-development-channelsAktivieren 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 aufclaude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissionsÜberspringen Sie alle Berechtigungsaufforderungen (mit Vorsicht verwenden). Siehe Berechtigungsmodi für das, was dies überspringt und nicht überspringtclaude --dangerously-skip-permissions
--debugAktivieren Sie den Debug-Modus mit optionaler Kategoriefilterung (zum Beispiel "api,hooks" oder "!statsig,!file")claude --debug "api,mcp"
--disable-slash-commandsDeaktivieren Sie alle Skills und Befehle für diese Sitzungclaude --disable-slash-commands
--disallowedToolsTools, die aus dem Kontext des Modells entfernt werden und nicht verwendet werden können"Bash(git log *)" "Bash(git diff *)" "Edit"
--effortLegen Sie die Aufwandsstufe für die aktuelle Sitzung fest. Optionen: low, medium, high, max (nur Opus 4.6). Sitzungsbezogen und wird nicht in den Einstellungen beibehaltenclaude --effort high
--fallback-modelAktivieren Sie automatisches Fallback auf das angegebene Modell, wenn das Standardmodell überlastet ist (nur Print-Modus)claude -p --fallback-model sonnet "query"
--fork-sessionErstellen Sie beim Fortsetzen eine neue Sitzungs-ID, anstatt die ursprüngliche wiederzuverwenden (verwenden Sie mit --resume oder --continue)claude --resume abc123 --fork-session
--from-prSetzen Sie Sitzungen fort, die mit einem bestimmten GitHub PR verknüpft sind. Akzeptiert eine PR-Nummer oder URL. Sitzungen werden automatisch verknüpft, wenn sie über gh pr create erstellt werdenclaude --from-pr 123
--ideVerbinden Sie sich automatisch beim Start mit der IDE, wenn genau eine gültige IDE verfügbar istclaude --ide
--initFühren Sie Initialisierungs-Hooks aus und starten Sie den interaktiven Modusclaude --init
--init-onlyFühren Sie Initialisierungs-Hooks aus und beenden Sie (keine interaktive Sitzung)claude --init-only
--include-partial-messagesSchließ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-formatGeben Sie das Eingabeformat für den Print-Modus an (Optionen: text, stream-json)claude -p --output-format json --input-format stream-json
--json-schemaErhalten 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"
--maintenanceFühren Sie Wartungs-Hooks aus und beenden Sieclaude --maintenance
--max-budget-usdMaximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden kann, bevor gestoppt wird (nur Print-Modus)claude -p --max-budget-usd 5.00 "query"
--max-turnsBegrenzen Sie die Anzahl der agentic Turns (nur Print-Modus). Beendet mit einem Fehler, wenn das Limit erreicht wird. Standardmäßig kein Limitclaude -p --max-turns 3 "query"
--mcp-configLaden Sie MCP-Server aus JSON-Dateien oder Strings (durch Leerzeichen getrennt)claude --mcp-config ./mcp.json
--modelLegt 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 festclaude --model claude-sonnet-4-6
--name, -nLegen 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-chromeDeaktivieren Sie Chrome-Browser-Integration für diese Sitzungclaude --no-chrome
--no-session-persistenceDeaktivieren Sie die Sitzungspersistenz, sodass Sitzungen nicht auf der Festplatte gespeichert werden und nicht fortgesetzt werden können (nur Print-Modus)claude -p --no-session-persistence "query"
--output-formatGeben Sie das Ausgabeformat für den Print-Modus an (Optionen: text, json, stream-json)claude -p "query" --output-format json
--enable-auto-modeEntsperren Sie Auto-Modus im Shift+Tab Zyklus. Erfordert einen Team-Plan (Enterprise und API-Unterstützung wird in Kürze ausgerollt) und Claude Sonnet 4.6 oder Opus 4.6claude --enable-auto-mode
--permission-modeBeginnen Sie in einem angegebenen Berechtigungsmodusclaude --permission-mode plan
--permission-prompt-toolGeben Sie ein MCP-Tool an, um Berechtigungsaufforderungen im nicht-interaktiven Modus zu verarbeitenclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirLaden Sie Plugins aus einem Verzeichnis nur für diese Sitzung. Jedes Flag nimmt einen Pfad auf. Wiederholen Sie das Flag für mehrere Verzeichnisse: --plugin-dir A --plugin-dir Bclaude --plugin-dir ./my-plugins
--print, -pGeben Sie die Antwort ohne interaktiven Modus aus (siehe Agent SDK-Dokumentation für Details zur programmatischen Verwendung)claude -p "query"
--remoteErstellen Sie eine neue Web-Sitzung auf claude.ai mit der bereitgestellten Aufgabenbeschreibungclaude --remote "Fix the login bug"
--remote-control, --rcStarten 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 übergebenclaude --remote-control "My Project"
--resume, -rSetzen Sie eine bestimmte Sitzung nach ID oder Name fort, oder zeigen Sie eine interaktive Auswahl an, um eine Sitzung auszuwählenclaude --resume auth-refactor
--session-idVerwenden Sie eine bestimmte Sitzungs-ID für die Konversation (muss eine gültige UUID sein)claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sourcesDurch Kommas getrennte Liste von Einstellungsquellen zum Laden (user, project, local)claude --setting-sources user,project
--settingsPfad zu einer Einstellungs-JSON-Datei oder eine JSON-Zeichenkette zum Laden zusätzlicher Einstellungenclaude --settings ./settings.json
--strict-mcp-configVerwenden Sie nur MCP-Server aus --mcp-config, ignorieren Sie alle anderen MCP-Konfigurationenclaude --strict-mcp-config --mcp-config ./mcp.json
--system-promptErsetzen Sie den gesamten Systemprompt durch benutzerdefinierten Textclaude --system-prompt "You are a Python expert"
--system-prompt-fileLaden Sie den Systemprompt aus einer Datei, ersetzen Sie den Standard-Promptclaude --system-prompt-file ./custom-prompt.txt
--teleportSetzen Sie eine Web-Sitzung in Ihrem lokalen Terminal fortclaude --teleport
--teammate-modeLegen Sie fest, wie Agent-Team Teamkollegen angezeigt werden: auto (Standard), in-process oder tmux. Siehe Agent-Teams einrichtenclaude --teammate-mode in-process
--toolsBeschrä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"
--verboseAktivieren Sie ausführliches Logging, zeigt vollständige Turn-by-Turn-Ausgabeclaude --verbose
--version, -vGeben Sie die Versionsnummer ausclaude -v
--worktree, -wStarten Sie Claude in einem isolierten Git Worktree bei <repo>/.claude/worktrees/<name>. Wenn kein Name angegeben wird, wird einer automatisch generiertclaude -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.
FlagVerhaltenBeispiel
--system-promptErsetzt den gesamten Standard-Promptclaude --system-prompt "You are a Python expert"
--system-prompt-fileErsetzt mit Dateiinhaltenclaude --system-prompt-file ./prompts/review.txt
--append-system-promptFügt zum Standard-Prompt anclaude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileFügt Dateiinhalte zum Standard-Prompt anclaude --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. Verwenden Sie für die meisten Anwendungsfälle ein Append-Flag. Das Anhängen bewahrt die integrierten Funktionen von Claude Code, während Ihre Anforderungen hinzugefügt werden. Verwenden Sie ein Ersetzungs-Flag nur, wenn Sie vollständige Kontrolle über den Systemprompt benötigen.

Siehe auch