Logo Vincent
返回文章列表

Claude Code /plugin 详解：给你的 AI 编程助手装插件

Claude
Claude Code /plugin 详解：给你的 AI 编程助手装插件

为什么需要 /plugin

Claude Code 自带 40+ 工具和 80+ 命令，已经很强了。但每个团队、每个项目的需求不同——有人想加一个一键部署的命令，有人想接入内部的 MCP 服务，有人想让 Claude 在每次提交前自动跑检查。

靠内置功能满足所有人是不现实的。所以 Claude Code 做了一套插件系统，让你自己扩展它的能力。

/plugin 就是管理这些插件的入口。

/plugin 是什么

/plugin 是 Claude Code 的插件管理命令（别名 /plugins、/marketplace）。它提供一个交互式界面，让你浏览、安装、启用、禁用和管理插件。

输入：

/plugin

会弹出插件管理界面，显示已安装的插件列表和可用的 Marketplace。

插件能做什么

一个插件可以包含以下任意组合：

组件说明举例
Commands自定义斜杠命令/build、/deploy
SkillsAI 技能（SKILL.md 格式）代码审查技能、测试生成技能
AgentsAI 子代理专门跑测试的 Agent
Hooks生命周期钩子提交前自动 lint
MCP ServersMCP 协议服务器连接数据库、内部 API
LSP Servers语言服务协议自定义语言支持
Output Styles终端输出样式自定义主题

简单说，插件是给 Claude Code 加功能的标准化方式。

插件的结构

一个典型的插件目录长这样：

my-plugin/
├── plugin.json          # 插件清单（元数据 + 组件声明）
├── commands/            # 自定义命令
│   ├── build.md
│   └── deploy.md
├── skills/              # AI 技能
│   └── code-review/
│       └── SKILL.md
├── agents/              # AI 代理
│   └── test-runner.md
├── hooks/               # 生命周期钩子
│   └── hooks.json
├── .mcp.json            # MCP 服务器配置
└── data/                # 持久化数据目录

核心是 plugin.json，它声明了插件的所有元数据和组件：

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "A custom plugin for my team",
  "author": {
    "name": "Your Name"
  },
  "commands": "./commands",
  "skills": "./skills",
  "agents": "./agents",
  "hooks": "./hooks/hooks.json",
  "mcpServers": {
    "my-db": {
      "command": "npx",
      "args": ["my-mcp-server"]
    }
  }
}

安装和管理

交互式管理

/plugin

进入图形界面，可以直接操作插件的安装、启用和禁用。

命令行管理

更适合脚本和自动化：

# 安装插件
claude plugin install my-plugin@github:owner/repo

# 卸载
claude plugin uninstall my-plugin@github:owner/repo

# 启用 / 禁用
claude plugin enable my-plugin@github:owner/repo
claude plugin disable my-plugin@github:owner/repo

# 更新
claude plugin update my-plugin@github:owner/repo

# 查看已安装
claude plugin list
claude plugin list --json        # JSON 格式输出
claude plugin list --available   # 显示可安装的插件

# 验证插件清单
claude plugin validate ./path/to/plugin.json

三种安装范围

范围配置位置影响谁
user~/.claude/settings.json你的所有项目
project.claude/settings.json这个仓库的所有协作者
local.claude/settings.local.json只有你、只有这个仓库副本

通过 --scope 参数指定：

claude plugin install my-plugin@marketplace --scope project

默认范围是 user。

Marketplace

Marketplace 是插件的来源。你可以添加多个 Marketplace：

# 添加 GitHub 仓库作为 Marketplace
claude plugin marketplace add github:owner/plugin-repo

# 查看已添加的 Marketplace
claude plugin marketplace list

# 更新 Marketplace 缓存
claude plugin marketplace update

# 移除
claude plugin marketplace remove marketplace-name

Marketplace 支持多种来源：

  • GitHub 仓库：github:owner/repo
  • Git URL：任意 Git 仓库
  • URL：直接指向 marketplace.json 的链接
  • 本地目录：开发调试用

插件标识符

每个插件的唯一标识是 name@marketplace，例如：

  • my-tool@github:owner/repo — 来自 GitHub Marketplace
  • dev-util@builtin — 内置插件
  • test-plugin@inline — 会话级插件（通过 --plugin-dir 加载）

内置插件

Claude Code 自带一些内置插件，标识为 @builtin。它们和第三方插件一样可以启用或禁用，但不需要安装——直接随 CLI 发布。

在 /plugin 界面中，内置插件会显示在单独的 “Built-in” 区域。

插件的环境变量

