Codexプラグインとは？Skills・Hooks・MCPとの違いと導入方法

CodexのPlugin（プラグイン）は、再利用したい手順や外部ツール連携、自動検査を、利用者がまとめて導入できる配布パッケージです。Plugin自体が新しい処理方式なのではなく、Skill、MCP Server、Hookなどを束ね、導入・更新・共有しやすくする役割を持ちます。

本記事では、Codex Pluginの役割、Skills・Hooks・MCPとの違い、Codex CLIへの導入、最小構成、安全に使うための確認点を整理します。仕様と対応環境は2026年9月8日時点のOpenAI公式ドキュメントで確認しています。

3行まとめ

• Skillは作業手順、Hookはライフサイクル時の自動処理、MCPは外部能力への接続、Pluginはそれらの配布単位です。
• Codex CLIでは/pluginsからMarketplaceを閲覧し、内容を確認して導入します。導入後は新しいセッションを開始します。
• Plugin同梱Hookは自動的に信頼されません。MCPの認証・操作権限・送信データと合わせて、導入前後に確認が必要です。

Codexプラグインは「機能」ではなく「配布単位」

Pluginを理解する近道は、「何を実行するか」と「どう届けるか」を分けることです。

たとえば、リリース前チェックをCodexへ任せたいとします。確認順序はSkillへ書き、GitHubやSentryを操作する能力はMCP ServerやConnectorから提供し、Tool実行前の禁止条件はHookで検査できます。これらをチームの各メンバーが別々に設定すると、versionや依存関係がずれやすくなります。そこで、関連する構成を一つのPluginとして配布します。

OpenAIのPlugin解説では、PluginにSkills、Connectors、MCP Servers、Browser extensions、Hooks、Scheduled task templatesを含められると説明されています。ただし、すべてを含める必要はありません。Skill一つだけを配る小さなPluginも作れます。

Skills・Hooks・MCP・Pluginの違い

同じ「Codexを拡張する仕組み」でも、責務は異なります。

Skillは「どう進めるか」、MCPは「何を操作できるか」、Hookは「どの時点で自動処理するか」を決めます。Pluginは、それらを利用者へ届ける箱です。

それぞれの作り方や内部構造は、次の記事で詳しく解説しています。

• Codex Skillsの作り方｜繰り返す開発手順をSKILL.mdへまとめる
• Codex Hooks入門｜秘密情報チェックと終了時テストを自動化する
• MCPとは？AIエージェントと外部ツールをつなぐ仕組みを図解

Pluginに同梱できるもの

Pluginは、目的に応じて次の要素を組み合わせられます。

重要なのは、機能を増やすことではなく、一つの利用目的に必要なものだけを束ねることです。会議メモから決定事項を抽出するだけならSkillだけで足ります。そこからGoogle Driveの文書取得やタスク管理serviceへの登録まで扱うなら、MCPやConnectorを組み合わせる理由が生まれます。

どの環境で使えるか

Pluginとstandalone Skillでは、対応範囲が同じではありません。

OpenAI公式資料では、PluginはChatGPTとCodexで共通の公開directoryを使います。一方、Codex IDE extensionはPluginに対応していません。IDE中心で自分だけが使うworkflowなら、standalone Skillの方が単純です。

また、利用できるPluginはaccount、workspace policy、認証方法、対応surfaceによって異なる場合があります。画面や件数を固定情報として覚えるのではなく、実際のPlugin Browserで確認してください。

Codex CLIへPluginを導入する

Codex CLIでは、対話session内からPlugin Browserを開きます。

/plugins

基本の流れは次の通りです。

1. Codex CLIを起動し、/pluginsを実行する。
2. Marketplaceのtabを切り替え、目的に合うPluginを探す。
3. 詳細画面で提供元、説明、Skills、接続先、Hooksなどを確認する。
4. Pluginをinstallする。外部接続が必要なら、表示された認証と権限を確認する。
5. 必要に応じて、install済みPluginの有効・無効を切り替える。
6. 現在のsessionを終了し、新しいsessionを開始する。
7. 通常の依頼文、または利用surfaceのselectorでPluginや同梱Skillを明示し、代表的なtaskを試す。Codex CLIでSkillを指定する場合は$を使う。

