在使用 Claude Code 时最常见的痛点之一就是手动逐项配置耗时且易出错。通过插件可以一次性打包所有功能，省去繁琐步骤，让团队协作更顺畅。不过，

一、Plugin 目录结构

一个最简单的插件结构示例：

my-plugin/
└── .claude-plugin/
└── plugin.json

唯一必须文件是：

.claude-plugin/plugin.json

如果你想建立更完整的功能包，例如 Java 开发工具包。可以参考以下高级结构：

java-dev-plugin/
├── .claude-plugin/plugin.json
├── skills/
│ ├── springboot/
│ └── mybatis/
├── agents/
│ ├── architect.md
│ └── performance.md
├── hooks/
│ └── hooks.json
├── .mcp.json
└── .lsp.json

安装后 Claude 自动获取 SpringBoot 专家技能、MyBatis 专家技能、架构师 Agent 等，一次安装即拥有完整开发工具链。

二、Plugin Manifest

插件身份信息写在 .claude-plugin/plugin.json。再看示例内容如下，

{
至于"name"，"plugin-name","displayName": "Plugin Name","version": ".","description": "Brief plugin description","author": {
再看"name"，"Author Name","email": "","url": "https://github.com/author"
},...
}

字段	作用
name	唯一标识。用于程序识别和加载
displayName	给使用者看的名字，提高可读性
description	功能简介，帮助快速判断是否需要使用该插件
sensitive 配置	"sensitive:true" 的字段会安全存储，避免 API Key 泄漏，解决了安全顾虑痛点。

User Config 示例

{
"userConfig": {
"api_endpoint": {
从"type"来看，"string","title":"API endpoint","description":"Your team's API endpoint"
},"api_token": {
说到"type"，"string","title":"API token","description":"API auntication token",**"sensitive":true**
}
}
}

插件环境变量说明

${CLAUDE_PLUGIN_DATA}

This environment variable stores runtime data directories,not code itself.

${CLAUDE_PLUGIN_ROOT}

This variable points to installation directory。allowing scripts to reference plugin files easily:

{
command: 'node ${CLAUDEPLUGINROOT}/bin/audit.js'
}

三、Plugin Monitors 和 LSP 支持

LSP 支持示例

{
"typescript":{
"command":"typescript-language-server","args":,"extensionToLanguage":{
再看".ts"，"typescript"," .tsx":"typescriptreact"
}
}
}

• Avoids relying on model for syntax checks.
• Presents real-time diagnostics and type info.
• Makes collaboration consistent across team members.
• Saves time that would orwise be spent debugging manually.

LSP 的最大价值：语义信息，而非纯粹诊断。

MCP Monitor 示例

{
"name"的观点是，"deploy-status","command":"tail -F ./logs/error.log"。"description":"Application error log"
}

• 可以控制启动时机，如仅在 debug 时才激活，减少资源使用情况。

四、加载 & 热重载 插件方式

本地开发测试

claude --plugin-dir ./my-plugin
This temporarily loads plugin until session ends.

For multiple plugins:

claude \
--plugin-dir ./my-plugin \
--plugin-dir ./anor-plugin

远程 ZIP 测试

如果你已经打包成 tag.zip:。可直接加载： text claude --plugin-url https://example.com/my-plugin.zip 多包可叠加这方面，text claude \ --plugin-url https://a.zip \ --plugin-url https://b.zip 这能快速验证第三方插件是否兼容。说起来，``

• <风险>
• <安全>

热重载

text /reload-plugins

此命令立即重新读取所有已挂载目录中的 plugin.json 并刷新能力。无需重启 CLI，话说回来，

Marketplace交互方式

使用斜杠命令 /plugins 打开管理界面。默认只提供官方行业市场：

text claude-plugins-official

从安装示例来看，

text /plugin install code-review@claude-plugins-official

若需添加自定义仓库: text /plugin marketplace add ccplugins/awesome-claude-code-plugins

在 Discover 界面即可搜索并安装。

---

五、Subagent 权限限制

• Agent 是行为主体，只负责定义思考方式和审查策略； 不具备直接声明程序权限的能力。

Plugin 才是权限主体；它在安装时声明所需的 MCP Hook Monitor LSP UserConfig 等，而且在使用者授权后才可使用。

举个不允许 Agent 声明权限的错误配置: json { "name"这方面，"Security Expert","mcpServers":,"hooks":,**permissionMode**:"bypass" } 正确做法是让 Plugin 声明： json { 再看"name"，"github-review",".mcp.json": "./.mcp.json"。".hooks.json":"./hooks.json" }

---

六、管理插件

命令	作用
claude plugin list	查看已安装插件列表，可快速了解当前环境中哪些功能已启用。

claude plugin validate 检查配置文件是否合法，防止因为拼写错误导致无效或冲突。

claude plugin uninstall 彻底移除指定插件及其所有文件。用于清理不再需要的工具包。不过，

claude plugin disable / enable 临时关闭/打开某个功能。而不需要卸载，从而方便实验与回滚。若有同名冲突，可指定仓库：disable code-review@ccplugins.

Scope 参数： --scope user/project/local 可细粒度控制谁能看到此设置。​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​   ---scope user/project/local: 使用者级 / 项目级 / 本地项目级。若未指定则默认为全局启用/禁用，但仍受 Scope 默认值影响。对于团队协作将禁用设置到 project 或 local 层更安全，也能避免意外覆盖团队统一标准。支持--force --no-confirm,用于批量调整. 如要永久禁用某个公共仓库。请在~/.config/cli/plugins-disable.list`.

​ ​ ​ ​

---

---

。

---