SpyBara
Go Premium

cli-reference.md 2026-11-08 22:58 UTC to 2026-11-09 23:02 UTC

This page contains 92 additions and 92 deletions.

2026
Mon 2 23:57 Tue 3 23:58 Mon 9 23:02

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 サーバーを開始します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 上の Claude Code の前に SSO とポリシーをデプロイする管理者向けです。--config で gateway.yaml を指す必要があります。 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 で終了します。JSON には、CLI が使用する 設定ディレクトリ の名前を付ける configDirectory フィールドが含まれます。このフィールドには Claude Code v2.1.268 以降が必要です。JSON の authMethod フィールドは、none、claude.ai、oauth_token、api_key、api_key_helper、または third_party のいずれかです 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|name> このターミナルで バックグラウンドセッション に接続します。ID の代わりに実行中のセッション名の一部を渡すには、Claude Code v2.1.290 以降が必要です claude attach 7c5dcf5d
claude auto-mode defaults 組み込み auto モード 分類器ルールを JSON として出力します。claude auto-mode config を使用して、設定が適用された有効な設定を確認してください。--label <prefix> は、ラベルがそのプレフィックスで始まるルールのみを出力します。大文字と小文字を区別しません。Claude Code v2.1.208 以降が必要です claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset ユーザー設定ファイルから autoMode セクションを削除して、デフォルト auto モード 設定を復元します。書き込み前に確認を求めます。-y/--yes を渡してプロンプトをスキップします。管理設定 または --settings フラグからのルールは引き続き適用されます。Claude Code v2.1.212 以降が必要です。デフォルトと有効な設定を検査 を参照してください claude auto-mode reset --yes
claude daemon logs バックグラウンドセッション スーパーバイザー のログファイル ~/.claude/daemon.log を追跡し、Ctrl+C を押すまで新しい行が届くたびに出力します claude daemon logs
claude daemon run バックグラウンドセッション スーパーバイザー をこのターミナルのフォアグラウンドで実行し、そのログを出力します claude daemon run
claude daemon status バックグラウンドセッション スーパーバイザー の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します claude daemon status
claude daemon stop --any バックグラウンドセッション スーパーバイザー とそれがホストするセッションを停止します。--keep-workers を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。--any はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、応答しないスーパーバイザー から回復します claude daemon stop --any --keep-workers
claude doctor セッションを開始せずにターミナルから読み取り専用のインストールおよび設定診断を出力します。インストール正常性、設定ファイル検証エラー、および Remote Control 適格性を含みます。セッション内のセットアップチェックアップで修正を適用することもできます。/doctor を実行してください claude doctor
claude import [source] 他のコーディングエージェントからの設定を Claude Code に取り込むために /import を実行するインタラクティブセッションを開始します。コマンドと同じ --dry-run および --yes オプションを受け入れます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform では利用できません。機能フラグ取得 をオフにした場合も利用できません。Claude Code v2.1.213 以降が必要です claude import codex --dry-run
claude logs <id|name> バックグラウンドセッション からの最近の出力を出力します。ID の代わりにセッション名の一部を渡すには、Claude Code v2.1.290 以降が必要です claude logs 7c5dcf5d
claude mcp Model Context Protocol（MCP）サーバーを設定 Claude Code MCP ドキュメント を参照してください。
claude mcp login <name> 設定済み MCP サーバーの OAuth フローを実行します。インタラクティブな /mcp パネルを開きません。HTTP、SSE、および claude.ai コネクタサーバーで機能します。SSH 経由では --no-browser を追加すると、ブラウザを開く代わりに認可 URL を出力します。HTTP または SSE サーバーの場合は、リダイレクト URL をプロンプトに貼り付けます。claude.ai コネクタの場合は、シェルからコネクタを再度認可する を参照してください。コマンドラインから認証 を参照してください claude mcp login sentry
claude mcp logout <name> MCP サーバーの保存された OAuth 認証情報をクリアします claude mcp logout sentry
claude plugin Claude Code plugins を管理します。エイリアス：claude plugins。サブコマンドについては plugin reference を参照してください claude plugin install code-review@claude-plugins-official
claude purge [path] プロジェクトのすべてのローカル Claude Code 状態を削除します：トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴行、および ~/.claude.json 内のプロジェクトエントリ。[path] を省略して、インタラクティブリストから選択します。フラグ：--dry-run でプレビュー、-y/--yes で確認をスキップ、-i/--interactive で各項目を確認、--all ですべてのプロジェクト。ローカルデータをクリア を参照してください claude purge ~/work/repo --dry-run
claude remote-control Remote Control サーバーを開始して、claude.ai または Claude アプリから Claude Code を制御します。エイリアス：claude rc。サーバーモード（ローカルインタラクティブセッションなし）で実行されます。サーバーモードフラグ を参照してください。サーバーを停止した後、サーバーが提供していたセッションを復元できます。サーバー停止後のセッション再開 を参照してください claude remote-control --name "My Project"
claude respawn <id> 会話を保持したまま、バックグラウンドセッション を再開します。実行中または停止中。--all を使用してすべての実行中セッションを再開します。たとえば、更新された Claude Code バイナリを取得するため claude respawn 7c5dcf5d
claude rm <id> バックグラウンドセッション をリストから削除します。削除が セッションの worktree を理由に拒否 され、2 回目の claude rm で解決できる場合、拒否は渡すべき正確なフラグと値を出力します：--discard-unpushed <commit>@<worktree-id> はプッシュされていないコミットを持つ worktree をそれらのコミットとともに破棄し、--force-remove-worktree <worktree-id> は git または WorktreeRemove フックが削除できなかった worktree ディレクトリを削除します。--discard-unpushed には Claude Code v2.1.260 以降が必要です。また、--force-remove-worktree には v2.1.268 以降が必要です。会話トランスクリプトはローカルマシンに残り、claude --resume を通じて利用可能です claude rm 7c5dcf5d
claude self-hosted-runner このマシンまたはコンテナを 自己ホスト環境 に登録し、Claude Code クラウドセッションをインフラストラクチャ上でホストするランナープロセスを開始します。claude self-hosted-runner setup でガイド付きオペレーターウォークスルーを実行し、claude self-hosted-runner doctor で デプロイされたランナーを診断 し、claude self-hosted-runner orchestrator で オンデマンドランナー をスポーンします。Claude Code v2.1.224 以降が必要です claude self-hosted-runner setup
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> を使用して 45 分のデフォルトを上書きします。github.com プルリクエストターゲットで --post を使用して、完了した結果を GitHub アカウントから PR に 1 つのプレーンコメントとして投稿します。--no-post がデフォルトです。--post と --no-post には Claude Code v2.1.227 以降が必要です。プルリクエストに結果を投稿 を参照してください claude ultrareview 1234 --json

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

