词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
课程信息 预计学时:4-6小时 难度等级:⭐⭐ 入门级 更新日期:2026年4月 适用版本:Claude Code v2.1.133(验证于 2026-05-08;v2.1.90+ 插件市场 env 见文内 release 摘录)
/plugin + market 的主路径,以及本地目录开发模式✅ 术语表(3分钟)
✅ 第1章:Plugins概览(10分钟)
✅ 第2章:5分钟快速开始(15分钟)✅ 第1-2章:概念+快速上手(30分钟)
✅ 第3章:Marketplace深度指南(30分钟)
✅ 第4章:创建自定义Plugin(90分钟)
✅ 第5章:发布与分享(30分钟)🔧 第6章:故障排查指南
🔧 第7章:FAQ| 术语 | 英文 | 解释 |
|---|---|---|
| Plugin | Plugin | Claude Code 的扩展包,可封装 agents、skills、hooks、MCP、LSP、bin、settings 等资源 |
| Marketplace | Marketplace | Plugin商店,浏览和发现Plugin的网页平台 |
| .claude-plugin/plugin.json | - | Plugin的元数据清单文件,位于 .claude-plugin/ 子目录中 |
| --plugin-dir | - | Claude Code 启动参数,主要用于本地开发 / 调试加载指定目录 |
| Skill | Skill | Plugin中的核心能力模块(SKILL.md定义) |
| Hook | Hook | Plugin中的自动化触发器(如代码提交前检查) |
手机 | Claude Code
------------------|------------------
操作系统(iOS/Android) | Claude Code核心
App Store | Plugin Marketplace(网页)
安装的APP | 已安装的Plugins
APP更新 | Plugin手动更新(git pull)| 维度 | Commands | Skills | MCP | Plugins |
|---|---|---|---|---|
| 定义 | Markdown提示词 | 专业Agent能力 | 外部服务集成 | 打包的扩展 |
| 位置 | .claude/commands/(兼容层) | .claude/skills/ | .mcp.json | 本地目录 + market 安装 |
| 可分享性 | ❌ 手动复制 | ❌ 手动复制 | ⚠️ 需配置 | ✅ 市场安装 / CLI / 本地开发目录 |
| 包含内容 | 单个提示词 | 多个文件+配置 | 服务器配置 | manifest + agents/skills/hooks/MCP/LSP/bin/settings |
| 加载方式 | 自动(在项目目录中) | 自动(在项目目录中) | 自动(配置后) | /plugin 为主,--plugin-dir 为本地开发补充 |
Plugin = manifest + runtime resources + optional markets/scope + 文档/plugin 和网页入口协同使用https://code.claude.com/pluginshttps://github.com/jeremylongshore/claude-code-plugins-plusclaude-code-plugin⚠️ 重要说明:Claude Code 现在既有交互里的 /plugin,也有 CLI 子命令claude plugin(别名claude plugins)。对普通用户来说,/plugin依旧是最顺手的入口;claude plugin更适合脚本化和精确控制作用域。
/plugin/plugin install <plugin-name-or-market-entry>💡 实际名称 取决于当前 market 提供的条目。最稳妥的做法是先 /plugin浏览,再从列表里安装。
--plugin-dir--plugin-dir 加载Plugin.claude-plugin/plugin.json,加载其中定义的 manifest、skills、hooks、agents 等资源。💡 开发小技巧:开发本地 Plugin 时,优先把 --plugin-dir当成调试入口,而不是最终分发方式。
/plugin 里卸载;如果你是本地目录加载,删除目录即可:⚠️ 注意:Marketplace 是网页平台,不是CLI命令。
https://code.claude.com/plugins| 功能 | 说明 |
|---|---|
| 分类浏览 | 按用途分类:文档处理、代码质量、项目管理等 |
| 搜索 | 按关键词搜索Plugin |
| 详情页 | 查看 Plugin 说明、安装量、评分、仓库链接 |
| 安装指引 | 每个Plugin页面提供安装命令(git clone) |
.claude-plugin/plugin.json:my-plugin/
├── .claude-plugin/
│ └── plugin.json # 必需:Plugin元数据清单
├── .mcp.json # 可选:MCP配置
├── README.md # 推荐:使用文档
├── skills/ # 可选:Agent Skills
│ └── my-skill/
│ └── SKILL.md
├── commands/ # 可选:Slash Commands
│ └── my-command.md
├── agents/ # 可选:Agent定义
│ └── my-agent.md
└── hooks/ # 可选:Hooks
└── pre-commit.py{
"name": "my-awesome-plugin",
"description": "A plugin that does awesome things",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}💡 注意: plugin.json必须放在.claude-plugin/子目录中,不是 Plugin 根目录。name、description、version是最常见核心字段,author是可选项,且官方示例中通常写成对象。
{
"name": "hello-world-plugin",
"description": "A simple hello world plugin for learning",
"version": "1.0.0",
"author": {
"name": "Claude Student"
}
}skills/hello/SKILL.md:💡 为什么这里用了 namespaced 命令? 官方当前规范里,plugin 内的 skill 会自动加上 plugin-name:前缀,例如/hello-world-plugin:hello。这样做是为了避免多个 plugin 之间撞名。
code-review-plugin/
├── .claude-plugin/
│ └── plugin.json
├── README.md
├── commands/
│ └── review.md
└── skills/
└── code-reviewer/
└── SKILL.md| 原则 | 说明 |
|---|---|
| 单一职责 | 每个Plugin专注一个领域(代码审查、文档生成等) |
| 清晰文档 | README必须包含安装步骤、使用示例、配置说明 |
| 版本管理 | 使用语义化版本号(SemVer),打git tag |
| 最小依赖 | 尽量减少外部依赖,保持Plugin轻量 |
| 安全第一 | 不在Plugin中硬编码密钥,使用环境变量 |
✅ .claude-plugin/plugin.json 字段完整(至少有 name / version / description;author 推荐但可选)
✅ README.md 包含安装和使用说明
✅ 所有命令和Skills已测试通过
✅ 无硬编码密钥或敏感信息
✅ .gitignore 排除了不必要的文件
✅ LICENSE 文件存在claude-code-plugin、claude-code、ai-pluginclaude-code-plugin topic 方便社区搜索发现jeremylongshore/claude-code-plugins-plusanthropics/claude-code 的 Discussions 板块分享code.claude.com/plugins 查看提交指南--plugin-dir 指定后,Plugin的命令/Skills没有生效| 原因 | 解决方案 |
|---|---|
| commands目录路径错误 | 确认在Plugin根目录下有 commands/ 目录 |
| 命令文件不是.md格式 | 命令文件必须是 .md 后缀 |
| .claude-plugin/plugin.json 缺失 | 确认Plugin根目录下有 .claude-plugin/plugin.json |
| 文件权限问题 | 确认文件可读:chmod 644 commands/*.md |
claude plugins install 命令?/pluginclaude plugin(别名 claude plugins)/plugin,本地开发和自动化更常用 claude plugin ... 或 --plugin-dir。claude --debug 查看详细日志| 资源 | 链接 | 说明 |
|---|---|---|
| 上一节 | 07-Skills定制完整指南 | 创建可复用功能包 |
| 下一节 | 09-Agent-SDK完整指南 | 编程开发AI Agent |
| 操作 | 命令 |
|---|---|
| 安装Plugin | /plugin install <name> |
| 浏览市场 | 交互里输入 /plugin,或浏览器访问 code.claude.com/plugins |
| 本地开发加载 | claude --plugin-dir .claude/plugins/<name> |
| 本地加载多个 | claude --plugin-dir ./a --plugin-dir ./b |
| 更新本地克隆 | cd .claude/plugins/<name> && git pull |
| 卸载本地Plugin | rm -rf .claude/plugins/<name> |
| 查看Plugin信息 | cat .claude/plugins/<name>/.claude-plugin/plugin.json |
| 开发时重载 | 修改后重新启动会话,或重新以 --plugin-dir 进入调试 |
| 调试Plugin | claude --plugin-dir <path> --debug |
my-plugin/
├── .claude-plugin/
│ └── plugin.json # 必需:元数据清单
├── .mcp.json # 可选:MCP配置
├── README.md # 推荐:文档
├── commands/*.md # 可选:Slash命令
├── skills/*/SKILL.md # 可选:Agent能力
├── agents/*.md # 可选:Agent定义
└── hooks/*.py # 可选:自动化脚本💡 命名空间:Plugin中的Skills会自动添加命名空间前缀,格式为 /plugin-name:skill-name,避免与其他Plugin冲突。
最后更新:2026年5月8日 | 适用版本:Claude Code v2.1.133