codex-plugin-ccでClaude CodeとCodexを連携する手順

Claude Code を日常的に使っていると、実装からセルフレビューまで同じ AI モデルに任せる形になり、「もう一つの視点からコードを検証したい」「別 AI に敵対的レビューを依頼したい」というニーズが出てきます。

その課題への OpenAI 側からの回答が、2026 年 3 月に公開された公式プラグイン codex-plugin-cc です。Claude Code のセッションを離れずに OpenAI Codex を呼び出し、コードレビュー・タスク委任・セッション引き継ぎを行える設計になっています。ただし、Review Gate による無限ループや使用量の急消費、Codex CLI 側設定への依存など、事前に把握しておかないと導入後に詰まりやすいポイントも存在します。

さらに、同じ「Claude Code から別 AI CLI を呼ぶ」という発想では、コミュニティ製の Codex Skill や Gemini 版プラグインなどの類似 OSS も存在し、「なぜ他ではなくこれを選ぶのか」という判断軸が必要になります。

本記事では、codex-plugin-cc の概要・8 つのスラッシュコマンド・導入手順・典型ユースケース・類似 OSS との違い・導入前の注意点までを、公式 README とドキュメントに基づいて整理します。動作検証や体験レポートは含まず、archived=false / fork=false の状態にある公式リポジトリを対象に、ドキュメントベースで「自分のプロジェクトに導入すべきか」の判断材料を提供することが本記事のゴールです。

codex-plugin-cc とは？OpenAI 公式プラグインの概要

codex-plugin-cc は、Anthropic の Claude Code から OpenAI Codex を呼び出すための OpenAI 公式プラグインです。README の一文で言えば「Use Codex from Claude Code to review code or delegate tasks.」（Claude Code から Codex を使ってコードレビューやタスク委任を行う）というプロダクトです。公式リポジトリは openai/codex-plugin-cc にあります。

Anthropic のツール内で OpenAI が公式にプラグインを提供している点が本プロジェクトの特徴です。競合ベンダーの CLI に踏み込む形の公式サポートは珍しく、Claude Code ユーザーの既存ワークフローに Codex を組み込むためのハードルを下げる狙いがあります。Claude Code 側のプラグイン配布エコシステム全体の位置づけについては、Anthropic 自身が公開している公式プラグイン集を扱った claude-plugins-official の仕組みと収録基準 も併せて参照すると、codex-plugin-cc がどのような文脈で提供されているかを把握しやすくなります。

リポジトリ基本情報とライセンス

公式リポジトリのメタデータは以下のとおりです（本記事執筆時点、gh api による取得値に基づく）。

公開から約 3.5 か月で 27,000 スター超に到達しており、GitHub 上での注目度は非常に高い水準です。archived=false かつ fork=false の状態で、OpenAI の管理下にあるオリジナルのリポジトリです。ライセンスは Apache-2.0 で、再配布時には同梱されている NOTICE ファイルの保持義務があります。

動作要件と前提環境

README で明示されている動作要件は次のとおりです。

• ChatGPT サブスクリプション（無料プランを含む）または OpenAI API キー
• Codex CLI がインストール済み（未インストール時は /codex:setup から npm 経由で導入可能）
• Node.js 18.18 以降

Codex の呼び出しは ChatGPT サブスクリプションまたは API キーの usage limit にカウントされます。料金体系については OpenAI Codex Pricing で確認できます。

codex-plugin-cc で使える 8 つのスラッシュコマンド

codex-plugin-cc は Claude Code のセッションに 8 つのスラッシュコマンドを追加します。各コマンドの正式な仕様は 公式 README を出典として、以下に用途別で整理します。

レビュー系コマンド（/codex:review と /codex:adversarial-review の違い）

/codex:review は Claude Code の作業ディレクトリの未コミット変更、または --base <ref> で指定したブランチとの差分を Codex にレビューさせます。読み取り専用でコード改変は行いません。--background でバックグラウンド実行、--wait で終了待機ができます。ただし focus text（何を重点的に見てほしいかの自由記述）は渡せません。

一方 /codex:adversarial-review は「なぜこの実装・設計を選んだか」を問う圧力テスト型のレビューです。--base / --wait / --background に加え、focus text を渡せるため、認証・データ損失・ロールバック・レースコンディション・信頼性といった特定リスク領域を集中的に検証する用途に向いています。こちらも読み取り専用です。

Claude Code のセッションで完成させた実装に対して、Codex 側から敵対的な視点でレビューを依頼できるため、「1 つの AI で実装からレビューまで完結させることのバイアス」を軽減する運用が可能になります。

委任・セッション系コマンド（/codex:rescue と /codex:transfer）

