Claude Plugins Official

这是什么？适合谁？

Claude Plugins Official 是 Anthropic 官方维护的 Claude Code 插件目录（Plugin Marketplace），GitHub 仓库地址 anthropics/claude-plugins-official。它把分散在社区里的 Claude Code 插件集中到一个可发现、可安装、可版本管理的入口里。一个插件（Plugin）在 Claude Code 里是一个”能力包”，可以同时打包 MCP 服务器（.mcp.json）、斜杠命令（commands/）、子 Agent（agents/）和 Skills（skills/），安装后直接在 Claude Code 里被 /plugin 和 /agents 发现使用。

这个目录分两层：/plugins 目录放 Anthropic 官方团队自己开发维护的内部插件，/external_plugins 目录放经过审核的第三方与合作伙伴插件。第三方插件要进目录，必须通过质量与安全标准审核，并填写官方提交表单。这种”官方背书 + 审核准入”的机制，是它区别于纯社区聚合列表的核心价值。

适合谁：正在用 Claude Code 做日常开发、想把浏览器自动化、GitHub/线性任务管理、消息通道（Telegram/iMessage）、企业协作（M365/Asana）等能力”即插即用”接进工作流的开发者；以及想把自己的内部工具或 Skills 打包成插件、对外分发或对内私有复用的团队。对只想要”一个 MCP server 列表”的用户，它可能略显重——那种场景用 Smithery 或 mcp.so 这类纯 MCP 注册中心更轻。和社区精选列表如 awesome-claude-code 相比，本目录的优势是官方审核 + 与 Claude Code 插件系统深度集成（自动版本同步、改名迁移）；劣势是收录范围更克制，不如社区列表包罗万象。

使用前提：需要已经安装并登录 Claude Code；安装插件本身不需要额外 API Key，但某些插件（如 M365、Telegram、Asana 连接器）会要求你自己的账号授权或 Token。对插件开发者，还需要理解 .claude-plugin/plugin.json 的 manifest 结构。

一句话总结：如果你把 Claude Code 当主力开发环境，Claude Plugins Official 就是它的”官方应用商店”。

准备工作

1. 安装 Claude Code。macOS/Linux/WSL 可用官方脚本 curl -fsSL https://claude.ai/install.sh | bash，或通过 npm npm install -g @anthropic-ai/claude-code；Windows 走 WSL 或原生安装包。登录 claude 命令完成认证。这是硬前提——目录本身没有独立运行时。

2. 系统要求。目录本身只是一个 Git 仓库 + Claude Code 的 marketplace 元数据，无额外运行时依赖；真正的环境要求取决于你安装的插件（例如 MCP 服务器插件可能需要 Node.js 18+ 或 Python 3.10+）。仓库主语言为 Python，仅供提交/开发插件时参考。

3. 获取方式。目录已作为默认 marketplace 内置在 Claude Code 里，通常无需手动克隆仓库；只有开发/提交插件时才需要 git clone https://github.com/anthropics/claude-plugins-official。官方文档在 code.claude.com/docs/en/plugins。

4. API 密钥来源。安装目录本身不需要密钥；但若安装的插件对接第三方服务（M365、Telegram Bot、Asana、GitHub 等），需自行到对应平台申请 Token/密钥，并在插件配置里填入。Anthropic 官方明确声明：它不控制插件内置的 MCP 服务器或文件，也无法验证它们是否按预期工作。

5. 替代方案。如果只是想快速找一个 MCP server：用 Smithery、mcp.so 或官方 MCP servers 仓库；如果想按”技能包”补充能力：直接找社区 Skills 集合（如 obra/superpowers）。如果你不需要 Claude Code 的插件系统，只想手动接 MCP，可在 ~/.claude.json 里直接配 mcpServers。

快速上手（4 步）

第一步：打开插件面板

在 Claude Code 交互界面里输入：

/plugin

预期结果：进入插件面板，能看到 Discover（发现）、已安装插件、marketplace 列表等选项卡；官方目录 claude-plugins-official 应已默认出现在 marketplace 列表中。

第二步：安装一个插件

浏览 Discover 找到想装的插件，或直接用命令安装（以官方 example 演示插件为例，实际替换成真实插件名）：

/plugin install example-plugin@claude-plugins-official

预期结果：Claude Code 拉取插件 manifest，把 MCP 服务器、命令、Agent、Skills 注册进当前环境。

第三步：刷新并验证

/reload-plugins

预期结果：插件变更立即生效；此时插件带来的斜杠命令（/ 菜单）和子 Agent（/agents）应可见。如果装了 MCP 插件，可在 /mcp 里看到对应服务器已连接。

第四步：运行插件的第一个能力

