AIコーディングエージェントの代表格として注目される Codex CLI（OpenAI製）。コードの作成・バグ修正・ファイル操作をAIが自動で行ってくれるターミナルツールです。本記事では、Codex CLIが持つ 主要な拡張機能群——MCP（Model Context Protocol）・Hooks（フック）・Subagents（サブエージェント）・Skills（スキル）・Plugins（プラグイン）——それぞれの役割と、エンジニア初心者にとっての活用方法を解説します。
この記事でわかること
- Codex CLIとは何か、Claude Codeとの正確な違い
- Skills（スキル）で繰り返し作業を自動化する方法
- MCP で GitHub・Slackなどの外部ツールを連携させる仕組み
- Plugins・Hooks・Subagentsによる高度な自動化の実例
- 初心者がどの機能から始めるべきか
Codex（コーデックス）とは？Claude Codeとの違い
Codex CLI は、OpenAI が開発したオープンソースのターミナル型AIコーディングエージェントです。GPTモデルを使い、コードの作成・リファクタリング・デバッグをコマンドライン上で直接実行できます。
よく比較される Claude Code（Anthropic製）とは 別の会社が開発した別のツール です。ただし、Skills・MCP・Hooks・Subagentsなどの概念はオープン標準として両方のツールで共通しており、片方を覚えればもう片方にも応用できます。
| 比較項目 | Codex CLI（OpenAI） | Claude Code（Anthropic） |
|---|---|---|
| 開発元 | OpenAI | Anthropic |
| ベースモデル | GPT-5系 | Claude 4系 |
| Skills対応 | ✅ | ✅ |
| MCP対応 | ✅ | ✅ |
| Hooks対応 | ✅（GA: 2026年4月） | ✅ |
| Subagents対応 | ✅（GA: 2026年3月） | ✅ |
| Plugins対応 | ✅（v0.117.0〜） | ✅ |
Skills・MCP・Plugins・Hooks・SubagentsはAIコーディングエージェント共通の概念。Codex CLIでもClaude Codeでも基本的な使い方は同じです。
Skills（スキル）の仕組みと活用例
最初の基本機能が Skills（スキル） です。
Skillsは、Markdownファイル（SKILL.md）で書かれた 再利用可能なワークフロー指示書 です。「YouTubeの動画をWordPress記事に変換する」「毎週のテスト報告書を作成する」など、繰り返し行う作業の手順をSkillとして保存します。
保存したSkillは、Codex CLI上で $skill-name と入力するだけで呼び出せます。AIが手順通りに自動実行してくれるので、毎回同じプロンプトを手打ちする必要がなくなります。
Skillsの基本的な使い方
- やりたい作業の手順を
SKILL.mdに書く（name・descriptionが必須） - Skillフォルダ（
~/.agents/skills/）に保存 - Codex上で
$skill-nameで呼び出す - AIが手順に従い自動実行
初心者におすすめのSkills活用例
- コードレビュー自動化：レビュー観点をSkillに書いて毎回再利用
- 週次報告書作成：報告書の形式と手順をSkillとして保存
- 動画→記事変換：YouTube動画からブログ記事に変換するワークフロー
Skillsは「AI版の作業マニュアル」。一度書けば何度でも再利用でき、初心者でもMarkdown1ファイルから始められます。自作が難しい場合は $skill-creator で自動生成できます。
MCPで外部ツールを連携させる方法
MCP（Model Context Protocol） は、AIエージェントと外部ツールを接続するための 業界標準のオープンプロトコル です。Anthropicが策定し、OpenAI・Googleなど業界全体が採用しています。
一言で言うと「AIと外部ツール間の共通言語」です。MCPを使うと、Codex CLIがSlack・GitHub・Jira・Notionなどの外部サービスに直接アクセスし、情報を取得したり操作したりできるようになります。
MCPでできること（具体例）
- GitHubと連携：Pull Requestの内容を読み込んで自動レビュー
- Slackと連携：特定チャンネルのメッセージを読んでコードに反映
- Supabaseと連携：DBスキーマを読み取りながらバックエンドコードを修正
- ブラウザと連携：Playwright MCPでWebページをスクレイピング・操作
MCP接続の設定方法
MCPサーバーの追加はコマンド一つで行えます。例えばPlaywrightでブラウザ操作を追加する場合：
codex mcp add playwright npx @playwright/mcp@latest接続状況は /mcp コマンドで確認できます。接続済みのMCPサーバーとトークンコストの一覧が表示されます。
注意： MCP経由で外部ツールに接続する際は権限設定に注意。初回は必ずテスト環境と低権限アカウントから始めましょう。特にデータベース系MCPは誤操作でデータを削除してしまう可能性があります。
MCPは「AIと外部ツール間の翻訳者」。一度設定すれば、AIがどんなツールの情報でも理解・操作できるようになります。
Pluginsで複数機能をひとまとめにする
Plugins（プラグイン） は、Skills・MCP設定・Hooks・Subagentsなどの複数機能を 1つのパッケージにまとめて配布できる仕組み です。Codex CLI v0.117.0で正式リリースされました。
わかりやすい例えで言うと：Skillは「レシピ」、PluginはそのレシピCに加えて「調理道具と材料と調理許可証をセットにしたキッチン全体」です。ユーザーはインストールするだけで複雑なワークフロー一式が使えます。
SkillsとPluginsの使い分け
| 比較項目 | Skills | Plugins |
|---|---|---|
| 定義ファイル | SKILL.md のみ | plugin.json ＋ 複数ファイル |
| 外部ツール連携 | なし | MCP設定を同梱可 |
| 複数機能統合 | 単体機能 | Skills＋MCP＋Hooks＋Subagents |
| 配布・再利用 | 個人・チーム向け | マーケットプレイスで公開可能 |
Pluginsの入手・作成方法
既存プラグインはターミナル内の /plugins コマンドから検索・インストールできます。自作する場合は、組み込みの @plugin-creator スキルを使うと最速で始められます。
Pluginsは「インストール一発で全機能が使えるセット商品」。まずは公開済みのプラグインを使い、慣れてきたら自作に挑戦しましょう。
Hooksでワークフローを自動化する
Hooks（フック） は、「特定のイベントが起きたとき、自動的にスクリプトを実行する」仕組みです。Gitフックと同じ考え方で、「ファイルを編集したらLinterを走らせる」「コマンドを実行する前に危険チェックをする」といったことが自動化できます。
Codex CLI では v0.124.0（2026年4月）からHooksエンジンが安定版（GA）になりました。v0.129.0以降はターミナル内で /hooks コマンドを実行すると、利用可能なHooksの一覧と有効・無効の切り替えができます。
Hooksの主なトリガーイベント
| イベント名 | 発火タイミング | 活用例 |
|---|---|---|
| PreToolUse | ツール実行前 | 危険なコマンドのブロック |
| PostToolUse | ツール実行後 | Linter・フォーマット自動実行 |
| SessionStart | セッション開始時 | 環境チェック・通知 |
| Stop | セッション終了時 | Slack通知・ログ記録 |
| FileChanged | ファイル変更後 | テスト自動実行 |
SkillsとHooksの違い
混同されやすいSkillsとHooksの違いは明確です。Skillsは「AIが判断して適用する指示書」で、AIがSkillの内容を読んで実行します。一方 Hooksは「イベント発火時に必ず実行されるスクリプト」で、AIの判断を介しません。
重要： Hooksはプロンプト指示と違い「必ず実行される」強制力があります。CLAUDE.mdやAgents.mdに「○○しないで」と書いてもAIは従わないことがありますが、Hooksで設定したブロックは確実に動作します。セキュリティルールはHooksで設定しましょう。
Hooksは「開発ワークフローの自動検証ゲート」。人手を介さず品質基準を強制できる、最も確実な自動化手段です。
Subagentsで複数のAIエージェントを連携させる
Subagents（サブエージェント） は、複数の専門化されたAIエージェントが 並列で同時に働く 仕組みです。Codex CLIでは2026年3月（v0.115.0）に正式GA版がリリースされました。
例えば「コードレビューをしたい」という場面で：「コード品質チェック」担当・「セキュリティスキャン」担当・「パフォーマンス確認」担当の3つのエージェントが同時並列で動き、結果をまとめて返してくれます。
Subagentsの主な特徴
- 独立したコンテキスト：各エージェントが独自のメモリを持ち、互いに干渉しない
- 並列実行：複数エージェントが同時に処理するため時間短縮
- 明示的な起動：ユーザーが明示的に指示した場合のみ起動（自動暴走なし）
- カスタム定義：TOMLまたはMarkdownでエージェントの役割・モデル・権限を細かく設定可能
カスタムサブエージェントの定義例
プロジェクト固有のサブエージェントは .codex/agents/ 配下のTOMLファイルで定義します：
name = "reviewer"
description = "コードレビュー専門エージェント"
sandbox_mode = "read-only"
model = "gpt-5.3-codex-spark"注意： Subagentsは並列で複数モデルを動かすため、単一エージェントより多くのトークンを消費します。最大スレッド数を max_threads = 6 で制限するなど、コスト管理に注意しましょう。
Subagentsは「役割分担したAIチーム」。複数のエージェントが専門分野を並列処理することで、品質と速度を両立できます。
5つの機能を組み合わせた実務活用パターン
5つの機能を個別に使うだけでなく、組み合わせることでさらに強力なワークフローが実現します。
パターン1：テスト自動化（Skills + Hooks）
- 開発者がファイルを編集
- Hooks（PostToolUse）がファイル変更を検知
- 「テスト実行」Skillが自動起動
- テスト失敗 → Hooks経由でSlack通知を自動送信
パターン2：自動コードレビュー（MCP + Subagents）
- GitHub に Pull Request を作成
- MCP がGitHub PRの内容を取得
- 3つのSubagentsが並列動作：コード品質・セキュリティ・パフォーマンスをそれぞれ確認
- MCP 経由でPRにレビューコメントを自動投稿
パターン3：Pluginでワークフロー一括配布
「YouTube動画 → WordPress記事自動生成」プラグインの例：
- Skill：動画情報取得→記事構成→HTML生成の手順
- MCP：YouTube API・WordPress REST APIとの連携設定
- Hooks：投稿前の品質チェック・画像検証
- Subagents：記事作成・画像生成・事実確認を並列処理
これらをPluginにまとめて配布すれば、チームメンバーはインストール一発で全機能が使えます。
初心者が始めるべき優先順位
5つの機能があると「何から始めればいい？」と迷うかもしれません。以下の順で学ぶと無理なくステップアップできます：
- Skills：Markdownで簡単な手順を書いて再利用する感覚を掴む
- Hooks：イベントトリガーと自動実行の基本を理解する
- MCP：GitHubなど使い慣れたツールとの連携から始める
- Subagents：複数エージェント設計を学ぶ（中級者向け）
- Plugins：作成した機能をパッケージ化して共有する（上級者向け）
Codex公式ドキュメントとGitHubコミュニティには、すぐに使えるSkillsやPluginsが多数公開されています。まずは既存のものを使い、コードを読みながら学ぶのが最短ルートです。
まとめ：Codex CLIを使いこなすための機能ガイド
本記事では、Codex（コーデックス）で最初に覚えるべき5つの基本機能を解説しました。
| 機能名 | 役割 | 初心者向けの活用例 |
|---|---|---|
| Skills | 再利用可能なワークフロー指示書 | 「毎回同じ手順」をMarkdownに保存して再利用 |
| MCP | 外部ツール連携の業界標準規格 | GitHub・Slackなど既存ツールとシームレスに連携 |
| Plugins | Skills＋MCP＋Hooksのセット | 便利なワークフロー丸ごとインストール |
| Hooks | イベント発火時の強制自動実行 | テスト・検証・通知を確実に自動化 |
| Subagents | 複数AIエージェントの並列実行 | 実装・レビュー・チェックを同時処理 |
まずは Skillsで小さな自動化 から始めましょう。慣れてきたらHooks、MCP、Subagentsへと拡張していくと、自然と全機能を使いこなせるようになります。
よくある質問（FAQ）
Q1. Codex CLI とClaude Codeはどっちを使えばいいですか？
どちらも優れたツールです。OpenAIのGPTモデルを普段使っているならCodex CLI、AnthropicのClaudeモデルを使っているならClaude Codeがスムーズです。SkillsやMCPなどの概念は共通なので、片方を覚えればもう片方にも応用できます。
Q2. MCPを設定するのは難しいですか？
基本的な設定は数行のコマンドだけで完了します。最初はGitHubやSlackのような公式対応ツールから始めると設定ミスも少なく安心です。公式ドキュメント（developers.openai.com/codex）に豊富なサンプルがあります。
Q3. SkillsとPluginsはどう使い分けますか？
「1つの作業手順を保存したい」→ Skills、「複数の機能（MCP設定を含む）をまとめてチームに配布したい」→ Pluginsが適切です。最初はSkillsから始め、複雑化したらPluginsにまとめましょう。
Q4. HooksとSkillsはどう違うのですか？
Skillsは「AIが読んで判断・実行する指示書」で、AIの判断が介在します。一方Hooksは「特定イベント発生時に必ず実行されるスクリプト」で、AIの判断なしに強制実行されます。セキュリティルールなどはHooksで設定する方が確実です。
Q5. Subagentsはどのくらいのコストがかかりますか？
Subagentsは並列で複数モデルを動かすため、単一エージェントより多くのトークン（API利用料）を消費します。設定ファイルで max_threads = 6 のように最大スレッド数を制限できます。複雑なタスクには効果的ですが、費用対効果を考えて使用しましょう。
本記事の情報は 2026年5月17日時点の公開情報に基づいています。Codex CLIの仕様は頻繁に更新されるため、最新情報は公式ドキュメントをご確認ください。