Tools and plugins

创建插件

创建插件这一页讲的，就是创建插件这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

创建插件

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

插件就是把常用本事打包好，别的项目一装就能用。

它可以带上子代理、技能、MCP 配置这些“成套工具”。

像把常用农具装成一套工具箱。下次去另一块地，不用再一把锄头一把铲子重新找。

如果你们团队有固定工作流，插件最适合拿来做复用。

先想清楚这个插件解决的是哪类重复问题，再决定里面放技能、子代理还是外部连接。

插件不要贪多。一个插件最好解决一类明确场景，而不是把所有东西都塞进去。

打包前先问三句

想明白这三句，插件就不容易做成一坨。

1. 这个插件帮谁省时间？
2. 安装后最常用的动作是什么？
3. 团队里哪些项目都能复用？

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

When to use plugins vs standalone configuration

这一段主要是在帮你判断：When to use plugins vs standalone configuration 这种东西到底值不值得现在就上。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Quickstart

别把这段只当成标题看，它其实是在给"Quickstart"划边界。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

Prerequisites

这一块主要是在说"Prerequisites"真到手上该怎么用，哪里最容易踩坑。

Create your first plugin

这一段是在教你把 the plugin directory 真正建出来。文件放哪儿、字段怎么写、建完怎么验，都得跟着看。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

终端里敲

Create your first plugin 1

真到动手的时候了，下面这条直接敲一遍，看它回什么。

mkdir my-first-plugin

终端里敲

Create your first plugin 2

真到动手的时候了，下面这条直接敲一遍，看它回什么。

mkdir my-first-plugin/.claude-plugin

改配置

Create your first plugin 3

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

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

终端里敲

Create your first plugin 4

真到动手的时候了，下面这条直接敲一遍，看它回什么。

mkdir -p my-first-plugin/skills/hello

改配置

Create your first plugin 5

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

终端里敲

Create your first plugin 6

真到动手的时候了，下面这条直接敲一遍，看它回什么。

claude --plugin-dir ./my-first-plugin

Plugin structure overview

看到这里，就把"Plugin structure overview"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Develop more complex plugins

这一段主要是在把"Develop more complex plugins"讲实，不是只摆个标题给你看。

Add Skills to your plugin

这一段主要是在把"Add Skills to your plugin"讲实，不是只摆个标题给你看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

目录怎么摆

Add Skills to your plugin 1

这一段主要是认目录和文件摆放位置。先把地方放对，后面才不容易串。

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

改配置

Add Skills to your plugin 2

这会儿轮到改配置了，字段名和关键字别自己乱换。

---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

Add LSP servers to your plugin

看到这里，就把"Add LSP servers to your plugin"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Add LSP servers to your plugin

这一段说完，最后还得写到配置里才算真的生效。

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

Add background monitors to your plugin

这一块主要是在说"Add background monitors to your plugin"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Add background monitors to your plugin

想把这条规矩固定住，就把下面这块老老实实写进去。

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

Ship default settings with your plugin

这一段主要是在把"Ship default settings with your plugin"讲实，不是只摆个标题给你看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

改配置

Ship default settings with your plugin

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "agent": "security-reviewer"
}

Organize complex plugins

这一块主要是在说"Organize complex plugins"真到手上该怎么用，哪里最容易踩坑。

Test your plugins locally

这一段是在说怎么用 the --plugin-dir flag 去做 test plugins during development. This loads your plugin directly without requiring installation.。看这种内容，光知道名字没用，还是得落到手上。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

终端里敲

Test your plugins locally 1

看到这里，别光点头，下面这条命令先跑起来再说。

claude --plugin-dir ./my-plugin

终端里敲

Test your plugins locally 2

看到这里，别光点头，下面这条命令先跑起来再说。

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

终端里敲

Test your plugins locally 3

看到这里，别光点头，下面这条命令先跑起来再说。

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

终端里敲

Test your plugins locally 4

看到这里，别光点头，下面这条命令先跑起来再说。

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

Debug plugin issues

遇到这种内容，别急着大拆大改，先按它给的路子把问题缩小。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Share your plugins

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Submit your plugin to the official marketplace

这一段主要是在把"Submit your plugin to the official marketplace"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Convert existing configurations to plugins

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Migration steps

这一段是在教你把 the plugin structure 真正建出来。文件放哪儿、字段怎么写、建完怎么验，都得跟着看。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

终端里敲

Migration steps 1

看到这里，别光点头，下面这条命令先跑起来再说。

mkdir -p my-plugin/.claude-plugin

改配置

Migration steps 2

想把这条规矩固定住，就把下面这块老老实实写进去。

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

终端里敲

Migration steps 3

看到这里，别光点头，下面这条命令先跑起来再说。

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

终端里敲

Migration steps 4

看到这里，别光点头，下面这条命令先跑起来再说。

mkdir my-plugin/hooks

What changes when migrating

这一块主要是在说"What changes when migrating"真到手上该怎么用，哪里最容易踩坑。

Next steps

这里不是让你背"Next steps"这个词，而是让你看它真干活时怎么使。

For plugin users

这一段主要是在把"For plugin users"讲实，不是只摆个标题给你看。

For plugin developers

这一段是在教你把 and distribute a marketplace: package and share your plugins 真正建出来。文件放哪儿、字段怎么写、建完怎么验，都得跟着看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

照着做一遍

第一次做插件，先别想着一口气把 skills、hooks、MCP 全塞进去。

先做一个最小能装、能跑、能试的插件，跑通以后再加复杂能力。

终端里敲

第 1 步：先建插件目录

先把插件的壳子搭起来，这一步就是把地圈出来。

mkdir my-first-plugin
mkdir my-first-plugin/.claude-plugin

改配置

第 2 步：写 plugin.json

这个文件像工具箱封面，告诉 Claude 这套插件叫什么、干什么。

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

改配置

第 3 步：先加一个最小 skill

不要先上复杂代理，先放一个最简单的 skill，能呼出来就算跑通。

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

终端里敲

第 4 步：本地试装

先别发给别人，先在自己机器上临时加载，确认能用。

claude --plugin-dir ./my-first-plugin
/my-first-plugin:hello

一眼看懂这一页

这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。

创建插件
   |
   v
创建插件 这一页讲的，就是 创建插件 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。

顺手再看

Sub-agents、Plugins、MCP 怎么选

先分清插件到底值不值得上。

常见报错排查清单

插件一装就出事时，先别乱拆环境。