Loading...

文章背景图

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

2026-11-09
3
- 字
- 分钟
|

claude-plugins-official

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

Claude Code 插件官方示例

最新提交

2026-10-23

一句话定位

Anthropic 官方维护的 Claude Code 插件目录,含内部自研插件与第三方合作伙伴插件


一、目录结构

单个插件的标准结构:


二、部署方式

方式 A:在 Claude Code 内直接安装(推荐)

在 Claude Code 会话中输入:

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

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

方式 C:仅使用 Skill(不装整套插件)

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

  • skills 中每个路径相对于 source.path,指向包含 SKILL.md 的目录。

  • 路径可以 跨越多层,例如 ["./libA/skill-1", "./libB/skill-2"] 可从多个子库中精选暴露。

  • 每个 skill 在 Claude Code 中注册为 <plugin-name>:<skill-name>。

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

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


三、使用方法

3.1 浏览与安装

操作

命令

打开插件面板

/plugin

浏览目录

/plugin → Discover

安装插件

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

管理市场

/plugin → Marketplaces

3.2 启用自动更新(重要)

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

  1. 运行 /plugin

  1. 打开 Marketplaces

  1. 选中 claude-plugins-official

  1. 选择 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 映射,旧安装会自动迁移:

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


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

4.1 内部插件

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

4.2 第三方插件

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

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

4.3 本地开发调试


五、安全提醒

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

实践建议:

  • 只安装你真正需要的插件

  • 安装前阅读插件的 README.md 与 .mcp.json,看清它会启动哪些外部进程、访问哪些网络

  • 涉及执行命令或读取凭据的插件,额外在 Claude Code 的权限设置中限制其可访问的路径


参考链接

安装部署(实操步骤)

1. 前置准备

  • 项目仓库:anthropics/claude-plugins-official(https://github.com/anthropics/claude-plugins-official)
  • 需要本机具备 Git;按项目语言准备对应运行时(Python / Node.js / Go / Java 等)
  • 建议先在本机或测试服务器上跑通,再部署到生产环境
  • 遇到依赖版本问题时,以仓库 README 与 Releases 说明为准

3. 部署流程

  1. 克隆仓库:git clone https://github.com/anthropics/claude-plugins-official
  2. 进入目录后按上面的官方命令安装依赖
  3. 参考 README 的配置说明填写配置文件或环境变量
  4. 按官方说明启动服务,确认监听端口与访问地址
  5. 浏览器访问验证功能,确认无报错后再开放外网

4. 常见问题排查

  • 依赖安装失败:先升级包管理器,再确认运行时版本符合 README 要求
  • 启动报端口占用:修改配置中的端口或释放被占用端口
  • 页面打不开:检查防火墙 / 安全组是否放行对应端口
  • 功能异常:查看运行日志,对照 Issues 中同类问题处理

5. 官方链接

评论交流

文章目录