「Codex 插件」「Claude 插件」搜出来一堆文章,越看越糊涂,多半是因为三个词被混着用:插件、技能、MCP。这篇先把三者分清,再把两家各自的「去哪找、怎么装、装完怎么用」按官方文档写全。事实只出自两处:OpenAI 开发者文档(developers.openai.com)与 Anthropic 官方文档、官方仓库 anthropics/skills(GitHub 实时 196,728 星,本站核对日期 2026-11-18)。

先分清三个词(两家通用)

词 是什么 打个比方
技能(Skill) 一个文件夹,核心是一份 SKILL.md:写清这个活的名字、什么时候用、正文步骤。可附脚本、参考资料、素材 一张写好的岗位操作卡
插件(Plugin) 可安装的分发单元:把一个或多个技能,连同 MCP 配置、应用连接打包成一个可安装的整体 把几张操作卡装订成一本手册发给别人
MCP 让 AI 连接外部工具与数据的协议接口,管的是「能碰到哪些系统」 手册里要用到的那台设备的插头标准

一个关键事实:两家的技能都基于开放的 Agent Skills 标准,核心文件都叫 SKILL.md,都只要求 name 与 description 两个字段起步。但两家的加载目录、插件清单格式和安装命令各不相同,从一家抄来的现成包不要直接塞给另一家,先按目标家的文档对一遍结构。

Claude 这边:市场(marketplace)是入口

去哪找

  1. 官方市场 claude-plugins-official:Claude Code 第一次启动交互会话时会自动添加,里面是 Anthropic 官方与合作方的插件。
  2. 官方技能仓库 anthropics/skills:Anthropic 官方的技能示例库,创意设计、开发技术、企业沟通、文档处理四类,仓库里的文档技能(docx、pdf、pptx、xlsx)就是 Claude 文档能力背后的同款,本站有逐篇中文教程(见文末)。仓库声明多数技能为 Apache-2.0 许可证。
  3. claude.ai 网页与桌面端:从「Customize > Plugins」进插件页,Discover 里是可添加的插件,添加后按账号同步到 Claude Code 与 Cowork,不用重复装。

怎么装(Claude Code,以官方文档为准)

  1. 在 Claude Code 会话里输入 /plugin,在 Discover 标签里选插件安装——这是最省事的路。
  2. 装官方技能库:在会话里运行 /plugin marketplace add anthropics/skills,把该仓库注册成一个市场。
  3. 再运行 /plugin install document-skills@anthropic-agent-skills(文档技能包)或 /plugin install example-skills@anthropic-agent-skills(示例技能包)。
  4. 装完不用背命令:直接在对话里提这个活,例如「用 PDF 技能把这个文件里的表单字段提取出来」,Claude 会按技能的说明去做。

自己写一个技能

一个文件夹加一份 SKILL.md 就行:文件头写 name(小写、连字符)和 description(说清干什么、何时用),正文写步骤、例子和注意事项。官方仓库里有 template 模板目录,照着改最稳。

Codex 这边:技能直接装,插件是分发形态

去哪找

  1. 插件目录:ChatGPT 与 Codex 共用同一个通用插件目录(universal plugin directory),在 Codex App 的 Plugins 标签里浏览、搜索、安装。
  2. 官方技能仓库 openai/skills:Codex 内置的技能安装器就从这里取精选技能,也能让它去别的仓库取。

怎么装(以官方文档为准)

  1. 装现成技能:在 Codex 里用内置安装器,例如输入 $skill-installer linear,就把名为 linear 的技能装进本地。
  2. 装插件:在 Codex App 的 Plugins 标签里找到插件,点加号安装;插件里若带需要连接的服务,按提示完成连接后新开一个会话使用。
  3. 自己造技能:用内置的技能创建器,输入 $skill-creator,把目标说清,它会帮你起草 SKILL.md;也可以手工建文件夹,SKILL.md 的文件头同样只要 name 与 description 起步。
  4. 要把自己的技能发给别人用,官方建议打包成插件:一个插件可以装多个技能,还能带上 MCP 配置和应用映射。

