SECTION 01
Claude CodeからCodexレビューを呼べるようになった——何が変わるのか
OpenAIから、Claude Code上でCodexのコードレビューを直接実行できる公式プラグイン codex-plugin-cc がリリースされました。Apache 2.0ライセンスのオープンソースとして公開されており、誰でもコードを確認できます。
これまで別々のターミナルで動かしていたCodexを、Claude Codeのセッションの中からコマンド一つで呼び出せます。
このプラグインで一番大きいのは、レビュー依頼から結果の受け取り、修正指示までが一本の流れで完結することです。Codex CLIを単独で立ち上げてレビューさせる方法もありますが、結果を見てからClaude Codeに「ここを直して」と頼むまでの動線がつながっていませんでした。
もう一つ安心できるのが、レビュー系のコマンドはすべて読み取り専用という点です。既存のコードに手を加えるリスクがないので、試しに使ってみるハードルが低いです。
さらにバックグラウンド実行に対応しており、レビューを走らせている間もClaude Codeとの会話を続けられます。レビュー待ちで手が止まる、という問題が起きません。
SECTION 02
インストールと初期セットアップ
事前にCodex CLIがインストールされていることが前提です。まだの場合は npm install -g @openai/codex で入ります。Node.js 18.18以降が必要です。
セットアップは以下の4ステップで完了します。すべてClaude Codeのプロンプトにそのまま貼り付けて実行できます。
/plugin marketplace add openai/codex-plugin-cc（マーケットプレイスを追加）/plugin install codex@openai-codex（プラグインをインストール）/reload-plugins（プラグインをリロード）/codex:setup（Codexが使える状態か確認）
/codex:setup を実行すると、Codexのインストール状況と認証ステータスをチェックしてくれます。Codexが未インストールの場合はその場でインストールを提案してくれることもあります。
認証がまだの場合は !codex login でログインします。ChatGPTのサブスクリプション（無料プランを含む）またはOpenAI APIキーがあれば利用できます。
プラグインの詳細なセットアップ手順やソースコードは、GitHubリポジトリ で確認できます。
SECTION 03
/codex:review と /codex:adversarial-review の使い分け
レビューコマンドは2種類あります。/codex:review は保守的に問題点を洗い出す標準レビューで、/codex:adversarial-review は設計や実装の判断に踏み込んで改善案を出す攻撃的レビューです。
使い分けの目安はこうです。
- コミット前の最終チェック →
/codex:reviewで抜け漏れを確認 - 設計に迷いがある機能追加 →
/codex:adversarial-reviewで判断を揺さぶる - まず何を使うか迷ったとき →
/codex:reviewから始めるのが安全
/codex:review は渡されたコードに対して淡々と問題点を指摘します。余計な提案は少なく、変更内容への最終確認として使いやすいです。ブランチ比較をしたいときは --base <ref> オプションも使えます。
一方 /codex:adversarial-review は、トレードオフや障害モードまで踏み込んで疑問を投げかけてくれます。コマンドの後ろにフォーカスしたい観点をテキストで追加できるので、「パフォーマンス面で問題ないか」など方向性を絞ることもできます。
どちらのコマンドも読み取り専用で、コードを変更することはありません。指摘を読んで判断するのはあくまで自分自身です。
SECTION 04
バックグラウンド実行で作業を止めないレビュー運用
実際に使ってみると、レビューにはそれなりの時間がかかります。自分の場合、15ファイルくらいの変更で約10分。同期で待つのは現実的ではないので、バックグラウンド実行が基本になります。
使い方はシンプルで、--background オプションを付けるだけです。
/codex:review --background（バックグラウンドでレビュー開始）/codex:status（実行中のジョブと進捗を確認）/codex:result（完了したジョブの結果を表示）/codex:cancel（実行中のジョブをキャンセル）
バックグラウンドで走らせている間は、Claude Codeとの通常の会話をそのまま続けられます。終わったらClaude Codeが検知してくれるので、意識して張り付く必要もありません。
運用として効果的なのは、回すタイミングをルーティン化することです。コミット前の最終確認、機能追加が一段落したとき、PR作成前など、区切りのいいポイントで自然にレビューを挟むリズムを作ると無理なく続けられます。
SECTION 05
レビュー結果をどう扱うか——自動修正しない設計が良い理由
実際に使ってよかったのは、レビュー結果がいったん返ってくるだけで、Claude Codeが自動的に修正しない設計になっていることです。AIのレビューをそのまま全部適用するのは正直怖いので、この挙動はありがたいです。
たとえば意図的に変更している部分にも指摘が飛んでくることがあります。でもそれをClaude Codeが勝手に元に戻そうとしないので、自分の判断で取捨選択できます。必要なものだけ選んで「これを直して」とClaude Codeに頼む流れです。
この運用が長く使えると感じる理由は明確です。
- 指摘を精査するステップが挟まるので、意図しない変更が起きにくい
- 自分がやった変更の意図を理解しないまま直されると後で困る場面が多い
- レビュー結果をそのまま修正指示に変換できるので手間は最小限
AIレビューを鵜呑みにするフローは、短期的には楽でも長期的には信頼できません。返ってきた結果を自分の目で見て判断するプロセスがあるからこそ、安心して日常に組み込めます。
SECTION 06
一人開発こそAIレビューを組み込むべき理由
これまで多くのサービスを作ってきた中で、プログラミング力が一段上がったと感じた瞬間は、自分より腕のあるプログラマにコードを指摘してもらったときでした。あの体験には大きな価値があります。
ただ、フリーランスや個人開発だとコードレビューの機会は驚くほど少ないです。チーム開発ならPRレビューが当たり前のように回りますが、一人で作っているとその仕組み自体がありません。
Codexはじっくり粘り強く取り組んでくれる性格があり、レビュアーとしての評判がエンジニアの間でも良いです。抜け漏れの確認や設計の見直しに向いていて、試行錯誤の中でレビューはCodex、実装はClaude Codeという使い分けに自然と落ち着きました。
一人開発の場合、意識しないとレビューは永遠にスキップされます。
- コミット前に
/codex:review --backgroundを習慣にする - 機能追加が終わったタイミングで回す
- PR作成前に設計面も含めて
/codex:adversarial-reviewを通す
レビュー文化を自分一人でも作れるのが、このプラグインの実務的な価値だと感じています。第二の目を意図的に確保できる手段として、かなり実用的です。
SECTION 07
英語で返ってくるレビューを日本語にする方法
デフォルトではCodexのレビュー結果は英語で返ってきます。内容の把握やチームへの共有を考えると、日本語のほうが都合がいい場面は多いです。
対応方法はシンプルで、Claude Codeに「レビューを日本語で返して」と頼むだけです。Claude Codeがレビュー用のプロンプトを修正してくれて、次回以降は日本語でレビューが返ってくるようになります。
プラグインの設定ファイルを直接触る必要がないのが楽なポイントです。Claude Codeを通じて調整を依頼できるので、導入後のカスタマイズもハードルが低いです。
Codexの設定は ~/.codex/config.toml（ユーザーレベル）や .codex/config.toml（プロジェクトレベル）で管理されており、プラグインはこの設定を引き継ぎます。モデルの指定やreasoning effortの調整なども同じ仕組みで反映されます。
SECTION 08
補足：/codex:rescue で編集を伴うタスクも依頼できる
レビュー系コマンドは読み取り専用ですが、/codex:rescue は編集を伴う作業もCodexに委任できます。バグの調査、テスト失敗の修正、設計のやり直しなどを自然言語で依頼できます。
代表的な使い方はこのあたりです。
/codex:rescue investigate why the tests started failing（テスト失敗の調査）/codex:rescue fix the failing test with the small model（小さいモデルで高速処理）/codex:rescue --background investigate the flaky test（バックグラウンドで長時間タスク）
rescueはサブエージェントとしてCodexが動く仕組みなので、レビューとは性質が異なります。コードに変更を加える可能性があることを理解した上で使う必要があります。
おすすめの導入順序は、まず読み取り専用のレビューから始めて、慣れてきたらrescueに広げることです。いきなり編集権限を渡すより、Codexの指摘の傾向を掴んでから任せる範囲を広げるほうが安全です。
SECTION 09
実務で回すならこのフローがおすすめ
ここまでの内容を踏まえて、日常の開発に組み込むフローを整理します。ポイントは「回すタイミング」と「結果の扱い方」を決めておくことです。
実装フェーズでの流れはこうなります。
- 機能の実装が一段落したら
/codex:review --backgroundを実行 - その間Claude Codeと別の作業（ドキュメント修正、次のタスクの設計など）を進める
/codex:statusで完了を確認したら/codex:resultで結果を取得- 指摘を読んで、修正が必要なものだけClaude Codeに依頼
設計判断に自信がないときや、複雑なロジックを書いたときは /codex:adversarial-review に切り替えます。「本当にこのアプローチでいいのか」を外部の視点で揺さぶってもらう感覚です。
このプラグインの一番の利点は、ターミナルを複数立ち上げるコンテキストスイッチが不要になることです。ツール間を行き来するコストは地味に重いので、一つの画面で完結する体験は日々の作業効率に直結します。
ChatGPTの無料プランを含むサブスクリプションがあれば使えるので、普段からClaude CodeとCodexの両方を使い分けている方は、まずレビューから試してみる価値があります。
プラグインのソースコードや最新の更新情報は GitHub で確認できます。
