过去一年,Claude Code 已从命令行里的 AI 编程助手,逐步成长为许多开发者日常写代码、排查问题、修改 PR、运行测试、接工具的核心工作入口。
但 Claude Code 要真正变得好用、强大且贴合实际需求,不能只依靠模型本身。它还需要不断接入新的能力。
而这些能力,都可以通过插件的形式植入 Claude Code。
在 Claude Code 的体系中,一款完整插件可以封装 Skills 、Commands、Subagents、hooks、MCP 服务器等。它能把原本沉淀在团队文档、个人经验和项目配置中的知识与流程,打包成标准化能力包,支持一键安装、即时调用和跨项目复用。
然而,当各类插件增多之后,新的问题也随之出现,哪些插件真正可靠?哪些适合自己的项目?是否存在权限或安全风险?插件作者又该如何发布、适配,并被更多开发者发现?
Anthropic 开源的 claude-plugins-official,正是为了解决这些问题。目前,该项目在 GitHub 已收获29.3k Stars。

项目链接:
https://github.com/anthropics/claude-plugins-official
它是 Anthropic 官方维护的 Claude Code 高质量插件目录仓库。这个项目的意义远不止提供了一些插件,而是为整个 Claude Code 插件生态建立了一套清晰的分发入口和收录标准。
仓库中既包含 Anthropic 内部开发维护的优质插件,也收录了经筛选的第三方插件。
对开发者而言,它提供了一个更可信的插件入口,让大家不必在海量插件中盲目挑选;对插件作者而言,它也打开了一个规范化的发布通道,让插件不再是散落在个人仓库里的配置文件,而是可以被统一发现、安装和更新的生态资产。
01
项目介绍
claude-plugins-official 是 Anthropic 官方维护的高质量 Claude Code 插件目录仓库,帮助 Claude Code 从一个代码助手,进化成能深度集成开发流程、智能协作的超级生产力工具。
在这个仓库中,/plugins 目录里收录的是由 Anthropic 内部团队开发和维护的36个官方插件,覆盖了从基础开发体验到高级工作流多个维度。
例如,各种主流编程语言的 LSP(Language Server Protocol)(如 typescript-lsp、pyright-lsp、rust-analyzer-lsp 等),让 Claude Code 获得更精确的代码诊断和代码导航能力,例如查看类型错误、跳转定义、查找引用、列出符号或追踪调用关系。
还有代码审查(code-review)、安全指导(security-guidance)、特性开发(feature-dev)、代码现代化改造(code-modernization)等,通过这些插件,Claude Code 就不只是停留在“读代码、改代码”,而是可以在更结构化的工作流中参与代码质量检查、安全风险提示、项目配置建议和开发过程记录。
以及输出风格优化(如 explanatory-output-style)、项目初始化设置(claude-code-setup)等插件。
通过这些插件,Claude Code能够帮助开发者自动处理代码质量、安全检查、会话报告等重复性工作,大幅提升编程效率和代码可靠性。
最简单的插件可以只包含一个 Skill,创建一个插件目录,在 skills/hello/ 下放置 SKILL.md 文件(包含 YAML frontmatter 和具体指令),再搭配 .claude-plugin/plugin.json 定义插件名称。加载后,该 Skill 会以带命名空间的形式出现,例如 /my-first-plugin:hello,有效避免不同插件间的命名冲突。
如果想做复杂插件,还可以继续加入 agents、hooks、MCP servers、LSP servers 和 background monitors。
比如,团队可以把自己的代码审查标准写成 Skill,把安全审查角色写成 agent,把提交前自动检查写成 hook,把内部文档系统或项目管理系统通过 MCP 接进来,再用 .lsp.json 接入特定语言的语言服务器。
这样,这个插件就不只是一条命令,而是一整套可安装、可复用、可跨项目迁移的团队工作流。
开发阶段也不需要一上来就发布到 marketplace。官方支持用 claude --plugin-dir ./my-plugin 直接加载本地插件进行测试,修改后可以通过 /reload-plugins 重新加载插件,等插件稳定之后,再考虑通过 marketplace 或团队内部目录分发。
所以,claude-plugins-official 的价值并不只是官方收录了一些插件。
它真正建立的是一套插件生态的基本秩序,Anthropic 负责维护官方目录和规范,内部插件提供基础工程能力,外部插件连接真实开发工具,而开发者和团队则可以把自己的经验封装成标准插件。
02
安装教程
claude-plugins-official 会在 Claude Code 启动时自动可用。用户可以在 Claude Code 里运行 /plugin,进入 Discover 页面浏览可安装插件,也可以直接用命令安装。
/plugin install <plugin-name>@claude-plugins-official如果 Claude Code 提示找不到插件,可能是 marketplace 信息没有刷新,可以先运行:
/plugin marketplace update claude-plugins-official或者手动添加官方 marketplace:
/plugin marketplace add anthropics/claude-plugins-official安装完成后,可以执行:
/reload-plugins这样无需重启 Claude Code,就可以重新加载当前启用的插件。
(2)创建插件
首先,新建一个插件目录,接着创建插件元数据目录。
#创建插件目录mkdir my-first-plugin#创建插件清单mkdir my-first-plugin/.claude-plugin
touch .claude-plugin/plugin.json写入以下内容:{"name": "my-first-plugin","description": "A greeting plugin to learn the basics","version": "1.0.0","author": {"name": "Your Name"}}
接下来添加一个 Skill。Claude Code 官方推荐在插件根目录下创建 skills/ 目录,每个 Skill 是一个独立文件夹,里面放一个 SKILL.md 文件。需要注意,不要把 skills/、commands/、agents/、hooks/ 放进 .claude-plugin/ 目录里;.claude-plugin/ 里主要放 plugin.json,其他能力目录应该放在插件根目录。
mkdir -p my-first-plugin/skills/quality-reviewtouch my-first-plugin/skills/quality-review/SKILL.md
写入以下内容:
---description: Review code for bugs, security risks, performance issues, and maintainability problems.---# Team Quality ReviewYou are helping the team review code changes.When reviewing code, focus on:1. Whether the change matches the existing project style.2. Whether there are obvious bugs or edge cases.3. Whether error handling is complete.4. Whether there are security risks.5. Whether tests should be added or updated.6. Whether the code is easy for future maintainers to understand.Output should be concise and actionable.Use this format:## SummaryBriefly describe what the change does.## IssuesList important issues. For each issue, explain why it matters and how to fix it.## Suggested TestsSuggest tests that should be added or updated.## Final VerdictGive one of: Looks good / Needs changes / High risk.
到这里,一个最小插件已经完成了。当前目录结构应该是:
my-first-plugin/├── .claude-plugin/│ └── plugin.json└── skills/└── quality-review/└── SKILL.md
如果修改了 SKILL.md,可以在 Claude Code 里执行:
/reload-plugins如果想让插件更像一个完整的团队工作流,还可以继续添加 Agent。插件支持在根目录下创建 agents/ 目录,用 Markdown 文件定义专项 subagent;这类 agent 可以由 Claude 自动调用,也可以由用户手动调用。
mkdir -p my-first-plugin/agentstouch my-first-plugin/agents/security-reviewer.md
写入:
---name: security-reviewerdescription: Use this agent when reviewing code for security risks, unsafe data flow, authentication issues, or permission problems.model: sonneteffort: mediummaxTurns: 20disallowedTools: Write, Edit---You are a security-focused code reviewer.Review the code for:- injection risks- authentication and authorization mistakes- insecure direct object references- hardcoded secrets- unsafe file or path handling- missing input validation- risky dependency usageDo not modify files. Only report findings with severity, evidence, and suggested fixes.
这样,这个插件就不只是一个 Skill,而开始拥有一个“安全审查专家”角色。Claude Code 可以在合适任务中调用它,也可以让用户在需要安全审查时手动触发。
如果团队还想把外部工具接进来,可以添加 .mcp.json。Claude Code 插件可以在插件根目录携带 MCP Server 配置;官方插件结构里也把 .mcp.json 标为可选的 MCP server configuration。
touch my-first-plugin/.mcp.json参考写法如下:
{"mcpServers": {"internal-docs": {"command": "node","args": ["./bin/internal-docs-mcp.js"]}}}
如果要添加 Hook,也可以在插件根目录创建 hooks/hooks.json。
mkdir -p my-first-plugin/hookstouch my-first-plugin/hooks/hooks.jsonmkdir -p my-first-plugin/scriptstouch my-first-plugin/scripts/format-code.shchmod +x my-first-plugin/scripts/format-code.sh
hooks/hooks.json可以写成:{"hooks": {"PostToolUse": [{"matcher": "Write|Edit","hooks": [{"type": "command","command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/format-code.sh"}]}]}}
scripts/format-code.sh可以先写一个简单版本:#!/usr/bin/env bashecho "Code formatting hook triggered."
完成这些能力后,一个更完整的插件目录大概会长这样:

