SpyBara
Go Premium

cli-reference.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 50 additions and 40 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

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 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 を使用して、設定が適用された有効な設定を確認してください。--label <prefix> は、ラベルがそのプレフィックスで始まるルールのみを出力します。大文字と小文字を区別しません。Claude Code v2.1.208 以降が必要です claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset ユーザー設定ファイルから autoMode セクションを削除して、デフォルト auto mode 設定を復元します。書き込み前に確認を求めます。-y/--yes を渡してプロンプトをスキップします。管理設定 または --settings フラグからのルールは引き続き適用されます。Claude Code v2.1.212 以降が必要です。デフォルトと有効な設定を検査 を参照してください claude auto-mode reset --yes
claude daemon status バックグラウンドセッション スーパーバイザー の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します claude daemon status
claude daemon stop --any バックグラウンドセッション スーパーバイザー とそれがホストするセッションを停止します。--keep-workers を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。--any はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、応答しないスーパーバイザー から回復します claude daemon stop --any --keep-workers
claude doctor セッションを開始せずにターミナルから読み取り専用のインストールおよび設定診断を出力します。インストール正常性、設定ファイル検証エラー、およびリモートコントロール適格性を含みます。セッション内のセットアップチェックアップで修正を適用することもできます。/doctor を実行してください claude doctor
claude import [codex|gemini] 他のコーディングエージェントからの設定を 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> バックグラウンドセッション からの最近の出力を出力します 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 を出力し、リダイレクト URL をプロンプトに貼り付けます。Claude Code v2.1.186 以降が必要です。コマンドラインから認証 を参照してください claude mcp login sentry
claude mcp logout <name> 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 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? と出力します。

v2.1.199 以降、claude --dangerously-skip-permissions daemon <subcommand> は daemon サブコマンドを実行します。以前のバージョンでは、daemon <subcommand> を新しいインタラクティブセッションのプロンプトとして扱ったため、フラグが最初に来た場合、サブコマンドは実行されませんでした。これは claude がフラグを含むようにエイリアスされている場合の一般的なセットアップです。先頭の --dangerously-skip-permissions または --allow-dangerously-skip-permissions のみが daemon にこの方法でルーティングされます。他の先頭フラグはまだインタラクティブセッションを開始します。

CLI フラグ

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

