プランモードは、Claude Code にコードを一切変更させず、調査と計画立案だけを行わせる読み取り専用モードです。大きめの変更やリスクのある作業を始める前に、まず方針を固めたいときに役立ちます。これは Anthropic 公式の Claude Code に実在する機能です。
プランモードとは
プランモード(Plan Mode)は、Claude Code がファイルの読み取り・検索・分析だけを行い、ファイルの編集やコマンドの実行といった変更を伴う操作を行わないモードです。Claude はコードベースを調べたうえで「何を、どの順番で、どのファイルに対して行うか」という実装計画を提示します。あなたが計画を承認するまで実際の変更は始まりません。
調査と実行を明確に分けることで、意図と違う方向に大量の変更が入ってしまうのを防ぎ、着手前に方針をレビューできます。
有効化する方法
対話セッション中に Shift+Tab を押すと、権限モードが順番に切り替わります。通常モード、自動承認(auto-accept)モード、そしてプランモードの間を循環し、画面下部に現在のモードが表示されます。プランモードに入ると、Claude は変更系の操作を行わなくなります。
# 起動して対話を始める
claude
# セッション中に Shift+Tab を数回押して "plan mode" 表示に切り替える
# 例: 「認証まわりをリファクタリングする計画を立てて」と依頼する
最初からプランモードで起動したい場合は、起動時に権限モードを指定できます。
claude --permission-mode plan
どんなときに使うか
次のような場面でプランモードが向いています。
- 複数ファイルにまたがる規模の大きいリファクタリングや機能追加を始める前
- 不慣れなコードベースの構造をまず把握したいとき
- 変更を加える前に、Claude の理解と方針が正しいか確認したいとき
- 本番に近い環境など、うっかり変更を走らせたくない場面での調査
計画から実装へ移る
Claude が提示した計画を確認し、問題なければ承認すると、Claude は通常モードに移って計画に沿った実装を進めます。計画に過不足があれば、承認せずに「この部分は不要」「先にテストを追加して」などと指示して計画を練り直せます。
計画は着手前の合意形成のためのものです。実装中に前提が変わった場合は、あらためてプランモードに戻して方針を立て直すこともできます。
ベストプラクティス
- 大きな作業は「まず計画、レビューしてから実装」を習慣にすると手戻りが減ります。
- 計画が大きすぎると感じたら、承認前にスコープを小さく分割するよう依頼しましょう。
- プロジェクト固有の制約(使用ライブラリ・命名規則など)は CLAUDE.md に書いておくと、計画の精度が上がります。
関連記事: サブエージェントの使い方 / スラッシュコマンド リファレンス