claude --dangerously-skip-permissions daemon <subcommand> は daemon サブコマンドを実行するため、claude がフラグを含むようにエイリアスされている場合でもサブコマンドは機能します。先頭の --dangerously-skip-permissions または --allow-dangerously-skip-permissions のみがこの方法で daemon にルーティングされます。daemon の前にそれ以外のフラグがある場合、サブコマンドは実行されません。

CLI フラグ

以下のコマンドラインフラグで Claude Code の動作をカスタマイズできます。claude --help にはすべてのフラグが表示されるわけではないため、--help にフラグが表示されないからといって、そのフラグが使用できないわけではありません。

フラグ 説明 例
--add-dir Claude がファイルを読み取り・編集するための作業ディレクトリを追加します。ファイルへのアクセスを許可するものであり、Claude Code はこれらのディレクトリからほとんどの .claude/ 設定を検出しません。各パスがディレクトリとして存在することを検証します。\\server\share などのほとんどのネットワークパスは追加できません。これらのディレクトリをセッション間で保持するには、設定で permissions.additionalDirectories を設定します claude --add-dir ../apps ../lib
--advisor <model> モデルエイリアス（fable、opus、sonnet）または完全なモデル ID を指定して、このセッションでサーバー側のアドバイザーツールを有効にします。このセッションでは advisorModel 設定よりも優先されます。fable には Fable へのアクセスが必要です claude --advisor opus
--agent 現在のセッションのエージェントを指定します（agent 設定を上書きします） claude --agent my-custom-agent
--agents JSON を使用してカスタムサブエージェントを動的に定義します。CLI で定義するサブエージェント用に記載されたフィールドを受け付けます。--print と併用する場合は、値の代わりにオブジェクトを含む JSON ファイルへのパスを指定することもできます。ファイル形式には Claude Code v2.1.281 以降が必要です。Claude Code は起動時に値を検証し、無効な値の場合は終了します。メッセージと、検証をスキップするフラグおよび環境変数については Invalid --agents configuration を参照してください。検証には Claude Code v2.1.242 以降が必要です claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions bypassPermissions を Shift+Tab のモード切り替えサイクルに追加しますが、そのモードでは開始しません。plan などの別のモードで開始し、後で bypassPermissions に切り替えることができます。権限モードを参照してください claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools 権限を求めるプロンプトなしで実行されるツール。ただし、ネットワークパスからの読み取りは除きます。パターンマッチングについては権限ルールの構文を参照してください。使用可能なツールを制限するには、代わりに --tools を使用します。ここでタスク追跡ツールのいずれかを指定すると、Claude Code はセッションでそれらのツールの利用も有効にします "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt すべてのサブエージェントのシステムプロンプトの末尾にカスタムテキストを追加します。ネストされたサブエージェントも対象ですが、会話自体のプロンプトを再利用するフォークされたサブエージェントは除きます。-p を使用した非対話モードでのみ適用されます。Claude Code v2.1.205 以降が必要です claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file ファイルからテキストを読み込み、サブエージェントのシステムプロンプトに追加します。コマンドラインで渡すには長すぎるテキスト向けの、--append-subagent-system-prompt の代替手段です。2 つのフラグは併用できません。-p を使用した非対話モードでのみ適用されます。Claude Code v2.1.261 以降が必要です claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt デフォルトのシステムプロンプトの末尾にカスタムテキストを追加します claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file ファイルから追加のシステムプロンプトテキストを読み込み、デフォルトのプロンプトに追加します claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> 保存済みの設定を変更せずに、このセッションの自動圧縮ウィンドウを設定します。/autocompact と同じ値を受け付けます。値の形式と、このフラグを上書きするものについてはそのセクションで説明しています。Claude Code v2.1.221 以降が必要です claude --autocompact 500k
--ax-screen-reader スクリーンリーダーに適した出力（装飾的な罫線やアニメーションのないフラットなテキスト）をレンダリングします。クラシックレンダラーを強制するため、tui 設定は効果がありません。ただし、アタッチされたバックグラウンドセッションは引き続きフルスクリーンでレンダリングされます。CLAUDE_AX_SCREEN_READER および axScreenReader 設定よりも優先されます。Claude Code v2.1.181 以降が必要です claude --ax-screen-reader
--bare 最小モード：フック、スキル、カスタムコマンド、サブエージェント、インストール済みプラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップし、スクリプトからの呼び出しを高速に開始します。--add-dir で渡したディレクトリ内のスキルは引き続き読み込まれます。Claude は Bash、ファイル読み取り、ファイル編集のツールにアクセスできます。CLAUDE_CODE_SIMPLE を設定します。bare モードを参照してください claude --bare -p "query"
--betas API リクエストに含めるベータヘッダー（API キーユーザーのみ） claude --betas interleaved-thinking
--bg, --background セッションをバックグラウンドエージェントとして開始し、すぐに制御を返します。セッション ID と管理コマンドを出力します。--exec と組み合わせると Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行し、--agent と組み合わせると特定のサブエージェントを実行します。開始前にディレクトリのワークスペースの信頼を確認します。-p/--print とは併用できません。エラーリファレンスを参照してください claude --bg "investigate the flaky test"
--channels （リサーチプレビュー）このセッションで Claude がチャネル通知をリッスンする MCP サーバー。plugin:<name>@<marketplace> エントリのスペース区切りリストです。claude.ai または Console の API キーによる Anthropic 認証が必要です claude --channels plugin:my-notifier@my-marketplace
--chrome Web の自動化とテストのために Chrome ブラウザ統合を有効にします claude --chrome
--cloud タスクの説明を指定すると、新しいクラウドセッションを作成します。セッション ID（session_... または cse_...）または claude.ai/code の URL を指定すると、代わりに -p と併用して、その既存のセッションにメッセージをキューに追加します。フォローアップメッセージを送信するを参照してください。 claude --cloud "Fix the login bug"
--continue, -c 現在のディレクトリで最新の会話を読み込みます（終了したバックグラウンドセッションを含む）。終了したバックグラウンドセッションを開くには Claude Code v2.1.257 以降が必要です。claude -p または Agent SDK で作成されたセッションと、最初のプロンプトが /loop だったセッションはスキップされます。claude -p --continue では -p、SDK、/loop のセッションも対象になります。/add-dir でこのディレクトリを追加したセッションも含まれます claude --continue
--dangerously-load-development-channels ローカル開発のために、承認済みの許可リストにないチャネルを有効にします。plugin:<name>@<marketplace> および server:<name> エントリを受け付けます。確認を求めるため、対話セッションで有効になります。-p を使用すると、Claude Code はこのフラグを無視します claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions 権限プロンプトをスキップします。--permission-mode bypassPermissions と同等です。これによってスキップされるものとされないものについては、権限モードを参照してください。--bg で開始したセッションでは、このモードはスーパーバイザーがセッションを再起動しても保持されます claude --dangerously-skip-permissions
--debug オプションのカテゴリフィルタリング付きでデバッグモードを有効にします（例：--debug='mcp,startup' や --debug='!mcp'）。フィルターは = 形式でのみ適用されます。スペース区切りでフィルターを指定すると、フィルタリングなしでデバッグモードが有効になります claude --debug='mcp,startup'
--debug-file <path> デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。CLAUDE_CODE_DEBUG_LOGS_DIR よりも優先されます claude --debug-file /tmp/claude-debug.log
--desktop 現在のディレクトリで Claude Desktop アプリを開き、ターミナルでセッションを開始せずに終了します。代わりにそのセッションを Desktop で開くには、--continue、またはセッション ID を指定した --resume を追加します。ここでの --resume はセッション ID のみを受け付け、名前やトランスクリプトのパスは受け付けません。アプリ自体がセッションを開始するため、プロンプトは受け付けず、--verbose と --debug 系のフラグ以外のフラグも受け付けません。Claude サブスクリプションでサインインしている場合に、macOS と x64 Windows で使用できます。Claude Code v2.1.285 以降が必要です claude --desktop
--disable-slash-commands このセッションのすべてのスキルとコマンドを無効にします claude --disable-slash-commands
--disallowedTools, --disallowed-tools 拒否ルール。ツール名のみを指定すると、一致するツールが Claude のコンテキストから削除されます。"Edit" は Edit を、"*" はすべてのツールを、"mcp__*" はすべての MCP ツールを削除します。Bash(rm *) のようなスコープ付きのルールではツールは引き続き使用可能なままで、記述どおりに一致する呼び出しのみが拒否されます。EndConversation を指定するルールでは、他のツールが残っている限りそれを削除できません "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort 現在のセッションの effort レベルを設定します。オプション：low、medium、high、xhigh、max、または ultracode。使用可能なレベルはモデルによって異なります。ultracode は ultracode をオンにした状態で xhigh の effort を要求するもので、Claude Code v2.1.203 以降が必要です。メイン会話のモデルでは、このセッションの modelSettings および effortLevel 設定を上書きし、保持されません claude --effort high
--enable-auto-mode v2.1.111 で削除されました。auto モードはデフォルトで Shift+Tab のサイクルに含まれるようになりました。auto モードで開始するには --permission-mode auto を使用します claude --permission-mode auto
--environment <environment-id> 指定した ID のセルフホスト環境で実行される新しいクラウドセッションを作成します。環境 ID は ccpool_ で始まります。ディスパッチの動作と、このフラグが拒否するフラグの組み合わせについては、--environment のディスパッチ動作を参照してください。Claude Code v2.1.224 以降が必要です claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections 自動メモリの場所などのユーザーごとのコンテキストを、システムプロンプトから最初のユーザーメッセージに移動します。同じタスクを実行する異なるユーザーやマシン間でのプロンプトキャッシュの再利用が向上します。デフォルトのシステムプロンプトでのみ適用され、--system-prompt または --system-prompt-file が設定されている場合は無視されます。スクリプト化されたマルチユーザーのワークロードでは -p と併用してください claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Claude セッションを開始する代わりに、シェルコマンドを PTY ベースのバックグラウンドジョブとして実行します。シェルから起動するには --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
--forward-subagent-text サブエージェントのテキストと思考ブロックを、parent_tool_use_id が設定された assistant および user メッセージとして出力ストリームに出力し、各サブエージェントのトランスクリプトを再構築できるようにします。このフラグがない場合、Claude Code はフォアグラウンドで実行されるサブエージェントのテキストと思考ブロックを省略します。--print と --output-format stream-json が必要です。ネストされたサブエージェント、フォークされたスキル、およびそれぞれに必要なバージョンについては、サブエージェントのメッセージを追跡するを参照してください。CLAUDE_CODE_FORWARD_SUBAGENT_TEXT 環境変数でも同じ動作が有効になります。Claude Code v2.1.211 以降が必要です claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr 特定のプルリクエストにリンクされたセッションに絞り込んだ状態でセッションピッカーを開きます。PR 番号、GitHub または GitHub Enterprise の PR URL、GitLab のマージリクエスト URL、Bitbucket のプルリクエスト URL を受け付けます。Claude がプルリクエストを作成すると、セッションは自動的にリンクされます claude --from-pr 123
--ide 有効な IDE がちょうど 1 つだけ利用可能な場合、起動時に自動的に IDE に接続します claude --ide
--init セッションの前に init matcher で Setup フックを実行します（print モードのみ） claude -p --init "query"
--init-only Setup および SessionStart フックを実行し、会話を開始せずに終了します claude --init-only
--include-hook-events フックのライフサイクルイベントを出力ストリームに含めます。SessionStart と Setup のフックイベントは常に含まれるため、このフラグは不要です。Notification、SessionEnd、PreCompact、PostCompact などの一部のフックイベントは、このフラグを指定しても hook_started イベントを生成しません。これらのイベントについても、Claude Code は 1 秒を超えて実行されるコマンドフックが出力を生成している間は hook_progress を出力し、バックグラウンドで実行されるフックが終了したときにのみ hook_response を出力します。--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 print モードの入力形式を指定します（オプション：text、stream-json） claude -p --input-format stream-json --output-format stream-json --verbose
--json-schema エージェントがワークフローを完了した後、JSON Schema に一致する検証済みの JSON 出力を取得します（print モードのみ）。構造化出力を参照してください。Claude Code は無効なスキーマの場合はエラーで終了し、format キーワードはクライアント側の検証を行わずにアノテーションとして受け付けます claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance セッションの前に maintenance matcher で Setup フックを実行します（print モードのみ） claude -p --maintenance "query"
--max-budget-usd API 呼び出しの推定支出額がこの金額に達した時点で実行を停止します（print モードのみ）。Claude Code は上限をクライアント側のコスト見積もりと照合しますが、これは実際の請求額と異なる場合があります。サブエージェントによる支出も上限に含まれます。支出は上限を超える可能性があるため、余裕を持たせてください。--continue または --resume で会話に戻った場合、以前の実行から復元された合計額は上限に含まれません。支出が上限に達すると、別のサブエージェントの生成は Budget limit reached で失敗し、Claude Code はまだ実行中のバックグラウンドサブエージェントを停止します。これらの上限適用の動作には Claude Code v2.1.217 以降が必要です claude -p --max-budget-usd 5.00 "query"
--max-turns エージェントのターン数を制限します（print モードのみ）。デフォルトでは制限はありません。--input-format stream-json を使用している場合、制限によってターンが終了した時点でまだキューにあるメッセージはキューに残り、独自の制限を持つ新しいターンを開始します claude -p --max-turns 3 "query"
--mcp-config JSON ファイルまたは文字列（スペース区切り）から MCP サーバーを読み込みます。このフラグを -p と併用すると、Claude Code は最初のターンを実行する前に、まだ保留中のサーバーが接続するのを MCP_TIMEOUT の起動タイムアウト（デフォルトは 30 秒）まで待機します。キャッシュされたツールリストを持つサーバーは待機をスキップし、初回使用時に接続します。セルフホスト環境では、代わりにより短い待機時間が適用されます。この待機には Claude Code v2.1.221 以降が必要です 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 セッションの永続化を無効にし、セッションがディスクに保存されず再開できないようにします。print モードのみ。CLAUDE_CODE_SKIP_PROMPT_HISTORY 環境変数は、どのモードでも同じ動作をします claude -p --no-session-persistence "query"
--output-format print モードの出力形式を指定します（オプション：text、json、stream-json） claude -p "query" --output-format json
--permission-mode 指定した権限モードで開始します。default、acceptEdits、plan、auto、dontAsk、bypassPermissions、または default のエイリアスとして manual を受け付けます。manual エイリアスは UI で Manual と表示される権限モードを選択するもので、Claude Code v2.1.200 以降が必要です。claude --help では default の代わりにこちらが表示されますが、どちらの値も機能します。設定ファイルの defaultMode を上書きします。このフラグも --dangerously-skip-permissions も指定しない場合、新しいセッションはセッションが開始する権限モードで説明されている権限モードで開始します。このセクションでは、-p の実行がどのモードで開始するかも説明しています claude --permission-mode plan
--permission-prompt-tool 非対話モードで権限プロンプトを処理する MCP ツールを指定します。実行時に読み込まれる MCP サーバー上のツールの完全な名前（mcp__<server>__<tool> など）を渡します。Claude Code は最初のターンを実行する前に、そのツールの MCP サーバーが接続するのを MCP_TIMEOUT の起動タイムアウト（デフォルトは 30 秒）まで待機します。ツールが返す必要があるものを参照してください。 プロンプトツールは、ユーザー操作が必要とマークされた MCP ツールを承認できません。Claude Code はそのようなツールに対する allow の結果を拒否に変換します。この制限には Claude Code v2.1.199 以降が必要です claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"
--permission-prompts print モードで権限プロンプトに誰が応答するかを設定します。デフォルトの host では、Claude Code はプロンプトを Agent SDK ホストまたは --permission-prompt-tool のツールに送信します。誰も応答できない場合は none を渡すと、Claude Code は代わりにプロンプトを拒否します。無人実行で権限プロンプトをオフにするを参照してください。Claude Code v2.1.259 以降が必要です claude -p --permission-prompts none "query"
--plugin-dir このセッションに限り、ディレクトリまたは .zip アーカイブからプラグインを読み込むか、プラグインのフォルダから複数のプラグインを読み込みます。各フラグは 1 つのパスを受け取ります。複数のパスを指定するにはフラグを繰り返します：--plugin-dir A --plugin-dir B.zip。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です claude --plugin-dir ./my-plugin
--plugin-url このセッションに限り、URL からプラグインの .zip アーカイブを取得します。複数のプラグインを指定するには、フラグを繰り返すか、引用符で囲んだ 1 つの値にスペース区切りで URL を渡します claude --plugin-url https://example.com/plugin.zip
--print, -p 対話モードを使用せずに応答を出力します（プログラムによる使用の詳細については Agent SDK ドキュメントを参照）。まだ実行中のバックグラウンドセッションに対する --resume については、実行中のバックグラウンドセッションを再開するを参照してください claude -p "query"
--prompt-suggestions 予測される次のユーザープロンプトを生成した各ターンの後に、そのプロンプトを含む prompt_suggestion メッセージを出力します。非常に短い会話では生成されない場合があります。--print、--output-format stream-json、--verbose が必要です。プロンプトの提案を参照してください claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> --environment と併用して、新しいセッションのチェックアウトをローカルの HEAD ではなく指定した ref に基づかせます claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote --cloud の非推奨のエイリアスです（既存セッション形式を含む） 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
--restricted 制限モードで開始します。評価ハーネスが共有マシン上で claude を駆動し、Claude Code がコマンドを実行したり、そのマシンのユーザー設定やプロジェクト設定を読み取ったりしてはならない場合に使用します。Claude Code は、コマンドやコードを実行する組み込みツールと WebFetch を削除します。ただし、default プリセット経由ではなく --tools で個別に指定した場合は除きます。また、組み込みのファイルツールを作業ディレクトリに限定し、管理設定と --settings のみを読み込み、bypassPermissions を拒否し、クラウドセッションの作成を拒否します。Claude Code v2.1.248 以降が必要です claude --restricted -p "query"
--resume, -r ID または名前で特定のセッションを再開するか、対話型のピッカーを表示してセッションを選択します。ID の代わりに、セッションの .jsonl トランスクリプトファイルへの絶対パスを渡すこともできます。ピッカーと名前検索には、/add-dir でこのディレクトリを追加したセッションも含まれます。セッション ID を渡すと、Claude Code は現在のプロジェクトディレクトリとその git worktree を検索し、次にこのマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索の対象は現在のプロジェクトディレクトリとその git worktree のみでした。バックグラウンドセッションはピッカーに bg のマーク付きで表示されます。まだ実行中のセッションを再開すると、claude attach を通じてこのターミナルでそのセッションが開き、コマンドラインで渡したプロンプトはそのセッションの次のターンとして送られます。v2.1.285 より前は、Claude Code は再開を拒否し、代わりに実行する claude attach コマンドを出力していました claude --resume auth-refactor
--safe-mode 壊れた設定をトラブルシューティングするために、すべてのカスタマイズを無効にして開始します。CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーボードショートカット、ステータスラインとファイル候補のコマンド、LSP サーバー、自動メモリは読み込まれません。認証、モデル選択、組み込みツール、権限は通常どおり機能し、この点が --bare とは異なります。管理設定のポリシーは引き続き適用され、ポリシーで設定されたフック、ステータスライン、ファイル候補のコマンドも含まれます。一方、管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシーで設定された MCP サーバーは適用されません。カスタマイズが自動モデルフォールバックを引き起こしているかどうかを確認するのに役立ちます。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 ファイル内の同じキーを上書きします。省略したキーはファイルベースの値を保持します。ファイルは 2 MiB 以下の通常のファイルである必要があります。設定の優先順位を参照してください claude --settings ./settings.json
--strict-mcp-config --mcp-config の MCP サーバーのみを使用し、他のすべての MCP 設定を無視します。管理 MCP ファイルがある場合のこのフラグの動作については、managed-mcp.json による排他的制御を参照してください 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
--system-prompt-snapshot off を渡すと、会話の最初のリクエストで記録されたプロンプトを再利用する代わりに、リクエストごとにシステムプロンプトを再構築します。たとえば、--continue の実行をまたいで --append-system-prompt のテキストを繰り返し調整する場合に使用します。Claude Code v2.1.257 以降が必要です claude --system-prompt-snapshot off
--teleport クラウドセッションをローカルのターミナルで再開します claude --teleport
--teammate-mode エージェントチームのチームメイトの表示方法を設定します：in-process（デフォルト）、auto、tmux、iterm2。このセッションでは teammateMode 設定を上書きします。表示モードを選択するを参照してください claude --teammate-mode auto
--tmux worktree 用の tmux セッションを作成します。--worktree が必要です。利用可能な場合は iTerm2 のネイティブペインを使用します。従来の tmux を使用するには --tmux=classic を渡します claude -w feature-auth --tmux
--tools Claude が使用できる組み込みツールを制限します。すべて無効にするには ""、デフォルトのセットには "default" を使用するか、"Bash,Edit,Read" のようにツール名を指定します。macOS、Linux、WSL では、Glob ツールの動作で説明されているように、デフォルトのセットに Glob と Grep は含まれません。ここでタスク追跡ツールのいずれかを指定すると、Claude Code はセッションでそれらのツールの利用も有効にします。このフラグは MCP ツールには影響しません。MCP ツールも拒否するには --disallowedTools "mcp__*" を使用します。EndConversation を省略したリストではそれは削除されません。"" は MCP ツールが残っていない場合にのみそれを削除します claude --tools "Bash,Edit,Read"
--verbose 詳細なログを有効にし、ターンごとの完全な出力を表示します。このセッションでは viewMode 設定を上書きします claude --verbose
--version, -v バージョン番号を出力します claude -v
--worktree, -w <repo>/.claude/worktrees/<name> にある分離された git worktree で Claude を開始します。名前を指定しない場合は Claude Code が生成します。#<number>、GitHub のプルリクエスト URL、または GitLab のマージリクエスト URL を渡すと、その PR または MR を origin から取得し、そこから worktree のブランチを作成します。GitLab のマージリクエストからブランチを作成するには Claude Code v2.1.233 以降が必要です claude -w feature-auth

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

