プランモード

初級

What you'll learn

プランモードが何をするか、なぜ読み取り専用なのかを説明する
まず計画すべき場合と、スキップしてよい場合を判断する
調査・提案・承認・実行のループを一通りたどる
プランモードと権限（Permissions）を区別し、両者を併用する

大きな考え方

工事業者に家の鍵を渡すのと、まず家の中を歩いて回って何を変えるかを書き出してもらうのとを想像してみてください。プランモードはその「歩いて回る」段階です。

プランモードは Claude Code を読み取り専用にします。コードベースを探索し、検索を実行し、推論できますが、ファイルを編集したり状態を変えるコマンドを実行したりはしません。代わりに計画を作成し、あなたの承認を待ちます。

Pro tip

読み取り専用とは、Claude が考える（THINK）が行動しない（ACT）という意味です。あなたが GO と言うまで、ファイル編集も状態を変えるコマンドもありません。

なぜ最も安全な始め方なのか

大きい、リスクがある、あるいは不慣れな作業では、Claude がリポジトリに触れる前に何をしようとしているかを見たいものです。プランモードは考えることと行動することを分離します。

見返り：間違ったコードになる前に、間違った前提に気づけます。

いつ使うか

Pro tip

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

ごく小さく明白な編集ならスキップしてかまいません。ただし迷ったら、まず計画を立てましょう。

実際の動き方

ループに従います。各ステップが次のステップを引き出します。Claude が編集に切り替わるのは、あなたが承認した後だけです。

Guided walkthrough1 of 4

読み取り専用モードに切り替え、達成したいことを説明します。

自分で試す

これを実際のプランニングセッションに貼り付けて、ループが展開する様子を見てみましょう。

プランニングセッションを始める

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.

:::tip CLAUDE.md と組み合わせる良い CLAUDE.md は計画をより的確にします。Claude はあなたの規約とガードレールを最初から踏まえて計画を立てます。 :::