电视剧《风流才子翻转天》故事梗概
2026-07-29 3432449
2026-07-29 0
这次要聊的主题，是 OpenAI Codex 与 Claude Code 的插件。
可以把 Claude Code 或 Codex 想象成一名助手：起初它只能读代码、改代码和运行命令等基础工作；安装工具包，也就是插件后，助手便能掌握新的技能。
例如：
只需一条命令，Claude 的能力便可得到扩展。实现这一点的 Claude Code 插件，本质是可安装的能力包，其中集中封装了外部工具集成（MCP）、自动化钩子、子 agent 以及一个或多个技能。
插件并非单一功能，而是一个能够容纳多类组件的文件夹：
团队专属开发助手可以由通用 Claude Code 转化而来，关键在于组合使用这些组件。
Claude Code 提供两种扩展方式：
方式一：项目内 .claude/ 配置
直接在项目中创建一个 .claude/ skills、agents、hooks 均置于该目录中。适合：
方式二：插件（Plugin）
将能力打包到一个独立目录，并附带 plugin.json 借助描述文件实现更新、分享与安装。适合：
官方建议是：先在公司项目中使用 .claude/ 进行快速迭代，确认有效后再打包为插件。
许多人不清楚何时该选择插件，其实判断标准并不复杂：
| 场景 | 用 .claude/ 配置 | 用插件 |
|---|---|---|
| 仅供当前项目使用 | ✅ | 没有必要 |
| 个人尝试 | ✅ | 没有必要 |
| 希望在多个项目中复用 | ❌ | ✅ |
| 希望分享给团队 | ❌ | ✅ |
| 需要版本管理及自动更新 | ❌ | ✅ |
| 希望发布至社区市场 | ❌ | ✅ |
简单来说：
.claude/；理解插件是什么以及何时使用后，接下来直接制作一个最简插件。
mkdir my-first-plugin
该目录将作为插件根目录，今后所有插件文件都存放在这里。
创建 .claude-plugin/plugin.json：
mkdir -p my-first-plugin/.claude-plugin
写入：
{"name": "my-first-plugin","description": "一个最简的问候插件","version": "1.0.0","author": {"name": "Your Name"}}
name 它既是插件的唯一标识，也是技能使用的命名空间。
mkdir -p my-first-plugin/skills/hello
在 my-first-plugin/skills/hello/SKILL.md 中写入：
description: 向用户热情地打招呼用温暖、热情的语气问候用户，并问他今天需要什么帮助。
告诉 Claude 该技能要完成什么，是 Skill 核心自然语言指令的作用。
claude --plugin-dir ./my-first-plugin
先进入 Claude Code，再输入：
/my-first-plugin:hello
如果 Claude 对你作出热情回应，就代表插件已经正常运行。
把 SKILL.md 修改为：
description: 用名字向用户打招呼用温暖、热情的语气问候用户 "$ARGUMENTS"，并问他今天需要什么帮助。
然后运行：
/my-first-plugin:hello Alex
随后 Claude 会称呼你的名字进行回应。
plugin.json 必须放到 .claude-plugin/ 下；skills/、agents/、hooks/ 等目录应放在插件根目录，不要放入 .claude-plugin/ 中；/reload-plugins Claude Code 无须退出，执行后便会重新加载。类似的插件系统也被 OpenAI 的 Codex CLI 支持：它与 Claude Code 的设计思路相近，同样使用同一个 SKILL.md + plugin.json 模式，只是调用方式和目录名称略有差异。
Codex 更简便之处在于，它内置了一个 @plugin-creator 技能，能够直接生成插件骨架。下面使用 @plugin-creator 生成相同的「hello」问候插件，并与手动修改得到的文件作对比。
@plugin-creator 生成codex@plugin-creator
根据提示填写插件名，例如 my-codex-plugin。随后 Codex 会自动生成 .codex-plugin/plugin.json 和 skills/ 目录。
plugin.json 修改为 hello 插件{"name": "my-codex-plugin","description": "一个最简的问候插件","version": "1.0.0","author": {"name": "Your Name"}}
在生成的 skills/hello/SKILL.md 里写：
description: 向用户热情地打招呼用温暖、热情的语气问候用户，并问他今天需要什么帮助。
在 Codex 本地市场中加入插件目录：
codex plugin marketplace add ./my-codex-plugin
进入 Codex 后输入：
$hello
如果看到 Codex 热情地回应你，说明插件已经跑通。
把 SKILL.md 修改为：
description: 用名字向用户打招呼用温暖、热情的语气问候用户 "$ARGUMENTS"，并问他今天需要什么帮助。
然后运行：
$hello Alex
Codex 就会称呼你的名字回应。
| 项目 | Claude Code | Codex |
|---|---|---|
| 描述文件所在目录 | .claude-plugin/plugin.json | .codex-plugin/plugin.json |
| 创建方式 | 手动 mkdir + 编写文件 | @plugin-creator 生成插件骨架 |
| 调用 skill | /plugin-name:skill-name | $skill-name |
| 本地加载 | claude --plugin-dir ./my-plugin | codex plugin marketplace add ./my-plugin |
.codex-plugin/ 不要混淆目录与 .claude-plugin/ ；$hello；/plugins 查看状态）。下一篇将全面介绍插件结构，说明 skills、agents、hooks、MCP、LSP、monitors 各自是什么以及何时使用。掌握这些内容后，你便能依据自身工作流设计插件，不再只是跟着文档复制示例。