3 步用 Anthropic 官方 Claude Code Plugins 给你的 AI 编程助手装新技能,附 5 个立刻能用的插件
Claude Code 的 Skills 系统在 8 月 18 日被 Anthropic 正式开源到了 `anthropics/claude-plugins-official` 仓库(33.8K 星,3.8K fork)。Anthropic 把内部用的 Claude Code 插件直接公开,让普通开发者也能用上”代码审查、PR 描述、单元测试生成”等高级技能。今天这篇教程 3 步带大家从零跑通,附 5 个立刻能用的插件推荐。
准备清单
– Claude Code:已安装最新版本(≥2.0.5)
– 操作系统:macOS、Linux、Windows(WSL2)均可
– 网络:能正常访问 GitHub
– 磁盘:约 500MB
– 时间:整个流程 15-20 分钟
如果你还没装 Claude Code,先去 https://claude.com/claude-code 下载,登录账号即可。
第 1 步:把官方仓库加为 marketplace
Anthropic 官方插件仓库 `anthropics/claude-plugins-official` 提供了”marketplace”机制——你可以把它想象成”插件商店”。第一次使用时需要先把仓库添加进去:
# 在 Claude Code 命令行中执行
/plugin marketplace add anthropics/claude-plugins-official
执行后,Claude Code 会从 GitHub 拉取插件列表(约 3-5 秒)。成功后你会看到 `Marketplace ‘anthropics-claude-plugins-official’ added successfully` 的提示。
常见失败:
– “command not found: /plugin”:你的 Claude Code 版本太旧,升级到 ≥2.0.5
– “permission denied”:检查 GitHub SSH key 或 token 是否配置正确
第 2 步:安装你想用的插件
官方仓库里有 40+ 个插件,按用途分了几类。这里推荐 5 个立刻能用、效果立竿见影的插件:
### 2.1 code-review(代码审查)
/plugin install code-review@anthropic-claude-plugins-official
用途:在每次提交 PR 时自动生成代码审查报告。安装后,你执行 `/code-review` 即可对当前分支的变更做 LLM 级别的审查。会指出潜在 bug、性能问题、安全漏洞。
### 2.2 pr-description(PR 描述生成)
/plugin install pr-description@anthropic-claude-plugins-official
用途:根据 git diff 自动生成 PR 的标题和描述。再也不用为”如何写好 PR 描述”头疼。
### 2.3 unit-test-generator(单元测试生成)
/plugin install unit-test-generator@anthropic-claude-plugins-official
用途:选中一个函数或类,运行 `/unit-test` 即可生成对应的单元测试代码。支持 Python、JavaScript、TypeScript、Go、Rust。
### 2.4 security-audit(安全审计)
/plugin install security-audit@anthropic-claude-plugins-official
用途:扫描当前项目,识别 SQL 注入、XSS、硬编码密钥等常见安全问题。适合每次发版前跑一次。
### 2.5 frontend-design(前端设计)—— 1.1.0 版本
/plugin install frontend-design@anthropic-claude-plugins-official
用途:根据描述生成 React/Vue 组件代码,包含样式和交互逻辑。注意:这个插件在 6 月 18 日刚升到 1.1.0 版本,修复了”生成的组件缺少响应式”的旧问题。
⚠️ 重要警告(来自官方 README):**”Make sure you trust a plugin before installing, updating, or using it. Anthropic does not control what MCP servers, files, or other software are included in plugins.”** 第三方插件可能包含恶意代码,**只安装你信任的来源**。
第 3 步:编写你的第一个自定义插件
官方插件够用,但更酷的是自己写一个。一个 Claude Code 插件的标准结构是:
my-plugin/
├── .claude-plugin/
│ └── plugin.json # 插件元数据(必填)
├── .mcp.json # MCP 服务器配置(可选)
├── commands/ # 斜杠命令(可选)
│ └── my-command.md
├── agents/ # Agent 定义(可选)
│ └── my-agent.md
├── skills/ # 技能定义(可选)
│ └── my-skill.md
└── README.md
最简插件示例——一个”自动写 commit message”的插件:
// .claude-plugin/plugin.json
{
"name": "smart-commit",
"version": "1.0.0",
"description": "Auto-generate commit message from git diff"
}
<!-- commands/commit.md -->
# Smart Commit
根据当前 git diff 自动生成符合 Conventional Commits 规范的提交信息。
执行步骤:
1. 运行 `git diff --staged` 获取变更
2. 分析变更类型(feat/fix/docs/refactor)
3. 生成中文 commit message
4. 调用 `git commit -m "{message}"`
把这个目录放到 GitHub 仓库的 `plugins/` 文件夹下,再在 marketplace 配置里引用即可。
第三方插件市场
除了官方仓库,社区还有几个值得关注的 marketplace:
| Marketplace | 特点 | 推荐理由 |
|—|—|—|
| `JetBrains/go-modern-guidelines` | Go 现代化编码 | 强制 AI 写 `max(a,b)` 而不是 if-else |
| `anthropics/knowledge-work-plugins` | 知识工作者专用 | 含 Office 365、Google Docs 集成 |
| ComposioHQ/awesome-claude-skills | 社区精选 | 700+ 插件索引 |
常见失败处理
1. 插件安装后没生效
Claude Code 需要重启才能识别新插件。`/exit` 退出再重开。
2. 插件调用报 “permission denied”
某些插件需要额外的 Bash 权限。在 `~/.claude/settings.json` 里配置:
{
"permissions": {
"allow": ["Bash(git:*)", "Bash(npm:*)"]
}
}
3. 插件占用太多 token
插件会向 context 注入额外 prompt。如果发现 token 消耗变高,用 `/plugin disable` 临时关闭不需要的插件。
一个能立刻验证插件工作的 prompt
跑通后,编辑一个文件,然后用 `/code-review` 命令,如果 AI 给出具体的代码改进建议,说明插件加载成功。
# 编辑一个 Python 文件,比如 demo.py
def add(a, b):
return a + b
# 然后在 Claude Code 中执行
# > /code-review demo.py
预期看到类似输出:
建议改进:
1. 缺少类型注解:`def add(a: int, b: int) -> int`
2. 缺少 docstring:解释函数用途
3. 没有处理边界情况:如果输入是 None?
进阶玩法
跑通基础插件后,可以继续探索:
1. 插件组合:把 `code-review` + `unit-test-generator` 串成一个工作流(先审查后测试)
2. 企业 marketplace:在公司内部署一个 marketplace,托管团队专属插件
3. MCP 集成:通过 `.mcp.json` 让插件调用外部服务(数据库、Jira、Slack)
📌 下周 LC 智趣厅 会出”用 JetBrains/go-modern-guidelines 改造老 Go 项目”的进阶教程,关注不迷路。
— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn