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"Über SDK fortsetzenclaude -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, und --sso, um SSO-Authentifizierung zu erzwingenclaude auth login --email [email protected] --sso
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 subagents auflisten, gruppiert nach Quelleclaude agents
claude mcpModel Context Protocol (MCP) Server konfigurierenSiehe die Claude Code MCP-Dokumentation.
claude remote-controlStarten Sie eine Remote Control-Sitzung, um Claude Code von Claude.ai oder der Claude-App aus zu steuern, während sie lokal ausgeführt wird. Siehe Remote Control für Flagsclaude remote-control

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 vorhanden ist)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 subagents dynamisch über JSON (siehe unten für das Format)claude --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-promptBenutzerdefinierten Text am Ende des Standard-Systemprompts anhängen (funktioniert sowohl im interaktiven als auch im Druckmodus)claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileZusätzlichen Systemprompt-Text aus einer Datei laden und an den Standard-Prompt anhängen (nur Druckmodus)claude -p --append-system-prompt-file ./extra-rules.txt "query"
--betasBeta-Header, die in API-Anfragen einzubeziehen sind (nur API-Schlüssel-Benutzer)claude --betas interleaved-thinking
--chromeAktivieren Sie die Chrome-Browser-Integration für Web-Automatisierung und Testsclaude --chrome
--continue, -cLaden Sie die letzte Konversation im aktuellen Verzeichnisclaude --continue
--dangerously-skip-permissionsAlle Berechtigungsaufforderungen überspringen (mit Vorsicht verwenden)claude --dangerously-skip-permissions
--debugDebug-Modus mit optionaler Kategoriefilterung aktivieren (zum Beispiel "api,hooks" oder "!statsig,!file")claude --debug "api,mcp"
--disable-slash-commandsAlle skills und Befehle für diese Sitzung deaktivierenclaude --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"
--fallback-modelAutomatisches Fallback auf das angegebene Modell aktivieren, wenn das Standardmodell überlastet ist (nur Druckmodus)claude -p --fallback-model sonnet "query"
--fork-sessionBeim Fortsetzen eine neue Sitzungs-ID erstellen, anstatt die ursprüngliche wiederzuverwenden (mit --resume oder --continue verwenden)claude --resume abc123 --fork-session
--from-prSitzungen fortsetzen, 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
--ideAutomatisch mit IDE beim Start verbinden, wenn genau eine gültige IDE verfügbar istclaude --ide
--initInitialisierungs-Hooks ausführen und interaktiven Modus startenclaude --init
--init-onlyInitialisierungs-Hooks ausführen und beenden (keine interaktive Sitzung)claude --init-only
--include-partial-messagesPartielle Streaming-Ereignisse in die Ausgabe einbeziehen (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 Druckmodus an (Optionen: text, stream-json)claude -p --output-format json --input-format stream-json
--json-schemaValidierte JSON-Ausgabe abrufen, die einem JSON-Schema entspricht, nachdem der Agent seinen Workflow abgeschlossen hat (nur Druckmodus, siehe strukturierte Ausgaben)claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenanceWartungs-Hooks ausführen und beendenclaude --maintenance
--max-budget-usdMaximaler Dollarbetrag, der für API-Aufrufe ausgegeben werden kann, bevor gestoppt wird (nur Druckmodus)claude -p --max-budget-usd 5.00 "query"
--max-turnsBegrenzen Sie die Anzahl der agentengesteuerten Durchläufe (nur Druckmodus). 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
--no-chromeDeaktivieren Sie die 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 Druckmodus)claude -p --no-session-persistence "query"
--output-formatGeben Sie das Ausgabeformat für den Druckmodus an (Optionen: text, json, stream-json)claude -p "query" --output-format json
--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 Verzeichnissen nur für diese Sitzung (wiederholbar)claude --plugin-dir ./my-plugins
--print, -pAntwort ohne interaktiven Modus drucken (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"
--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 Text (funktioniert sowohl im interaktiven als auch im Druckmodus)claude --system-prompt "You are a Python expert"
--system-prompt-fileLaden Sie den Systemprompt aus einer Datei, ersetzen Sie den Standard-Prompt (nur Druckmodus)claude -p --system-prompt-file ./custom-prompt.txt "query"
--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 (funktioniert sowohl im interaktiven als auch im Druckmodus). 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 Durchlauf-für-Durchlauf-Ausgabe (hilfreich zum Debuggen sowohl im Druck- als auch im interaktiven Modus)claude --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
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-Flag-Format

Das Flag --agents akzeptiert ein JSON-Objekt, das einen oder mehrere benutzerdefinierte subagents definiert. Jeder subagent erfordert einen eindeutigen Namen (als Schlüssel) und ein Definitionsobjekt mit den folgenden Feldern:
FeldErforderlichBeschreibung
descriptionJaNatürlichsprachige Beschreibung, wann der subagent aufgerufen werden sollte
promptJaDer Systemprompt, der das Verhalten des subagent leitet
toolsNeinArray von spezifischen Tools, die der subagent verwenden kann, zum Beispiel ["Read", "Edit", "Bash"]. Falls weggelassen, erbt alle Tools. Unterstützt Agent(agent_type)-Syntax
disallowedToolsNeinArray von Tool-Namen, die für diesen subagent explizit verweigert werden
modelNeinModell-Alias zum Verwenden: sonnet, opus, haiku oder inherit. Falls weggelassen, wird standardmäßig inherit verwendet
skillsNeinArray von skill-Namen, die in den Kontext des subagent vorgeladen werden sollen
mcpServersNeinArray von MCP-Servern für diesen subagent. Jeder Eintrag ist eine Server-Name-Zeichenkette oder ein {name: config}-Objekt
maxTurnsNeinMaximale Anzahl von agentengesteuerten Durchläufen, bevor der subagent stoppt
Beispiel:
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."
  }
}'
Weitere Details zum Erstellen und Verwenden von subagents finden Sie in der subagents-Dokumentation.