如果只是自己使用或测试,可以用本地加载方式:
claude --plugin-dir ./my-first-plugin如果要给团队成员安装,应创建团队内部 marketplace。
流程包括,先准备插件,再创建 .claude-plugin/marketplace.json,然后把 marketplace 推到 GitHub、GitLab 或其他 git host,最后让用户通过 /plugin marketplace add 添加并安装插件。
{"name": "my-team-plugins","owner": {"name": "Your Team"},"plugins": [{"name": "my-first-plugin","source": "./plugins/my-first-plugin","description": "Team code review workflow for Claude Code"}]}
本地测试 marketplace 时,可以在 Claude Code 中运行:
/plugin marketplace add ./my-marketplace/plugin install my-first-plugin@my-team-plugins
安装后调用:
/my-first-plugin:quality-review
如果后续把 marketplace 推到团队 GitHub 或 GitLab 仓库,团队成员就可以通过同样的 marketplace 机制安装。
完整教程请参考:
https://code.claude.com/docs/zh-CN/plugins
03
总结
在真实项目里,写代码其实是很小的一部分。
开发者还要理解业务规则、遵守代码规范、查文档、跑测试、提 PR、写 commit、排查安全风险、连接数据库、查看监控,并和项目管理系统同步状态。
过去,这些能力分散在不同工具和流程里。AI 想接入真实工程环境,往往要靠开发者手动配置、反复提示、不断补上下文。
插件的意义,就是把这些工程能力变得可安装、可复用、可更新、可管理。
这也是为什么 claude-plugins-official 值得关注。它不是在做一个简单的命令合集,而是在给 Claude Code 建立一个生态入口。
代码诊断能力可以通过 LSP 插件进入,外部服务可以通过 MCP 配置和工具插件进入,团队规范可以通过 Skills、Agents 和 Hooks 沉淀下来,流程控制可以通过 Hooks 自动触发,专项任务则可以交给不同的 Agents 执行。
未来,插件生态很可能会成为 AI Agent 走向产业场景的关键基础设施。
因为真实产业环境从来不是一个干净的 prompt。它由权限、工具、代码库、文档、审查流程、合规要求、历史系统和团队习惯共同构成。
而 AI 要真正进入这个环境,不能只靠一次次临时对话,必须具备可配置、可分发、可安全审计、可迭代升级的工程化能力,而标准化的插件生态恰好补齐了这一环。