插件内的命令、Hook 和 MCP 配置可以使用以下变量：

变量值用途
${CLAUDE_PLUGIN_ROOT}插件安装路径引用插件内的文件
${CLAUDE_PLUGIN_DATA}~/.claude/plugins/data/<id>/持久化数据目录
${CLAUDE_SKILL_DIR}技能子目录路径技能内部使用
${CLAUDE_SESSION_ID}当前会话 ID跨工具关联
${user_config.KEY}用户配置的值动态参数

${CLAUDE_PLUGIN_DATA} 目录在插件更新后依然保留，适合存放用户数据。

用户配置

插件可以声明用户需要填写的配置项：

{
  "userConfig": {
    "API_KEY": {
      "type": "secret",
      "description": "Your API key for the service",
      "sensitive": true
    },
    "BUILD_FLAGS": {
      "type": "string",
      "description": "Extra build flags",
      "default": "--production"
    }
  }
}

安装插件后，Claude Code 会提示用户填写这些配置。敏感字段（如 API Key）不会出现在命令内容中。

/reload-plugins

修改了插件配置后，不需要重启 Claude Code。直接：

/reload-plugins

它会：

  1. 清空插件缓存
  2. 重新加载所有插件
  3. 报告加载结果：插件数、技能数、Agent 数、Hook 数、MCP/LSP 服务器数
  4. 如果有加载错误，会明确提示

插件 Hook 系统

插件可以注册 Hook 来监听 Claude Code 的生命周期事件。支持的事件包括：

  • SessionStart / SessionEnd — 会话开始和结束
  • PreToolUse / PostToolUse — 工具调用前后
  • UserPromptSubmit — 用户提交消息时
  • PreCompact / PostCompact — 上下文压缩前后
  • Stop — Claude 停止响应时

Hook 配置示例：

{
  "PreToolUse": [
    {
      "matcher": "Bash",
      "hooks": [
        {
          "name": "lint-before-bash",
          "command": "echo 'Running pre-check...'"
        }
      ]
    }
  ]
}

错误排查

插件加载失败？用 /doctor 命令可以看到所有插件错误的详细信息。

常见错误类型：

  • plugin-not-found — Marketplace 中找不到该插件
  • manifest-parse-error — plugin.json 格式错误
  • dependency-unsatisfied — 依赖的其他插件未启用
  • mcp-config-invalid — MCP 服务器配置错误

实际使用场景

场景 1：团队共享命令

你的团队有一套标准的部署流程。把它封装成插件，放到 .claude/settings.json（project 范围），所有人 clone 仓库后就自动拥有 /deploy 命令。

场景 2：接入内部工具

公司有一个内部 MCP 服务器，连接着数据库和监控系统。通过插件声明 MCP 配置，团队成员安装后就能让 Claude 直接查询生产数据。

场景 3：自定义代码检查

写一个 Hook 插件，在每次 Claude 修改文件后自动运行你的 lint 和 type-check。发现问题立即反馈，不用等到提交时才发现。

场景 4：开发调试

开发自己的插件时，用 --plugin-dir 参数临时加载本地目录：

claude --plugin-dir ./my-local-plugin

调试完成后再发布到 Marketplace。

写在最后

/plugin 把 Claude Code 从一个”固定功能的工具”变成了一个可扩展的平台。

你不再受限于 Claude Code 内置了什么——如果缺少某个功能，自己写一个插件就行。而且通过 Marketplace 和安装范围机制，插件可以在团队间轻松共享。

好的工具不是什么都做，而是让你能做任何事。

相关推荐

AI-first 创业公司，为什么只需要一种编程语言？

技术架构越简单 = AI Coding 效率越高。从 Java 的"防人"设计到 TypeScript 全栈通吃，聊聊 AI 时代创业公司的编程语言选择。

cc-ping：一行命令 Ping 所有 Claude Code 配置

用多个 Claude Code API Key 或中继？cc-ping 帮你管理配置、一键切换，还能并行 Ping 所有节点比速度。

震惊！程序员用这个工具，4分钟干完95分钟的活！效率暴涨24倍

躺床上发3条消息，4分钟搞定3个项目。传统方式需要95分钟，这就是冷兵器和热兵器的差距。

CCBot - 研发提效 24 倍

通过 IM 机器人控制 Claude Code，3 个项目 4 分钟全部搞定。传统编程需要 95 分钟，效率提升 24 倍。

Claude Code /add-dir：被低估的 Monorepo 神器

Claude Code 默认只能看到当前目录。/add-dir 打破这个限制——分享我每天跨 5 个仓库使用的经验。