/codex:rescue は Codex にタスクを委任するコマンドで、サブエージェント codex:codex-rescue を経由して呼び出されます。バグ調査、修正、Codex の過去タスク継続、より軽量なモデルでの再実行などのユースケースが README で示されています。--background / --wait / --resume / --fresh / --model / --effort のオプションを持ち、--resume を省略した場合は直近の rescue スレッドを継続するかどうかをプラグインが提示する挙動です。モデル指定で「spark」を渡すと gpt-5.3-codex-spark にマッピングされます。「Ask Codex to redesign the database connection to be more resilient.」のように自然言語でタスクを委任できます。

/codex:transfer は Claude Code のセッションから Codex の永続スレッドを作成し、codex resume <session-id> を出力します。この出力を実行することで Codex CLI 側で同じ文脈を継続できる設計です。Claude Code の SessionStart フックで transcript path が自動供給される仕組みになっていて、--source で手動指定も可能です。ソースは ~/.claude/projects 配下に限定されます。Codex 側で外部エージェントセッションインポート機能を使うため、対応していない古い Codex は事前に更新が必要です。

ジョブ管理系コマンド（/codex:status / /codex:result / /codex:cancel）

バックグラウンド実行を前提とした 3 つのコマンドで構成されます。

• /codex:status: バックグラウンドで動作中または直近終了した Codex ジョブを一覧表示
• /codex:result: 終了ジョブの最終出力を表示。セッション ID も表示され、Codex 側で継続可能
• /codex:cancel: 実行中のバックグラウンドジョブをキャンセル

/codex:review --background や /codex:rescue --background で非同期に走らせたジョブを、Claude Code の会話を継続しつつ管理できます。

セットアップ系コマンド（/codex:setup と Review Gate）

/codex:setup は Codex 未インストール時に npm 経由で導入するオプションを提示し、認証確認を行うコマンドです。加えて Review Gate（Stop フック）の有効化・無効化を管理します。

Review Gate を有効化すると、Claude のレスポンスに基づいて Codex にターゲット化レビューを実行させ、問題があれば Stop をブロックして Claude が対処するまで進めなくなる挙動になります。ただし README でも WARNING として明示されているとおり、長時間 Claude / Codex ループを引き起こす可能性があり、usage limit を急速に消費するリスクがあります。本記事後半の注意点セクションであらためて詳述します。

codex-plugin-cc の導入手順と初期設定

導入は Claude Code の Plugin Marketplace 経由で行います。以下は README からの抜粋です。

プラグインのインストール手順

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

（出典: openai/codex-plugin-cc README）

Marketplace 上の名前は openai-codex、プラグイン名は codex です。Marketplace 追加とインストール、/reload-plugins によるリロードの後、/codex:setup を実行することで初期化が走ります。

Codex CLI 側の準備（インストール・ログイン）

Codex CLI が未インストールの場合、/codex:setup が npm 経由での導入を案内します。手動で入れる場合は以下のコマンドが README で示されています。

npm install -g @openai/codex

（出典: openai/codex-plugin-cc README）

Codex にまだログインしていない場合は、Claude Code のセッション内から次のようにログインコマンドを実行できます。

!codex login

（出典: openai/codex-plugin-cc README）

ChatGPT アカウントでのログインまたは API キーによる認証のどちらにも対応します。codex login の詳細な引数・挙動については Codex CLI Reference に公式リファレンスが用意されています。

初回動作確認は次の 3 コマンドで行うことが README で示されています。

/codex:review --background
/codex:status
/codex:result

（出典: openai/codex-plugin-cc README）

Review Gate のオンオフと注意点

/codex:setup から Review Gate の有効化・無効化を切り替えられます。有効化した場合、Claude のレスポンス完了時に Codex 側で自動レビューが走り、問題があれば Stop フックが Claude を止める挙動になります。「AI 二重チェックを自動化したい」という要件にはハマる一方、Claude と Codex が互いに指摘し合うループに入ると、想定を超えた API コール・トークン消費が発生し得る点は事前に把握しておく必要があります。

なお、本記事はドキュメントベースでの整理を目的としており、実際のインストールや動作検証は行っていません。手順の再現性・不具合の有無については、公式リポジトリの Issues を最新の情報源として参照してください（本記事執筆時点で Open Issues は 305 件）。

Claude Code と Codex を連携させる典型ユースケース

codex-plugin-cc は「レビュー用のもう一つの目」だけでなく、タスク委任・セッション引き継ぎまでカバーします。README の記述に基づき、主な使い方を 4 つのフローに整理します。

セルフレビューを Codex に依頼する

もっとも基本的なフローは、Claude Code で実装した変更を /codex:review に渡す形です。バックグラウンド実行と組み合わせると、以下のような流れになります。