Plugin BrowserではMarketplaceごとに一覧を切り替え、詳細確認、install・uninstall、有効・無効の切り替えができます。導入直後のsessionには同梱SkillやToolが反映されないため、新しいsessionで試す点を忘れないでください。selectorの記号や表示はsurfaceで異なるため、Plugin BrowserとSkill一覧に表示される案内を優先します。

検索結果にはOpenAIとは別の第三者Marketplaceやinstallerも表示されます。本記事の/plugins手順はOpenAI公式機能を対象にしています。配布元が異なるcommandを使う場合は、その運営主体、保存先、update方法、削除方法を別途確認してください。

インストール前に確認する5項目

Pluginの便利さは、複数の能力をまとめて導入できる点です。同時に、確認対象もまとめて増えます。

特に外部serviceへ接続するPluginでは、「ログインできる」ことと「その操作を許可してよい」ことは別です。要求scope（権限範囲）を読み、書き込みが不要なら読み取りだけに絞ります。Codex Host上で実行する能力には、そのHostのsandbox（操作範囲を制限する仕組み）とapproval policyも適用されます。

削除にも注意が必要です。公式資料では、Plugin bundleをuninstallしても、同梱Connectorの接続が残り、ChatGPT側で別途管理が必要な場合があると説明されています。導入前に「元へ戻す手順」まで確認しておくと安全です。

skills-only Pluginの最小構成

外部serviceを使わない場合は、manifestとSkillだけで始められます。次は、repositoryのrelease noteを確認する独自例です。

release-review/
├── .codex-plugin/
│   └── plugin.json
└── skills/
    └── release-review/
        └── SKILL.md

plugin.jsonはPluginの入口です。

{
  "name": "release-review",
  "version": "0.1.0",
  "description": "Review a release candidate before publishing",
  "skills": "./skills/"
}

skills/release-review/SKILL.mdには、発火条件とworkflowを書きます。

---
name: release-review
description: Check a release candidate for tests, migration notes, and rollback readiness before publishing.
---

# Release review

1. Read the release diff and test results.
2. Check whether migration and rollback steps are documented.
3. Report blocking issues separately from follow-up improvements.

安定したkebab-case（小文字単語をハイフンでつなぐ形式）のPlugin名を使い、Skillのdescriptionには「いつ使うか」と対象範囲を具体的に書きます。詳しいSkill設計はCodex Skillsの作り方を参照してください。

Plugin同梱HooksとMCPの安全境界

Hookはinstallしただけでは実行されない

Codexは、有効なPluginのrootにあるhooks/hooks.jsonを既定のHook定義として探します。別の場所に置く場合は、.codex-plugin/plugin.jsonのhooksentryでPlugin root内のpathを指定できます。

{
  "name": "release-review",
  "hooks": "./hooks/hooks.json"
}

ただし、Pluginをinstallまたは有効化しただけでは、同梱Hookは信頼済みになりません。Codexは、現在のHook定義を利用者がreviewして信頼するまでskipします。これは、Skillの文章確認だけでは見落としやすい安全境界です。

Hookを信頼する前に、少なくとも次を確認します。

• eventとmatcherが広すぎないか
• 実行commandがPlugin root外の不明なscriptを呼ばないか
• network送信やfile変更などの副作用がないか
• timeoutや失敗時の扱いが定義されているか
• version更新でHook定義が変わっていないか

MCPは認証後もTool Policyを確認する

Plugin同梱MCP Serverは、Plugin側のmanifestから起動・接続されます。利用者側では、PluginごとのMCP Server設定で有効状態やTool Policyを制御できます。

