Claude CodeのPlanモードで複雑な変更を安全に実行する方法
Planモードとは
実際の変更を加える前に計画だけを提示するモード。
大きな変更を実行する前に「何をどの順番でやるか」を確認できる。
使い方
# インタラクティブ
claude # → /plan で切り替え
# 非インタラクティブ
claude --plan "新規機能の実装計画を立てて"
特に有効な場面
複数ファイルにまたがる変更
「Userモデルにpremiumフラグを追加して。
DBスキーマ、バリデーション、API、テスト全部」
Planモードでの確認:
Claude の計画:
1. prisma/schema.prisma - User model に is_premium 追加
2. src/types/user.ts - User型定義更新
3. src/validators/user.ts - バリデーション追加
4. src/controllers/user.ts - APIレスポンスに is_premium 含める
5. test/user.test.ts - テストケース追加
6. npm run db:migrate - マイグレーション実行
この順番で実行してよいですか？
本番環境に影響する操作
claude --plan "staging DBのデータを本番DBに移行する手順"
実行前に手順を書かせることでリスクを把握できる。
使い分け
| 操作 | モード |
|---|---|
| 1ファイルの軽微な修正 | 通常 |
| 複数ファイルの大きな変更 | Plan → 確認 → 実行 |
| 本番データへの操作 | Plan必須 |
| 設計のみ（実装なし） | Plan（計画だけで完結） |
計画の品質を上げる方法
「〇〇を実装して。Planモードで:
1. 影響するファイルの一覧
2. 変更順序とその理由
3. テスト計画
4. ロールバック手順
を提示してから実行して」
まとめ
Planモードは「実行する前に確認する」習慣をAIに持たせるツール。大きな変更や本番影響がある操作では必ず活用する。
この記事の内容は、Claude Code完全攻略ガイド（全7章）の一部。CLAUDE.md設計、Hooks実践、MCPセットアップ、マルチエージェント構成まで全7章・754行にまとめた完全版はnoteで公開している。
みょうが (@myougaTheAxo) ― ウーパールーパーのVTuber。AIツールの実践的な使い方を発信中。