1. Claude Code のセッション内で実装作業を進める
2. /codex:review --background を実行して Codex にレビューを依頼
3. /codex:status で進捗を確認しつつ、Claude Code 側の別作業を継続
4. /codex:result でレビュー結果を確認

Claude Code の会話を止めずに、非同期でセカンドオピニオンを得られる点が利点です。

設計判断を敵対的レビューで圧力テストする

「なぜこの API 設計にしたか」「このエラーハンドリングで本当に大丈夫か」といった、設計判断そのものを問い直したい場面では /codex:adversarial-review が有効です。focus text で「認証周り」「データ損失リスク」「並行アクセス時のレース」などのリスク領域を明示して渡せるため、Claude Code だけでは指摘されにくい観点を Codex 側から引き出せます。

長時間タスクを Codex に委任する

Claude Code のセッション主軸から外して Codex に任せたいタスクは /codex:rescue で委任します。バグ調査や修正、より軽量なモデル（--model spark で gpt-5.3-codex-spark を指定するなど）を使った試行、Codex の過去タスクを --resume で継続する運用などが想定されています。--background を組み合わせれば、Claude Code のメインセッションを止めずに調査を並列化できます。

Claude Code のセッションを Codex 側に引き継ぐ

Claude Code の文脈をそのまま Codex 側に持ち出したい場合は /codex:transfer を使います。Codex CLI 側で codex resume <session-id> を実行することで、Claude Code で組み立てたコンテキストを Codex 側の永続スレッドとして継続できます。「Claude Code は短い探索フェーズだけに使い、腰を据えた実装は Codex CLI 側に移す」といった段階的なハンドオフが可能です。

どの場面で Claude Code に留まり、どこから Codex 側に移すかは、扱うタスクの長さ・必要な reasoning effort・使用モデルによって判断することになります。

codex-plugin-cc と類似 OSS の違い

「Claude Code から別 AI CLI を呼ぶ」という発想には類似の OSS がいくつか存在します。ここでは代表例 2 つを比較対象とし、選定判断の材料を整理します。

skills-directory/skill-codex との違い

skills-directory/skill-codex は Claude Code の Agent Skill（プラグインよりも軽量な形式）として提供されるコミュニティ製プロジェクトです。Codex CLI の codex exec やセッション resume 経由で、Claude Code からコード解析・リファクタ・編集を委任する用途に絞られています。

codex-plugin-cc との主な違いは次のとおりです。

• 配布主体: OpenAI 公式 vs コミュニティ製
• 機能範囲: codex-plugin-cc は敵対的レビュー・ジョブ管理・セッション引き継ぎまで持つが、skill 側は単発の委任中心
• モデル選択 UX: skill 側はプロンプト実行時に Claude 側から「どのモデルか」「reasoning effort をどれにするか」を対話的に確認する設計

シンプルに「Codex を単発で呼び出したい」だけであれば skill 側のほうが軽量です。

sakibsadmanshajib/gemini-plugin-cc との違い

sakibsadmanshajib/gemini-plugin-cc は、Claude Code から Google Gemini CLI を呼び出すためのプラグインです。codex-plugin-cc と同じく「Claude Code プラグイン」形式で、コードレビューやタスク委任を目的としています。

主な差分は以下のとおりです。

• 委任先: Gemini CLI（Google 側）
• 配布主体: コミュニティ製（Google 公式ではない）
• 通信レイヤ: ACP（Agent Client Protocol）— JSON-RPC 2.0 を stdio 上で使う設計。永続 broker プロセスで複数コマンドの状態を保持
• 強み: Gemini の長大コンテキスト（100 万トークン級）を Claude Code 側からハンドオフしたい用途に向く
• 弱み: 認証・料金体系は Google 側になる。Codex 特有の adversarial-review 相当のコマンドは持たない

選定の判断軸

「相互レビューを組み込みたい」という同じ目的でも、どこにボトルネックがあるかで選定が変わります。

• Codex 特有の敵対的レビューやジョブ管理まで欲しい → codex-plugin-cc
• 単発の Codex 委任で十分・skill 形式で軽く運用したい → skills-directory/skill-codex
• Gemini の長大コンテキストを活用したい → sakibsadmanshajib/gemini-plugin-cc

「公式サポート」という観点では codex-plugin-cc のみが該当します。CI や社内標準ワークフローに組み込む場合、公式配布であることは意思決定上のプラス要素になり得ます。

codex-plugin-cc を導入する前に知っておきたい注意点

codex-plugin-cc は導入のハードルは高くありませんが、設計上いくつか注意しておくべきポイントがあります。事前に把握しておくと導入後のトラブルを避けやすくなります。

Review Gate の暴走リスクと使用量管理

