Claude Code CLI リファレンスマニュアル

一、CLI コマンド

二、CLI フラグ

以下のフラグで Claude Code の実行動作をカスタマイズできます：

ヒント：--output-format jsonフラグはスクリプトや自動化シナリオに最適で、Claude の応答結果を直接プログラムで解析できます。

三、拡張説明

3.1 サブエージェントフラグ形式

--agentsフラグは JSON オブジェクトを受け取り、1 つ以上のカスタムサブエージェントを定義します。各サブエージェントには一意の名前をキーとして設定し、値は以下のフィールドを含むオブジェクトです：

例

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

システムプロンプトフラグ

Claude Code は 3 種類のシステムプロンプトカスタマイズ方法を提供し、さまざまな使用ニーズに対応します：

使用シナリオと例

1. --system-prompt：システムプロンプトを完全に引き継ぎ、デフォルト指示をクリア

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

2. --system-prompt-file：ファイルからプロンプトを読み取り、標準化シナリオに最適

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

3. --append-system-prompt：デフォルト機能を保持し、カスタム要件を追加（ほとんどのシナリオで推奨）

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

注意：--system-promptと--system-prompt-file相互排他であり、同時には使用できません。
ヒント：優先的に使用--append-system-prompt、Claude Code の組み込み機能を維持しつつカスタマイズ要件も満たせます。完全なカスタマイズが必要な場合のみ、他の 2 つのフラグを使用してください。

プリントモード（-p）の詳細な使い方（出力形式、ストリーミング、プログラム的統合など）は、以下を参照SDK ドキュメント。