Plan Mode(プランモード)

仕組み・概念
Plan Mode
プランモード
Claude Codeの動作モードの1つで、ファイルの書き換えやコマンド実行といった「変更系」を全部止めて、読み取りと計画書の作成だけに動きを限定する仕組み。承認されるまで実物のファイルは1文字も変わらない、というのが本質。

Claude Codeにいきなりコードを書かせるのが不安で、先に作業手順だけ提案してもらってから実行に進みたい人向け

新しいプロジェクトを引き継いだ初日に全体構造を読み解きたいときや、副業のLPを作りたいけど勝手にスコープを膨らませてほしくないとき、または既存OSSをgit cloneしてきて中身を理解する前にいきなりコマンドを実行されたくないとき。Shift+Tabを2回押すか、起動時に「claude --permission-mode plan」で入って、計画書を見てから次の動き方を選ぶ。

Claude Codeにいきなり手を動かされるのが怖いとき、最初の一手として叩いておきたいモードです。Plan Modeに入れると、Claude Codeはファイルを書き換えたりコマンドを実行したりする「変更系」の動作を全部止めて、読み取り中心の動きだけに切り替わります。中身を一通り眺めたあと、「私はこう進めるつもりです」という計画書を出してきて、人間の承認を待つ。

承認するか、計画を直させるか、あるいはそこで会話を切るか。判断する時間が確保されるのが一番大きい。

噛み砕くと

新しい職人さんが家のリフォームに来たとき、いきなり壁を叩き始めるのと、最初に「ここをこう直して、次にここをこう塗ります」と紙に書いて見せてくるのとでは、安心感が全然違います。Plan Modeは後者の動きを強制するスイッチです。

Claude Codeは普段だと「読む・書く・実行する」を全部やる前提で動いていて、危ない動作の前にだけ確認を挟みます。Plan Modeに切り替えると、書く・実行するの権利を一時的に没収されて、読むことしかできなくなる。代わりに、読んだ内容をもとに「次にやる作業の手順書」を提出する義務が発生します。

提出された手順書を見て、納得したら承認して通常モードへ戻る。納得しなければ「ここはこう変えて」と差し戻す。承認するまで実物のファイルは1文字も変わりません。

大事な前提:Plan Modeでも「読む系」は普通に動く

勘違いされやすいけど、Plan Modeは「何もしないモード」ではありません。ファイルを読む、フォルダの中身を一覧する、ターミナルで lsgit status みたいな参照系のコマンドを叩く、ウェブを見に行く——こういう「情報を取りにいく動作」は全部動きます。

つまりPlan Mode中でも、Claude Codeはあなたの作業フォルダの中身を読み込んでいるし、必要なら外部のサイトも見にいきます。「Plan Modeにしておけば何を見せても安全」というのは半分間違いで、すでに作業フォルダに置いた秘密ファイル(API鍵が入った設定や社内資料)は普通に読まれる可能性がある。

「副業で料理ブログを始める」を例に、実際の手順を見る

料理ブログの最初の1記事を書くために、Claude Codeに「フォルダ構成」と「記事のひな形」を作ってもらう想定で動かしてみます。題材は「世界の地方料理を1品ずつ紹介していくブログ」。

ステップ1: 空のフォルダを作って、その中でClaude Codeを起動する

デスクトップに cooking-blog という名前のフォルダを作って、その中に入った状態でClaude Codeを起動します。

$ mkdir cooking-blog
$ cd cooking-blog
$ claude

起動した瞬間は通常モード Ask before edits になっているので、ここでまずPlan Modeに切り替えます。

ステップ2: Shift+Tabを押してPlan Modeに切り替える

キーボードでShiftキーを押しながらTabキーを2回押すと、画面下のステータス表示が「plan mode on」に変わります。1回押しでaccept editsモード(ファイル編集だけ自動承認する中間モード)、2回押しがplan、もう1回押すと通常モードに戻る、というローテーション構造。

切り替わったら、最初の指示を投げます。

世界の地方料理を1品ずつ紹介する個人ブログを始めたいです。
最初の記事を書くための、フォルダ構成と記事ひな形を考えてください。
記事は週1更新、画像は自分で撮影、執筆はマークダウンでやります。

ステップ3: Claude Codeが計画書だけを返してくる

普段なら、ここでClaude Codeはいきなりフォルダを作り始めたり、ファイルを書き始めたりします。でもPlan Modeに入っているので、書き換え系の動作は全部封じられている。返ってくるのは作業計画だけです。

提案する構成:

cooking-blog/
├── posts/                # 記事本体(マークダウン)
│   └── 2026-05-02-thai-tom-yum.md
├── images/               # 各記事の写真
│   └── 2026-05-02-thai-tom-yum/
├── templates/            # 記事ひな形
│   └── post-template.md
├── README.md             # ブログの方針メモ
└── .gitignore            # 公開しないファイルの設定

