はじめに

Claude Codeを使っていて「いきなり実装を始めて途中で方針がブレる」「大きな変更で予想外のファイルが壊れる」と感じたことはないでしょうか。Plan Modeを使えば、実装前にコードベースを分析し、詳細な計画を立ててから作業を進めることができます。

本記事では、Plan Modeの基本から実践的な使い方までを解説します。

Plan Modeとは

Plan Modeは、Claude Codeの読み取り専用の計画フェーズです。ファイルを編集したりコマンドを実行したりせず、コードベースを分析して実装計画を作成します。

3つのモード

Claude Codeには3つの実行モードがあります。

モード	名称	特徴
Mode 1	Ask before edits	デフォルト。編集時に確認を要求
Mode 2	Edit automatically	自動で編集（コマンド実行は要確認）
Mode 3	Plan mode	読み取り専用で計画を作成

なぜPlan Modeが必要か

いきなり実装を始めると、以下の問題が起きやすいです。

影響範囲が見えない: 修正すべきファイルを見落とす
方針がブレる: 途中で「こっちのほうがいいかも」と迷走する
手戻りが発生する: 実装後に設計ミスに気づく

Plan Modeを使うことで、実装前に全体像を把握し、計画に沿って作業を進められます。

起動方法

キーボードショートカット

Shift+Tab を2回押す → Plan Modeに切り替え

通常モード → Edit automatically → Plan Mode の順で循環します。

CLIオプション

# Plan Modeで起動
claude --permission-mode plan

# 非対話モードで実行
claude --permission-mode plan -p "認証システムを分析して改善案を提案して"

セッション中の切り替え

> /plan

Plan Modeでできること・できないこと

できること

ツール	用途
Read	ファイルの読み取り
Glob	ディレクトリのリスティング
Grep	コード検索
WebFetch	Web情報の取得
AskUserQuestion	ユーザーへの質問

できないこと

ファイルの編集・作成
コマンドの実行
ファイルシステムの変更

Plan Modeは「調査と計画」に特化したモードです。

計画ファイルの保存場所

デフォルト

~/.claude/plans/

プロジェクト内に保存（推奨）

.claude/settings.jsonで以下を設定すると、プロジェクト内に保存できます。

{
  "plansDirectory": ".claude/plans"
}

プロジェクト内に保存すると、Gitで管理してチームで共有できます。

基本フロー

ユーザー
  │
  ▼ 「認証システムをOAuth2に移行したい」
Plan Mode（分析）
  │ コードベースを調査
  │ 影響範囲を特定
  │ 実装計画を作成
  │
  ▼ plan.md を生成
ユーザー（レビュー）
  │ 計画を確認・修正
  │
  ▼ 承認
通常モード（実装）
  │ 計画に沿って実装
  │
  ▼
完了

実践例

例1: 大規模リファクタリング

claude --permission-mode plan

> 認証システムをJWTからOAuth2に移行したい。
> 影響範囲を分析して、移行計画を作成してください。

Claudeは以下のような計画を作成します。

## 移行計画: JWT → OAuth2

### 影響範囲
- src/modules/auth/ - 認証ロジック全体
- src/libs/guards/ - 認証ガード
- src/modules/user/ - ユーザー情報取得部分

### 実装ステップ

#### Phase 1: 準備
1. OAuth2プロバイダーの設定追加
2. 新しい認証エンドポイントの作成

#### Phase 2: 移行
3. 既存のJWT検証をOAuth2に置き換え
4. ユーザーセッション管理の更新

#### Phase 3: クリーンアップ
5. 古いJWT関連コードの削除
6. テストの更新

### リスク
- 既存セッションの無効化
- 外部連携への影響

### 検証手順
- 全認証フローのE2Eテスト
- 既存ユーザーのログイン確認

例2: 新機能の設計

> ユーザープロフィール編集機能を追加したい。
> 既存のコードパターンを分析して、実装計画を立ててください。

Plan Modeは既存のコードを分析し、プロジェクトのパターンに沿った計画を提案します。

例3: 未知のコードベース理解

> このプロジェクトに参加したばかりです。
> 認証システムの仕組みを分析して説明してください。

Plan Modeはコードを読み取り、構造を説明します。実装せずに理解だけしたい場合に便利です。

Tips

計画を編集してから実装

計画に納得いかない部分があれば、修正を依頼できます。

> Phase 2の順番を変えたい。3と4を入れ替えて。

または、生成されたplan.mdを直接編集することもできます。

Ctrl+G  # エディタで計画ファイルを開く

サブエージェントとの組み合わせ

Plan Modeで計画を立て、PMエージェントにタスク分解を任せる流れが効果的です。

1. Plan Mode: 全体の実装計画を作成
2. PM: 計画をタスクに分解
3. Engineer: 各タスクを並列実装
4. Reviewer: 成果物をレビュー

30分以内の単位に分ける

大きすぎるタスクは、30分以内で完了する単位に分けましょう。Plan Modeで全体像を把握してから、フェーズごとに実装を進めると管理しやすいです。

デフォルトでPlan Modeを使う

慎重に進めたいプロジェクトでは、デフォルトをPlan Modeに設定できます。

// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

推奨される使用シーン

シーン	理由
大規模リファクタリング	影響範囲を事前に把握できる
複数ファイルへの修正	漏れを防げる
未知のコードベース理解	実装せずに調査できる
設計の検討	複数のアプローチを比較できる
チームでの合意形成	計画をGitで共有して議論できる

プロジェクト構成例

project-root/
├── .claude/
│   ├── settings.json        # plansDirectoryを設定
│   ├── plans/               # 計画ファイルの保存先
│   │   ├── auth-refactor.md
│   │   └── new-feature.md
│   └── agents/
│       ├── pm.md
│       ├── engineer.md
│       └── reviewer.md
└── ...

まとめ

Plan Modeを使うことで、実装前にコードベースを分析し、計画を立ててから作業を進められます。

Shift+Tab×2 でPlan Modeに切り替え
読み取り専用で調査・計画に集中
plan.mdに計画を出力し、レビュー後に実装
plansDirectoryを設定してGitで管理

「いきなり実装」ではなく「まず計画」を習慣にすることで、手戻りを減らし、品質の高い開発ができます。

参考リンク

Claude Code 公式ドキュメント - Common workflows