插件(Plugin)是 Claude Code 中最高级别的扩展机制,用于将命令、代理、Skills、钩子、MCP、LSP 等能力打包、版本化、共享和分发。
插件 = 一组可复用的 Claude Code 扩展能力集合
一个插件可以包含:
- 斜杠命令(Slash Commands)
- 子代理(Agents)
- Skills(能力说明)
- Hooks(事件钩子)
- MCP 服务器(外部工具/服务)
- LSP 服务器(代码智能)
插件的核心目标只有一个:
让 Claude Code 的能力像工具箱"一样被复用,而不是每个项目重复配置
Claude Code 支持两种扩展方式:
方式 命令形式 适合场景
独立配置(
.claude/)
/hello 个人使用、单项目、快速实验
插件(
.claude-plugin/)
/plugin-name:hello 团队共享、跨项目、版本化
- 只在当前项目使用
- 个人工作流
- 尚未稳定的实验性配置
- 想要简短命令名(如
/review)
- 要在多个项目复用
- 要分享给团队或社区
- 需要版本控制、升级、回滚
- 计划通过市场分发
- 可以接受命名空间命令(避免冲突)
**实践:
先在
.claude/中迭代 → 稳定后打包为插件
my-plugin/ ├── .claude-plugin/ │ └── plugin.json # 插件清单(必需) ├── commands/ # 斜杠命令 ├── agents/ # 子代理 ├── skills/ # Skills ├── hooks/ # 钩子 ├── .mcp.json # MCP 配置 └── .lsp.json # LSP 配置
重要规则
.claude-plugin/目录中只能放plugin.json- 其他目录必须在插件根目录
插件的"身份证",决定:
- 插件名称
- 命令命名空间
- 版本
- 作者信息
示例:
{ "name": "my-first-plugin", "description": "A greeting plugin to learn the basics", "version": "1.0.0", "author": { "name": "Your Name" } }
关键字段说明:
位于 commands/ 目录 每个命令 = 一个 Markdown 文件 文件名 = 命令名
示例:
commands/hello.md
对应命令:
/my-first-plugin:hello
--- description: Greet the user with a friendly message --- Greet the user warmly and ask how you can help them today.
使用 $ARGUMENTS 捕获用户输入:
Greet the user named "$ARGUMENTS" warmly.
调用:
/my-first-plugin:hello Alex
使用 --plugin-dir 直接加载插件目录:
claude --plugin-dir ./my-plugin
特点:
- 不需要安装
- 修改后需重启 Claude Code
- 支持同时加载多个插件
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b
插件通过市场分发,本质是一个插件目录仓库。
默认已添加 运行 /plugin → Discover

安装插件:
/plugin install plugin-name@claude-plugins-official
推荐:
- 团队工具 → 项目范围
- 个人效率工具 → 用户范围
- TypeScript、Python、Go、Rust 等
- 提供跳转定义、引用、类型错误
需要本地安装对应语言服务器
GitHub / GitLab Jira / Notion Slack / Figma Vercel / Supabase
本质:插件 = MCP 服务器 + 配置
Git 提交、PR 代码审查代理 插件开发工具
/plugin # 打开插件管理器 /plugin install # 安装插件 /plugin uninstall # 卸载 /plugin enable/disable # 启用 / 禁用 /plugin marketplace add # 添加市场 /plugin marketplace rm # 移除市场
原来 迁移后 .claude/commands plugin/commands .claude/agents plugin/agents settings.json hooks plugin/hooks/hooks.json
迁移后:
插件版本优先生效 可删除旧 .claude/ 配置避免重复
你已经有稳定的 Claude 工作流 你在反复复制 .claude/ 团队成员开始问你:"这个怎么配置?" 你希望 Claude 像 IDE 插件一样可控
插件,是 Claude Code 从"个人 AI 助手"走向"工程化工具"的分水岭
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/276351.html