ひな形に入れる項目:
- 料理名(現地語と日本語)
- 国・地方
- 食べたきっかけ/食べた場所
- 材料リスト
- 作り方の手順
- 食べた感想(数字での評価込み)
- 関連リンク

承認すれば、実際にこの構成でフォルダとひな形を生成します。

ステップ4: 計画を読んで判断する(ここが肝心)

ここで初心者がやりがちな勘違いがあります。「Plan Modeで計画を承認したら、自動的にいい感じに進めてくれる」と思いがち。でも違います。承認した瞬間に「次の動き方」を5択で聞かれます。

  • 承認してauto modeで進める - 確認なしで一気に作らせる
  • 承認してaccept editsで進める - ファイル編集だけは自動承認、危ない操作は確認
  • 承認して1個ずつ手動で確認 - 通常モードに戻して、変更ごとに承認を求めさせる
  • 計画を直させる - フィードバックを伝えてもう一度計画を作り直してもらう
  • Ultraplanで計画を精査する - claude.ai上のブラウザ画面で計画の詳細を見直す上級者向けの追加項目。Ultraplanが使えるプランかどうかは事前に確認が必要

つまり「Plan Modeでの承認」は実行のゴーサインじゃなくて、「次にどの強さで進めるかを選ぶ分岐点」です。料理ブログの構成みたいに、後から手で直せるレベルの作業なら2番目(accept edits)でいいし、副業のお金が絡むコードなら3番目(1個ずつ手動確認)が安全。

ステップ5: 計画を直したい場合

計画を見て「画像フォルダを記事ごとに分けるんじゃなくて、まとめて images/ に入れるシンプル構成がいい」と思ったら、そのまま会話で伝えれば直してくれます。

画像は記事ごとにフォルダ分けせず、images/ 直下に
日付プレフィックス付きで全部置く構成に変えてください。
ひな形に「料理ジャンル(メイン/副菜/デザート)」のフィールドも追加。

Claude Codeはまだ Plan Mode の中にいるので、新しい計画書を返してくる。実物のフォルダはまだ何も作られていません。何度でも作り直してもらえる。

ステップ6: 承認して実行に移す

納得したら、計画提示画面で「承認してaccept editsで進める」を選びます。Plan Modeから抜けて、Claude Codeが実際にフォルダを掘り、post-template.md を書き、README.md に方針を書き出していく。

もしこの段階で「やっぱりやめます」と思ったら、Plan Mode中にShift+Tabをもう1回押せば、計画ごと破棄して通常モードに戻れます。実物のファイルは何も変わらないまま。

つまりPlan Modeは何をしてくれるのか

  • やってくれる: 作業フォルダや既存ファイルの読み取り、計画書の作成、ウェブ検索、参照系のターミナル操作。「何をするつもりか」を文章で見せること
  • やってくれない: ファイルの作成・上書き・削除、書き換え系のターミナル操作、git の保存系操作。要するに「何かを変える」動作は全部止まる
  • 意味が薄い場面: 単に質問の答えがほしいだけのとき(普通に聞けばいい)、すでに細かい修正方針が決まっていて手を動かしてほしいだけのとき、5秒で終わる作業のとき

使いどころ3シナリオ

シナリオ1: 既存のプロジェクトを別の人から引き継いだ初日

同僚が辞めて、Reactで書かれた社内ツールを引き継いだ初日。フォルダの中に何が入っているか分からないし、いきなり触ると壊しそう。Plan Modeで起動して「全体構造を読んで、ログイン機能を追加するなら何をどう変えるか計画して」と頼むと、まず全ファイルを読み込んで、影響範囲と変更手順を文章で出してきます。納得してから「accept editsで進める」を選べば、計画通りに着手してくれる。読み込みだけで実害ゼロのまま地図が手に入る。

シナリオ2: 個人で副業のLP(ランディングページ)を作るとき

「副業で美容オイルの紹介ページを作りたい、構成はこんな感じ」と漠然としたイメージしかない状態。普通モードでお願いすると、Claude Codeがいきなり気を利かせてフォームのバリデーション処理まで書き始めることがある。Plan Modeに入れて「私が触りたいのはトップ画面の見出しと、商品の特徴3つだけ。それ以外は触らないで」と先に宣言してから計画を出させると、勝手にスコープが膨らむのを防げる。最初に「私はここまでで止める」と握ってから動き出す感覚です。

シナリオ3: 既存OSSをgit cloneしてきて中身を読み解きたいとき

GitHubで見つけたツールを自分の環境で動かしたいけど、READMEが英語で薄くて、何がどこに書いてあるか分からない。Plan Modeで起動して「このプロジェクトの全体像と、自分のMacで動かすために必要な手順を計画して」と頼めば、Claude Codeがフォルダを全部読んで、依存関係と起動手順をまとめた計画書を返してくれます。読み取り専用なので、知らないコマンドを勝手に実行されて環境が荒れる心配がない。地図ができてから本番作業に進める。

