cli-reference

CLI リファレンス

Claude Code コマンドラインインターフェースの完全なリファレンスです。

使用する場面

• 「利用できる CLI フラグは何ですか？」
• 「ヘッドレスモードの使い方を教えてください」
• 「自動化／CI/CD で Claude を使う」
• 「出力形式のオプション」
• 「CLI からのシステムプロンプト設定」
• 「エージェントを適切に起動する方法を教えてください」

基本コマンド

コマンド	説明	例
claude	対話型 REPL を起動	claude
claude "query"	初期プロンプト付きで REPL を起動	claude "explain this project"
claude -p "query"	ヘッドレスモード（SDK）	claude -p "explain function"
cat file | claude -p	パイプで渡されたコンテンツを処理	cat logs.txt | claude -p "explain"
claude -c	直近のセッションを続行	claude -c
claude -c -p "query"	SDK 経由で続行	claude -c -p "check types"
claude -r "id" "query"	セッションを再開	claude -r "auth" "finish PR"
claude update	バージョンを更新	claude update
claude mcp	MCP サーバーを設定	MCP ドキュメントを参照

セッション制御

フラグ	説明	例
--continue, -c	直近の会話を読み込む	claude --continue
--resume, -r	ID／名前でセッションを再開	claude --resume auth-refactor
--session-id	特定の UUID を使用	claude --session-id "550e8400-..."
--fork-session	再開時に新しいセッションを作成	claude --resume abc --fork-session

ヘッドレスモード（エージェントで重要）

フラグ	説明	例
--print, -p	非対話型で実行し、終了する	claude -p "query"
--output-format	text、json、stream-json	claude -p --output-format json
--max-turns	エージェントのターン数を制限	claude -p --max-turns 100 "query"
--verbose	ターンごとの出力をすべて表示	claude --verbose
--dangerously-skip-permissions	権限の確認をスキップ	claude -p --dangerously-skip-permissions
--include-partial-messages	ストリーミングイベントを含める	claude -p --output-format stream-json --include-partial-messages
--input-format	入力形式（text/stream-json）	claude -p --input-format stream-json

ツール制御

フラグ	説明	例
--allowedTools	これらのツールを自動承認	"Bash(git log:*)" "Read"
--disallowedTools	これらのツールをブロック	"Bash(rm:*)" "Edit"
--tools	これらのツールのみを許可	--tools "Bash,Edit,Read"

サブエージェントの定義（--agents フラグ）

JSON を使ってカスタムサブエージェントをインラインで定義します。

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality and security.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors and provide fixes."
  }
}'

エージェントのフィールド

フィールド	必須	説明
description	はい	このエージェントを呼び出すタイミング
prompt	はい	動作を指定するシステムプロンプト
tools	いいえ	使用可能なツール（省略した場合はすべて継承）
model	いいえ	sonnet、haiku、または claude-opus-4-5-20251101

重要なポイント

Lead が Task ツールを使うと、これらの定義から自動的に起動します。手動で起動する必要はありません。

システムプロンプトのカスタマイズ

フラグ	動作	モード
--system-prompt	システムプロンプト全体を置き換える	対話型＋Print
--system-prompt-file	ファイルの内容で置き換える	Print のみ
--append-system-prompt	デフォルトに追加する（推奨）	対話型＋Print

ほとんどの場合は --append-system-prompt を使用してください。Claude Code の機能を維持できます。

モデルの選択

フラグ	説明	例
--model	セッションで使用するモデルを設定	--model claude-sonnet-4-5
--fallback-model	デフォルトのモデルが過負荷の場合に使う代替モデル	--fallback-model sonnet

エイリアス：sonnet、opus、haiku

MCP の設定

フラグ	説明	例
--mcp-config	JSON から MCP サーバーを読み込む	--mcp-config ./mcp.json
--strict-mcp-config	これらの MCP サーバーのみを使用	--strict-mcp-config --mcp-config ./mcp.json

高度なフラグ

フラグ	説明	例
--add-dir	作業ディレクトリを追加します	--add-dir ../apps ../lib
--agent	セッションに使用するエージェントを指定します	--agent my-custom-agent
--permission-mode	権限モードで開始します	--permission-mode plan
--permission-prompt-tool	権限用の MCP ツール	--permission-prompt-tool mcp_auth
--plugin-dir	ディレクトリからプラグインを読み込みます	--plugin-dir ./my-plugins
--settings	ファイルまたは JSON から設定を読み込みます	--settings ./settings.json
--setting-sources	読み込む設定を指定します	--setting-sources user,project
--betas	ベータ版 API ヘッダー	--betas interleaved-thinking
--debug	デバッグモードを有効にします	--debug "api,hooks"
--ide	IDE に自動接続します	--ide
--chrome	Chrome 連携を有効にします	--chrome
--no-chrome	セッションで Chrome を無効にします	--no-chrome
--enable-lsp-logging	詳細な LSP デバッグを有効にします	--enable-lsp-logging
--version, -v	バージョンを出力します	claude -v

出力形式

JSON（解析用）

claude -p "query" --output-format json
# {"result": "...", "session_id": "...", "usage": {...}}

ストリーミング（リアルタイム監視用）

claude -p "query" --output-format stream-json
# Newline-delimited JSON events

構造化出力（スキーマ検証用）

claude -p "Extract data" \
  --output-format json \
  --json-schema '{"type":"object","properties":{...}}'

ヘッドレスエージェントのパターン（重要）

ヘッドレスエージェントを正しく起動する方法：

claude -p "$TASK_PROMPT" \
  --session-id "$UUID" \
  --dangerously-skip-permissions \
  --max-turns 100 \
  --output-format stream-json \
  --agents '{...}' \
  --append-system-prompt "Context: ..."

次のいずれかが欠けていると、処理がハングします：

• --session-id - セッションを追跡します
• --dangerously-skip-permissions - ヘッドレスモードでは必須です
• --max-turns - 無限ループを防ぎます

よく使うパターン

CI/CD の自動化

claude -p "Run tests and fix failures" \
  --dangerously-skip-permissions \
  --max-turns 50 \
  --output-format json | jq '.result'

パイプ入力

cat error.log | claude -p "Find root cause"
gh pr diff | claude -p "Review for security"

複数ターンのセッション

id=$(claude -p "Start task" --output-format json | jq -r '.session_id')
claude -p "Continue" --resume "$id"

ストリームの監視

claude -p "Long task" \
  --output-format stream-json \
  --include-partial-messages | while read -r line; do
    echo "$line" | jq '.type'
done

キーボードショートカット（対話型）

ショートカット	操作
Ctrl+C	現在の処理をキャンセルします
Ctrl+D	終了します
Ctrl+R	履歴を逆順検索します
Esc Esc	変更を巻き戻します
Shift+Tab	権限モードを切り替えます

クイックコマンド

プレフィックス	操作
/	スラッシュコマンド
!	Bash モード
#	メモリに追加
@	ファイルへの言及