プランモード

初級

What you'll learn

プランモードが何をブロックし、何を引き続き実行できるのかを説明する
プランモードに入る方法と抜ける方法を3通り押さえる
調査 → 提案 → 承認 → 実行のループを順にたどる
プランモードと権限（Permissions）の違いを理解し、併用する

基本の考え方

業者に家の鍵を渡すのと、まず現場を見て「何を変えるつもりか」を書き出してもらうのとでは違います。プランモードは後者の下見にあたります。

プランモードは、Claude に変更せずに調べて提案するよう指示します。ファイルを読み、調査のためにシェルコマンドを実行し、計画を書きますが、ソースは編集しません。計画を承認するまで、編集はブロックされたままです。

Pro tip

プランモードでは、Claude はソースを「調査」するが「変更」はしない。計画を作り、あなたの合図を待つ。

厳密な読み取り専用ではない

調べるにはコマンドが必要なこともあるため、プランモードは「実行しない」ではなく「編集しない」ためのものです。計画中のシェルコマンドがどう扱われるかはセッションによって決まり、最初に当てはまるケースが優先されます。

Guided walkthrough1 of 3

プランモードのブロックは強制されません。Claude は編集せずに計画するよう指示されたままですが、計画中に試みた編集やコマンドは確認なしで実行されます。それ以外の環境（ヘッドレスの -p 実行、Agent SDK、VS Code 拡張のチャットパネル）ではプランモードのブロックが維持されます。

Watch out

--allow-dangerously-skip-permissions で起動した場合、プランモードは強固な指示にすぎず、厳格なガードレールではありません。サンドボックスではなく、計画のための取り決めとして扱ってください。

最も安全な出発点である理由

大規模・高リスク・不慣れな作業では、Claude がリポジトリに触れる前に「何をするつもりか」を確認したいものです。プランモードは考えることと実行することを切り離します。

得られるものは、誤った前提が誤ったコードになる前に気づけることです。

使うタイミング

Pro tip

大規模または複数ファイルにまたがる変更、マイグレーション、リファクタリングでは必ず使う
まだ十分に把握していないコードベースで作業するとき
チームメイトと共有できる、レビュー可能な計画が欲しいとき

ごく小さく自明な編集なら省いてかまいませんが、迷ったらまず計画しましょう。

実際の流れ

ループを順にたどります。各ステップが次のステップの前提になり、Claude は承認の後にはじめて編集に移ります。

Guided walkthrough1 of 4

ステータスバーに 'plan mode on' と表示されるまで Shift+Tab で権限モードを切り替えるか、1回のプロンプトの先頭に /plan を付けます。最初からプランモードで始めるには claude --permission-mode plan で起動します。その後、達成したいことを説明します。

計画を承認せずにプランモードを抜けるには、もう一度 Shift+Tab を押します。プロジェクトのターミナルセッションでデフォルトにするには、.claude/settings.json で defaultMode を plan に設定します。詳しくは設定を参照してください。

試してみよう

実際の計画セッションにこれをコピーして、ループが進む様子を確かめてみましょう。

計画セッションを始める

I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.

CLAUDE.md と組み合わせる

優れた CLAUDE.md があると計画が鋭くなります。Claude があなたの規約やガードレールを踏まえて計画を立てるからです。