Claude Code には、システムプロンプトをカスタマイズするための 5 つのフラグがあります。4 つはプロンプトのテキストを設定するもので、--system-prompt-snapshot では、会話が開始時のテキストを保持し続けるかどうかを制御します。5 つすべてが対話モードと非対話モードの両方で機能します。

フラグ 動作 例
--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-snapshot off の場合、リクエストごとにプロンプトを再構築します。デフォルトの on の場合、記録が適用されるときは記録されたプロンプトを再利用します claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

これらのフラグは組み合わせて使用できます。デフォルトのプロンプトを置き換えたうえで独自のテキストを追加するには、--system-prompt または --system-prompt-file と一緒に --append-system-prompt または --append-system-prompt-file を渡します。Claude Code v2.1.283 以降では、--append-system-prompt と --append-system-prompt-file のように、フラグとそのファイル形式を一緒に渡すこともでき、Claude Code は両方を使用します。

たとえば、ファイルのスタイルガイドと追加の指示 1 つの両方を追加するには、シェルで次のように実行します：

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

Claude は、デフォルトのシステムプロンプトの後に style.md の内容、空行、Always reply in French が続いたものを受け取ります。--append-system-prompt-file より前に --append-system-prompt を渡した場合でも、ファイルの内容が先になります。

置き換えるテキストが、毎回同じ指示と実行ごとに変わるコンテキストを組み合わせたものである場合は、指示とコンテキストの間に __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ のみを含む行を追加します。Claude Code は最初にあるその行でプロンプトを分割してその行を削除するため、その行より上の部分はキャッシュされたままとなり、下の部分は変更されます。Claude Code v2.1.275 以降が必要です。分割が適用される設定については、カスタムプロンプトの静的な部分をキャッシュするに一覧があります。

