CodexのPlan Modeとは?コードを書く前に調査と計画を確認する使い方

AIにプログラムの修正を頼むとき、少し不安になることがあります。例えば、CSVを読み込んで広告費やクリック数を集計し、CTRやCPCを計算する仕組みが、すでに正しく動いているとします。そこへ「広告別のCPAも出せるようにして」と頼むと、AIはすぐにコードを書き換えてくれるかもしれません。

しかし、その変更で別の計算が動かなくなったり、CSVの列名や保存先の形が変わったりする可能性もあります。そこで、コードを変える前に調査と計画をAIに頼む使い方を支えるのが、Codexの「Plan Mode(プランモード)」です。

この記事で分かること

  • CodexのPlan Modeとは何か、通常の実装との違い
  • 「調査→計画→確認→実装」の進め方と依頼文の例
  • 計画を確認するときのポイントと、使うべき場面の目安
目次

CodexのPlan Modeとは

Plan Modeは、コードを変更する前に、既存のコードを調べて実装の計画を作るためのモードです。OpenAIの公式ドキュメントでは、CLI(文字で操作する画面)の「/plan」は「実装を始める前に、実行計画を提案させるときに使う」と説明されています。

/plan

アプリやIDE(開発用のエディター)では、画面のモード選択からPlanを選ぶ形の場合もあります。操作方法は環境やバージョンで違うため、自分の画面で確認してください。

Plan Mode通常の実装
主な目的調査・設計・計画コードの変更
ファイルの変更原則しないする
テストテスト方法を計画する実行して直す
人の役割計画を確認する結果を確かめる

小さな文字の修正なら、すぐ直しても問題ないことが多いです。一方、データの取得・保存・計算・レポートが連携している仕組みでは、1つのファイルの変更が別の機能に響くことがあります。変更の前に影響する範囲を調べるために、Plan Modeが役立ちます。

Plan Modeの進め方

① まず現状を調べてもらう

最初に、今の仕組みを把握します。設計書と実際のコードが合っていないこともあるため、コードそのものを調べてもらうのが大切です。

このプロジェクトの構成を調査してください。
主要なファイルと役割、データの取得・保存方法、
KPIの計算処理、既存のテストを整理してください。
現時点ではコードを変更しないでください。
確認できた事実と推測を分けて説明してください。

② 追加したいことと条件を伝える

「CPAは広告費÷成果件数で出す」という計算式だけでなく、「CTR・CPCの計算はそのまま残す」という守る条件も伝えます。成果件数が0件のときにCPAをどう表示するか、といった例外もこの段階で決めておきます。

③ 変更するファイルと影響を調べてもらう

変更するファイルだけでなく、変更しないファイルも確認すると、不要な改修を防ぎやすくなります。AIが「影響はありません」と答えた場合も、根拠になるファイルや関数を示してもらいます。

④ 実装方法を比べて、計画にまとめてもらう

「今の関数に足す」「計算専用の関数を作る」など、方法はいくつかあります。大事なのは、一番複雑な設計ではなく、今の目的に必要十分な方法を選ぶことです。最後に、目的・変更するファイル・変更しないファイル・手順・テスト方法・リスク・元に戻す方法・未確認のことをまとめた計画を作ってもらいます。

計画を確認するときのポイント

AIの計画にも、見落としや誤った前提が入ることがあります。人が次の点を確認します。

  • 変更するファイルは適切か、今の機能は残るか
  • 頼んでいない機能や大きな構造変更が入っていないか
  • テスト方法は十分か、失敗したら戻せるか

CPAを足すだけなのにデータベース全体の作り直しが提案された、といった場合は、「今回はCPAの追加だけ。将来の改善案は別にまとめて」と伝えて計画を直してもらいます。実装を頼むときも、「計画外の変更が必要になったら、進める前に理由を説明して」「実行していないテストを成功扱いにしないで」と添えておくと安心です。

実際にやってみて

私はeBay輸出の値付けツールを作ったとき、この「計画→確認→実装」の流れで進めました。ただし計画はCodexのPlan Modeではなく、Claude Codeで設計書と実装計画を作り、私が確認してからCodexに実装を頼む形です。

Codexの実装ではテストが27件すべて成功しました。それでも、Claude Codeが実際の画面で確かめたところ、為替を自動で取ってくる部分が動いていませんでした。テストが通っても、計画どおりに動くかの確認は別に必要だと分かった出来事です。詳しくは2つのAIで関税込みの値付けツールを作った記録にまとめています。

Plan Modeを使うかどうかの目安

作業必要性
文字の修正低い
小さな関数の追加状況による
複数ファイルの変更・API連携の追加高い
データベースの構造変更・全体の作り直し非常に高い

計画づくりにも時間とAIの利用量がかかります。変更の大きさだけでなく、失敗したときの影響も考えて使い分けます。小さな変更でも、お金の計算など大事な処理なら慎重に計画した方がよい場面があります。

計画はファイルに残しておく

長く育てる仕組みでは、計画を会話の中だけで終わらせず、プロジェクト内の「docs/」などにファイルとして保存しておくと、後から変更の経緯を確かめやすくなります。私の値付けツールでも、docs/に設計書・実装計画・Codexへの指示文の写しを置いています。また、変更前の状態をGitで記録しておけば、失敗しても戻しやすくなります。

まとめ

CodexのPlan Modeは、いきなりコードを書かせるのではなく、まず「何を、どこを、どう変えるか」を調べて計画させるためのモードです。ただし、Plan Modeを使えば必ず安全な設計になるわけではありません。計画を作ることと、実装を許可することは別です。人が計画を確認し、実装後も計画と結果を照らし合わせることで、今動いている仕組みを守りながら機能を足していけると考えています。

Codexの基本についてはOpenAI Codexとは?ChatGPTとの違いで整理しています。

※機能や操作方法は変わることがあります。記事作成時点(2026年11月)の情報のため、最新の内容は公式ドキュメントをご確認ください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次