Claude Code 省 Token 小技巧：感叹号的妙用

一个简单却容易被忽略的技巧——用感叹号直接执行命令，省 token、提速度、更可控。

我做了个机器人，让团队在飞书里用 Claude Code

CCBot 让你的团队在飞书群聊里直接用 Claude Code——不需要终端、不需要 SSH。开源、自部署、五分钟搞定。

Claude Code /btw 命令详解：不打扰主线的快问快答

详细介绍 Claude Code 的 /btw 命令——它是什么、怎么用、什么时候该用，以及它和子代理、/compact 的区别。

Claude Code /compact：释放上下文，不丢进度

任务做到一半上下文满了？/compact 帮你压缩对话继续干活——和 /clear、/rewind 的区别一次讲清。

Claude Code /config：一文搞懂所有可调设置

用 Claude Code 却从没打开过 /config？这篇带你逐项拆解——从权限模式到自动压缩，从主题切换到通知配置，帮你打造最顺手的 AI 编程环境。

Claude Code /context：你的上下文都被什么吃了？

对话到一半 Claude Code 说上下文不够了？/context 用一张可视化网格告诉你：上下文被什么占了、占了多少、怎么优化。

Claude Code /diff：这次对话改了什么，一目了然

Claude Code 帮你改了一堆文件，但你不确定到底改了什么？/diff 用交互式界面展示所有改动——既有 git 视角的全量 diff，也有按对话轮次拆分的逐步 diff。

Claude Code /fast：同样的 Opus，两倍速——值不值？

/fast 不会降级模型，还是 Opus，只是更快。什么时候该开、什么时候该关，以及实际体验差异。

Claude Code 引用外部知识的最佳实践：GitHub MCP + Context7

用 GitHub MCP 和 Context7 MCP 两个工具组合，解决 Claude Code 知识过时导致的代码错误问题。

Claude Code /hooks：让 AI 按你的规矩办事

想在 Claude Code 执行命令前自动检查？想在任务完成后自动通知？/hooks 让你用脚本、AI 甚至 HTTP 请求，在关键节点插入自定义逻辑。

Claude Code /init：10 秒自动生成 CLAUDE.md

别再手写 CLAUDE.md 了。看看 /init 自动生成的效果、怎么自定义输出，以及一个让 Claude Code 效率翻倍的小技巧。

Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具

MCP 把 Claude Code 从代码阅读器升级为全栈 Agent。哪些 MCP 服务器值得装、配置怎么写，实测分享。

Claude Code /memory 详解：让 AI 真正记住你的项目

详细介绍 Claude Code 的 /memory 命令和记忆系统——CLAUDE.md 手动指令、Auto Memory 自动记忆、模块化规则，让 Claude 跨会话记住项目规范和个人偏好。

Claude Code /model：Opus、Sonnet、Haiku 怎么选？

不是每个任务都需要 Opus。怎么切换模型、哪个场景用哪个、怎么省 token 又不掉质量。

Claude Code /permissions：谁能干什么，你说了算

每次 Claude Code 要跑命令都弹窗问你？嫌烦又不敢全放开？/permissions 帮你精细控制每个工具的权限——该放的放，该拦的拦。

Claude Code /plan 详解：先想清楚再动手

详细介绍 Claude Code 的 /plan 命令和 Plan Mode——只读规划模式，让 Claude 先分析代码、制定方案，确认后再动手，避免复杂任务翻车。

Claude Code + Playwright MCP：AI 终于能"看见"页面了

一个 Modal 溢出的 bug，Claude Code 反复修了 5 次都没搞定。直到接入 Playwright MCP 让它真正看到页面，一次定位，一次修复。

Claude Code /resume 命令详解：别让对话白聊

详细介绍 Claude Code 的 /resume 命令——恢复历史对话、管理会话、实用技巧，让你的每一轮对话都不浪费。

Claude Code /review：让 AI 帮你做 Code Review

提了 PR 没人看？想在合并前多一道把关？/review 让 Claude Code 像一个资深开发者一样审查你的代码——还有 /ultrareview 和 /security-review 两个进阶选择。

Claude Code Skills 详解：打造你的专属命令库

详细介绍 Claude Code 的 Skills 功能——创建自定义斜杠命令、复用提示词模板、共享团队最佳实践，让 AI 编程更高效更一致。

Claude Code /stats：看看 AI 到底帮你写了多少代码

好奇 Claude Code 到底写了多少行代码？/stats 给你完整数据——token、编辑次数、工具调用，教你怎么看。

Claude Code /status 命令详解：一眼看清会话全貌