Claude Code のデフォルトのアイデンティティがタスクに合っているかどうかで選択してください。Claude をコーディングアシスタントのままにしつつ、追加のルール（呼び出しごとの指示、出力のフォーマット、-p スクリプトのドメインコンテキストなど）にも従わせたい場合は、追加フラグを使用します。追加ではデフォルトのツールガイダンス、安全性に関する指示、コーディング規約が保持されるため、異なる部分だけを指定すれば済みます。サーフェス、アイデンティティ、または権限モデルが Claude Code と異なる場合、たとえば人間が監視しないパイプライン内のコーディング以外のエージェントなどには、置き換えフラグを使用します。置き換えると、ツールガイダンスや安全性に関する指示を含むデフォルトのプロンプトがすべて失われるため、タスクに引き続き必要なものはユーザー自身が用意する必要があります。

切り替えたりプロジェクト全体で共有したりできる永続的なペルソナには、出力スタイルを使用します。Claude に常に従わせたいプロジェクトの規約には、CLAUDE.md を使用します。同じ判断について、システムプロンプトに関する Agent SDK ガイドでより詳しく説明しています。

再開した会話でのシステムプロンプトフラグ

デフォルトでは、Claude Code は会話の最初のリクエスト時に、システムプロンプトフラグのテキストを適用したうえでシステムプロンプトを 1 回だけ構築し、セッションに記録します。会話が圧縮されるまでは、以降のすべてのリクエストでその記録されたプロンプトが使用されます。これは --resume または --continue で会話に戻った後も同様です。その後の起動時に異なるシステムプロンプトフラグのテキストを渡した場合（またはフラグを渡さなかった場合）、その変更は会話が圧縮された時点、または新しい会話を開始した時点で有効になります。

クラウドセッション以外で、--bare を渡すか CLAUDE_CODE_SIMPLE=1 を設定して bare モードで Claude Code を開始した場合、--system-prompt-snapshot on を渡さない限り記録はオフのままです。v2.1.268 より前は、機能フラグを取得しないセッション（Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry 上のセッションを含む）ではリクエストごとにプロンプトが再構築され、--system-prompt-snapshot は効果がありませんでした。

代わりにリクエストごとにプロンプトを再構築するには、--system-prompt-snapshot off を渡します。たとえば、--continue の実行をまたいでプロンプトの文言を繰り返し調整する場合に便利です。v2.1.265 より前は、いずれかのシステムプロンプトフラグを渡すと、--system-prompt-snapshot on を渡さない限り記録もオフになっていました。

関連項目