CLI-Befehle
| Befehl | Beschreibung | Beispiel |
|---|
claude | Interaktive REPL starten | claude |
claude "query" | REPL mit anfänglichem 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 fortsetzen | claude -c |
claude -c -p "query" | Über SDK fortsetzen | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | Sitzung nach ID fortsetzen | claude -r "abc123" "Finish this PR" |
claude update | Auf neueste Version aktualisieren | claude update |
claude mcp | Model Context Protocol (MCP)-Server konfigurieren | Siehe die Claude Code MCP-Dokumentation. |
CLI-Flags
Passen Sie das Verhalten von Claude Code mit diesen Befehlszeilenflags an:
| Flag | Beschreibung | Beispiel |
|---|
--add-dir | Zusätzliche Arbeitsverzeichnisse hinzufügen, auf die Claude zugreifen kann (validiert, dass jeder Pfad als Verzeichnis existiert) | claude --add-dir ../apps ../lib |
--agents | Benutzerdefinierte Subagenten dynamisch über JSON definieren (siehe unten für Format) | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools | Eine Liste von Tools, die ohne Benutzeraufforderung erlaubt sein sollten, zusätzlich zu settings.json-Dateien | "Bash(git log:*)" "Bash(git diff:*)" "Read" |
--disallowedTools | Eine Liste von Tools, die ohne Benutzeraufforderung nicht erlaubt sein sollten, zusätzlich zu settings.json-Dateien | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--print, -p | Antwort ohne interaktiven Modus ausgeben (siehe SDK-Dokumentation für Details zur programmgesteuerten Nutzung) | claude -p "query" |
--system-prompt | Ersetzen Sie den gesamten System-Prompt durch benutzerdefinierten Text (funktioniert sowohl im interaktiven als auch im Print-Modus; hinzugefügt in v2.0.14) | claude --system-prompt "You are a Python expert" |
--system-prompt-file | System-Prompt aus einer Datei laden und den Standard-Prompt ersetzen (nur Print-Modus; hinzugefügt in v1.0.54) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--append-system-prompt | Benutzerdefinierten Text am Ende des Standard-System-Prompts anhängen (funktioniert sowohl im interaktiven als auch im Print-Modus; hinzugefügt in v1.0.55) | claude --append-system-prompt "Always use TypeScript" |
--output-format | Ausgabeformat für Print-Modus angeben (Optionen: text, json, stream-json) | claude -p "query" --output-format json |
--input-format | Eingabeformat für Print-Modus angeben (Optionen: text, stream-json) | claude -p --output-format json --input-format stream-json |
--include-partial-messages | Teilweise Streaming-Ereignisse in der Ausgabe einschließen (erfordert --print und --output-format=stream-json) | claude -p --output-format stream-json --include-partial-messages "query" |
--verbose | Ausführliches Logging aktivieren, zeigt vollständige Turn-by-Turn-Ausgabe (hilfreich zum Debuggen in beiden Print- und interaktiven Modi) | claude --verbose |
--max-turns | Begrenzen Sie die Anzahl der agentischen Turns im nicht-interaktiven Modus | claude -p --max-turns 3 "query" |
--model | Setzt 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 | claude --model claude-sonnet-4-5-20250929 |
--permission-mode | Beginnen Sie in einem angegebenen Berechtigungsmodus | 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" |
--resume | Setzen Sie eine bestimmte Sitzung nach ID fort, oder wählen Sie im interaktiven Modus | claude --resume abc123 "query" |
--continue | Laden Sie die letzte Konversation im aktuellen Verzeichnis | claude --continue |
--dangerously-skip-permissions | Berechtigungsaufforderungen überspringen (mit Vorsicht verwenden) | claude --dangerously-skip-permissions |
Das Flag --output-format json ist besonders nützlich für Scripting und
Automatisierung und ermöglicht es Ihnen, Claudes Antworten programmgesteuert zu analysieren.
--agents akzeptiert ein JSON-Objekt, das einen oder mehrere benutzerdefinierte Subagenten definiert. Jeder Subagent erfordert einen eindeutigen Namen (als Schlüssel) und ein Definitionsobjekt mit den folgenden Feldern:
| Feld | Erforderlich | Beschreibung |
|---|
description | Ja | Natürlichsprachige Beschreibung, wann der Subagent aufgerufen werden sollte |
prompt | Ja | Der System-Prompt, der das Verhalten des Subagenten lenkt |
tools | Nein | Array von spezifischen Tools, die der Subagent verwenden kann (z. B. ["Read", "Edit", "Bash"]). Falls weggelassen, erbt alle Tools |
model | Nein | Modell-Alias zur Verwendung: sonnet, opus oder haiku. Falls weggelassen, verwendet das Standard-Subagenten-Modell |
claude --agents '{
"code-reviewer": {
"description": "Expert code reviewer. Use proactively after code changes.",
"prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "Debugging specialist for errors and test failures.",
"prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
}
}'
System-Prompt-Flags
Claude Code bietet drei Flags zum Anpassen des System-Prompts, die jeweils einem anderen Zweck dienen:
| Flag | Verhalten | Modi | Anwendungsfall |
|---|
--system-prompt | Ersetzt den gesamten Standard-Prompt | Interaktiv + Print | Vollständige Kontrolle über Claudes Verhalten und Anweisungen |
--system-prompt-file | Ersetzt mit Dateiinhalten | Nur Print | Laden Sie Prompts aus Dateien für Reproduzierbarkeit und Versionskontrolle |
--append-system-prompt | Hängt an den Standard-Prompt an | Interaktiv + Print | Fügen Sie spezifische Anweisungen hinzu, während Sie das Standard-Claude Code-Verhalten beibehalten |
-
--system-prompt: Verwenden Sie, wenn Sie vollständige Kontrolle über Claudes System-Prompt benötigen. Dies entfernt alle Standard-Claude Code-Anweisungen und gibt Ihnen eine leere Leinwand.
claude --system-prompt "You are a Python expert who only writes type-annotated code"
-
--system-prompt-file: Verwenden Sie, wenn Sie einen benutzerdefinierten Prompt aus einer Datei laden möchten, nützlich für Team-Konsistenz oder versionskontrollierte Prompt-Vorlagen.
claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
-
--append-system-prompt: Verwenden Sie, wenn Sie spezifische Anweisungen hinzufügen möchten, während Sie die Standard-Funktionen von Claude Code beibehalten. Dies ist die sicherste Option für die meisten Anwendungsfälle.
claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
--system-prompt und --system-prompt-file schließen sich gegenseitig aus. Sie können nicht beide Flags gleichzeitig verwenden.
Für die meisten Anwendungsfälle wird --append-system-prompt empfohlen, da es die integrierten Funktionen von Claude Code beibehält und gleichzeitig Ihre benutzerdefinierten Anforderungen hinzufügt. Verwenden Sie --system-prompt oder --system-prompt-file nur, wenn Sie vollständige Kontrolle über den System-Prompt benötigen.
-p), einschließlich Ausgabeformate,
Streaming, ausführliches Logging und programmgesteuerte Nutzung, finden Sie in der
SDK-Dokumentation.
Siehe auch