根据插件类型调用它的命令，例如某个带斜杠命令的插件安装后直接输入：

/<插件提供的斜杠命令>

预期结果：命令正常执行并返回结果，说明插件端到端跑通。安装前建议先点开插件的 homepage/README 确认它做了什么、需要哪些权限。

常见踩坑

踩坑 1：手动”添加”官方目录报错，提示 cannot add

• 现象：执行 /plugin marketplace add anthropics/claude-plugins-official 时报错或失败（GitHub issue #587 有多人反馈）。
• 原因：claude-plugins-official 是 Claude Code 的默认内置 marketplace，不需要也不应该再手动 add，重复添加会冲突。
• 解决：直接 /plugin 看 Discover；确认你的 Claude Code 版本足够新（插件系统为较新版本引入），过旧则先升级 Claude Code。

踩坑 2：插件提交后显示”Published”但目录里搜不到

• 现象：在提交门户看到状态是 Published，但 /plugin Discover 里找不到自己的插件（issue #984、#997）。
• 原因：提交门户状态与 marketplace 实际同步之间存在延迟，或插件尚在最终审核/索引阶段。
• 解决：确认已收到正式通过通知；等待同步（通常以小时到天计）；仍无结果则在仓库 issue 区反馈并附上插件名与提交时间。

踩坑 3：企业 M365 连接器被”访问策略拦截”

• 现象：安装 M365 Connector 后报 “Your organization’s access policy blocks the MCP server”，即使管理员已授权（issue #1494）。
• 原因：Microsoft Entra ID（Azure AD）的条件访问策略或 MCP 服务端策略在企业租户层拦截了连接，管理员的应用同意授权并不能绕过策略。
• 解决：由租户管理员在条件访问/服务策略中放行该 MCP 服务，或先用个人开发者租户验证连通性，再推广到企业租户。

踩坑 4：Telegram 插件多实例 409 冲突、消息静默丢失

• 现象：同一 Telegram 插件在多台机器/多个 Claude Code 实例同时运行时，出现 409 冲突，部分消息被静默丢弃（issue #1075）。
• 原因：Telegram Bot 的长轮询（getUpdates）同一 token 只允许一个消费者，多实例争抢导致消息被”抢走”或冲突。
• 解决：每个实例使用独立的 Bot token，或停掉重复运行的实例，只保留一个消费者。

踩坑 5：iMessage 插件收不到消息 / 回复报 AppleScript -1728

• 现象：macOS 上 iMessage 插件实时监听收不到消息，或对用 email 身份的自聊回复时报 AppleScript 错误 -1728（issue #1037、#1012）。
• 原因：macOS 存储 chat 的 GUID 前缀会因账户类型变化（如 any;-; 而非 iMessage;-;），插件旧版本监听逻辑未覆盖；自聊若用 email 身份而非手机号也会触发。
• 解决：更新插件到已修复版本；问题仍存在时到对应插件仓库报 issue 并附上 macOS 版本与 chat GUID 前缀。

踩坑 6：Asana MCP 创建任务失败

• 现象：create_task 调用失效，或迁移到 V2 端点被 OAuth 不兼容挡住（issue #998）。
• 原因：Asana 上游把 create_task 从 V1 SSE 端点静默移除，V2 端点又与现有 OAuth 流程不兼容，属于上游 API 变更。
• 解决：迁移到 Asana 推荐的 V2 端点，或改用 REST API 走自定义 MCP；跟进 Asana 官方的迁移说明。

踩坑 7：改了插件名导致用户端 plugin-not-found

• 现象：插件发布后改名，已安装用户升级时报 plugin-not-found。
• 原因：marketplace 条目的 name 是不可变 slug（README 明确说明），用户是按旧 slug 安装的，改名即断链。
• 解决：改名用 displayName 字段而不是 name；确需改名，在 .claude-plugin/marketplace.json 顶层 renames map 里加 "旧名": "新名" 让旧安装自动迁移。

初级用法

1. 装一个 GitHub MCP 插件：让 Claude Code 直接读 Issue/PR/仓库文件，代替手动复制粘贴上下文。
2. 装一个 Skill 类插件：例如打包了代码审查或调试技巧的 Skills 插件，装完 /agents 里会出现对应能力。
3. 装一个消息通道插件（Telegram/iMessage）：把 Claude Code 变成可远程触发的助手，用手机发消息即可派活。
4. 浏览 Discover 按需发现：每次 /plugin 的 Discover 页会展示最新收录的官方与第三方插件，作为”今天又多了什么能力”的信息源。
5. 管理已装插件：在 /plugin 面板里更新、禁用、卸载，保持环境干净。

高级玩法

