Claude Code 插件

点击下方👇“【贵气星球的奇妙瞬间】”关注公众号

千万一线医信行业工作者共同学习、成长

如果本篇文章对您有帮助或有价值，记得点赞分享给更多人

加入群聊，行业动态，交流HIT技术，学习AI知识

引言：插件（Plugin）是 Claude Code 中最高级别的扩展机制，用于将命令、代理、Skills、钩子、MCP、LSP 等能力打包、版本化、共享和分发。

插件 = 一组可复用的 Claude Code 扩展能力集合

一个插件可以包含：

斜杠命令（Slash Commands）
子代理（Agents）
Skills（能力说明）
Hooks（事件钩子）
MCP 服务器（外部工具/服务）
LSP 服务器（代码智能）

插件的核心目标只有一个：
让 Claude Code 的能力像工具箱"一样被复用，而不是每个项目重复配置

插件 vs 独立配置（如何选择）

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
其他目录必须在插件根目录

插件清单（plugin.json）

插件的"身份证"，决定：

插件名称
命令命名空间
版本
作者信息

示例：

{"name":"my-first-plugin","description":"A greeting plugin to learn the basics","version":"1.0.0","author":{"name":"Your Name"}}

关键字段说明：

字段	作用
name	唯一标识 + 命令命名空间
description	插件市场中展示
version	语义化版本控制
author	可选，归属说明

斜杠命令（最常用插件能力）

1、命令定义方式

位于 commands/ 目录
每个命令 = 一个 Markdown 文件
文件名 = 命令名

示例：

commands/hello.md

对应命令：

/my-first-plugin:hello

2、命令内容示例

---description:Greet the user with a friendly message---Greet the user warmly and ask how you can help them today.

3、命令参数

使用 $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

插件还能做什么

能力	用途
Commands	自定义斜杠命令
Agents	专用子代理
Skills	教会 Claude 何时用某种能力
Hooks	自动化（写完文件后执行命令等）
MCP	连接外部服务（GitHub、DB、API）
LSP	代码智能（跳转、类型检查）

插件市场（Plugin Marketplace）

插件通过市场分发，本质是一个插件目录仓库。

官方市场

默认已添加
运行 /plugin → Discover

安装插件：

/plugin install plugin-name@claude-plugins-official

插件安装范围

范围	说明
用户范围	仅你自己，所有项目
项目范围	当前仓库，团队共享
本地范围	当前仓库，仅你

典型插件分类

1、代码智能（LSP）

TypeScript、Python、Go、Rust 等
提供跳转定义、引用、类型错误

需要本地安装对应语言服务器

2、外部集成（MCP）

GitHub / GitLab
Jira / Notion
Slack / Figma
Vercel / Supabase

本质：插件 = MCP 服务器 + 配置

3、开发工作流

Git 提交、PR
代码审查代理
插件开发工具

插件管理常用命令

/plugin                # 打开插件管理器/plugin install         # 安装插件/plugin uninstall       # 卸载/plugin enable/disable  # 启用 / 禁用/plugin marketplace add # 添加市场/plugin marketplace rm  # 移除市场