認証に成功しても、すべてのToolを常時許可する必要はありません。読み取り、検索、作成、更新、削除を分け、影響の大きい操作にはapprovalを残します。MCPそのものの構造はMCPとは？AIエージェントと外部ツールをつなぐ仕組みを図解で解説しています。

SkillからPluginへ移行する判断基準

Plugin化は、workflowを書き始めた時点の必須作業ではありません。OpenAIのBuild pluginsも、一つの個人workflowを反復中ならSkillから始め、共有・複数Skillの集約・外部service接続・team配布の段階でPluginを検討する流れを示しています。

迷ったら、最初はSkillにします。利用者が増え、「このSkillと接続設定とHookを同じversionで導入したい」という問題が現れた時点が、Plugin化を考える目安です。

ローカルMarketplaceで作成・検証する流れ

Codexでは、組み込みの$plugin-creatorを使ってPluginの雛形とMarketplace entryを作成できます。

依頼時には、次の情報をまとめて伝えます。

• Plugin名と解決したい問題
• 同梱するSkillやMCP Server
• Hookが必要なら、event、command、副作用
• ローカルMarketplace entryを作るか
• 対応surfaceと想定利用者

共有までの基本flowは次の通りです。

目的を定義
  ↓
$plugin-creatorで雛形を作成
  ↓
plugin.json・Skills・Hooks・MCP権限をreview
  ↓
ローカルMarketplaceへ追加
  ↓
Pluginをinstall
  ↓
新しいsessionで代表taskをtest
  ↓
versionを付けてteamまたは公開directoryへ配布

MCP Serverを含める場合は、先にServerのTool、認証、deployment、error処理を単独でtestし、その接続情報をPluginへ組み込みます。Pluginとしてinstallできたことだけを完成条件にせず、代表的な依頼、拒否すべき依頼、権限不足、接続失敗まで確認します。

よくある勘違いと対処

Pluginを入れれば現在のsessionですぐ使える

同梱SkillやToolは新しいchatまたはCLI sessionから利用します。導入後にCodexを再起動するか、新しいsessionを開始してください。

PluginとSkillはどちらか一方を選ぶ

競合関係ではありません。Skillはworkflowの中身、Pluginはその配布手段です。一つのSkillをPluginに包む構成も成立します。

Pluginを削除すれば外部接続もすべて解除される

Plugin bundleとConnector接続は管理が分かれる場合があります。uninstall後も、ChatGPTの接続管理から不要なConnectorと認証を確認します。

HookはPluginを有効にすれば自動実行される

Plugin同梱Hookには信頼reviewがあります。実行されない場合は、定義が読み込まれているかに加えて、現在のHook定義を信頼したか確認します。

検索で見つけたMarketplaceはすべてOpenAI公式である

公開Plugin Directory、workspaceやprojectのMarketplace、第三者Marketplaceは運営主体と導入方法が異なります。名称だけで判断せず、配布元URL、installer、保存先、権限、更新・削除方法を確認します。

まとめ

Codex Pluginは、Skill、Hook、MCPなどを置き換える仕組みではなく、関連する能力を一つの目的で導入・共有するための配布単位です。

一つのworkflowを試す段階ではstandalone Skillから始め、複数の能力を他者へ安定して届ける必要が生まれたらPluginへ移行します。導入時は/pluginsから詳細を確認し、同梱Skill、MCPの権限、Hookのcommand、配布元、削除方法を確認してください。便利な「一括導入」を、安全な「一括信頼」に変えてしまわないことが、Plugin運用の要点です。

参考資料

• Plugins – OpenAI Docs（2026年9月8日確認）
• Build plugins – OpenAI Docs（2026年9月8日確認）
• Hooks – OpenAI Docs（2026年9月8日確認）
• Agent Skills – OpenAI Docs（2026年9月8日確認）
• Model Context Protocol – OpenAI Docs（2026年9月8日確認）
• ChatGPT & Codex changelog – OpenAI Docs（2026年9月8日確認）