CLI リファレンス

Claude Code コマンドラインインターフェースの完全なリファレンス。コマンドとフラグを含みます。

CLI コマンド

これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。

コマンド	説明	例
`claude`	インタラクティブセッションを開始	`claude`
`claude "query"`	初期プロンプト付きでインタラクティブセッションを開始	`claude "explain this project"`
`claude -p "query"`	SDK 経由でクエリを実行してから終了	`claude -p "explain this function"`
`cat file \| claude -p "query"`	パイプされたコンテンツを処理	`cat logs.txt \| claude -p "explain"`
`claude -c`	現在のディレクトリで最新の会話を続行	`claude -c`
`claude -c -p "query"`	SDK 経由で続行	`claude -c -p "Check for type errors"`
`claude -r "<session>" "query"`	セッション ID または名前でセッションを再開	`claude -r "auth-refactor" "Finish this PR"`
`claude update`	最新バージョンに更新	`claude update`
`claude gateway`	自己ホスト型 Claude apps gateway サーバーを開始します。Bedrock、Vertex AI、または Foundry 上の Claude Code の前に SSO とポリシーをデプロイする管理者向けです。`--config` で `gateway.yaml` を指す必要があります。Claude Code v2.1.195 以降で利用可能です。	`claude gateway --config gateway.yaml`
`claude install [version]`	ネイティブバイナリをインストールまたは再インストールします。`2.1.118` のようなバージョン、または `stable` または `latest` を受け入れます。特定のバージョンをインストールを参照してください	`claude install stable`
`claude auth login`	Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます	`claude auth login --console`
`claude auth logout`	Anthropic アカウントからログアウト	`claude auth logout`
`claude auth status`	認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します	`claude auth status`
`claude agents`	エージェントビューを開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示するか、`--json` を使用してアクティブなセッションを JSON 配列として出力してスクリプト作成用にします（`--json --all` は完了したバックグラウンドセッションも含みます）。`--permission-mode`、`--model`、`--effort`、または `--agent` を渡して、ディスパッチされたセッションのデフォルトを設定します。トップレベルの `claude` コマンドと同様に `--settings`、`--add-dir`、`--plugin-dir`、および `--mcp-config` を受け入れます。エージェントビューを開くにはインタラクティブターミナルが必要です	`claude agents --json`
`claude attach <id>`	このターミナルでバックグラウンドセッションに接続します	`claude attach 7c5dcf5d`
`claude auto-mode defaults`	組み込み auto mode 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください	`claude auto-mode defaults > rules.json`
`claude daemon status`	バックグラウンドセッションスーパーバイザーの状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します	`claude daemon status`
`claude daemon stop --any`	バックグラウンドセッションスーパーバイザーとそれがホストするセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。`--any` はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、応答しないスーパーバイザーから回復します	`claude daemon stop --any --keep-workers`
`claude logs <id>`	バックグラウンドセッションからの最近の出力を出力します	`claude logs 7c5dcf5d`
`claude mcp`	Model Context Protocol（MCP）サーバーを設定	Claude Code MCP ドキュメントを参照してください。
`claude mcp login <name>`	{/* min-version: 2.1.186 */}設定済み MCP サーバーの OAuth フローを実行します。インタラクティブな `/mcp` パネルを開きません。HTTP、SSE、および claude.ai コネクタサーバーで機能します。SSH 経由で `--no-browser` を追加して、ブラウザを開く代わりに認可 URL を出力し、リダイレクト URL をプロンプトに貼り付けます。Claude Code v2.1.186 以降が必要です。コマンドラインから認証を参照してください	`claude mcp login sentry`
`claude mcp logout <name>`	{/* min-version: 2.1.186 */}MCP サーバーの保存された OAuth 認証情報をクリアします。Claude Code v2.1.186 以降が必要です	`claude mcp logout sentry`
`claude plugin`	Claude Code plugins を管理します。エイリアス：`claude plugins`。サブコマンドについては plugin reference を参照してください	`claude plugin install code-review@claude-plugins-official`
`claude project purge [path]`	プロジェクトのすべてのローカル Claude Code 状態を削除します：トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴行、および `~/.claude.json` 内のプロジェクトエントリ。`[path]` を省略して、インタラクティブリストから選択します。フラグ：`--dry-run` でプレビュー、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべてのプロジェクト。ローカルデータをクリアを参照してください	`claude project purge ~/work/repo --dry-run`
`claude remote-control`	Remote Control サーバーを開始して、Claude.ai または Claude アプリから Claude Code を制御します。サーバーモード（ローカルインタラクティブセッションなし）で実行されます。サーバーモードフラグを参照してください	`claude remote-control --name "My Project"`
`claude respawn <id>`	会話を保持したまま、バックグラウンドセッションを再開します。実行中または停止中。`--all` を使用してすべての実行中セッションを再開します。たとえば、更新された Claude Code バイナリを取得するため	`claude respawn 7c5dcf5d`
`claude rm <id>`	バックグラウンドセッションをリストから削除します。会話トランスクリプトはローカルマシンに残り、`claude --resume` を通じて利用可能です	`claude rm 7c5dcf5d`
`claude setup-token`	CI とスクリプト用の長期間有効な OAuth トークンを生成します。ターミナルにトークンを出力し、保存しません。Claude サブスクリプションが必要です。長期間有効なトークンを生成を参照してください	`claude setup-token`
`claude stop <id>`	バックグラウンドセッションを停止します。`claude kill` も受け入れます	`claude stop 7c5dcf5d`
`claude ultrareview [target]`	ultrareview を非対話的に実行します。結果を stdout に出力し、成功時は 0 で終了し、失敗時は 1 で終了します。`--json` を使用して生のペイロードを取得し、`--timeout <minutes>` を使用して 30 分のデフォルトをオーバーライドできます	`claude ultrareview 1234 --json`

