factsClaude Codecli-reference

stable4 日前 · 2026-08-09

CLI reference

概要

claude コマンドのサブコマンドとフラグの一覧。claude --help は全フラグを列挙しないため、--help に出ないことは利用不可を意味しない。

仕様

CLI コマンド

コマンド説明
claude対話セッションを開始する
claude "query"初期プロンプト付きで対話セッションを開始する
claude -p "query"SDK 経由でクエリし終了する
cat file | claude -p "query"パイプされた内容を処理する
claude -c現在のディレクトリの直近の会話を継続する
claude -c -p "query"SDK 経由で継続する
claude -r "<session>" "query"ID または名前でセッションを resume する
claude update最新版へ更新する
claude gatewayself-hosted の Claude apps gateway サーバーを起動する。Amazon Bedrock / Google Cloud's Agent Platform / Microsoft Foundry 上の Claude Code の前段に SSO とポリシーを置く管理者向け。gateway.yaml を指す --config が必要。v2.1.195 以降
claude install [version]native binary をインストール/再インストールする。2.1.118 のようなバージョン、stablelatest を受け付ける
claude auth loginサインインする。--email でメールアドレスを事前入力、--sso で SSO 認証を強制、--console で Claude サブスクリプションではなく Anthropic Console(API 課金)でサインイン
claude auth logoutログアウトする
claude auth status認証状態を JSON で表示する。--text で人間可読。ログイン済みなら 0、未ログインなら 1 で終了する
claude agentsagent view を開き、並行するバックグラウンドセッションを監視・投入する。--cwd <path> でそのディレクトリ配下のセッションのみ表示、--json で有効なセッションを JSON 配列として出力(--json --all は完了済みも含む)。--permission-mode / --model / --effort / --agent で投入セッションの既定を設定する。--settings / --add-dir / --plugin-dir / --mcp-config も受け付ける。agent view を開くには対話ターミナルが必要
claude attach <id>このターミナルでバックグラウンドセッションにアタッチする
claude auto-mode defaults組み込みの auto mode 分類ルールを JSON で出力する。--label <prefix> でラベルの前方一致(大小文字無視)に絞る。v2.1.208 以降
claude auto-mode resetuser settings から autoMode セクションを削除して既定に戻す。書き込み前に確認する(-y / --yes で省略)。managed settings や --settings のルールは残る。v2.1.212 以降
claude daemon statusバックグラウンドセッションの supervisor の状態・バージョン・socket ディレクトリ・worker 数を出力する。supervisor 未起動なら 1 で終了する
claude daemon stop --anysupervisor とそのセッションを停止する。--keep-workers でバックグラウンドセッションを残す。--any は on-demand supervisor の停止を確認する(既定)
claude doctorセッションを開始せずに読み取り専用のインストール・設定診断を出力する(インストール健全性、設定ファイルの検証エラー、Remote Control の適格性)
claude import [codex|gemini]/import を実行する対話セッションを開始する。--dry-run--yes を受け付ける。v2.1.213 以降
claude logs <id>バックグラウンドセッションの直近の出力を表示する
claude mcpMCP サーバーを設定する
claude mcp login <name>対話 /mcp パネルを開かずに MCP サーバーの OAuth フローを実行する。HTTP / SSE / claude.ai connector サーバーに対応。SSH 越しでは --no-browser で認可 URL を出力しリダイレクト URL を貼り戻す。v2.1.186 以降
claude mcp logout <name>MCP サーバーの保存済み OAuth 認証情報を消す。v2.1.186 以降
claude pluginplugin を管理する。エイリアス claude plugins
claude project purge [path]プロジェクトのローカル状態(トランスクリプト、タスクリスト、デバッグログ、ファイル編集履歴、プロンプト履歴、~/.claude.json のエントリ)を削除する。[path] 省略で対話一覧から選択。--dry-run / -y--yes / -i--interactive / --all
claude remote-controlRemote Control サーバーを起動する(サーバーモード、ローカル対話セッションなし)
claude respawn <id>実行中/停止中のバックグラウンドセッションを会話を保ったまま再起動する。--all で全実行中セッション
claude rm <id>バックグラウンドセッションを一覧から削除する。トランスクリプトはローカルに残り claude --resume で参照できる
claude setup-tokenCI とスクリプト向けの長寿命 OAuth トークンを生成する。保存せず端末に出力する。Claude サブスクリプションが必要
claude stop <id>バックグラウンドセッションを停止する。claude kill も可
claude ultrareview [target]ultrareview を非対話で実行する。所見を stdout に出力し、成功で 0、失敗で 1。--json で生ペイロード、--timeout <minutes> で既定 30 分を上書き
  • サブコマンドを打ち間違えると、最も近い候補を提案してセッションを開始せず終了する(例: claude udpateDid you mean claude update?
  • v2.1.199 以降、claude --dangerously-skip-permissions daemon <subcommand>daemon サブコマンドを実行する。それ以前は daemon <subcommand> を新規対話セッションのプロンプトとして扱っていた。この経路になるのは先頭が --dangerously-skip-permissions または --allow-dangerously-skip-permissions の場合のみで、他のフラグが先頭なら対話セッションが始まる

CLI フラグ

フラグ説明
--add-dirClaude が読み書きする作業ディレクトリを追加する。ファイルアクセスを与えるが、これらのディレクトリからは .claude/ の設定の多くは検出されない。各パスがディレクトリとして存在するか検証する。永続化するには settings の permissions.additionalDirectories
--advisor <model>このセッションで server-side の advisor tool を有効にする。opus / sonnet のエイリアスまたは完全なモデル ID。セッションでは advisorModel 設定より優先される。claude --advisor fable はエラー終了する
--agent現在のセッションの agent を指定する(agent 設定を上書き)
--agentsJSON でカスタム subagent を動的に定義する。フィールド名は subagent の frontmatter と同じで、加えて指示用の prompt フィールドを持つ
--allow-dangerously-skip-permissionsbypassPermissionsShift+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_READERaxScreenReader 設定より優先される。v2.1.181 以降
--barehooks / skills / plugins / MCP サーバー / auto memory / CLAUDE.md の自動探索を飛ばす最小モード。Bash・ファイル読み取り・ファイル編集のツールが使える。CLAUDE_CODE_SIMPLE を設定する
--betasAPI リクエストに含める beta ヘッダー(API キーユーザーのみ)
--bg, --backgroundバックグラウンド agent としてセッションを開始し即座に戻る。セッション ID と管理コマンドを出力する。--exec と組み合わせると Claude セッションではなくシェルコマンドをバックグラウンドジョブとして実行する。-p / --print とは併用できない
--channels(research preview)このセッションで channel 通知を受け取る MCP サーバー。plugin:<name>@<marketplace> のスペース区切り一覧。claude.ai または Console API キーでの Anthropic 認証が必要
--chromeChrome ブラウザ統合を有効にする
--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-permissionspermission 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-toolsdeny ルール。素のツール名は該当ツールを Claude のコンテキストから取り除く("Edit" は Edit、"*" は全ツール、"mcp__*" は全 MCP ツール)。Bash(rm *) のようなスコープ付きルールはツールを残し、一致する呼び出しだけを拒否する。EndConversation を指すルールは、他のツールが残っている限りそれを取り除けない
--effortこのセッションの effort level を設定する。low / medium / high / xhigh / max / ultracode。利用可能な水準はモデルに依存する。ultracodexhigh で開始し ultracode を有効にする(v2.1.203 以降)。effortLevel 設定を上書きし、永続化しない
--enable-auto-modev2.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 指定時は無視される
--execClaude セッションではなく PTY 対応のバックグラウンドジョブとしてシェルコマンドを実行する。シェルから起動するには --bg と併用する
--fallback-model主モデルが過負荷または利用不可のとき指定モデルへ自動フォールバックする。カンマ区切りの一覧を順に試す。永続化には fallbackModel 設定(このフラグが上書きする)
--fork-sessionresume 時に元の ID を再利用せず新しいセッション ID を作る(--resume / --continue と併用)
--forward-subagent-textsubagent のテキストと 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-onlySetup と SessionStart hook を実行して会話を開始せず終了する
--include-hook-eventsすべての hook イベントのライフサイクルイベントを出力ストリームに含める。SessionStartSetup は常に含まれるためこのフラグは不要。--output-format stream-json が必要
--include-partial-messages部分的なストリーミングイベントを出力に含める。--print--output-format stream-json が必要
--input-formatprint モードの入力形式(text / stream-json
--json-schemaエージェント完了後に JSON Schema に一致する検証済み JSON を得る(print モードのみ)。不正なスキーマはエラー終了。format キーワードは注釈として受け付けクライアント側検証はしない
--maintenanceセッション前に maintenance matcher の Setup hook を実行する(print モードのみ)
--max-budget-usdAPI 呼び出しの上限金額(print モードのみ)。subagent の支出も算入される。上限に達すると新たな subagent の起動が Budget limit reached で失敗し、実行中のバックグラウンド subagent を停止する。上限の強制は v2.1.217 以降
--max-turnsagentic turn 数の上限(print モードのみ)。上限到達でエラー終了する。既定は無制限。--input-format stream-json では、作業中に送られたメッセージはキューに残り、上限で現在のターンが終わった後に自身の上限を持つ独立したターンとして実行される
--mcp-configJSON ファイルまたは文字列から 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-formatprint モードの出力形式(text / json / stream-json
--permission-mode指定した permission mode で開始する。default / acceptEdits / plan / auto / dontAsk / bypassPermissions、および default のエイリアスとしての manualmanual は 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-urlURL から 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, --rcRemote Control を有効にした対話セッションを開始する。セッション名を渡せる
--remote-control-session-name-prefix <prefix>自動生成される Remote Control セッション名の接頭辞。既定はマシンのホスト名。CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX でも同じ
--replay-user-messagesstdin のユーザーメッセージを確認応答として stdout に再出力する。--input-format stream-json--output-format stream-json が必要
--resume, -rID または名前でセッションを 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
--settingssettings JSON ファイルのパス、またはインライン JSON 文字列。ここで設定した値はこのセッションで settings.json の同じキーを上書きする。省略したキーはファイルの値を保つ。ファイルは 2 MiB 以下の通常ファイルであること
--strict-mcp-config--mcp-config の MCP サーバーのみを使い、他の MCP 設定を無視する
--system-promptシステムプロンプト全体をカスタムテキストで置き換える
--system-prompt-fileファイルからシステムプロンプトを読み込み既定のプロンプトを置き換える
--teleportweb session をローカルターミナルで resume する
--teammate-modeagent team の teammate の表示方法(in-process(既定) / auto / tmux / iterm2)。iterm2 は v2.1.186 で追加。既定は v2.1.179 で auto から変更された。teammateMode 設定を上書きする
--tmuxworktree 用の tmux セッションを作る。--worktree が必要。iTerm2 が使えるならネイティブペインを使う。--tmux=classic で従来の tmux
--toolsClaude が使える組み込みツールを制限する。"" で全無効、"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 を分岐する

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

対話・非対話の両方で使える。

フラグ挙動
--system-prompt既定のプロンプト全体を置き換える
--system-prompt-fileファイル内容で置き換える
--append-system-prompt既定のプロンプトに追加する
--append-system-prompt-fileファイル内容を既定のプロンプトに追加する
  • --system-prompt--system-prompt-file は排他。append 系はどちらの置き換えフラグとも併用できる
  • 置き換えは tool guidance と safety instructions を含む既定プロンプト全体を落とす
  • これらのフラグはその起動限り

設定

claude --add-dir ../apps ../lib
claude --model claude-sonnet-5
claude --permission-mode plan
claude -p --output-format stream-json --verbose --include-partial-messages "query"
claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
claude -w feature-auth --tmux
claude --settings ./settings.json

関連

  • facts/claude-code/interactive-mode.md
  • facts/claude-code/settings.md
  • facts/claude-code/permission-modes.md
  • facts/claude-code/model-config.md
  • facts/claude-code/headless.md
  • facts/claude-code/worktrees.md
  • facts/claude-code/plugins.md
  • facts/claude-code/mcp.md
  • facts/claude-code/sub-agents.md
  • facts/claude-code/output-styles.md
  • facts/claude-code/memory.md