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 [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> |
バックグラウンドセッション からの最近の出力を出力します | 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> |
バックグラウンドセッション をリストから削除します。削除が セッションのワークツリーを介して拒否 され、2 番目の claude rm で解決できる場合、拒否は渡すべき正確なフラグと値を出力します:--discard-unpushed <commit>@<worktree-id> はプッシュされていないコミットを持つワークツリーをそれらのコミットとともに破棄し、--force-remove-worktree <worktree-id> は git または WorktreeRemove フックが削除できなかったワークツリーディレクトリを削除します。--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? と出力します。
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> |
このセッションのサーバー側アドバイザーツールを有効にします。モデルエイリアス fable、opus、sonnet、または完全なモデル ID を使用します。advisorModel 設定よりも優先されます。fable にはFable アクセスが必要です |
claude --advisor opus |
--agent |
現在のセッションのエージェントを指定します(agent 設定をオーバーライドします) |
claude --agent my-custom-agent |
--agents |
JSON を使用してカスタムサブエージェントを動的に定義します。CLI で定義されたサブエージェントのリストされたフィールドを受け入れます。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 を使用してください。タスク追跡ツールの 1 つをここで名前を付けた場合、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 を設定します。ベアモードを参照してください |
claude --bare -p "query" |
--betas |
API リクエストに含める Beta ヘッダー(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 |
Chrome ブラウザ統合を有効にして、Web 自動化とテストを行います | 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 またはエージェント SDK で作成されたセッション、および最初のプロンプトが /loop だったセッションをスキップします。claude -p --continue には -p、SDK、/loop セッションが含まれます。このディレクトリを /add-dir で追加したセッションを含みます |
claude --continue |
--dangerously-load-development-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 |
拒否ルール。ベアツール名は一致するツールを Claude のコンテキストから削除します。"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 で削除されました。オートモードはデフォルトで 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 リポジトリフラグ)を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、プロンプトキャッシュの再利用を改善します。デフォルトシステムプロンプトでのみ適用されます。--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 はネストされたサブエージェントからのメッセージも転送し、各サブエージェントを生成したエージェントツール呼び出しの 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 マッチャーでセットアップフックを実行します(プリントモードのみ) |
claude -p --init "query" |
--init-only |
セットアップおよび 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 |
プリントモードの入力形式を指定します(オプション:text、stream-json) |
claude -p --output-format json --input-format stream-json |
--json-schema |
エージェントがワークフローを完了した後、JSON スキーマに一致する検証済み JSON 出力を取得します(プリントモードのみ)。構造化出力を参照してください。Claude Code は無効なスキーマでエラーで終了し、format キーワードをクライアント側検証なしの注釈として受け入れます |
claude -p --json-schema '{"type":"object","properties":{...}}' "query" |
--maintenance |
セッションの前に maintenance マッチャーでセットアップフックを実行します(プリントモードのみ) |
claude -p --maintenance "query" |
--max-budget-usd |
API 呼び出しで支出する最大ドル額。停止する前に支出します(プリントモードのみ)。サブエージェントからの支出はキャップにカウントされます。支出がキャップに達すると、別のサブエージェントを生成すると Budget limit reached で失敗し、Claude Code は引き続き実行中のバックグラウンドサブエージェントを停止します。キャップ実行動作には Claude Code v2.1.217 以降が必要です |
claude -p --max-budget-usd 5.00 "query" |
--max-turns |
エージェンティックターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限がありません。--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 は 1 つに対する allow 結果を拒否に変換します。この制限には Claude Code v2.1.199 以降が必要です |
claude -p --permission-prompt-tool mcp_auth_tool "query" |
--permission-prompts |
プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの host を使用すると、Claude Code はそれらをエージェント 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 アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します |
claude --plugin-url https://example.com/plugin.zip |
--print, -p |
対話モードなしで応答を出力します(プログラム的な使用の詳細についてはエージェント 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 の代わりに名前付きリファレンスに基づかせます |
claude -p "Run the smoke test" --environment ccpool_abc123 --ref main |
--remote |
--cloud の非推奨エイリアス。既存セッション形式を含みます |
claude --remote "Fix the login bug" |
--remote-control, --rc |
リモートコントロールを有効にして対話型セッションを開始して、claude.ai または Claude アプリからも制御できるようにします。オプションでセッションの名前を渡します | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> |
明示的な名前が設定されていない場合、自動生成されたリモートコントロールセッション名のプレフィックス。デフォルトはマシンのホスト名で、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 ワークツリーを検索してから、このマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索は現在のプロジェクトディレクトリとその git ワークツリーのみをカバーしていました。バックグラウンドセッションはピッカーに bg でマークされて表示されます |
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 ファイルの下で何を行うかについては、管理 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(v2.1.186 で追加)。このセッションの teammateMode 設定をオーバーライドします。表示モードを選択を参照してください |
claude --teammate-mode auto |
--tmux |
ワークツリーの tmux セッションを作成します。--worktree が必要です。利用可能な場合は iTerm2 ネイティブペインを使用します。従来の tmux の場合は --tmux=classic を渡します |
claude -w feature-auth --tmux |
--tools |
Claude が使用できるビルトインツールを制限します。"" を使用してすべてを無効にするか、"default" をデフォルトセットに使用するか、"Bash,Edit,Read" などのツール名を使用します。macOS、Linux、WSL では、デフォルトセットは Glob ツール動作で説明されているように Glob と Grep を除外します。タスク追跡ツールの 1 つをここで名前を付けた場合、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 ワークツリーで開始します。名前を指定しない場合、Claude Code は 1 つを生成します。#<number>、GitHub プルリクエスト URL、または GitLab マージリクエスト URL を渡して、origin からそのプルリクエストまたはマージリクエストをフェッチし、ワークツリーをそれから分岐させます。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 は相互に排他的です。追加フラグは置換フラグのいずれかと組み合わせることができます。
Claude Code のデフォルト ID がタスクに適合するかどうかに基づいて選択します。Claude がコーディングアシスタントのままで、追加のルールも従うべき場合は、追加フラグを使用します。呼び出しごとの指示、出力形式、または -p スクリプトのドメインコンテキスト。追加するとデフォルトのツールガイダンス、安全指示、コーディング規約が保持されるため、異なる部分のみを提供します。Claude Code のサーフェス、ID、または権限モデルが異なる場合は、置換フラグを使用します。人間が見ていないパイプラインの非コーディングエージェントなど。置換するとデフォルトプロンプト全体が削除されます。ツールガイダンスと安全指示を含むため、タスクがまだ必要とするものについて責任を負います。
プロジェクト間で切り替えて共有できる永続的なペルソナについては、出力スタイルを使用します。Claude が常に従うべきプロジェクト規約については、CLAUDE.mdを使用します。エージェント SDK ガイド(システムプロンプト)は同じ決定をより詳しく説明しています。
再開された会話でのシステムプロンプトフラグ
デフォルトでは、Claude Code はシステムプロンプトを 1 回構築します。会話の最初のリクエストで、適用されたシステムプロンプトフラグからのテキストを使用して、セッションに記録します。会話がコンパクトされるまで、その後のすべてのリクエストは、--resume または --continue で会話に戻った後を含めて、その記録されたプロンプトを使用します。その後の起動で異なるシステムプロンプトフラグテキストを渡すか、何も渡さない場合、会話がコンパクトされるか、新しい会話を開始するときに有効になります。
クラウドセッションの外で、--bare を渡すか CLAUDE_CODE_SIMPLE=1 を設定して Claude Code をベアモードで開始する場合、--system-prompt-snapshot on を渡さない限り、記録はオフのままです。v2.1.268 より前は、フィーチャーフラグをフェッチしないセッション(Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry のセッションを含む)は、すべてのリクエストでプロンプトを再構築し、--system-prompt-snapshot は効果がありませんでした。
代わりに、例えば --continue 実行全体でその文言を反復処理する場合など、すべてのリクエストでプロンプトを再構築するには、--system-prompt-snapshot off を渡します。v2.1.265 より前は、システムプロンプトフラグのいずれかを渡すと、--system-prompt-snapshot on を渡さない限り、記録もオフになりました。
関連項目
- Chrome 拡張機能 - ブラウザ自動化と Web テスト
- インタラクティブモード - ショートカット、入力モード、インタラクティブ機能
- クイックスタートガイド - Claude Code の開始方法
- 一般的なワークフロー - 高度なワークフローとパターン
- 設定 - 設定オプション
- Agent SDK ドキュメント - プログラムによる使用と統合