はじめに
2026年4月の GitHub Trending では、Claude Code 周辺のエコシステムと並行して、Codex CLI のエコシステムも急速に立ち上がっている。OpenAI が2025年にオープンソースとしてリリースした Codex CLI は、Claude Code と同様に「AIエージェントをどう運用するか」という課題に直面し、そのエコシステムが拡大している。
拡張レイヤー、CI統合、サブエージェント、ベストプラクティス——Claude Code エコシステムで見られた発展パターンと同じカテゴリが Codex CLI 側でも並行して生まれている点が興味深い。
本記事では、Codex CLI エコシステムを構成する5つの注目リポジトリをカテゴリ別に整理し、それぞれの位置づけと選び方を解説する。
注記: 本記事の情報は2026年4月時点のものであり、各リポジトリの機能・数値は変動する可能性がある。Stars 数は2026年4月13日時点の各リポジトリページに基づく。最新の情報は各リポジトリの README を参照してほしい。
リポジトリ一覧
5つのリポジトリはそれぞれ異なるレイヤー——拡張・CI・サブエージェント・実践知識——を担っており、競合というよりも組み合わせて使う関係にある。
| # | リポジトリ | Stars 規模 | カテゴリ | 一言で言うと |
|---|---|---|---|---|
| 1 | oh-my-codex | ~22k | 拡張レイヤー | hooks / agent teams / HUD による Codex CLI のワークフローエンジン化 |
| 2 | codex-action | ~900 | CI統合 | 公式 GitHub Action(2層構造のセキュリティ制御) |
| 3 | awesome-codex-subagents | ~4k | サブエージェント集 | TOML 定義の特化サブエージェント集 |
| 4 | codex-specialized-subagents | ~59 | サブエージェント基盤 | MCP サーバーで Autopilot/Run/Resume の3ツールによるサブエージェント委任を実現 |
| 5 | codex-cli-best-practice | ~607 | 実践知識 | Tips・ガイド・ワークフロー比較を備えたベストプラクティス集 |
カテゴリ別解説
1. 拡張レイヤー: oh-my-codex
oh-my-codex(以下 OMX)は、Codex CLI の上にワークフロー層を被せる拡張レイヤーだ。本番 npm 依存を3パッケージに絞り、パフォーマンス要求の高い処理を Rust クレートで補完する軽量設計が特徴だ。姉妹プロジェクトの oh-my-claudecode と同じ作者による Codex CLI 版である。
hooks(ネイティブ + プラグインの二重レイヤー)、agent teams(tmux 上での並列実行、Codex / Claude / Gemini の3 CLI 対応)、HUD(リアルタイムステータス表示)の3機能を核とする。ワークフローは $deep-interview(要件の明確化)→ $ralplan(計画の立案・ユーザー承認)→ $ralph / $team(単一 or 並列での実装)という3段階で構成され、$autopilot による自律モードも備える。
MCP サーバー群を内蔵し、ワークフロー状態やプロジェクトメモリを MCP プロトコル経由で提供する。プロジェクト状態は .omx/ ディレクトリに永続化され、CI/CD パイプラインとの統合やチーム間共有が容易だ。
詳細は本シリーズの oh-my-codex入門編、設計判断の比較は 比較記事 を参照
2. CI統合: codex-action
codex-action は OpenAI 公式の GitHub Action で、Codex CLI を CI パイプラインに組み込むための公式アプローチだ。
注目すべき特徴は 2層構造のセキュリティ制御だ。safety-strategy(Action レベルの権限制御: drop-sudo / unprivileged-user / read-only / unsafe の4種)と sandbox(Codex CLI レベルのサンドボックスモード: workspace-write / read-only / danger-full-access の3種)が独立して設定される。safety-strategy が read-only の場合はサンドボックスも強制的に read-only になるなど、安全側に倒す設計だ。
セキュリティ設計のもうひとつの特徴は API キーのプロキシ分離だ。API キーはプロキシプロセスにのみ渡し、Codex プロセスの環境変数からは即座に除去する。認証は OpenAI API に加えて Azure OpenAI にも対応しており、エンタープライズ環境での利用を想定している。
Claude Code 側の claude-code-action が MCP サーバーによるカスタムツール拡張を特徴としているのに対し、codex-action はセキュリティ制御の深さが特徴的だ。
3. サブエージェント集: awesome-codex-subagents
awesome-codex-subagents は、Codex CLI 向けの特化サブエージェントを多数収録したキュレーション集だ。
サブエージェントは TOML ファイルで定義され、モデル割り当て、サンドボックスアクセスレベル、ロール固有の指示を含む標準化された構成になっている。Core Development、Language Specialists、Infrastructure、Quality & Security など10のカテゴリに整理されており、言語別スペシャリストからビジネス・PM 領域まで幅広くカバーしている。
導入は .toml ファイルを ~/.codex/agents/(グローバル)または .codex/agents/(プロジェクト固有)にコピーするだけだ。サブエージェントは自動起動せず、プロンプトで明示的に委任する設計のため、意図しない動作のリスクが低い。
4. サブエージェント基盤: codex-specialized-subagents
codex-specialized-subagents は、Codex CLI 向けのサブエージェント委任機構を提供する MCP サーバーだ。公式 MCP SDK を採用し、Codex 標準のスキルシステム(.codex/skills/)と統合されている。
公開する MCP ツールは3種: delegate_autopilot(タスクの複雑さを判定し scan → implement → verify の3フェーズに自動分解)、delegate_run(単一サブエージェントの実行)、delegate_resume(以前のスレッドの再開)。ルーティングは LLM を使わない軽量なヒューリスティックで、単純なタスクは委任せず複合的なタスクのみをフェーズ分解する。
設計上の注目点は Artifact-first のアプローチだ。各ツール呼び出しがリクエスト・プロンプト・イベントストリーム・構造化出力などのアーティファクトを書き出し、デバッグ性と再現性を確保している。
awesome-codex-subagents が「何を委任するか」のカタログを提供するのに対し、codex-specialized-subagents は「どう委任するか」の実行基盤を提供するという相補関係にある。
5. 実践知識: codex-cli-best-practice
codex-cli-best-practice は、Codex CLI の実践的なベストプラクティス集だ。claude-code-best-practice と同じ作者による Codex CLI 版の運用ノウハウ集である。
このリポジトリの注目すべき特徴は、Claude Code と Codex CLI の双対設計だ。.claude/ と .codex/ が共存し、AGENTS.md と CLAUDE.md が並立している。Claude Code が Command → Agent → Skill のフローを取れるのに対し、Codex CLI は Agent → Skill のみ可能、という差異を明示しており、両ツールの使い分けを検討する際に参考になる。
実践 Tips、設定ガイド、ワークフローフレームワークの比較を収録しており、「小さなタスクには素の Codex のほうが複雑なワークフローより高性能」「AGENTS.md は150行以内に収めよ」といった定量的な指針が実務に直結する。いずれも Research → Plan → Execute → Review → Ship という共通フローに収束する点は、Claude Code 側のベストプラクティスと同じ傾向だ。
目的別ガイド
「チーム開発のワークフローを改善したい」場合:
oh-my-codex を導入し、$deep-interview → $ralplan → $ralph / $team のフローを構築する。Claude / Gemini CLI のワーカーとの混在も可能だ
「CI/CD に Codex を組み込みたい」場合:
codex-action を導入し、drop-sudo をベースにセキュリティ制御を設定する。API キー保護が重要な場合はプロキシ分離アーキテクチャを理解した上で適切な safety-strategy を選択する
「タスク特化のサブエージェントを使いたい」場合:
awesome-codex-subagents から必要なエージェントを選び、.codex/agents/ に配置する。委任の実行基盤が必要な場合は codex-specialized-subagents を検討する
「まず運用ルールを整えたい」場合:
codex-cli-best-practice の Tips とガイドを確認し、AGENTS.md の設計指針(150行目安、実制限は32 KiB)を適用する
Claude Code エコシステムとの対応関係
Codex CLI エコシステムは Claude Code 側と多くのカテゴリで対をなしている。
| カテゴリ | Claude Code 系 | Codex CLI 系 |
|---|---|---|
| 拡張レイヤー | oh-my-claudecode | oh-my-codex |
| CI統合 | claude-code-action | codex-action |
| サブエージェント | Claude サブエージェント機構 | awesome-codex-subagents + codex-specialized-subagents |
| 実践知識 | claude-code-best-practice | codex-cli-best-practice |
この収束は、「AIエージェントの運用設計」という共通課題が両エコシステムに同じ解決パターンを生んでいることを示唆している。両エコシステムの比較と共通トレンドの詳細は本シリーズの Overview 記事を参照してほしい。
まとめ
Codex CLI エコシステムは、Claude Code エコシステムと並行して、拡張レイヤー(oh-my-codex)、CI統合(codex-action)、サブエージェント(awesome-codex-subagents、codex-specialized-subagents)、実践知識(codex-cli-best-practice)と、開発ワークフローの主要レイヤーをカバーする形で立ち上がっている。
TOML ベースのエージェント定義、2層構造のサンドボックス制御、マルチ CLI ワーカー対応(Codex / Claude / Gemini)など、Codex CLI 固有の設計に基づく方向性も見え始めている。自分のチームが使う CLI に合わせてエコシステムを選択し、必要なレイヤーから段階的に導入していくのが実践的なアプローチだ。
参考リンク
- oh-my-codex — Codex CLI 拡張レイヤー
- codex-action — OpenAI 公式 GitHub Action
- awesome-codex-subagents — Codex CLI 向けサブエージェント集
- codex-specialized-subagents — サブエージェント委任 MCP サーバー
- codex-cli-best-practice — Codex CLI ベストプラクティス集
- claude-code-best-practice — Claude Code 版ベストプラクティス集(姉妹リポジトリ)
- claude-code-action — Claude Code 公式 GitHub Action