初心者が踏みやすい落とし穴

  • 「Plan Modeなら何でも見せて安全」と思い込む。読み取り系は普通に動くので、作業フォルダに .env みたいな秘密ファイルが置いてあると、Plan Mode中でも内容を読まれて会話履歴に残る可能性があります。秘密ファイルは別フォルダに退避してから起動するのが無難
  • 計画承認=自動で全部進む、と思い込む。承認時にステップ4で示した5択が出てくるので、ここで意識して選ばないと意図しない強さで進んでしまいます。慎重にいきたいなら3番目(1個ずつ手動確認)を選ぶ
  • Plan ModeとbypassPermissionsを同一視しない。Plan Modeは変更系の動作を止めるだけで、個別の確認プロンプト自体は通常モードと同じ強さで出続けます。一方bypassPermissionsは権限チェックと安全確認を全部スキップする別モードで、隔離されたコンテナや仮想環境以外では使ってはいけない設定です。「planで十分安全なのにbypassPermissionsは危険すぎる」は正しい認識です
  • 計画書が長すぎてClaude Codeが疲弊する。あまりに巨大なプロジェクトでPlan Modeを使うと、計画書自体が膨らみすぎて会話の容量を食い潰し、本番作業に入った頃には大事な前提を忘れていることがあります。1セッション1テーマに絞る
  • 計画通りに実装される保証はない。承認した計画はあくまで「これから進める方針」のメモ書きで、実装中に判断が変わって逸脱することもあります。最後にgitの差分で実物を確認する習慣をつけたほうがいい
  • Auto Modeとの使い分けを混乱する。Plan Modeは「読んで、提案して、止まる」。Auto Modeは「確認を省略してガンガン進む」。真逆の性格なので、用途も真逆。「不安だからPlan Mode、急ぎだからAuto Mode」くらいの感覚で切り替える
  • Shift+Tabのローテーションを覚えていない。1回押しでaccept edits、2回押しでplan、3回押しで通常モードに戻る。慌てて連打すると意図しないモードに入ってしまうので、ステータス表示を毎回確認する癖をつける
  • Plan Modeから抜けるときに「破棄」と「承認」を間違える。計画提示画面で会話を続けると計画修正、Shift+Tabで抜けると計画破棄、5択メニューで承認を選ぶと実行へ。挙動が3パターンあるので、初回は何度か試して感覚を掴んでおいたほうがいい

書き方

# 起動中に切り替える
Shift+Tab(2回押し)

# 起動時から指定する
$ claude --permission-mode plan

# 1回の指示だけPlan Mode的に扱う
/plan ここに指示を書く

やってみるとこうなる

入力

$ mkdir cooking-blog
$ cd cooking-blog
$ claude --permission-mode plan

# プロンプトに以下を投げる
世界の地方料理を1品ずつ紹介する個人ブログを始めたいです。最初の記事を書くためのフォルダ構成と、記事のひな形を考えてください。

出力例

提案する構成:

cooking-blog/
├── posts/
│   └── 2026-05-02-thai-tom-yum.md
├── images/
├── templates/
│   └── post-template.md
├── README.md
└── .gitignore

承認すれば、この構成で実際にフォルダとひな形を生成します。

[計画提示後、5択を聞かれる]
  1. 承認してauto modeで進める
  2. 承認してaccept editsで進める
  3. 承認して1個ずつ手動確認
  4. 計画を修正させる
  5. Ultraplanで計画を精査する

このページに出てきた言葉

permission mode
Claude Codeに「どこまで自動で動いていいか」を指示する動作モード設定。default / acceptEdits / plan / auto / dontAsk / bypassPermissions の6種類がある
Plan Mode
permission modeの1つ。読み取りと計画書作成だけに動きを限定し、ファイル変更やコマンド実行は全てブロックする
Shift+Tab
Claude Codeで動作モードを切り替えるキー操作。1回押しでaccept edits、2回押しでplan、3回押しで通常モードに戻る
ExitPlanMode
Plan Modeから抜けて計画を提示するときに内部で使われる仕組み。ユーザー側からは「計画提示→5択メニュー」として見える
accept edits
Plan Modeを承認したあとに選べる進め方の1つ。ファイル編集だけ自動承認し、危ない動作だけ確認を求める中間モード
auto mode
Plan Modeを承認したあとに選べる進め方の1つ。ほぼ全ての確認を省略して連続で進ませる、別の動作モード
Ultraplan
Plan Modeを承認したあとに選べる進め方の1つ。claude.aiのブラウザ画面側で計画の詳細を見直せる上級者向けの追加項目で、契約プラン依存
bypassPermissions
permission modeの1つで、権限チェックと安全確認を全部スキップしてしまう最強モード。Plan Modeとは性格が真逆で、隔離環境以外では使ってはいけない
protected paths
.gitや.claude.jsonなど、Plan Modeを含む全モードで「自動承認しない」と決められた特殊な保護対象。書き換えには必ず確認が要る

関連項目

公式ドキュメント

https://code.claude.com/docs/en/permission-modes

-

← 戻る