🎬 HoRain云小助手个人主页

 🔥 个人专栏: 《Linux 系列教程》《c语言教程

⛺️生活的理想,就是为了理想的生活!


⛳️ 推荐

前些天发现了一个超棒的服务器购买网站,性价比超高,大内存超划算!忍不住分享一下给大家。点击跳转到网站。

专栏介绍

专栏名称

专栏介绍

《C语言》

本专栏主要撰写C干货内容和编程技巧,让大家从底层了解C,把更多的知识由抽象到简单通俗易懂。

《网络协议》

本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘,一起解密网络协议在运行中协议的基本运行机制!

《docker容器精解篇》

全面深入解析 docker 容器,从基础到进阶,涵盖原理、操作、实践案例,助您精通 docker。

《linux系列》

本专栏主要撰写Linux干货内容,从基础到进阶,知识由抽象到简单通俗易懂,帮你从新手小白到扫地僧。

《python 系列》

本专栏着重撰写Python相关的干货内容与编程技巧,助力大家从底层去认识Python,将更多复杂的知识由抽象转化为简单易懂的内容。

《试题库》

本专栏主要是发布一些考试和练习题库(涵盖软考、HCIE、HRCE、CCNA等)

目录

⛳️ 推荐

专栏介绍

插件 vs 独立配置(如何选择)

什么时候用独立配置?

什么时候用插件?

插件的最小结构(必须记住)

插件清单(plugin.json)

斜杠命令(最常用插件能力)

1、命令定义方式

2、命令内容示例

3、命令参数

本地测试插件(开发必会)

插件还能做什么

插件市场(Plugin Marketplace)

官方市场

插件安装范围

典型插件分类

1、代码智能(LSP)

2、外部集成(MCP)

3、开发工作流

插件管理常用命令

从 .claude/ 迁移到插件(核心思路)

什么时候你一定要用插件?


img

插件(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  # 移除市场

从 .claude/ 迁移到插件(核心思路)

原来 迁移后
.claude/commands plugin/commands
.claude/agents plugin/agents
settings.json hooks plugin/hooks/hooks.json

迁移后:

  • 插件版本优先生效
  • 可删除旧 .claude/ 配置避免重复

什么时候你一定要用插件?

  • 你已经有稳定的 Claude 工作流
  • 你在反复复制 .claude/
  • 团队成员开始问你:"这个怎么配置?"
  • 你希望 Claude 像 IDE 插件一样可控

插件,是 Claude Code 从"个人 AI 助手"走向"工程化工具"的分水岭

❤️❤️❤️本人水平有限,如有纰漏,欢迎各位大佬评论批评指正!😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话,也请给个点赞、收藏下吧,非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧!🌙🌙🌙

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