Skip to content
catch-all-favorite
Esc
↑↓navigate↵open⌘Jpreview
On this page

同一ホスト内の Claude Code / Codex CLI 間でレビュー依頼・結果受け取りを行う方法 調査レポート

発行日: 2026-08-31（追記 2026-09-01: codex mcp-server の非推奨化を反映） テーマ: 同じマシン上で動く Claude Code 同士、Codex CLI 同士、およびその相互間で、コードレビューを依頼して結果を受け取る方法の整理（公式機能・実験的機能・コミュニティパターンの区別つき） 調査時点のバージョン: Claude Code v2.1.236 / Codex CLI v0.151.0 stable（2026-08-29） 出典: Claude Code Docs / anthropics/claude-code Releases / openai/codex / developers.openai.com/codex ほか（本文中に個別に明記）

TL;DR

  • Claude Code 同士は、v2.1.224（2026-08-07）で入った**クロスセッションメッセージング（ListAgents / SendMessage）**が本命。同一マシン上のセッションを自動発見し、Unix ドメインソケット経由でテキストを送受信できる（Anthropic サーバを経由しないローカル通信）。設定不要で、「セッション B に最新コミットのレビューを頼んで」と言うだけで依頼→返信の往復ができる。
  • Codex CLI 同士は、codex exec review（ヘッドレスレビュー）＋ codex exec resume によるセッション往復が基本。加えて v0.149.0+（実験的）の codex queue で、稼働中の別セッションにメッセージを直接投入できる（ただし返信チャネルは結果ファイル等を自前で決める必要がある）。
  • 相互（Claude ⇄ Codex）で最も堅牢なのはシェル経由の一発呼び出し（Claude が codex exec review を叩く／Codex が claude -p を叩く）。よりリッチな統合は、codex mcp-server が 2026-08-24 付けで非推奨化されたため、後継の Codex app server（codex app-server）か、Claude Code からは公式の Codex plugin for Claude Code（内部で app server を使用）を使う。
  • 共通の注意点: どちらの CLI も exit code はレビューの合否を表さないため判定は必ず出力のパースで行う。レビュー用途では書き込み権限は不要なので、Codex は --sandbox read-only、Claude は --allowedTools Read,Bash,Grep 程度に絞るのが安全。

使い分け早見表

ケース 推奨手段 備考
対話中の Claude Code 2 セッション間 クロスセッションメッセージング（ListAgents / SendMessage） v2.1.224+・設定不要。依頼も返信も自然文で往復できる
スクリプト / CI・構造化出力が欲しい claude -p --output-format json ／ codex exec review --output-schema stdout をパースする前提。毎回新規セッション
Claude から Codex にセカンドオピニオン Bash で codex exec review。常用なら Codex plugin for Claude Code レビューは --sandbox read-only で安全に実行できる
Codex から Claude にレビュー依頼 シェルで claude -p Codex サンドボックスのネットワーク遮断に注意（後述）
稼働中の Codex セッションへ割り込み依頼 codex queue（実験的）＋結果ファイル受け渡し v0.149.0+。返信チャネルは自前で決める必要あり

Ⅰ. Claude Code 同士

クロスセッションメッセージング（公式・推奨、v2.1.224+）

各対話セッションが起動時に所有者限定パーミッションの Unix ドメインソケット（/tmp/cc-socks/<pid>.sock、環境変数 CLAUDE_CODE_MESSAGING_SOCKET）をバインドし、ListAgents ツールで同一マシン上の他セッションを発見、SendMessage ツールでテキストを送受信する。通信は完全にローカルで、同一マシン間のメッセージは Anthropic のサーバを経由しない。設定は不要で自動有効。/list-agents（/peers）でピア一覧を確認できる。

レビュー往復の流れは次のとおり。

  1. セッション A で「セッション B に main〜HEAD のレビューを頼んで」と依頼する（Claude が ListAgents → SendMessage を実行）
  2. セッション B が受信し、/code-review などでレビューを実行する
  3. セッション B が SendMessage で結果を返信し、セッション A に届く

