Codexがプランを立てた。レビューできるファイルにしよう。

Codexはプランをチャットに出しますが、流れて見えなくなります。ファイルとして頼めば、1行ずつコメントでき、マークした箇所をCodexに直させられます。

macOS 14以降。閲覧は無料で、編集とレビューは1回のお支払いです。

要点

Codexで/planと入力するとプランモードに切り替わります。/plan Propose a migration plan for this serviceのように、依頼を続けて書くこともできます。プランはチャットに届きます。Codexにplans/<name>.mdとして保存し、DotMDで送るよう頼みましょう。手順にコメントすると、Codexが直し、あなたが承認するまで待ちます。Claude Codeが書いたプランをCodexにレビューさせることもできます。

Codexの/planでできること

/planコマンドは、Codexをプランモードに切り替えます。Codexはいきなりコードを書き始めず、先に実行プランを提案します。コマンドの後に依頼を書けます。/plan Propose a migration plan for this serviceのようにです。Codexがすでに作業中のときは使えないので、作業の最初に使います。

プランをファイルにすべき理由

プランモードでは、プランはチャットのメッセージとして返ってきます。OpenAIのドキュメントには、プランファイルの記載はありません。チャットのメッセージはレビューしにくいものです。流れていきますし、1つの手順を指し示せず、ほかの人も読めません。

ファイルなら、この3つが解決します。1行にコメントでき、前のバージョンと比べられ、コミットでき、別のエージェントに渡せます。だから、選んだフォルダにファイルとしてプランを頼みましょう。

うまくいくプロンプト

Codexがプランを提案したあと、または同じ依頼の中で、こう伝えます。

Write the plan to plans/<name>.md and send it to me in DotMD for review.

Codexはファイルを書き、DotMDのrequest_reviewを呼び出します。ファイルはサイドバーのNeeds Youに現れ、Codexは待ちます。プランを整形して読み、手順を選んで⌥⌘Mでコメントし、Sendをクリックします。Codexはコメントを受け取ってプランを直し、コメントごとに返します。修正を承認するか再オープンし、問題なければApproveをクリックします。

CodexがコメントをDotMDから読まず、プロジェクト内を探し回るときは、依頼にDotMDと書くか、AGENTS.mdに1行追加します。CLAUDE.mdとAGENTS.mdを参照してください。

Codexを一度だけ接続する

DotMDのSettings → MCPでMCPサーバーをオンにし、DotMDを~/.codex/config.tomlに追加します。

[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600

tool_timeout_secは、読んでいる間Codexを待たせるための設定です。ないと、Codexは約1分で待つのをやめます。追加したらCodexを再起動してください。アプリ、CLI、IDE拡張は設定が共通です。Codexガイドには、アプリでの手順もあります。

CodexがClaude Codeのプランをレビューする(逆も)

2つのエージェントなら、1つより多くのことに気づけます。Claude Codeにプランモードでプランを書かせ、Codexに頼みます。「DotMDでplans/migration.mdをレビューして、納得できない手順にコメントして」。Codexの指摘は、Codex自身の名前で、該当の行に付きます。あなたはそれを残すか、編集するか、削除するかを決め、Claude Codeには残ったものだけが届きます。逆の向きでも同じです。

エージェント同士が直接話すことはありません。やり取りはすべてファイルとそのコメントを通じて行われ、決めるのはあなたです。詳しくはエージェントが別のエージェントをレビューするを参照してください。

Codexのプランで確認すること

プランは直すのが安く、実装は高くつきます。いくつかの問いを頭に置いて、一度読みましょう。

  • 抜けている手順はないか。テスト、マイグレーション、ドキュメント、ロールバック。
  • 順序は正しいか。後の手順の結果を必要とする手順は、プランの誤りです。
  • 範囲は適切か。Codexに触れてほしいと頼んでいないファイルや領域がないか確認します。

指摘は、それが関わる手順へのコメントにして、何を変えるのかを書きます。Codexが見るのはコメントとファイルだけなので、「ここは間違い」よりも「ここは既存のヘルパーを使って」が効きます。DotMDは、頼んでいない変更もOther changesに一覧表示するので、修正が必要以上に広がっていないかも確認できます。

Codexのプランについての質問

Codexはプランをどこに保存しますか?

ファイルではなく、チャットの中です。OpenAIのドキュメントには、プランファイルの記載はありません。選んだファイルにプランを書くようCodexに頼んでください。

CodexはClaude Codeが書いたプランをレビューできますか?

はい。DotMDで行にコメントを残し、Claude Codeがそれを直します。

レビューを待つ間、Codexはトークンを使いますか?

tool_timeout_secを設定していれば使いません。1回のツール呼び出しの中で待ちます。

無料ですか?

DotMDでプランを読むのは無料です。エージェントとのレビューにはDotMD Reviewerが必要です。料金を参照してください。

その他の質問