Claude Code CLI-Referenzhandbuch

I. CLI-Befehle

II. CLI-Flags

Die folgenden Flags passen das Laufzeitverhalten von Claude Code an:

Hinweis：--output-format jsonFlags eignen sich ideal für Skripterstellung und Automatisierung; Sie können die Antwortausgabe von Claude programmatisch parsen.

III. Erweiterte Hinweise

3.1 Format des Agent-Flags

--agentsDas Flag akzeptiert ein JSON-Objekt, um einen oder mehrere benutzerdefinierte Subagenten zu definieren. Jeder Subagent benötigt einen eindeutigen Namen als Schlüssel, und der Wert ist ein Objekt mit den folgenden Feldern:

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."
  }
}'

System-Prompt-Flag

Claude Code bietet 3 Möglichkeiten, den System-Prompt anzupassen, um unterschiedliche Nutzungsanforderungen zu erfüllen:

Nutzungsszenarien und Beispiele

1. --system-prompt: System-Prompt vollständig übernehmen und Standardanweisungen löschen

   claude --system-prompt "You are a Python expert who only writes type-annotated code"

2. --system-prompt-file: Prompt aus Datei lesen, geeignet für standardisierte Szenarien

   claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"

3. --append-system-prompt: Standardfunktionalität beibehalten, benutzerdefinierte Anforderungen anhängen (für die meisten Szenarien empfohlen)

   claude --append-system-prompt "Always use TypeScript and include JSDoc comments"

Hinweis：--system-promptund--system-prompt-fileSchließen sich gegenseitig aus, können nicht gleichzeitig verwendet werden.
Tipp: Verwende vorzugsweise--append-system-prompt, da es die integrierten Funktionen von Claude Code bewahrt und gleichzeitig Anpassungsbedarf erfüllt; verwenden Sie die anderen beiden Flags nur, wenn vollständige Anpassung erforderlich ist.

Print-Modus (-p) detaillierte Verwendung (Ausgabeformat, Streaming, programmatische Integration usw.), sieheSDK-Dokumentation。