1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【2026年4月】Codex CLI エコシステムの全体像 — GitHub Trendingから読む5つの注目リポジトリ

1
Last updated at Posted at 2026-04-14

はじめに

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-strategyread-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 に合わせてエコシステムを選択し、必要なレイヤーから段階的に導入していくのが実践的なアプローチだ。

参考リンク

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?