Review Gate を有効化した場合、Claude のレスポンスに基づいて Codex にターゲット化レビューを実行させ、問題があれば Stop をブロックする挙動になります。この機構は「AI 二重チェックの自動化」に非常に有効な一方、README でも明示的に警告されているとおり、長時間 Claude / Codex ループを引き起こす可能性があり、usage limit を急速に消費するリスクがあります。

Review Gate を有効化する場合は、以下の対応を並行して検討することが推奨されます。

• 検証環境で挙動を確認してから本番運用に組み込む
• ChatGPT サブスクの usage 状況や API のコスト上限アラートを事前に確認する
• 最初は Review Gate を無効化して手動でのレビュー実行から始め、慣れてから有効化を検討する

Codex 側の料金・使用量の考え方は OpenAI Codex Pricing に整理されています。ChatGPT サブスクや Codex CLI の使用量をリアルタイムに可視化する運用面の工夫については、CodexBar による Claude Code・Codex 使用量の可視化 も併せて確認しておくと、Review Gate 導入時のコスト管理を組み立てやすくなります。

ローカル Codex CLI 設定への依存性

codex-plugin-cc は独自ランタイムを持たず、Codex app server をラップしてローカルの codex グローバルバイナリを呼び出す設計です。このため、Codex CLI 側の ~/.codex/config.toml や .codex/config.toml の設定がそのまま適用されます。

これは既存 Codex ユーザーにとっては「認証・設定を引き継げる」という利点になりますが、以下の側面も理解しておく必要があります。

• プロジェクトごとに .codex/config.toml を使い分けている場合、codex-plugin-cc の挙動もプロジェクト間で変わる
• openai_base_url の差し替えなど、Codex CLI 側で行った独自設定はプラグイン経由でもそのまま効く
• 認証状態は Codex 側に依存するため、Codex 側で再認証が必要になった場合はプラグインの動作にも影響する

Codex CLI の設定リファレンスは Codex CLI Reference から辿れます。

ライセンス・メンテナンス状況

ライセンスは Apache-2.0 で、NOTICE ファイルの再配布時保持義務があります。社内で fork して独自機能を追加するような運用を検討する場合は、この点を先に確認しておくと安全です。

メンテナンス状況は 2026 年 3 月の公開から 3.5 か月弱で 27,446 スター・1,777 フォーク・305 Open Issues という規模になっています（本記事執筆時点、repo-meta.json の値）。最新プッシュは 2026-07-08 で、活発に更新が続いています。バージョンごとの変更履歴は CHANGELOG で追跡できます。導入後はこの CHANGELOG を定期的に確認しておくと、破壊的変更や新コマンド追加への追従が容易になります。

まとめ：codex-plugin-cc を選ぶ判断軸

codex-plugin-cc は、Claude Code のセッションを離れずに OpenAI Codex を呼び出せる公式プラグインです。「Claude Code の実装セルフレビュー偏重をどう解消するか」という課題への OpenAI 公式からの回答であり、レビュー・委任・セッション引き継ぎ・ジョブ管理を 8 つのスラッシュコマンドで提供します。

導入を検討したいのは以下のようなケースです。

• Claude Code を主軸としつつ、Codex の敵対的レビューや委任機能をワークフローに組み込みたい
• 実装 AI と独立したレビュー視点（もう一つの AI）を安全に組み込みたいチーム
• 既存の Codex CLI 認証・設定を活かして、CLI 間のオーバーヘッドをゼロにしたい

一方で、以下のようなケースでは別の選択肢を検討する価値があります。

• Gemini の長大コンテキストで大規模コードを一気にハンドオフしたい → コミュニティ製の gemini-plugin-cc を検討
• 単発の Codex 委任で十分・軽量な skill 形式で運用したい → skills-directory/skill-codex を検討
• そもそも Codex を利用する予定がない・OpenAI 側の usage limit を消費したくない → 別 AI CLI 用のプラグインもしくは Claude Code 単体運用の継続

次のアクションとしては、公式リポジトリと README、そして CHANGELOG を確認して現行バージョン v1.0.6 の機能と挙動を最新情報でチェックし、Review Gate は最初は無効化した状態で /codex:review --background からスモールスタートするのが安全なアプローチです。判断材料が揃った段階で、/plugin marketplace add openai/codex-plugin-cc から /codex:setup までの導入手順に進むかを最終決定してください。

参考リンク

• 公式リポジトリ: openai/codex-plugin-cc
• 公式 README: openai/codex-plugin-cc README
• Codex CLI 公式リファレンス: Codex CLI Reference
• Codex 料金・使用量: OpenAI Codex Pricing
• CHANGELOG: plugins/codex/CHANGELOG.md