制約:

  • macOS / Linux（WSL2 可）のみ。ネイティブ Windows では利用不可
  • 送れるのはプレーンテキストのみ（会話履歴・ファイル・セッション状態は送れない）。構造化された「レビュー依頼 RPC」はないため、対象ブランチや観点は依頼文に書く運用になる
  • v2.1.236 では SendMessage に notify_when_idle（相手セッションが次にアイドルになったら 1 回だけ通知）が追加され、非同期の受け渡しがしやすくなっている

出典: Cross-Session Messaging（公式ドキュメント）、v2.1.224 リリース

ヘッドレスモード claude -p（公式、全バージョン）

セッション A の Bash から別インスタンスをワンショット起動し、stdout で結果を受け取る。自動化・CI 向けの基本形。

claude -p "main..HEAD の差分をレビューし、findings を JSON で返して" \
  --output-format json --allowedTools Read,Bash,Grep

# --resume <session_id> で同じレビューセッションに追加質問（往復会話）が可能
  • --output-format json で result / session_id / コストを含む構造化出力になる。リアルタイムに読みたい場合は stream-json
  • 毎回新規セッションとして起動する（文脈を引き継ぐには --resume / --continue を明示する）
  • 完了まで stdout はバッファされる

Agent Teams（実験的、v2.1.32+）

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定すると、リードセッションがレビュー担当の「チームメイト」セッションを spawn して並行作業させられる。チームメイト同士もクロスセッションメッセージングで直接やり取りする。ただしチームメイトはリードが生成するものであり、既に独立起動している 2 セッション間の連携には不向き。

出典: Agent Teams（公式ドキュメント）

使いにくい・非推奨の経路

  • claude mcp serve — Claude Code を MCP サーバ化できるが、公開されるのは Read / Bash 等のツールだけ。「考えてレビューする」推論そのものは呼べないため、レビュー依頼用途には不適
  • Hooks — PostToolUse / Stop フックから claude -p を蹴る自動レビューは組めるが、結果を依頼側の推論ループへ戻す仕組みがなく運用が煩雑

Ⅱ. Codex CLI 同士

ヘッドレスレビュー codex exec review（公式・推奨）

TUI の /review と同等のレビューを非対話で実行し、重要度順の findings と verdict を最終メッセージとして出力する。トップレベルの codex review としても実行できる。

codex exec review --base main --sandbox read-only -o /tmp/review.md   # ブランチ差分
codex exec review --uncommitted                                       # 未コミット変更
codex exec review --commit <SHA>                                      # 特定コミット
codex exec review --base main "並行処理とセキュリティ観点を重点的に"    # 指示付き
  • 進捗は stderr、最終メッセージのみ stdout。-o FILE（--output-last-message）でファイルにも書ける
  • exit code はレビュー結果を反映しない（バグ検出でも 0。非 0 は実行自体の失敗）。判定は必ず出力をパースする
  • 早期の提案段階では review base-branch main のような位置引数プリセット構文だったが、出荷されたのはフラグ構文。CI では CLI バージョンを固定するのが安全

出典: openai/codex exec/cli.rs、Codex SDK でコードレビューを構築する Cookbook

セッション往復（resume / fork）

--json（実験的、--experimental-json の別名）で JSONL イベントが stdout に流れ、thread.started イベントからスレッド ID を取れる。これを codex exec resume に渡すと往復会話になる。

tid=$(codex exec --json "main..HEAD をレビューし、指摘に番号を振って" \
      | jq -r 'select(.type=="thread.started").thread_id')
codex exec resume "$tid" "指摘2の具体的なパッチを提案して"

--output-schema schema.json で最終出力を JSON Schema に固定でき、verdict / findings の機械処理に向く。分岐させたい場合は codex exec fork <SESSION_ID>。

セッション間メッセージング codex queue（実験的、v0.149.0+）

稼働中の別セッション（対話・exec 問わず）にユーザーメッセージを投入できる、初の公式セッション間メッセージング。UUID または正確なセッション名で宛先を解決する。

codex queue --thread <uuid-or-name> \
  --message "feature.patch をレビューして結果を /tmp/review.md に書いて"

