ClaudeCode的Plugins学习

- [1. Plugins 介绍](#1. Plugins 介绍)
- - [1.1 插件介绍](#1.1 插件介绍)
  - [1.2 插件作用域](#1.2 插件作用域)
- [2. Plugins 格式](#2. Plugins 格式)
- - [2.1 插件目录结构](#2.1 插件目录结构)
  - [2.2 插件命令](#2.2 插件命令)
- [3 插件安装](#3 插件安装)
- - [3.1 插件市场安装](#3.1 插件市场安装)
  - [3.2 自定义插件安装](#3.2 自定义插件安装)

1. Plugins 介绍

1.1 插件介绍

**Plugins(插件)**是一个自包含的组件目录，用于为 Claude Code 扩展自定义功能。插件组件包括Skill技能、agent智能体、Hooks钩子、MCP 服务器、LSP 服务器和监视器。

Plugin 是一个 "容器"，可包含 MCP、Agent、Hook、Skill/LSP 等一个或多个组件。一个MCP也可以是一个插件

组件	核心定位	触发方式	存放 / 配置位置
Agent（代理）	专项任务专家智能体，负责复杂领域任务	手动调用 / 任务调度	`agents/` 目录
MCP Server	外部工具连接器，对接第三方系统	工具调用时自动连接	`.mcp.json`
Skill（技能）	模型可自动调用的功能单元	自动触发 / 手动 `/skill`	`skills/` 目录
Hook（钩子）	事件驱动自动执行脚本	会话 / 文件 / 命令等事件	`hooks/hooks.json`
LSP 服务器	代码语义分析引擎，提供 IDE 级代码理解	打开代码文件自动启动	系统环境 + 语言服务（pyright、gopls、ts-server 等）
Monitor 监视器	Token、成本、会话状态监控面板	全程后台运行	内置模块 / 独立监控工具M o n Claude Code 内置 / 可扩展的全链路监控与成本控制组件

1.2 插件作用域

作用域（Scope）	配置文件路径（Settings file）	使用场景（Use case）
`user`（用户级）	`~/.claude/settings.json`	个人插件，在所有项目中生效（默认配置）
`project`（项目级）	`.claude/settings.json`	团队插件，可通过版本控制共享
`local`（本地级）	`.claude/settings.local.json`	项目专属插件，默认被 `.gitignore` 忽略，不提交到版本库
`managed`（托管级）	Managed settings（托管配置）	由平台统一管理的插件（只读，仅可更新）

插件本身的文件 还是放在指定的路径里（比如 ~/claude-plugins/my-first-plugin），不会被移动。

Claude Code 会把这个插件的引用配置，写入到 对应目录结构/.claude/settings.json 文件里。

2. Plugins 格式

2.1 插件目录结构

sh 复制代码

enterprise-plugin/
├── .claude-plugin/           # 元数据目录（可选）
│   └── plugin.json             # 插件清单文件
├── skills/                   # 技能模块
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── pdf-processor/
│       ├── SKILL.md
│       └── scripts/
├── commands/                 # 以独立 .md 文件形式定义的技能
│   ├── status.md
│   └── logs.md
├── agents/                   # 子智能体定义
│   ├── security-reviewer.md
│   ├── performance-tester.md
│   └── compliance-checker.md
├── output-styles/            # 输出风格定义
│   └── terse.md
├── monitors/                 # 后台监控配置
│   └── monitors.json
├── hooks/                    # 钩子配置
│   ├── hooks.json           # 主钩子配置
│   └── security-hooks.json  # 扩展安全钩子
├── bin/                      # 插件可执行文件（会加入系统 PATH）
│   └── my-tool               # 可在 Bash 工具中直接作为命令调用
├── settings.json            # 插件默认配置
├── .mcp.json                # MCP 服务端定义
├── .lsp.json                # LSP 服务端配置
├── scripts/                 # 钩子与工具脚本
│   ├── security-scan.sh
│   ├── format-code.py
│   └── deploy.js
├── LICENSE                  # 许可证文件
└── CHANGELOG.md             # 版本更新记录

一级目录	说明
`.claude-plugin/plugin.json`	# 插件清单文件文件定义了插件的元数据和配置
`skills/`	插件能力模块目录
`commands/`	自定义命令目录
`agents/`	智能代理配置目录
`output-styles/`	输出风格配置目录
`monitors`	后台监控配置
`hooks`	钩子配置
`bin`	插件可执行文件（会加入系统 PATH）
`settings.json`	插件默认配置
`.mcp.json`	MCP 服务端定义
`.lsp.json`	LSP 服务端配置

2.2 插件命令

插件市场相关命令

sh 复制代码

/plugin marketplace add <来源>
/plugin market add <来源>  # 简写
# 来源可选
- GitHub：`/plugin marketplace add anthropics/claude-code`
- Git 地址：`/plugin marketplace add https://gitlab.com/xxx/plugins.git`
- 本地路径：`/plugin marketplace add ./my-marketplace`
- 远程 JSON：`/plugin marketplace add https://xxx.com/marketplace.json`

#列出所有市场
/plugin marketplace list

#更新市场
/plugin marketplace update <市场名>

#删除市场
/plugin marketplace remove <市场名>
/plugin market rm <市场名>  # 简写

插件相关命令

复制代码

#安装插件
/plugin install <插件名>@<市场名>
/plugin install <插件名>@<市场名> --scope project  # 指定项目范围

#禁用插件
/plugin disable <插件名>@<市场名>

# 启用插件
/plugin enable <插件名>@<市场名>

#卸载插件
/plugin uninstall <插件名>@<市场名>

#重载与生效
/reload-plugins

可视化插件管理面板

sh 复制代码

#查看插件列表
/plugin

Tab 页名	核心功能	适用场景	关键信息
Plugins	插件全局总览 / 入口	插件管理总览、快速跳转	插件功能的统一入口，承接全局管理逻辑
Discover	发现 / 安装可插件	找新插件、安装插件	浏览已添加市场的所有可安装插件，支持搜索安装
Installed	管理已安装插件	查看、启用 / 禁用、卸载插件 / MCP	展示本地 / 用户级已安装项，含状态（connected/failed）
Marketplaces	管理插件市场源	添加、查看、删除市场	配置插件市场的来源（如官方市场、私有市场）
Errors	展示错误日志	排查插件 / 市场加载失败	汇总插件安装、运行、市场同步过程中的错误信息

3 插件安装

安装方式	优点	缺点	适用场景
插件市场安装	自动更新、易管理、支持发现	需配置市场	日常使用、企业分发
自定义插件安装	无需命令行，批量部署方便	无版本管理，易出错	项目级插件、离线部署=

3.1 插件市场安装

使用插件市场好处

安全性 - 所有插件都来自已验证的市场源
版本管理 - 自动处理插件更新和依赖
隔离性 - 插件运行在受控环境中
标准化 - 统一的管理和配置方式

官方市场

Claude Code 默认配置了两个官方插件市场：

claude-plugins-official - 官方插件仓库
anthropic-agent-skills - Anthropic 技能插件

安装示例：

查看可用插件市场
sh 复制代码
/plugin marketplace list
安装插件市场 如果没有
复制代码
# 默认配置了市场
/plugin install github@claude-plugins-official
# 安装一个市场
/plugin marketplace add https://github.com/mixedbread-ai/mgrep
从官方市场安装插件

/plugin install @ [options]
sh 复制代码
# 添加frontend-design 插件 --scope作用域 user 当前用户
/plugin install frontend-design@anthropic-agent-skills --scope user    

3.2 自定义插件安装

参考2.1插件目录结构

复制代码

你的插件文件夹/
├─ .claude-plugin/
│  └─ plugin.json   ←插件清单文件
└─ 其他文件（skills、commands等）

本地安装

把你的自定义插件文件夹放在一个路径
sh 复制代码
/Users/xxx/my-custom-plugin
执行安装命令
复制代码
/plugin install /Users/xxx/my-custom-plugin

#成功提示
Plugin installed successfully
去 Plugins → Installed 就能看到你的插件 ✅