Systemprompt-Flags

Claude Code bietet vier Flags zum Anpassen des Systemprompts, die jeweils einem anderen Zweck dienen:
FlagVerhaltenModiAnwendungsfall
--system-promptErsetzt den gesamten Standard-PromptInteraktiv + DruckVollständige Kontrolle über Claudes Verhalten und Anweisungen
--system-prompt-fileErsetzt mit DateiinhaltenNur DruckLaden Sie Prompts aus Dateien für Reproduzierbarkeit und Versionskontrolle
--append-system-promptHängt an Standard-Prompt anInteraktiv + DruckFügen Sie spezifische Anweisungen hinzu, während Sie das Standard-Claude Code-Verhalten beibehalten
--append-system-prompt-fileHängt Dateiinhalte an Standard-Prompt anNur DruckLaden Sie zusätzliche Anweisungen aus Dateien, während Sie die Standardwerte beibehalten
Wann Sie jedes verwenden:
  • --system-prompt: Verwenden Sie, wenn Sie vollständige Kontrolle über Claudes Systemprompt 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-Claude Code-Funktionen intakt halten. Dies ist die sicherste Option für die meisten Anwendungsfälle.
    claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
    
  • --append-system-prompt-file: Verwenden Sie, wenn Sie Anweisungen aus einer Datei anhängen möchten, während Sie die Claude Code-Standardwerte beibehalten. Nützlich für versionskontrollierte Ergänzungen.
    claude -p --append-system-prompt-file ./prompts/style-rules.txt "Review this PR"
    
--system-prompt und --system-prompt-file schließen sich gegenseitig aus. Die Append-Flags können zusammen mit einem der Ersetzungs-Flags verwendet werden. Für die meisten Anwendungsfälle wird --append-system-prompt oder --append-system-prompt-file empfohlen, da sie die integrierten Funktionen von Claude Code beibehalten und gleichzeitig Ihre benutzerdefinierten Anforderungen hinzufügen. Verwenden Sie --system-prompt oder --system-prompt-file nur, wenn Sie vollständige Kontrolle über den Systemprompt benötigen.

Siehe auch