返信は自動で戻らないため、結果ファイルの置き場所など受け渡し規約を自分で決める必要がある。ほかに collab / Agents v2（spawn_agent / send_input / wait 等のサブエージェントツール、実験フラグ collab）もあるが、これは単一インスタンス内の機能。

出典: openai/codex queue_cmd.rs、codex queue 解説記事

Ⅲ. Claude Code ⇄ Codex の相互レビュー

シェル呼び出し（最も堅牢・一般的）

互いを CLI として一発呼び出しするパターン。もっとも壊れにくく、コミュニティでも支配的。

# Claude → Codex（Claude の Bash ツールから）
codex exec review --base main --sandbox read-only -o /tmp/codex-review.md

# Codex → Claude（Codex のシェルから）
claude -p "このdiffをレビューして: $(git diff main...HEAD)" --output-format json

注意: Codex のサンドボックスは既定でネットワーク遮断のため、Codex 側から claude -p を呼ぶには承認エスカレーションか [sandbox_workspace_write] network_access = true の設定が必要。Codex が「外部サービスへのコード送信」として難色を示す既知の挙動（issue #23211）もある。

MCP / app server 接続

Codex を MCP サーバとして常駐させる従来の codex mcp-server（stdio、codex / codex-reply の 2 ツールを公開）は、2026-08-24 付けで非推奨化された。起動時に「deprecated / 将来のリリースで削除予定」の警告が stderr に出る（警告追加は 2026-08-20 マージ）。当面は動作するが、新規の構成には使わない。

公式の移行先は用途別に 3 つ:

  • Claude Code から Codex を呼ぶ → 公式の Codex plugin for Claude Code（内部で app server を使用）。従来の claude mcp add codex -- codex mcp-server の置き換え
  • 深い統合（認証・会話履歴・承認・ストリームイベントの管理が必要な独自クライアント）→ Codex app server（codex app-server）
  • 自動化・CI のワンショット実行 → Codex SDK（および従来どおりの codex exec 系）

補足:

  • 逆方向（codex mcp add claude-code -- claude mcp serve）は引き続き設定可能だが、Claude 側はツールしか公開されないため、Codex → Claude のレビューは claude -p シェルアウトのほうが実用的
  • 既存の codex mcp-server ベースの構成（ラッパー MCP サーバ含む）は削除前に app server / plugin へ移行しておく

出典: OpenAI Codex changelog（2026-08-24 の非推奨化告知）、openai/codex PR #39657（起動時警告の追加）、Claude ⇄ Codex 双方向 MCP ガイド

ラッパー・スキル類（コミュニティ）

  • レビュー専用ツールを持つラッパー MCP サーバ: tuannvm/codex-mcp-server（uncommitted / branch / commit 対応の review ツール、sessionId によるセッション継続付き）ほか
  • CLI 間ブリッジ: zen-mcp-server の clink（codereview ロール付き）
  • Claude Code 用スキル / プラグインとしてパッケージ化された「Codex にレビューさせる」もの（codex-code-review 等）も複数存在。公式の Codex plugin for Claude Code の登場でラッパーの必要性は下がりつつあり、codex mcp-server ベースのラッパーは非推奨化の影響も受けるため、新規採用は避ける

バージョン・制約まとめ

  • Claude Code のクロスセッションメッセージングは v2.1.224+（2026-08-07）かつ macOS / Linux 限定。ネイティブ Windows は不可
  • Codex CLI の --json・queue・collab / Agents v2・exec-server は実験的扱い。exec review のフラグ構文も比較的最近変わったため、CI では CLI バージョンを固定するのが安全
  • codex mcp-server は 2026-08-24 付けで非推奨（将来のリリースで削除予定）。新規構成は Codex plugin for Claude Code / codex app-server / Codex SDK を使う
  • どちらの CLI も exit code はレビューの合否を表さない。判定は必ず出力（JSON / Markdown）のパースで行う
  • レビュー用途では書き込み権限は不要。Codex は --sandbox read-only、Claude は --allowedTools Read,Bash,Grep 程度に絞ると安全
  • SendMessage / codex queue とも送れるのはテキストのみ。diff 本体は git 参照（ブランチ名・SHA）かファイルパスで渡すのが確実

参考リンク

Was this page helpful?