Claude CLI オプション完全ガイド — コマンド一覧と実践的な使い方
Claude Code（claude コマンド）には多数のオプションが用意されています。本記事では、まず全体像を俯瞰できる一覧を示し、続いて各カテゴリの詳しい使い方を解説します。
全体像
まずカテゴリ別に代表的なコマンドをざっと確認しましょう。
サブコマンド（claude <command> 形式）
| コマンド | 一言説明 |
|---|---|
claude auth |
Anthropicアカウントの認証管理（ログイン・ログアウト） |
claude agents |
設定済みエージェントの一覧表示 |
claude mcp |
MCPサーバーの追加・削除・一覧管理 |
claude plugin |
プラグイン（スキル）のインストール・管理 |
claude remote-control |
claude.ai / Claude アプリからリモート操作するサーバーを起動 |
claude setup-token |
長期認証トークンのセットアップ（Proサブスク必須） |
claude doctor |
自動アップデーターの健全性チェック |
claude install [target] |
ネイティブビルドをバージョン指定でインストール |
claude update |
最新バージョンを確認してアップデート |
オプション（claude --option 形式）
| カテゴリ | 代表オプション | 一言説明 |
|---|---|---|
| セッション管理 |
-c / -r / -n
|
会話の継続・再開・命名 |
| 出力・実行モード |
-p / --effort / --output-format / --max-turns
|
非インタラクティブ実行・思考レベル・出力形式 |
| ツール・権限制御 |
--allowedTools / --permission-mode
|
使えるツールの制限と権限の細かな制御 |
| モデル指定 |
--model / --fallback-model
|
使用モデルの切り替え |
| プロンプト制御 |
--system-prompt / --agent / --teammate-mode
|
カスタム指示・エージェント設定 |
| Web・リモート連携 |
--remote / --remote-control / --teleport
|
claude.aiとの連携・Webセッション管理 |
| Git Worktree |
-w / --tmux
|
隔離された作業環境の作成 |
| MCP・設定 |
--mcp-config / --settings
|
MCPサーバーや追加設定の読み込み |
| デバッグ |
-d / --debug-file
|
トラブルシューティング用ログ |
| その他 |
--init / --version
|
初期化・バージョン確認など |
各カテゴリの詳細
サブコマンド
claude <コマンド> 形式で実行するサブコマンドです。オプションとは異なり、セッションを起動せずに管理系の操作を行います。
claude auth — 認証管理
Anthropic アカウントの認証を管理します。初回セットアップや認証が切れたときに使います。
| サブコマンド | 説明 |
|---|---|
claude auth login |
Anthropicアカウントにログイン（ブラウザが開く）。--email でメールを事前入力、--sso でSSO強制 |
claude auth logout |
ログアウトしてセッションを削除 |
claude auth status |
現在の認証状態を確認。--text で人間向け形式、未ログインの場合は終了コード1 |
# 初回ログイン
claude auth login
# SSO でログイン（メールを事前入力）
claude auth login --email user@example.com --sso
# 認証状態の確認（人間向け形式）
claude auth status --text
# ログアウト
claude auth logout
claude agents — エージェント一覧
設定済みのエージェントを一覧表示します。
claude agents
claude agents --setting-sources user # 読み込む設定ソースを指定
--agent オプションで指定できるエージェント名を確認したいときに使います。
claude mcp — MCPサーバー管理
MCP（Model Context Protocol）サーバーの追加・削除・一覧表示を行います。Figma・Slack・データベース等の外部サービスとの連携設定をここで管理します。設定は ~/.claude/settings.json に保存されます。
| サブコマンド | 説明 |
|---|---|
claude mcp add |
MCPサーバーを対話形式で追加 |
claude mcp add-from-claude-desktop |
Claude Desktop の設定からインポート |
claude mcp add-json |
JSON形式でMCPサーバーを追加 |
claude mcp get <name> |
指定したMCPサーバーの設定を表示 |
claude mcp list |
設定済みMCPサーバーの一覧を表示 |
claude mcp remove <name> |
MCPサーバーを削除 |
claude mcp reset-project-choices |
プロジェクトの使用許可設定をリセット |
claude mcp serve |
MCPサーバーとして起動（他ツールからの接続受け入れ） |
# サーバーを追加（対話形式）
claude mcp add
# JSON形式でサーバーを追加
claude mcp add-json '{"name": "my-server", "command": "node", "args": ["/path/to/server.js"]}'
# 設定済みサーバーの一覧を確認
claude mcp list
# 特定サーバーの設定を確認
claude mcp get my-server
# サーバーを削除
claude mcp remove my-server
# Claude Desktop の設定を移行
claude mcp add-from-claude-desktop
claude plugin / claude plugins — プラグイン管理
Claude Code のプラグイン（スキル）をインストール・管理します。スキルとは /commit や /pr-respond 等のスラッシュコマンドを定義するパッケージです。
| サブコマンド | 説明 |
|---|---|
claude plugin install (i) |
プラグインをインストール |
claude plugin uninstall (remove) |
プラグインをアンインストール |
claude plugin list |
インストール済みプラグインの一覧表示 |
claude plugin enable |
無効化したプラグインを有効化 |
claude plugin disable |
プラグインを無効化（削除せず残す） |
claude plugin update |
インストール済みプラグインを最新版に更新 |
claude plugin marketplace |
公式マーケットプレイスを表示 |
claude plugin validate |
プラグインの定義ファイルを検証 |
# プラグインをインストール
claude plugin install @anthropic/pr-tools
# インストール済みプラグインを確認
claude plugin list
# プラグインを一時的に無効化
claude plugin disable my-plugin
# 再度有効化
claude plugin enable my-plugin
# アップデート
claude plugin update
# マーケットプレイスを確認
claude plugin marketplace
claude remote-control — リモートコントロールサーバー起動
claude.ai または Claude アプリから Claude Code をリモート操作できるサーバーとして起動します。ローカルのインタラクティブセッションなしにサーバーモードで動作します。
claude remote-control --name "My Project"
インタラクティブセッションを起動しつつリモート操作も受け付けたい場合は、オプションの --remote-control / --rc フラグを使います。
claude setup-token — 長期認証トークン設定
ブラウザ認証を使わず、長期間有効なトークンでログインし続けるためのセットアップです。
claude setup-token
必要条件: Claude のサブスクリプション（Pro以上）。CI環境やサーバー環境で長期運用する際に便利です。
claude doctor — 自動アップデーター診断
自動アップデーターが正常に動作しているかチェックします。
claude doctor
claude update が失敗する場合や、バージョン管理に問題が起きたときに使います。
claude install [target] — ネイティブビルドのインストール
特定バージョンのネイティブビルドをインストールします。
claude install # デフォルト（stable）
claude install stable # 安定版
claude install latest # 最新版
claude install 1.2.3 # バージョン指定
claude install --force # 強制再インストール
通常の claude update と異なり、バージョンを明示的に指定してインストールしたい場合に使います。
claude update / claude upgrade — アップデート
最新バージョンを確認してインストールします。
claude update
定期的に実行して最新機能・バグ修正を取り込みましょう。
オプション
claude --option 形式で指定するオプションです。セッションの挙動・出力形式・権限・モデルなどを細かく制御できます。
1. セッション管理
Claude Code はセッション（会話履歴）を保存します。中断した作業の再開や、特定の文脈を引き継いだ作業に役立ちます。
| オプション | 説明 |
|---|---|
-c, --continue |
直近の会話をそのまま継続する |
-r, --resume [ID] |
セッションIDを指定して再開。IDなしで一覧ピッカーを表示 |
-n, --name <name> |
セッションに名前をつける（-r の一覧に表示される） |
--fork-session |
-c / -r 時に、元セッションから分岐した新セッションを作成 |
--from-pr [PR番号/URL] |
PRに紐づいたセッションを再開する |
--no-session-persistence |
セッションを保存しない（-p 使用時のみ有効） |
--session-id <uuid> |
特定のセッションIDを明示的に指定して起動 |
# 直近の会話を継続
claude -c
# 名前でセッションを保存 → 後で再開
claude -n "BIZ-37対応"
claude -r "BIZ-37対応"
# PRに紐づいたセッションを再開
claude --from-pr 10389
# 元セッションを保持しつつ分岐
claude -c --fork-session
便利な使い方： タスクごとにセッション名をつけておくと、数日後でも -r で文脈ごと復元できます。
2. 出力・実行モード
インタラクティブな対話が不要な場面では -p フラグが便利です。CI/CDやシェルスクリプトとの組み合わせに適しています。
| オプション | 説明 |
|---|---|
-p, --print |
応答を出力して即終了（非インタラクティブ） |
--output-format <format> |
出力形式: text（デフォルト）/ json / stream-json
|
--effort <level> |
思考努力レベル: low / medium / high / max（max はOpus 4.6専用） |
--verbose |
詳細出力モードを有効化 |
--input-format <format> |
入力形式: text / stream-json（-p 時のみ） |
--include-partial-messages |
チャンクを逐次出力（-p + stream-json 時のみ） |
--max-budget-usd <amount> |
APIコールの最大予算（-p 時のみ） |
--max-turns <n> |
agenticターン数の上限（-p 時のみ。制限超過でエラー終了） |
--json-schema <schema> |
構造化出力のJSONスキーマを指定（-p 時のみ） |
# レビュー結果をファイルに保存
claude -p "このPRをレビューして" > review.md
# JSON形式で出力してjqで処理
claude -p --output-format json "バグを特定して" | jq '.result'
# 最大精度モードで実行（Opus 4.6 専用）
claude --model opus --effort max "このアーキテクチャ設計をレビューして"
# コスト上限とターン数の上限を設定
claude -p --max-budget-usd 0.5 --max-turns 10 "このコードを分析して"
# 構造化出力
claude -p --json-schema '{"type":"object","properties":{"bugs":{"type":"array"}}}' "バグを列挙して"
--effort の使い分け：
-
low/medium— 簡単な質問・コード補完など素早く済ませたい場合 -
high/max— 複雑なデバッグ・設計レビューなど精度優先の場合（maxは Opus 4.6 のみ）
3. ツール・権限制御
Claude が使えるツール（ファイル編集・コマンド実行など）を細かく制御できます。セキュリティを重視する場面や、意図しない操作を防ぎたい場合に重要です。
| オプション | 説明 |
|---|---|
--allowedTools <tools> |
使用を許可するツールをホワイトリスト指定 |
--disallowedTools <tools> |
使用を禁止するツールをブラックリスト指定 |
--tools <tools> |
ツールセット全体を指定（"" で全無効、default で全許可） |
--permission-mode <mode> |
権限モードを指定（下記参照） |
--dangerously-skip-permissions |
全権限チェックをバイパス（サンドボックス専用） |
--allow-dangerously-skip-permissions |
権限バイパスをオプションとして有効化（--permission-mode と組み合わせ可） |
--permission-prompt-tool <tool> |
非インタラクティブモードで権限プロンプトを処理するMCPツールを指定 |
--permission-mode の種類：
| モード | 動作 |
|---|---|
default |
危険な操作は都度確認（デフォルト） |
acceptEdits |
ファイル編集は自動許可、それ以外は確認 |
dontAsk |
全操作を自動許可 |
bypassPermissions |
権限チェックを完全スキップ |
plan |
プランモード（実行せず計画のみ提示） |
auto |
Claude が自動判断 |
# 読み取りと検索のみ許可（安全な調査用）
claude --allowedTools "Read,Grep" -p "このコードの問題を調査して"
# git コマンドのみ許可
claude --allowedTools "Bash(git *)" "コミット履歴を分析して"
# ファイル編集は自動許可でサクサク作業
claude --permission-mode acceptEdits
# CI環境など全自動で実行したい場合
claude --permission-mode dontAsk -p "テストを実行して結果を報告して"
# ツールを全て無効にして純粋な会話モード
claude --tools ""
# プランモードで権限バイパスを組み合わせる
claude --permission-mode plan --allow-dangerously-skip-permissions
4. モデル指定
タスクの重要度やコストに応じてモデルを切り替えられます。
| オプション | 説明 |
|---|---|
--model <model> |
使用モデルをエイリアスまたはフルIDで指定 |
--fallback-model <model> |
主モデルが過負荷時のフォールバック（-p 時のみ） |
モデルエイリアス一覧：
| エイリアス | 実際のモデル | 用途 |
|---|---|---|
sonnet |
claude-sonnet-4-6 | バランス型（デフォルト） |
opus |
claude-opus-4-6 | 最高精度・複雑なタスク |
haiku |
claude-haiku-4-5 | 高速・軽量タスク |
# 最高精度モデルで設計レビュー
claude --model opus "このシステム設計をレビューして"
# 高速なHaikuで簡単な質問
claude --model haiku -p "この関数の引数を説明して"
# 過負荷時はHaikuにフォールバック
claude -p --model opus --fallback-model haiku "分析して"
5. プロンプト・エージェント制御
Claude の動作をカスタマイズしたり、専用エージェントを設定したりできます。
| オプション | 説明 |
|---|---|
--system-prompt <prompt> |
デフォルトのシステムプロンプトを置き換え |
--system-prompt-file <path> |
ファイルからシステムプロンプトを読み込み置き換え |
--append-system-prompt <prompt> |
デフォルトシステムプロンプトに追記 |
--append-system-prompt-file <path> |
ファイルの内容をデフォルトシステムプロンプトに追記 |
--agent <agent> |
設定済みエージェントを指定して起動 |
--agents <json> |
カスタムエージェントをインラインで定義 |
--teammate-mode <mode> |
エージェントチームの表示方法: auto（デフォルト）/ in-process / tmux
|
--disable-slash-commands |
/commit などのスキルを無効化 |
システムプロンプトフラグの使い分け：
--append-system-prompt/--append-system-prompt-fileが推奨。組み込み機能を保持しつつ要件を追加できる。--system-prompt/--system-prompt-fileは完全に置き換える場合のみ使用。
# 特定の役割を与えて起動
claude --system-prompt "あなたはセキュリティ専門家です。脆弱性の観点でレビューしてください。"
# ファイルからシステムプロンプトを読み込み
claude --system-prompt-file ./prompts/review.txt
# 追記形式（既存の機能を保持しつつ追加）
claude --append-system-prompt "常にTypeScriptで回答してください。"
claude --append-system-prompt-file ./style-rules.txt
# エージェントチームをtmuxで表示
claude --teammate-mode tmux
6. Web・リモート連携
claude.ai やモバイルの Claude アプリと連携してセッションを管理できます。
| オプション | 説明 |
|---|---|
--remote <task> |
claude.ai に新しいWebセッションを作成してタスクを開始 |
--remote-control / --rc
|
インタラクティブセッション起動 + claude.ai/Claude アプリからのリモート操作を有効化 |
--teleport |
claude.ai で作成したWebセッションをローカルターミナルで再開 |
# ログインバグの修正をWebセッションとして開始
claude --remote "Fix the login bug"
# ローカルで作業しつつモバイルからも操作できるように
claude --remote-control "My Project"
# Webセッションをローカルに引き継ぐ
claude --teleport
7. Git Worktree 連携
-w オプションで現在のリポジトリから独立した作業環境（worktree）を作成できます。メインブランチを汚さずに実験的な作業ができます。
| オプション | 説明 |
|---|---|
-w, --worktree [name] |
新しい git worktree を作成してセッションを開始 |
--tmux |
worktree 用の tmux セッションを作成（iTerm2はネイティブペイン使用） |
# 隔離環境で機能を試す
claude -w feature-experiment
# tmuxで並行作業
claude -w hotfix-v2 --tmux
8. MCP・設定の読み込み
MCP（Model Context Protocol）サーバーや追加設定を柔軟に読み込めます。
| オプション | 説明 |
|---|---|
--mcp-config <configs> |
MCPサーバー設定をJSONファイルまたは文字列で読み込む |
--strict-mcp-config |
--mcp-config のサーバーのみ使用（既存設定を無視） |
--settings <file-or-json> |
追加設定をファイルまたはJSON文字列で読み込む |
--setting-sources <sources> |
読み込む設定ソース: user / project / local
|
--plugin-dir <path> |
セッション限定でプラグインディレクトリを指定 |
--add-dir <dirs> |
ツールがアクセスできる追加ディレクトリを指定 |
--chrome |
Web自動化・テスト用のChromeブラウザ統合を有効化 |
--no-chrome |
Chromeブラウザ統合を無効化 |
--ide |
起動時にIDEへ自動接続（対応IDEが1つある場合のみ） |
# 特定のMCPサーバー設定を読み込む
claude --mcp-config ./my-mcp-servers.json
# プロジェクト設定のみ読み込む
claude --setting-sources project
# 作業ディレクトリを追加
claude --add-dir /tmp/workspace "このディレクトリのファイルを分析して"
# Chrome連携でWebテスト
claude --chrome "このページのフォーム動作を確認して"
9. デバッグ
動作がおかしいときや、ツール呼び出しの詳細を確認したいときに使います。
| オプション | 説明 |
|---|---|
-d, --debug [filter] |
デバッグモードを有効化（カテゴリフィルタ可） |
--debug-file <path> |
デバッグログをファイルに書き出す |
# 全デバッグ情報を表示
claude -d
# API関連とhooksのみ表示
claude --debug "api,hooks"
# 特定カテゴリを除外（先頭に ! をつける）
claude --debug "!statsig,!file"
# ファイルに保存して後で確認
claude --debug-file /tmp/claude-debug.log
10. その他
| オプション | 説明 |
|---|---|
--version / -v
|
バージョン番号を出力して終了 |
--init |
初期化フックを実行してインタラクティブモードを開始 |
--init-only |
初期化フックを実行して終了（セッションを起動しない） |
--maintenance |
メンテナンスフックを実行して終了 |
--betas <betas> |
ベータヘッダを追加（APIキーユーザー限定） |
--replay-user-messages |
ユーザーメッセージをstdoutに再出力（stream-json 用） |
# バージョン確認
claude -v
# 初期化フックのみ実行（CI/CDでのセットアップ用）
claude --init-only
実践パターン集
日常的な開発でよく使う組み合わせをまとめます。
パターン1: 中断した作業を再開する
# 昨日の作業を名前で再開
claude -r "認証機能リファクタリング"
# 直近の会話をそのまま続ける
claude -c
パターン2: CI/CDに組み込む
# PRの差分をレビューしてコメントを作成
git diff main...HEAD | claude -p --input-format text "このdiffをレビューしてMarkdownで出力して" > pr_review.md
# テスト失敗の原因を分析
npm test 2>&1 | claude -p "このエラーの原因と修正方法を教えて"
# ターン数とコストを制限してCI実行
claude -p --max-turns 20 --max-budget-usd 1.0 "テストを実行して失敗を修正して"
パターン3: セキュアな読み取り専用調査
# 編集権限を与えずコードを調査
claude --allowedTools "Read,Grep,Glob" "この認証周りのコードにセキュリティ上の問題があるか調査して"
# 設計の把握のみ（何も変更させない）
claude --tools "" "このシステムのアーキテクチャを説明して"
パターン4: タスクの重要度でモデルを使い分ける
# 軽い質問はHaikuで素早く
claude --model haiku -p "この関数の戻り値の型は？"
# 重要な設計判断はOpusで丁寧に（effortのmaxはOpus専用）
claude --model opus --effort max "このデータベース設計を見直して、スケーラビリティの問題を指摘して"
パターン5: 実験的な作業を安全に行う
# worktreeで本番コードを汚さず実験
claude -w experiment-new-algo
# 確認なしで自動作業（スクリプト的に使う）
claude --permission-mode dontAsk -p "このRubyファイルのN+1クエリを全て修正して"
パターン6: カスタムロールで専門的なレビュー
# セキュリティレビュー専用ロール
claude --append-system-prompt "セキュリティの専門家として、OWASP Top 10の観点でのみ指摘してください。" \
-p "このコードをレビューして"
# パフォーマンスレビュー専用
claude --append-system-prompt "パフォーマンスエンジニアとして、N+1クエリ・メモリリーク・不要な計算を中心にレビューしてください。" \
"このコードを確認して"
パターン7: Webセッションとローカルを行き来する
# モバイルのClaudeアプリでもローカル作業を操作できるように
claude --remote-control "My Project"
# Webセッションで作業してからローカルターミナルに引き継ぐ
claude --teleport
まとめ
| やりたいこと | 使うオプション |
|---|---|
| 前の会話を続けたい |
-c / -r
|
| スクリプトや自動化に使いたい |
-p + --output-format
|
| ファイルを触られたくない |
--tools "" or --allowedTools "Read,Grep"
|
| 確認ダイアログなしで動かしたい | --permission-mode dontAsk |
| 精度を最大にしたい | --model opus --effort max |
| 作業ブランチを隔離したい | -w |
| モバイルからも操作したい | --remote-control |
| Webセッションをローカルに引き継ぐ | --teleport |
| コスト・ターン数を制限したい |
--max-budget-usd / --max-turns
|
| デバッグしたい |
-d / --debug-file
|