1. 提交自己的插件进目录：按 /plugins/example-plugin 参考实现写好 manifest，走提交表单申请，通过安全审核后对外分发。
2. 做 Skill-bundle 插件：源仓库只有 SKILL.md 没有 manifest 时，用 strict: false + 显式 skills 数组把多个 skill 打包成一个插件，按 <plugin>:<skill> 注册。
3. 用 renames map 做无痛改名：在 marketplace.json 里配置 renames，让已安装用户下次 sync 时自动把旧 slug 重写到新 slug。
4. 搭企业私有 marketplace：把插件元数据托管到内部 Git 仓库，用 /plugin marketplace add 指向私有源，统一管控团队可用插件与版本。
5. 组合 MCP + Agent + Skill 做完整能力包：一个插件同时携带 MCP 服务器（连数据）、子 Agent（做决策）、Skills（沉淀方法），做成团队标准工具集分发。

小技巧

1. 装任何插件前先点开它的 homepage/README——Anthropic 官方声明不控制插件内 MCP server/文件，信任判断要自己做。
2. 改完插件配置后 /reload-plugins 立即生效，不必重启 Claude Code。
3. 优先用 /plugins（官方内部目录）里的插件，Anthropic 自维护、更新更及时。
4. 提交插件前对照 /plugins/example-plugin 检查 plugin.json 字段完整性，避免审核被退回。
5. 关注仓库 marketplace.json 的 renames 与版本变更，能提前发现插件迁移风险。

常见问题 FAQ

Q1：Claude Plugins Official 本身免费吗？

A：目录本身是开源免费的（Apache-2.0），使用无需付费。但目录里的第三方插件可能要求你自己的账号/订阅/Token（例如 M365 需要 Microsoft 租户、Telegram 需要 Bot token、Asana 需要 OAuth），费用取决于你对接的第三方服务，与目录无关。详见 GitHub 仓库。

Q2：它和 Smithery / mcp.so 这类 MCP 注册中心有什么区别？

A：Smithery、mcp.so 主要分发单个 MCP server；Claude Plugins Official 分发的是 Claude Code 的”插件”——一个插件可以同时打包 MCP server + 斜杠命令 + 子 Agent + Skills，并深度集成到 Claude Code 的 /plugin、/agents、/mcp 体系里，带官方审核与版本同步。想轻量找 MCP 用前者，想在 Claude Code 里装”完整能力包”用后者。来源：Smithery、mcp.so、插件文档。

Q3：装这些插件安全吗？

A：Anthropic 在 README 里明确警告：它不控制插件包含的 MCP 服务器、文件等软件，也无法验证它们是否按预期工作或未来是否会变，建议安装前自行信任并查看插件主页。官方内部目录 /plugins 相对更可信；第三方插件务必读源码与权限说明。

Q4：我能提交自己的插件吗？

A：可以。第三方插件需满足质量与安全标准，通过提交表单申请，审核通过后进入 /external_plugins。参考 /plugins/example-plugin 与官方 marketplace 文档了解 manifest 规范。

Q5：支持哪些平台？

A：目录本身随 Claude Code 跨平台（macOS、Linux、Windows/WSL），无独立平台限制。真正限制来自插件自身——例如 iMessage 插件仅 macOS，某些 MCP server 依赖特定运行时。仓库主语言为 Python，但使用目录无需关心实现语言。来源：官方文档。

进阶学习建议

想深入，别停留在”装插件”，直接读透它的分发机制本身：

• 吃透 plugin manifest：研究 .claude-plugin/plugin.json 的字段，以及 strict mode 与 strict: false skill-bundle 两种形态的区别，这是写任何插件的地基（官方文档 Plugin Marketplaces）。
• 逆向官方内部插件：/plugins/example-plugin 是 Anthropic 提供的参考实现，逐文件对照它如何组织 .mcp.json、commands/、agents/、skills/，比看任何教程都管用。
• 理解 renames 迁移机制：研究 marketplace.json 里的 renames map 如何让已装插件无痛改名，这背后是”slug 不可变 + 显式迁移”的工程约束，值得借鉴到自己的分发系统。
• 真实项目案例：目录里 M365/Telegram/iMessage/Asana 这几个连接器，是”外部服务 + MCP + 平台特性”结合的最佳范本，读它们的 issue（#1494、#1075、#1037、#998）能学到真实环境下的接入坑。
• 给团队做私有分发：把官方目录的审核/版本/迁移思路，落地到内部 Git 托管的私有 marketplace，形成团队统一的 Claude Code 能力基线。

参考链接

• GitHub 仓库 anthropics/claude-plugins-official
• Claude Code 插件官方文档
• Plugin Marketplace 规范文档
• 插件目录提交表单
• Smithery（MCP 注册中心）
• awesome-claude-code（社区精选）

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。