サブコマンドを誤入力した場合、Claude Code は最も近い一致を提案して、セッションを開始せずに終了します。たとえば、claude udpate は Did you mean claude update? と出力します。

CLI フラグ

これらのコマンドラインフラグを使用して Claude Code の動作をカスタマイズします。claude --help はすべてのフラグをリストしていないため、--help にフラグが表示されていないことは、そのフラグが利用できないことを意味しません。

フラグ	説明	例
`--add-dir`	Claude がファイルを読み取り、編集するための追加の作業ディレクトリを追加します。ファイルアクセスを許可します。ほとんどの `.claude/` 設定はこれらのディレクトリから検出されません。各パスがディレクトリとして存在することを検証します。これらのディレクトリをセッション全体で永続化するには、設定で `permissions.additionalDirectories` を設定してください	`claude --add-dir ../apps ../lib`
`--advisor <model>`	{/* min-version: 2.1.98 /}このセッションのサーバーサイド advisor ツールをモデルエイリアス `opus`、`sonnet`、または `fable`（{/ min-version: 2.1.170 */}v2.1.170+）、または完全なモデル ID で有効にします。このセッションの `advisorModel` 設定より優先されます。Claude Code v2.1.98 以降が必要です	`claude --advisor opus`
`--agent`	現在のセッションのエージェントを指定します（`agent` 設定をオーバーライドします）	`claude --agent my-custom-agent`
`--agents`	JSON 経由でカスタム subagents を動的に定義します。subagent frontmatter と同じフィールド名を使用し、さらにエージェントの指示用の `prompt` フィールドを追加します	`claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'`
`--allow-dangerously-skip-permissions`	`Shift+Tab` モードサイクルに `bypassPermissions` を追加します。これを開始時に有効にしません。`plan` のような別のモードで開始し、後で `bypassPermissions` に切り替えることができます。権限モードを参照してください	`claude --permission-mode plan --allow-dangerously-skip-permissions`
`--allowedTools`、`--allowed-tools`	権限を求めずに実行するツール。パターンマッチングについては権限ルール構文を参照してください。利用可能なツールを制限するには、代わりに `--tools` を使用してください	`"Bash(git log )" "Bash(git diff )" "Read"`
`--append-system-prompt`	デフォルトシステムプロンプトの末尾にカスタムテキストを追加します	`claude --append-system-prompt "Always use TypeScript"`
`--append-system-prompt-file`	ファイルから追加のシステムプロンプトテキストを読み込み、デフォルトプロンプトに追加します	`claude --append-system-prompt-file ./extra-rules.txt`
`--ax-screen-reader`	{/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします：装飾的なボーダーやアニメーションなしのフラットテキスト。クラシックレンダラーを強制するため、このセッションでは `tui` 設定は効果がありません。`CLAUDE_AX_SCREEN_READER` と `axScreenReader` 設定より優先されます。Claude Code v2.1.181 以降が必要です	`claude --ax-screen-reader`
`--bare`	最小限モード：hooks、skills、plugins、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップして、スクリプト化された呼び出しをより高速に開始します。Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。`CLAUDE_CODE_SIMPLE` を設定します。bare mode を参照してください	`claude --bare -p "query"`
`--betas`	API リクエストに含めるベータヘッダー（API キーユーザーのみ）	`claude --betas interleaved-thinking`
`--bg`、`--background`	セッションをバックグラウンドエージェントとして開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します	`claude --bg "investigate the flaky test"`
`--channels`	（研究プレビュー）Claude がこのセッションでリッスンすべき channel 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です	`claude --channels plugin:my-notifier@my-marketplace`
`--chrome`	Web 自動化とテストのための Chrome ブラウザ統合を有効にします	`claude --chrome`
`--continue`、`-c`	現在のディレクトリで最新の会話を読み込みます。このディレクトリを `/add-dir` で追加したセッションを含みます	`claude --continue`
`--dangerously-load-development-channels`	承認されたアローリストにない channels をローカル開発用に有効にします。`plugin:<name>@<marketplace>` および `server:<name>` エントリを受け入れます。確認を求めます	`claude --dangerously-load-development-channels server:webhook`
`--dangerously-skip-permissions`	すべての権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。権限モードを参照して、これが何をスキップし、何をスキップしないかを確認してください	`claude --dangerously-skip-permissions`
`--debug`	オプションのカテゴリフィルタリング付きでデバッグモードを有効にします（例：`"api,hooks"` または `"!statsig,!file"`）	`claude --debug "api,mcp"`
`--debug-file <path>`	デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` より優先されます	`claude --debug-file /tmp/claude-debug.log`
`--disable-slash-commands`	このセッションのすべてのスキルとコマンドを無効にします	`claude --disable-slash-commands`
`--disallowedTools`、`--disallowed-tools`	拒否ルール。ベアツール名はそのツールをモデルのコンテキストから削除します：`"Edit"` は Edit を削除し、`""` はすべてのツールを削除し、`"mcp__"` はすべての MCP ツールを削除します。`Bash(rm *)` のようなスコープ付きルールはツールを利用可能なままにし、一致する呼び出しのみを拒否します	`"Bash(git log )" "Bash(git diff )" "Edit"`
`--effort`	現在のセッションの努力レベルを設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。`effortLevel` 設定をこのセッションでオーバーライドし、永続化されません	`claude --effort high`
`--enable-auto-mode`	{/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください	`claude --permission-mode auto`
`--exclude-dynamic-system-prompt-sections`	システムプロンプトからマシンごとのセクション（作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ）を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください	`claude -p --exclude-dynamic-system-prompt-sections "query"`
`--exec`	シェルコマンドを PTY バックアップのバックグラウンドジョブとして実行します。Claude セッションを開始する代わりに `--bg` と一緒に使用してください	`claude --bg --exec 'pytest -x'`
`--fallback-model`	プライマリモデルが過負荷の場合、または利用できない場合、指定されたモデルへの自動フォールバックを有効にします。例えば、廃止されたモデル。カンマ区切りリストを受け入れ、順番に試されます。フォールバックモデルチェーンを参照してください。セッション全体でチェーンを永続化するには、`fallbackModel` 設定を使用してください。このフラグはそれをオーバーライドします	`claude --fallback-model sonnet,haiku`
`--fork-session`	再開時に、元のセッション ID を再利用する代わりに新しいセッション ID を作成します（`--resume` または `--continue` と一緒に使用）	`claude --resume abc123 --fork-session`
`--from-pr`	特定のプルリクエストにリンクされたセッションを再開します。PR 番号、GitHub または GitHub Enterprise PR URL、GitLab マージリクエスト URL、または Bitbucket プルリクエスト URL を受け入れます。Claude がプルリクエストを作成するときに、セッションは自動的にリンクされます	`claude --from-pr 123`
`--ide`	起動時に、正確に 1 つの有効な IDE が利用可能な場合、自動的に IDE に接続します	`claude --ide`
`--init`	セッション開始前に `init` マッチャーで Setup hooks を実行します（プリントモードのみ）	`claude -p --init "query"`
`--init-only`	Setup および `SessionStart` hooks を実行してから、会話を開始せずに終了します	`claude --init-only`
`--include-hook-events`	すべてのフックライフサイクルイベントを出力ストリームに含めます。`--output-format stream-json` が必要です	`claude -p --output-format stream-json --verbose --include-hook-events "query"`
`--include-partial-messages`	部分的なストリーミングイベントを出力に含めます。`--print` と `--output-format stream-json` が必要です	`claude -p --output-format stream-json --verbose --include-partial-messages "query"`
`--input-format`	プリントモードの入力形式を指定します（オプション：`text`、`stream-json`）	`claude -p --output-format json --input-format stream-json`
`--json-schema`	エージェントがワークフローを完了した後、JSON Schema に一致する検証済み JSON 出力を取得します（プリントモードのみ。構造化出力を参照）	`claude -p --json-schema '{"type":"object","properties":{...}}' "query"`
`--maintenance`	セッション開始前に `maintenance` マッチャーで Setup hooks を実行します（プリントモードのみ）	`claude -p --maintenance "query"`
`--max-budget-usd`	停止する前に API 呼び出しに費やす最大ドル金額（プリントモードのみ）	`claude -p --max-budget-usd 5.00 "query"`
`--max-turns`	agentic ターンの数を制限します（プリントモードのみ）。制限に達するとエラーで終了します。デフォルトでは制限なし	`claude -p --max-turns 3 "query"`
`--mcp-config`	JSON ファイルまたは文字列から MCP サーバーを読み込みます（スペース区切り）	`claude --mcp-config ./mcp.json`
`--model`	現在のセッションのモデルを、最新モデルのエイリアス（`sonnet`、`opus`、`haiku`、または `fable`）またはモデルの完全な名前で設定します。`model` 設定と `ANTHROPIC_MODEL` をオーバーライドします	`claude --model claude-sonnet-5`
`--name`、`-n`	セッションの表示名を設定します。`/resume` とターミナルタイトルに表示されます。`claude --resume <name>` で名前付きセッションを再開できます。 `/rename` はセッション中に名前を変更し、プロンプトバーにも表示します	`claude -n "my-feature-work"`
`--no-chrome`	このセッションの Chrome ブラウザ統合を無効にします	`claude --no-chrome`
`--no-session-persistence`	セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします（プリントモードのみ）。`CLAUDE_CODE_SKIP_PROMPT_HISTORY` 環境変数は任意のモードで同じことを行います	`claude -p --no-session-persistence "query"`
`--output-format`	プリントモードの出力形式を指定します（オプション：`text`、`json`、`stream-json`）	`claude -p "query" --output-format json`
`--permission-mode`	指定された権限モードで開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、または `bypassPermissions` を受け入れます。設定ファイルの `defaultMode` をオーバーライドします	`claude --permission-mode plan`
`--permission-prompt-tool`	非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します	`claude -p --permission-prompt-tool mcp_auth_tool "query"`
`--plugin-dir`	このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します：`--plugin-dir A --plugin-dir B.zip`	`claude --plugin-dir ./my-plugin`
`--plugin-url`	このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します	`claude --plugin-url https://example.com/plugin.zip`
`--print`、`-p`	インタラクティブモードなしで応答を出力します（プログラムによる使用の詳細については Agent SDK ドキュメントを参照）	`claude -p "query"`
`--prompt-suggestions`	各ターンの後に、予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを発行します。`--print`、`--output-format stream-json`、および `--verbose` が必要です。プロンプト提案を参照してください	`claude -p --prompt-suggestions --output-format stream-json --verbose "query"`
`--remote`	提供されたタスク説明で claude.ai に新しい Web セッションを作成します	`claude --remote "Fix the login bug"`
`--remote-control`、`--rc`	Remote Control を有効にしてインタラクティブセッションを開始し、claude.ai または Claude アプリからも制御できるようにします。オプションでセッションの名前を渡すことができます	`claude --remote-control "My Project"`
`--remote-control-session-name-prefix <prefix>`	明示的な名前が設定されていない場合、自動生成される Remote Control セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されます。同じ効果を得るには `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定してください	`claude remote-control --remote-control-session-name-prefix dev-box`
`--replay-user-messages`	stdin からのユーザーメッセージを stdout に再発行して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です	`claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages`
`--resume`、`-r`	ID または名前で特定のセッションを再開するか、セッションを選択するためのインタラクティブピッカーを表示します。ピッカーと名前検索には、このディレクトリを `/add-dir` で追加したセッションが含まれます。セッション ID を渡すと、現在のプロジェクトディレクトリとその git worktrees のみが検索されます。v2.1.144 以降、バックグラウンドセッションはピッカーに `bg` でマークされて表示されます	`claude --resume auth-refactor`
`--safe-mode`	{/* min-version: 2.1.169 */}すべてのカスタマイズを無効にして開始し、壊れた設定をトラブルシューティングします：CLAUDE.md、skills、plugins、hooks、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、および自動メモリは読み込まれません。認証、モデル選択、組み込みツール、および権限は通常どおり機能します。これは `--bare` とは異なります。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、およびポリシー設定 MCP サーバーは含まれません。Fable 5 からの自動フォールバックをトリガーするカスタマイズかどうかを確認するのに役立ちます。`CLAUDE_CODE_SAFE_MODE` を設定します	`claude --safe-mode`
`--session-id`	会話に特定のセッション ID を使用します（有効な UUID である必要があります）	`claude --session-id "550e8400-e29b-41d4-a716-446655440000"`
`--setting-sources`	読み込む設定ソースのカンマ区切りリスト（`user`、`project`、`local`）	`claude --setting-sources user,project`
`--settings`	設定 JSON ファイルまたはインライン JSON 文字列へのパス。ここで設定した値は、このセッションの `settings.json` ファイル内の同じキーをオーバーライドします。省略したキーはファイルベースの値を保持します。設定の優先順位を参照してください	`claude --settings ./settings.json`
`--strict-mcp-config`	`--mcp-config` からのみ MCP サーバーを使用し、他のすべての MCP 設定を無視します	`claude --strict-mcp-config --mcp-config ./mcp.json`
`--system-prompt`	デフォルトシステムプロンプト全体をカスタムテキストで置き換えます	`claude --system-prompt "You are a Python expert"`
`--system-prompt-file`	ファイルからシステムプロンプトを読み込み、デフォルトプロンプトを置き換えます	`claude --system-prompt-file ./custom-prompt.txt`
`--teleport`	Web セッションをローカルターミナルで再開します	`claude --teleport`
`--teammate-mode`	エージェントチームのチームメイトの表示方法を設定します：`in-process`（デフォルト）、`auto`、`tmux`、または {/* min-version: 2.1.186 */}`iterm2`（v2.1.186 で追加）。デフォルトは v2.1.179 で `auto` から変更されました。このセッションの `teammateMode` 設定をオーバーライドします。ディスプレイモードを選択を参照してください	`claude --teammate-mode auto`
`--tmux`	worktree 用に tmux セッションを作成します。`--worktree` が必要です。利用可能な場合は iTerm2 ネイティブペインを使用します。従来の tmux の場合は `--tmux=classic` を渡します	`claude -w feature-auth --tmux`
`--tools`	Claude が使用できる組み込みツールを制限します。`""` を使用してすべてを無効にし、`"default"` を使用してすべてを有効にするか、`"Bash,Edit,Read"` のようなツール名を使用します。MCP ツールは影響を受けません。それらも拒否するには、`--disallowedTools "mcp__*"` を使用するか、`--mcp-config` なしで `--strict-mcp-config` を渡して、MCP サーバーが読み込まれないようにします	`claude --tools "Bash,Edit,Read"`
`--verbose`	詳細ログを有効にし、ターンごとの完全な出力を表示します。このセッションの `viewMode` 設定をオーバーライドします	`claude --verbose`
`--version`、`-v`	バージョン番号を出力します	`claude -v`
`--worktree`、`-w`	Claude を `<repo>/.claude/worktrees/<name>` の分離された git worktree で開始します。名前が指定されていない場合は、自動生成されます。`#<number>` または GitHub プルリクエスト URL を渡して、`origin` からその PR をフェッチし、worktree をそこからブランチします	`claude -w feature-auth`

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

Claude Code は、システムプロンプトをカスタマイズするための 4 つのフラグを提供します。すべて 4 つはインタラクティブモードと非インタラクティブモードの両方で機能します。

フラグ	動作	例
`--system-prompt`	デフォルトプロンプト全体を置き換えます	`claude --system-prompt "You are a Python expert"`
`--system-prompt-file`	ファイルの内容で置き換えます	`claude --system-prompt-file ./prompts/review.txt`
`--append-system-prompt`	デフォルトプロンプトに追加します	`claude --append-system-prompt "Always use TypeScript"`
`--append-system-prompt-file`	ファイルの内容をデフォルトプロンプトに追加します	`claude --append-system-prompt-file ./style-rules.txt`

--system-prompt と --system-prompt-file は相互に排他的です。追加フラグは、置き換えフラグのいずれかと組み合わせることができます。

Claude Code のデフォルトの ID がタスクに適合しているかどうかに基づいて選択してください。Claude が追加のルールも従うコーディングアシスタントのままである場合は、追加フラグを使用してください：呼び出しごとの指示、出力形式設定、または -p スクリプトのドメインコンテキスト。追加することで、デフォルトのツールガイダンス、安全指示、およびコーディング規約が保持されるため、異なる部分のみを提供します。システムプロンプトの表面、ID、または権限モデルが Claude Code のものと異なる場合は、置き換えフラグを使用してください。例えば、人間が監視していないパイプラインの非コーディングエージェント。置き換えることで、デフォルトプロンプト全体が削除されます。ツールガイダンスと安全指示を含めて、タスクがまだ必要とするものについて責任を負います。

これらのフラグは現在の呼び出しにのみ適用されます。プロジェクト全体で切り替えて共有できる永続的なペルソナについては、出力スタイルを使用してください。Claude が常に従うべきプロジェクト規約については、CLAUDE.md を使用してください。Agent SDK ガイドのシステムプロンプトは、より詳細に同じ決定をカバーしています。

cli-reference.md 2026-06-29 23:02 UTC to 2026-06-30 23:02 UTC

CLI リファレンス

CLI コマンド

CLI フラグ

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

関連項目

cli-reference.md +2 −1