Claude Code の Plan Mode の使い方:実装前に計画を確認してから作業させる

「リファクタリングして」と頼んだら、想定と違う方向に大量のファイルが書き換えられていた。Claude Code を使っていると一度は経験する手戻りです。これを防ぐのが Plan Mode です。

Plan Mode では Claude はファイルを読んで調査し、実装計画を提示するところまでで止まります。計画を確認して修正したうえで実装に移せるため、大きめの変更ほど効果があります。

権限モードの一覧

Claude Code には、操作をどこまで自動で行うかを決める権限モードがあります。

モード	ファイル読み取り	ファイル編集	コマンド実行
plan	自動	不可	不可(読み取り専用の一部を除く)
default	自動	確認	確認
acceptEdits	自動	自動	確認
bypassPermissions	自動	自動	自動(隔離環境専用)

Plan Mode は「読むだけ」のモードです。調査・設計・レビューのように、変更を伴わない作業にも向いています。

Plan Mode に入る 3 つの方法

1. Shift+Tab で切り替える

対話中に Shift+Tab を押すと、モードが順に切り替わります。入力欄の下に現在のモードが表示されるので、「plan」になるまで押します。もっとも手軽な方法です。

2. 起動オプションで指定する

claude --permission-mode plan

調査から始めたいセッションでは、最初からこのオプションを付けて起動します。

3. 既定のモードにする

.claude/settings.json で既定にすると、毎回 Plan Mode で始まります。

{
  "permissions": {
    "defaultMode": "plan"
  }
}

慣れないうちはこの設定にしておき、計画を見てから実装に進む習慣をつけると安全です。permissions 全体の設計は settings.json で permissions を設計する を参照してください。

計画から実装までの流れ

1. Plan Mode で、やりたいことを具体的に伝えます。例:「認証処理を lib/auth.ts に集約して、各 API ルートから重複を除いてください」
2. Claude が関連ファイルを読み、変更対象のファイル一覧・手順・懸念点を計画として提示します。
3. 計画を読み、修正したい点があればそのまま返答します。例:「middleware.ts は今回触らないでください」
4. 計画に納得したら、表示される選択肢から実装に進みます。このとき通常モードか acceptEdits に切り替わり、編集が始まります。
5. 実装後、計画と差分を見比べて漏れがないか確認します。

Plan Mode が効く場面

• 複数ファイルにまたがる変更: リファクタリング、API の設計変更、依存ライブラリの置き換え
• 設計判断が必要な作業: 「どこに置くべきか」「既存の仕組みを使うか新設するか」を先に決めたいとき
• 知らないコードベースの調査: 「この機能はどこで実装されているか」を変更なしで調べる
• レビュー: 差分や PR を読んで指摘だけしてほしいとき

逆に、1 ファイルの小さな修正やタイポ直しに Plan Mode を使うと、確認の手間が増えるだけです。その場合は acceptEdits で直接進めた方が速いです。

計画の質を上げる指示の書き方

Plan Mode の出力は、最初の指示の具体性に左右されます。

目的: 決済処理のリトライを共通化したい
制約: 外部 API の呼び出し回数は増やさない。既存のテストは変更しない
求める出力: 変更ファイル一覧、各ファイルの変更概要、実装順序、テスト方針

このように「目的・制約・求める出力」を分けて書くと、計画に必要な要素が揃いやすくなります。

並列作業との組み合わせ

計画を立てた後、複数の独立したタスクに分かれる場合は、git worktree を使って別々のセッションで並列に進める方法があります。手順は Claude Code と git worktree で複数タスクを並列に進める を参照してください。

まとめ

• Plan Mode は読み取り専用で、調査と計画提示までを行うモード
• Shift+Tab、--permission-mode plan、defaultMode: "plan" の 3 通りで入れる
• 複数ファイルにまたがる変更や設計判断が必要な作業で使い、小さな修正では使わない
• 指示は「目的・制約・求める出力」を分けて書くと計画の質が上がる