フラグ 説明 例
--add-dir Claude がファイルを読み取り、編集するための追加の作業ディレクトリを追加します。ファイルアクセスを許可します。Claude Code は これらのディレクトリからほとんどの .claude/ 設定を検出しません。各パスがディレクトリとして存在することを検証します。ほとんどの ネットワークパス（\\server\share など）を追加することはできません。これらのディレクトリをセッション全体で永続化するには、設定で permissions.additionalDirectories を設定してください claude --add-dir ../apps ../lib
--advisor <model> このセッションのサーバーサイド advisor ツール をモデルエイリアス fable、opus、または sonnet、または完全なモデル ID で有効にします。このセッションの advisorModel 設定より優先されます。fable には Fable アクセス が必要です claude --advisor opus
--agent 現在のセッションのエージェントを指定します（agent 設定をオーバーライドします） claude --agent my-custom-agent
--agents JSON 経由でカスタム subagents を動的に定義します。CLI で定義された subagents のリストされたフィールド を受け入れます。Claude Code はスタートアップ時に JSON を検証し、無効な値で終了します。Invalid --agents configuration を参照してください。メッセージと検証をスキップするフラグおよび環境変数については、検証に Claude Code v2.1.242 以降が必要です 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 を使用してください。タスク追跡ツール のいずれかをここで名前を付けた場合、Claude Code もセッションをオプトインします "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt ネストされた subagents を含むすべての subagent のシステムプロンプトの末尾にカスタムテキストを追加します。ただし、フォークされた subagent は会話自体のプロンプトを再利用します。-p を使用した非インタラクティブモードでのみ適用されます。Claude Code v2.1.205 以降が必要です claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file ファイルからテキストを読み込み、subagent システムプロンプトに追加します。コマンドラインで渡すには長すぎるテキストの場合は、--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> このセッションの auto-compact ウィンドウ を設定します。保存された設定を変更しません。/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 最小限モード：hooks、skills、カスタムコマンド、subagents、plugins、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップして、スクリプト化された呼び出しをより高速に開始します。--add-dir で渡すディレクトリ内のスキルは引き続き読み込まれます。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 を実行します。-p/--print と組み合わせることはできません。エラーリファレンス を参照してください claude --bg "investigate the flaky test"
--channels （研究プレビュー）Claude がこのセッションでリッスンすべき channel 通知を持つ MCP サーバー。plugin:<name>@<marketplace> エントリのスペース区切りリスト。Anthropic 認証が claude.ai または Console API キーを通じて必要です claude --channels plugin:my-notifier@my-marketplace
--chrome Web 自動化とテストのための Chrome ブラウザ統合 を有効にします claude --chrome
--cloud タスク説明を使用して、claude.ai に新しい Web セッション を作成します。セッション 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 承認されたアローリストにない channels をローカル開発用に有効にします。plugin:<name>@<marketplace> および server:<name> エントリを受け入れます。確認を求めます claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions すべての権限プロンプトをスキップします。--permission-mode bypassPermissions と同等です。権限モード を参照して、これが何をスキップし、何をスキップしないかを確認してください。--bg で開始されたセッションの場合、モードは スーパーバイザーがセッションを再開するときに永続化 します claude --dangerously-skip-permissions
--debug オプションのカテゴリフィルタリング付きでデバッグモードを有効にします（例：--debug='mcp,startup' または --debug='!1p'）。フィルターは = 形式でのみバインドされます。スペース区切りフィルターはフィルタリングなしでデバッグモードを有効にします claude --debug='mcp,startup'
--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 *) のようなスコープ付きルールはツールを利用可能なままにし、一致する呼び出しのみを拒否します。EndConversation という名前のルールは、他のツールが残っている間はそれを削除できません "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort 現在のセッションの 努力レベル を設定します。オプション：low、medium、high、xhigh、max、または ultracode。利用可能なレベルはモデルによって異なります。ultracode は ultracode をオンにして xhigh 努力でセッションを開始し、Claude Code v2.1.203 以降が必要です。このセッションの modelSettings と effortLevel 設定をオーバーライドし、永続化されません claude --effort high
--enable-auto-mode v2.1.111 で削除されました。Auto mode は現在 Shift+Tab サイクルにデフォルトで含まれています。--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 システムプロンプトからマシンごとのセクション（作業ディレクトリ、環境情報、メモリパス、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
--forward-subagent-text subagent テキストと思考ブロックを出力ストリームに assistant および user メッセージとして parent_tool_use_id セットで発行し、各 subagent のトランスクリプトを再構築できるようにします。このフラグがない場合、Claude Code は subagent tool_use および tool_result ブロックのみを発行します。--print と --output-format stream-json が必要です。Claude Code は ネストされた subagents からのメッセージも転送し、各メッセージを生成した Agent ツール呼び出しの ID に parent_tool_use_id を設定します。これには Claude Code v2.1.219 以降が必要です。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 起動時に、正確に 1 つの有効な IDE が利用可能な場合、自動的に IDE に接続します claude --ide
--init セッション開始前に init マッチャーで Setup hooks を実行します（プリントモードのみ） claude -p --init "query"
--init-only Setup および SessionStart hooks を実行してから、会話を開始せずに終了します 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 プリントモードの入力形式を指定します（オプション：text、stream-json） claude -p --output-format json --input-format stream-json
--json-schema エージェントがワークフローを完了した後、JSON Schema に一致する検証済み JSON 出力を取得します（プリントモードのみ）。構造化出力 を参照してください。Claude Code は無効なスキーマでエラーで終了し、format キーワードをクライアント側の検証なしで注釈として受け入れます claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance セッション開始前に maintenance マッチャーで Setup hooks を実行します（プリントモードのみ） claude -p --maintenance "query"
--max-budget-usd 停止する前に API 呼び出しに費やす最大ドル金額（プリントモードのみ）。subagents からの支出は上限にカウントされます。支出が上限に達すると、別の subagent を生成すると Budget limit reached で失敗し、Claude Code は引き続き実行中のバックグラウンド subagents を停止します。上限強制動作には Claude Code v2.1.217 以降が必要です claude -p --max-budget-usd 5.00 "query"
--max-turns agentic ターンの数を制限します（プリントモードのみ）。制限に達するとエラーで終了します。デフォルトでは制限なし。--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> で名前付きセッションを再開できます。インタラクティブセッションで、このマシン上の別のライブセッションが既に名前を使用している場合、Claude Code は その変種を適用 します。

