夜雨聆风学习资料网

ARTICLE · 1185443

Claude Code 插件市场:Anthropic 官方插件目录推荐

发布时间：2026-10-15 12:47:11 最近访问：2026-10-15 12:47:12
Claude Code 插件市场:Anthropic 官方插件目录推荐
大家好，欢迎来到我的开源项目分享专题。

今天给大家推荐的是一个开源项目 —— Anthropic 官方维护的 Claude Code 插件目录，用一份 marketplace.json 收敛插件安装、校验与 SHA 追更。

项目地址：https://github.com/anthropics/claude-plugins-official

01 项目是什么

这是一个用 Python、TypeScript、Bun 脚本驱动的插件市场仓库：核心资产是一份 .claude-plugin/marketplace.json 清单，配套 .github/scripts 下的 SHA 追更、frontmatter 校验与外部 PR 范围守卫。它不是一个可运行的服务，交付形态是 Claude Code 通过 /plugin 读取的插件索引。使用者有两类：想给 Claude Code 快速扩展能力的开发者，以及希望把插件提交进官方目录的第三方团队。

02 核心功能

插件目录与安装

  • /plugins
    存放 Anthropic 内部插件，/external_plugins 存放第三方与社区插件
  • 插件 name 是不可变 slug，改名要在 marketplace.json 的 renames 中登记迁移
  • strict: false
     加 skills 数组可直接声明 skill-bundle，注册为 <插件>:<技能>

SHA 追更（discover_bumps.py）

  • 只处理 source 是对象且带 sha 的条目，调 GitHub API 比对上游最新提交
  • 按 pinned 提交距今的天数倒序排序，--max（默认 20）截断，避免长期饥饿
  • 把 404 与 422「No commit found」统一视为 dead upstream，写进步骤摘要

提交校验与外部 PR 管控

  • validate-frontmatter.ts 用 Bun 运行，校验 agent/skill/command 的 YAML 必填字段
  • 解析前先把含 {}[]*&#!|>%@ 等字符的值加双引号，让 glob 也能通过 YAML 解析
  • external-pr-scope.js 只放行新增条目，且 source.url 必须指向已有的 live 插件仓库

插件侧实现

  • claude-security 用 hooks.py 采集 scan_started、patches_written 等事件码上报
  • hooks.sh 先探测 python3 是否 ≥ 3.9，失败则回退 python/py 并按探测路径执行
  • fakechat 以 MCP stdio server 暴露 reply、edit_message 工具，附本地 Web UI

这张时序图讲的是 SHA 追更任务一次完整执行时，工作流、脚本、GitHub API 与清单文件之间的调用顺序。

03 技术栈

脚本与工具链：Python 3.9+、TypeScript、Bun、POSIX Shell市场清单：marketplace.json、plugin.json、.mcp.json、MCP SDKCI 与自动化：GitHub Actions、GitHub API（gh CLI）、yaml 解析License：Apache-2.0

04 架构设计

这张架构图讲的是插件从安装入口、清单解析、两条来源目录分叉到最终能力加载的主链路，以及 CI 侧从上游仓库回写 SHA 的旁路。

claude-plugins-official/├── .claude-plugin/marketplace.json  # 唯一插件索引：name / source / sha├── .github/scripts/                 # SHA 追更、frontmatter 校验、PR 范围守卫├── plugins/                         # Anthropic 内部插件（如 claude-security）├── external_plugins/                # 第三方与社区插件（discord、telegram 等）└── README.md                        # 安装方式、插件结构与提交约定

清单是唯一入口：Claude Code 读 marketplace.json 定位插件源，内部与外部两条目录在此分叉，最终汇成命令、技能与 MCP 三类能力加载进会话。CI 侧由 discover_bumps.py 从上游取最新提交、把 SHA 回写同一份清单，用户装到的始终是固定版本。

05 快速开始

# 在 Claude Code 内直接安装市场中的插件/plugin install {plugin-name}@claude-plugins-official# 或打开插件浏览器，在 Discover 中挑选/plugin > Discover# 第三方提交插件的入口（README 给出的表单）https://clau.de/plugin-directory-submission

README 没有给默认端口或默认凭据，安装入口就是 Claude Code 内的 /plugin，浏览入口是 /plugin > Discover。各插件自身的连接与配置，README 要求查看对应插件主页。需要提醒的是，README 明确说明 Anthropic 不控制插件里包含的 MCP server 与文件，安装前应自行确认可信度。

06 适用场景

  • 想给 Claude Code 一键补齐某类能力（IM 通道、代码安全扫描）的个人开发者
  • 有内部插件、希望统一收口到官方市场分发的团队
  • 需要自动跟踪上游插件版本、不想手动比对 SHA 的目录维护者
  • 不适合：期待官方逐行审计插件内部代码安全性的人——README 已声明 Anthropic 无法验证插件行为是否会变

写在最后

感谢大家阅读，欢迎在评论区进行讨论；关注+收藏，后续会带来更多的主流项目介绍。

个人的容器平台项目 https://github.com/caoyingjunz/pixiu ，欢迎大家 star 和深度使用

相关学习资料