国内使用:先把预期放对

  • Claude:官方服务有地区限制,中国大陆不在支持范围内,账号注册与使用条件以 Anthropic 官方说明为准;不要用自己的重要账号去试来路不明的注册渠道。国内能直接用的替代路线,是把「技能」这个方法搬到国产客户端上——本站的 AI技能栏目 就是按这个思路做的:同一套 SKILL.md 方法,配国内能用的客户端逐个写了安装步骤。
  • Codex:客户端与账号的可用性以 OpenAI 官方说明为准;技能文件本身只是文本与脚本,写好后不依赖某一家平台,换客户端时按对方的目录规范放好即可。
  • GitHub 访问:上面两个官方仓库都在 GitHub 上,网络不通时先解决仓库访问再谈安装,不要从不明镜像站下载技能包——技能里可以带脚本,来源不明等于让陌生代码在自己电脑上跑。

优缺点(按官方文档与仓库事实)

优点:两家的技能格式同源(SKILL.md+name/description),学会一家的写法,另一家的概念成本很低;官方仓库都是现成可学的样本,Claude 侧的 anthropics/skills 多数技能是 Apache-2.0,拿来改自己的版本有明确的许可证依据;插件把「装一堆东西」变成「装一个包」,分发和上手都更省事。

缺点与边界:两家的插件清单与加载路径不通用,现成包不能直接互搬;插件能带脚本和钩子,装第三方市场的东西等于运行别人的代码,官方文档也提示只从可信来源添加;Claude 侧对国内用户还有地区限制这一道硬门槛。

玩法:把每周重复交代的话,做成你的第一个技能

模拟一位每周写周报的职场人:卡点不是不会写,而是每周都要对 AI 重新交代一遍格式、口径和禁忌,交代漏了就返工。按技能的思路一次解决:

  1. 把交代的话写成一份 SKILL.md:name 写 weekly-report,description 写「把零散工作记录整理成公司周报格式时使用」,正文写死三件事——固定小标题顺序、每条记录的写法(做了什么+结果)、禁用词清单。
  2. 把这份文件放进你所用客户端的技能目录(Claude 侧走 /plugin 安装或技能上传,Codex 侧放进它的技能加载目录,具体路径以各自官方文档为准)。
  3. 以后每周只丢记录原文,说一句「用周报技能整理」,格式口径自动对齐——省下的不是打字时间,是返工和重复交代。

本站有一篇现成的同题技能文可以对照着学:skill-creator:把你的做法做成自己的技能;文档四件套的中文教程:docx、pptx、xlsx。

避坑清单

  • 装插件前先看它包含什么:技能、MCP、钩子都会随插件一起进来,官方在安装界面会列明细,别一路点确认。
  • 第三方市场(非官方名录)的插件没有经过官方审核,装之前先打开仓库看 SKILL.md 和脚本内容,看不懂的先别装。
  • 技能不生效,先查两件事:文件是不是叫 SKILL.md、文件头的 name/description 有没有写全——官方文档里这两个字段是必填。
  • 同一个活装了多个来源不明的技能,容易互相打架;一个活只留一个主力技能。

常见问题

插件和技能,我到底该装哪个?拿现成的用:有插件包就装插件(一次到位);只有单个工作流需求,就装单个技能。自己写:先写技能,要发给别人时再打包成插件。

两家的技能能互通吗?核心的 SKILL.md 写法同源,但目录、清单和命令不同,迁移时按目标家的官方文档逐项对,不要整包硬塞。

完全不会代码能写技能吗?能。技能的本体是写给 AI 看的说明书,Codex 的 $skill-creator 和 Claude 官方模板都是为「先把话说清」设计的;带脚本的进阶玩法再慢慢加。

本站往下读:AI插件栏目、AI智能体栏目、AI技能栏目。装不上、配不通的,可以看本站的配置跑通服务。