/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、または manual を default のエイリアスとして受け入れます。manual エイリアスは UI が Manual とラベル付けするモードを選択し、Claude Code v2.1.200 以降が必要です。claude --help は default の代わりにそれをリストし、両方の値が機能します。設定ファイルの defaultMode をオーバーライドします。このフラグまたは --dangerously-skip-permissions がない場合、新しいセッションは セッションが開始する権限モード で説明されている権限モードで開始します。-p の場合、それは何も設定されていない場合は default です claude --permission-mode plan
--permission-prompt-tool 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します。Claude Code は、最初のターンを実行する前に、そのツールの MCP サーバーが接続されるまで待機します。最大 MCP_TIMEOUT スタートアップタイムアウト、デフォルト 30 秒。

プロンプトツールは ユーザーインタラクションが必要 とマークされた MCP ツールを承認できません：Claude Code はそのようなツールの allow 結果を拒否に変換します。この制限には Claude Code v2.1.199 以降が必要です		 claude -p --permission-prompt-tool mcp_auth_tool "query"
--permission-prompts プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの 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 --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"
--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 は、--tools で個別に名前を付けない限り、default プリセットを通じてではなく、コマンドまたはコードを実行する組み込みツール、および WebFetch を削除します。また、組み込みファイルツールを 作業ディレクトリ に限定し、管理設定 と --settings のみを読み込み、bypassPermissions を拒否し、クラウドセッションの作成を拒否 します。Claude Code v2.1.248 以降が必要です claude --restricted -p "query"
--resume、-r ID または名前で特定のセッションを再開するか、セッションを選択するためのインタラクティブピッカーを表示します。ID の代わりに、セッションの .jsonl トランスクリプトファイル への絶対パスを渡すことができます。ピッカーと名前検索には、このディレクトリを /add-dir で追加したセッションが含まれます。セッション ID を渡すと、Claude Code は現在のプロジェクトディレクトリとその git worktrees を検索し、次にこのマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索は現在のプロジェクトディレクトリとその git worktrees のみをカバーしていました。バックグラウンドセッション はピッカーに bg でマークされて表示されます claude --resume auth-refactor
--safe-mode すべてのカスタマイズを無効にして開始し、壊れた設定をトラブルシューティングします：CLAUDE.md、skills、plugins、hooks、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 設定を無視します。managed-mcp.json での排他的制御 を参照してください。管理 MCP ファイルの下でフラグが何をするかについては、Claude Code v2.1.248 以降が必要です 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、または iterm2（v2.1.186 で追加）。このセッションの teammateMode 設定をオーバーライドします。ディスプレイモードを選択 を参照してください claude --teammate-mode auto
--tmux worktree 用に tmux セッションを作成します。--worktree が必要です。利用可能な場合は iTerm2 ネイティブペインを使用します。従来の tmux の場合は --tmux=classic を渡します claude -w feature-auth --tmux
--tools Claude が使用できる組み込みツールを制限します。"" を使用してすべてを無効にし、"default" を使用してすべてを有効にするか、"Bash,Edit,Read" のようなツール名を使用します。タスク追跡ツール のいずれかをここで名前を付けた場合、Claude Code もセッションをオプトインします。フラグは MCP ツールに影響しません。それらも拒否するには、--disallowedTools "mcp__*" を使用してください。EndConversation を省略するリストはそれを削除しません。"" は他の 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、または GitLab マージリクエスト URL を渡して、origin からその PR または MR をフェッチし、worktree をそこからブランチします。GitLab マージリクエストからのブランチには Claude Code v2.1.233 以降が必要です 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 ガイドのシステムプロンプト は、より詳細に同じ決定をカバーしています。

関連項目