anthropics/claude-plugins-official — Claude Code 官方插件目录

汇集 Claude Code 插件，扩展 AI 编程工作流。
本周新增 Star 5,441 ｜ 仓库 Star 总数 44,047 ｜ Forks 4,635

▲ 图 0：Claude Code 插件官方示例（Anthropic 官方插件运行截图）

一、目录结构

claude-plugins-official/
├── plugins/           # Anthropic 内部开发并维护的插件
└── external_plugins/  # 来自合作伙伴与社区的第三方插件

单个插件的标准结构：

plugin-name/
├── .claude-plugin/
│   └── plugin.json      # 插件元数据（必需）
├── .mcp.json            # MCP 服务器配置（可选）
├── commands/            # 斜杠命令（可选）
├── agents/              # 智能体定义（可选）
├── skills/              # Skill 定义（可选）
└── README.md            # 文档

二、部署方式

方式 A：在 Claude Code 内直接安装（推荐）

在 Claude Code 会话中输入：

/plugin install {plugin-name}@claude-plugins-official

或者用 /plugin → Discover 浏览目录挑选。

方式 B：添加为本地市场后安装

# 将官方目录添加为 marketplace
claude plugin marketplace add anthropics/claude-plugins-official

# 安装具体插件
claude plugin install {plugin-name}@claude-plugins-official

方式 C：仅使用 Skill（不装整套插件）

部分插件以 skill bundle 形式发布。目录条目可以用 strict: false + 显式 skills 数组声明：

{
  "name": "example-bundle",
  "description": "Brief description of the bundled skills.",
  "author": { "name": "Author Name" },
  "category": "development",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/example-org/sdk.git",
    "path": "packages/agent-skills",
    "ref": "main",
    "sha": ""
  },
  "strict": false,
  "skills": ["./skill-a", "./skill-b", "./skill-c"],
  "homepage": "https://github.com/example-org/sdk"
}

• skills 中每个路径相对于 source.path，指向包含 SKILL.md 的目录。
• 路径可以 跨越多层，例如 ["./libA/skill-1", "./libB/skill-2"] 可从多个子库中精选暴露。
• 每个 skill 在 Claude Code 中注册为 :。

方式 D：手动放置到本机目录

将插件目录复制到 Claude Code 的插件目录（通常为 ~/.claude/plugins/），重启 Claude Code 即可被发现。

三、使用方法

3.1 浏览与安装

3.2 启用自动更新（重要）

Claude Code 对第三方 marketplace 默认关闭自动更新。安装后：

1. 运行 /plugin
2. 打开 Marketplaces
3. 选中 claude-plugins-official
4. 选择 Enable auto-update

之后每次启动 Claude Code 会在后台刷新市场与已安装插件。提示时运行 /reload-plugins，或直接开新会话加载更新。

3.3 使用插件提供的能力

安装后，插件贡献的能力按其类型出现：

• MCP 服务器：以工具形式出现，智能体自动调用
• 斜杠命令：在输入框以 /plugin-name:command 形式出现
• Agents：可在会话中作为子智能体被委派
• Skills：按描述相关性自动触发，或显式 /plugin-name:skill-name 调用

3.4 命名不可变规则（自建市场时必读）

• name 字段是 不可变的 slug。一旦发布，用户是以该 slug 安装的，改名会导致 plugin-not-found 错误。
• 想改 UI 显示名，请设置 displayName。
• 确需改名时，在 .claude-plugin/marketplace.json 顶层加 renames 映射，旧安装会自动迁移：

"renames": {
  "old-name": "new-name"
}

Claude Code 的插件加载器会读取该映射，在用户下次同步时透明改写旧 slug。

四、自建插件并提交到目录

4.1 内部插件

Anthropic 团队成员开发，参考 /plugins/example-plugin 的实现。

4.2 第三方插件

通过官方 插件目录提交表单 提交：https://clau.de/plugin-directory-submission

外部插件需满足官方质量与安全标准才能入选。

4.3 本地开发调试

git clone https://github.com/anthropics/claude-plugins-official.git
cd claude-plugins-official

# 以本地市场形式加载自己的插件
claude plugin marketplace add ./my-plugin-dir
claude plugin install my-plugin@my-plugin-dir

五、安全提醒

⚠️ 安装前请确认你信任该插件。 Anthropic 不控制插件内包含的 MCP 服务器、文件或其他软件，无法验证它们是否会按预期工作或是否会发生变化。请查看每个插件的主页了解详情。

实践建议：

• 只安装你真正需要的插件
• 安装前阅读插件的 README.md 与 .mcp.json，看清它会启动哪些外部进程、访问哪些网络
• 涉及执行命令或读取凭据的插件，额外在 Claude Code 的权限设置中限制其可访问的路径

参考链接

• 仓库：https://github.com/anthropics/claude-plugins-official
• 插件开发文档：https://code.claude.com/docs/en/plugins
• 市场规范：https://code.claude.com/docs/en/plugin-marketplaces
• 提交表单：https://clau.de/plugin-directory-submission