--add-dir | Claude が読み書きする作業ディレクトリを追加する。ファイルアクセスを与えるが、これらのディレクトリからは .claude/ の設定の多くは検出されない。各パスがディレクトリとして存在するか検証する。永続化するには settings の permissions.additionalDirectories |
--advisor <model> | このセッションで server-side の advisor tool を有効にする。opus / sonnet のエイリアスまたは完全なモデル ID。セッションでは advisorModel 設定より優先される。claude --advisor fable はエラー終了する |
--agent | 現在のセッションの agent を指定する(agent 設定を上書き) |
--agents | JSON でカスタム subagent を動的に定義する。フィールド名は subagent の frontmatter と同じで、加えて指示用の prompt フィールドを持つ |
--allow-dangerously-skip-permissions | bypassPermissions を Shift+Tab のモード循環に追加する(そのモードでは開始しない) |
--allowedTools, --allowed-tools | 許可を求めずに実行するツール。パターンは permission rule syntax に従う。利用可能なツール自体を制限するには --tools |
--append-subagent-system-prompt | ネストしたものを含むすべての subagent のシステムプロンプト末尾にテキストを追加する。-p の非対話モードのみ。v2.1.205 以降 |
--append-system-prompt | 既定のシステムプロンプト末尾にテキストを追加する |
--append-system-prompt-file | ファイルから読んだテキストを既定のプロンプトに追加する |
--autocompact <auto|tokens> | 保存済み設定を変えずにこのセッションの auto-compact window を設定する。/autocompact と同じ値を受け付ける。v2.1.221 以降 |
--ax-screen-reader | スクリーンリーダー向けの出力(装飾枠やアニメーションのないフラットテキスト)。classic renderer を強制するため tui 設定は効かない。CLAUDE_AX_SCREEN_READER と axScreenReader 設定より優先される。v2.1.181 以降 |
--bare | hooks / skills / plugins / MCP サーバー / auto memory / CLAUDE.md の自動探索を飛ばす最小モード。Bash・ファイル読み取り・ファイル編集のツールが使える。CLAUDE_CODE_SIMPLE を設定する |
--betas | API リクエストに含める beta ヘッダー(API キーユーザーのみ) |
--bg, --background | バックグラウンド agent としてセッションを開始し即座に戻る。セッション ID と管理コマンドを出力する。--exec と組み合わせると Claude セッションではなくシェルコマンドをバックグラウンドジョブとして実行する。-p / --print とは併用できない |
--channels | (research preview)このセッションで channel 通知を受け取る MCP サーバー。plugin:<name>@<marketplace> のスペース区切り一覧。claude.ai または Console API キーでの Anthropic 認証が必要 |
--chrome | Chrome ブラウザ統合を有効にする |
--cloud | タスク説明を渡すと claude.ai に新しい web session を作る。セッション ID(session_... / cse_...)や claude.ai/code の URL を渡すと既存セッションを対象にする(-p でメッセージをキューイング、-p なしでターミナルをアタッチ) |
--continue, -c | 現在のディレクトリの直近の会話を読み込む。/add-dir でこのディレクトリを追加したセッションも含む |
--dangerously-load-development-channels | 承認 allowlist に無い channel をローカル開発向けに有効にする。plugin:<name>@<marketplace> と server:<name> を受け付ける。確認を求める |
--dangerously-skip-permissions | permission prompt を飛ばす。--permission-mode bypassPermissions と同等。--bg で開始したセッションでは supervisor が再起動してもモードが持続する |
--debug | カテゴリフィルタ付きのデバッグモード(--debug='mcp,startup'、--debug='!1p' など)。フィルタは = の形でのみ結び付く。スペース区切りではフィルタなしでデバッグモードになる |
--debug-file <path> | 指定パスにデバッグログを書く。暗黙にデバッグモードを有効にする。CLAUDE_CODE_DEBUG_LOGS_DIR より優先される |
--disable-slash-commands | このセッションのすべての skill とコマンドを無効にする |
--disallowedTools, --disallowed-tools | deny ルール。素のツール名は該当ツールを Claude のコンテキストから取り除く("Edit" は Edit、"*" は全ツール、"mcp__*" は全 MCP ツール)。Bash(rm *) のようなスコープ付きルールはツールを残し、一致する呼び出しだけを拒否する。EndConversation を指すルールは、他のツールが残っている限りそれを取り除けない |
--effort | このセッションの effort level を設定する。low / medium / high / xhigh / max / ultracode。利用可能な水準はモデルに依存する。ultracode は xhigh で開始し ultracode を有効にする(v2.1.203 以降)。effortLevel 設定を上書きし、永続化しない |
--enable-auto-mode | v2.1.111 で削除。auto mode は既定で Shift+Tab の循環に含まれる。--permission-mode auto を使う |
--environment <environment-id> | -p と併用して指定環境に新しい cloud session を作り、応答を待たず終了する。self-hosted 環境の ID は ccpool_... 形式。--cloud とは併用できない |
--exclude-dynamic-system-prompt-sections | システムプロンプトからマシン固有の節(作業ディレクトリ、環境情報、memory パス、git リポジトリフラグ)を最初のユーザーメッセージへ移す。既定のシステムプロンプトのときのみ適用され、--system-prompt / --system-prompt-file 指定時は無視される |
--exec | Claude セッションではなく PTY 対応のバックグラウンドジョブとしてシェルコマンドを実行する。シェルから起動するには --bg と併用する |
--fallback-model | 主モデルが過負荷または利用不可のとき指定モデルへ自動フォールバックする。カンマ区切りの一覧を順に試す。永続化には fallbackModel 設定(このフラグが上書きする) |
--fork-session | resume 時に元の ID を再利用せず新しいセッション ID を作る(--resume / --continue と併用) |
--forward-subagent-text | subagent のテキストと thinking ブロックを parent_tool_use_id 付きの assistant / user メッセージとして出力ストリームに流す。--print と --output-format stream-json が必要。CLAUDE_CODE_FORWARD_SUBAGENT_TEXT でも同じ。v2.1.211 以降 |
--from-pr | 特定の pull request に紐づくセッションで絞り込んだセッションピッカーを開く。PR 番号、GitHub / GitHub Enterprise の PR URL、GitLab の merge request URL、Bitbucket の pull request URL を受け付ける |
--ide | 有効な IDE がちょうど 1 つあるとき起動時に自動接続する |
--init | セッション前に init matcher の Setup hook を実行する(print モードのみ) |
--init-only | Setup と SessionStart hook を実行して会話を開始せず終了する |
--include-hook-events | すべての hook イベントのライフサイクルイベントを出力ストリームに含める。SessionStart と Setup は常に含まれるためこのフラグは不要。--output-format stream-json が必要 |
--include-partial-messages | 部分的なストリーミングイベントを出力に含める。--print と --output-format stream-json が必要 |
--input-format | print モードの入力形式(text / stream-json) |
--json-schema | エージェント完了後に JSON Schema に一致する検証済み JSON を得る(print モードのみ)。不正なスキーマはエラー終了。format キーワードは注釈として受け付けクライアント側検証はしない |
--maintenance | セッション前に maintenance matcher の Setup hook を実行する(print モードのみ) |
--max-budget-usd | API 呼び出しの上限金額(print モードのみ)。subagent の支出も算入される。上限に達すると新たな subagent の起動が Budget limit reached で失敗し、実行中のバックグラウンド subagent を停止する。上限の強制は v2.1.217 以降 |
--max-turns | agentic turn 数の上限(print モードのみ)。上限到達でエラー終了する。既定は無制限。--input-format stream-json では、作業中に送られたメッセージはキューに残り、上限で現在のターンが終わった後に自身の上限を持つ独立したターンとして実行される |
--mcp-config | JSON ファイルまたは文字列から MCP サーバーを読み込む(スペース区切り)。-p と併用すると最初のターン前に保留中のサーバー接続を MCP_TIMEOUT(既定 30 秒)まで待つ |
--model | セッションのモデルを設定する。最新モデルのエイリアス(sonnet / opus / haiku / fable)または完全名。model 設定と ANTHROPIC_MODEL を上書きする |
--name, -n | セッションの表示名を設定する。/resume と端末タイトルに表示され、claude --resume <name> で resume できる |
--no-chrome | このセッションの Chrome ブラウザ統合を無効にする |
--no-session-persistence | セッションをディスクに保存せず resume 不可にする。print モードのみ。CLAUDE_CODE_SKIP_PROMPT_HISTORY は任意のモードで同じ効果 |
--output-format | print モードの出力形式(text / json / stream-json) |
--permission-mode | 指定した permission mode で開始する。default / acceptEdits / plan / auto / dontAsk / bypassPermissions、および default のエイリアスとしての manual。manual は v2.1.200 以降が必要。settings の defaultMode を上書きする |
--permission-prompt-tool | 非対話モードで permission prompt を処理する MCP ツールを指定する。そのツールの MCP サーバー接続を MCP_TIMEOUT(既定 30 秒)まで待つ。user interaction が必要とマークされた MCP ツールは承認できず、allow 結果は deny に変換される(v2.1.199 以降) |
--plugin-dir | ディレクトリまたは .zip から plugin をこのセッション限りで読み込む。1 フラグにつき 1 パス。複数はフラグを繰り返す |
--plugin-url | URL から plugin の .zip を取得しこのセッション限りで読み込む。フラグの繰り返し、または引用したスペース区切り URL |
--print, -p | 対話モードなしで応答を出力する |
--prompt-suggestions | 各ターン後に次のユーザープロンプト予測を prompt_suggestion メッセージとして出力する。--print と --output-format stream-json と --verbose が必要 |
--ref <branch> | --environment と併用し、新しいセッションの checkout をローカル HEAD ではなく指定 ref に基づかせる |
--remote | --cloud の非推奨エイリアス(既存セッション形式を含む) |
--remote-control, --rc | Remote Control を有効にした対話セッションを開始する。セッション名を渡せる |
--remote-control-session-name-prefix <prefix> | 自動生成される Remote Control セッション名の接頭辞。既定はマシンのホスト名。CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX でも同じ |
--replay-user-messages | stdin のユーザーメッセージを確認応答として stdout に再出力する。--input-format stream-json と --output-format stream-json が必要 |
--resume, -r | ID または名前でセッションを resume する、または対話ピッカーを表示する。セッション ID を渡すと現在のプロジェクトディレクトリとその git worktree を探し、次にこのマシンの他のすべてのプロジェクトを探す(v2.1.223 より前は前者のみ)。バックグラウンドセッションはピッカーに bg 付きで表示される |
--safe-mode | すべてのカスタマイズを無効にして起動する(CLAUDE.md、skills、plugins、hooks、MCP サーバー、カスタムコマンド・agent、output styles、workflows、カスタムテーマ、カスタム keybindings、status line とファイル候補コマンド、LSP サーバー、auto memory を読み込まない)。認証・モデル選択・組み込みツール・permission は通常どおり動作する点が --bare と異なる。managed settings のポリシーは適用され続ける。CLAUDE_CODE_SAFE_MODE を設定する |
--session-id | 会話に特定のセッション ID を使う(有効な UUID) |
--setting-sources | 読み込む設定ソースのカンマ区切り一覧(user / project / local) |
--settings | settings JSON ファイルのパス、またはインライン JSON 文字列。ここで設定した値はこのセッションで settings.json の同じキーを上書きする。省略したキーはファイルの値を保つ。ファイルは 2 MiB 以下の通常ファイルであること |
--strict-mcp-config | --mcp-config の MCP サーバーのみを使い、他の MCP 設定を無視する |
--system-prompt | システムプロンプト全体をカスタムテキストで置き換える |
--system-prompt-file | ファイルからシステムプロンプトを読み込み既定のプロンプトを置き換える |
--teleport | web session をローカルターミナルで resume する |
--teammate-mode | agent team の teammate の表示方法(in-process(既定) / auto / tmux / iterm2)。iterm2 は v2.1.186 で追加。既定は v2.1.179 で auto から変更された。teammateMode 設定を上書きする |
--tmux | worktree 用の tmux セッションを作る。--worktree が必要。iTerm2 が使えるならネイティブペインを使う。--tmux=classic で従来の tmux |
--tools | Claude が使える組み込みツールを制限する。"" で全無効、"default" で全て、"Bash,Edit,Read" のようにツール名を指定。MCP ツールには影響しない(--disallowedTools "mcp__*" か、--mcp-config 無しの --strict-mcp-config を使う)。EndConversation を含めない一覧でもそれは除去されない。"" は MCP ツールが残っていない場合にのみ除去する |
--verbose | 詳細ログを有効にし、ターンごとの全出力を表示する。このセッションで viewMode 設定を上書きする |
--version, -v | バージョン番号を出力する |
--worktree, -w | <repo>/.claude/worktrees/<name> の分離 git worktree で Claude を開始する。名前省略時は自動生成。#<number> または GitHub の pull request URL を渡すと origin からその PR を取得して worktree を分岐する |