详细介绍 Claude Code 的 /status 命令——它是什么、怎么用、能看到哪些信息，以及它在日常工作流中的实际价值。

Claude Code /tasks 命令详解：后台任务尽在掌控

详细介绍 Claude Code 的 /tasks 命令——查看后台任务、管理并行 Agent、掌控长时间运行的进程，让多任务开发井井有条。

Claude Code /usage 命令详解：你的额度还剩多少

详细介绍 Claude Code 的 /usage 命令——查看用量、了解限额、避免突然被限速，让你对自己的额度心中有数。

Claude Code /vim：在 AI 编程助手里用 Vim 键位

习惯了 Vim 的操作方式？/vim 让你在 Claude Code 的输入框里用 hjkl 移动、dd 删行、ciw 替换单词——不用改变肌肉记忆。

Claude Code 使用指南：从安装到实战，一篇就够（2026）

用了半年 Claude Code 的经验总结——5 分钟安装配置、最常用的命令、CLAUDE.md 编写技巧，以及没人告诉你的实战心得。

Claude 全家桶：从聊天到写代码到自动办公，一文讲清楚

一篇文章带你了解 Anthropic 的 Claude 全家桶——Claude.ai、Claude Code、Claude Cowork，以及 Opus、Sonnet、Haiku 三大模型家族。

Claude Code /agents 详解：自定义 AI 子代理，各司其职

详细介绍 Claude Code 的 /agents 命令——查看、管理和创建自定义 Agent，让不同任务由专门的 AI 角色来执行，从代码探索到架构规划各司其职。

Claude Code /doctor 详解：一键诊断你的开发环境

详细介绍 Claude Code 的 /doctor 命令——自动检测安装状态、API 连接、MCP 配置、上下文用量等问题，帮你快速定位和修复环境故障。

Claude Code /effort 详解：控制 AI 思考的深度

详细介绍 Claude Code 的 /effort 命令——调节 Claude 的推理努力程度，在速度和质量之间找到最佳平衡点，让每一次对话都恰到好处。

Claude Code /cost 详解：你的 AI 编程到底花了多少钱

详细介绍 Claude Code 的 /cost 命令——实时查看会话 API 成本，了解各模型定价和 Token 消耗明细，让每一分钱都花得明明白白。

Claude Code /export 详解：把 AI 对话带走

详细介绍 Claude Code 的 /export 命令——将对话导出为文件或复制到剪贴板，方便分享、存档和复盘，让每一次有价值的对话都不浪费。

Claude Code /rewind 详解：AI 改错了？一键回退

详细介绍 Claude Code 的 /rewind 命令——将代码和对话回退到任意历史节点，支持只回退代码、只回退对话、或两者同时回退，是你和 AI 协作时的后悔药。

Claude Code /theme 详解：给你的终端换个好看的皮肤

详细介绍 Claude Code 的 /theme 命令——6 种预设主题 + 自动模式，支持深色/浅色、色盲友好、ANSI 兼容，60+ 色值覆盖终端全部 UI 元素。

Claude Code /insights 详解：用 AI 分析你自己用 AI 的方式

详细介绍 Claude Code 的 /insights 命令——五阶段数据分析流水线、七大洞察章节、多维度会话统计，用 Claude Opus 生成专属 HTML 使用报告。

Claude Code /rename 详解：给你的会话取个有意义的名字

详细介绍 Claude Code 的 /rename 命令——手动命名、AI 自动生成（Haiku 模型）、启动参数命名、Plan 模式自动命名，以及双标题系统与 Bridge 同步机制。

Claude Code settings.json 详解（一）：配置文件在哪里、谁说了算

全面介绍 Claude Code 的配置文件体系——五个配置来源的路径、优先级规则、数组合并与单值覆盖的区别、企业管理设置的多种下发方式。

Claude Code settings.json 详解（二）：permissions 权限系统全解析

深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义，以及 additionalDirectories 的作用。

Claude Code settings.json 详解（三）：hooks 钩子全解析

深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件（PreToolUse/PostToolUse/Stop/Notification）、stdin/stdout 协议、exit code 语义，以及实用配置示例。

Claude Code settings.json 详解（四）：env、模型、认证与其他实用字段

全面介绍 Claude Code settings.json 中的 env 环境变量注入、模型配置、身份认证辅助、Git 提交署名、会话清理、语言与界面、思考深度、自动更新、记忆系统等实用字段。

Claude Code Agent Loop：拆解 AI 编程助手的心脏

Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的？从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复，一次讲透。

© 2026 vincentqiao.com . 保留所有权利。