从零开始创建一个属于自己的 Claude Code Plugin

1387 字

7 分钟

从零开始创建一个属于自己的 Claude Code Plugin

2025-12-25

教程

Claude Code

/

Plugin

/

Github

/

GLM

/

GLM Coding Plan

/

GLM 4.7

TIP
如果想要获得性价比最高的 Vibe Coding 体验, 推荐购买 🔗 GLM Coding Lite 服务, Lite 版本的按 Prompt 计费, 每 5 小时最多约 120 次 prompts

Claude Code 核心功能#

我们在使用 Claude Code 时, 可以通过以下功能来 配置或者扩展 Claude Code 的能力, 这些能力都是 Claude Code 的核心功能

Commands: 自定义命令
Agents: 子代理
Hooks: 基于事件的自动化工作流
Skills: 技能
MCP: MCP 服务

Plugin#

Claude Code 插件是一种将 Claude Code 的核心功能(Commands / Agents / Hooks / Skills / MCP) 打包封装 的一种方式, 它实现了对于这些核心功能的分离和共享, 任何安装了插件的项目都可以使用插件内置的 Claude Code 核心功能

用途#

将自己在工作中创建的通用 Commands / Agents / Hooks / Skills / MCP 封装成插件, 在创建新项目时可以直接通过安装插件的方式来使用这些能力
想要将自己创建的 Commands / Agents / Hooks / Skills / MCP 在团队内共享或直接开源, 让别人也可以使用这些能力

目录结构#

一个插件的目录中包含了这些核心功能的文件, 目录结构与 .claude 中的路径结构相同, 结构如下:

1
my-first-plugin/
2
├── .claude-plugin/
3
│   └── plugin.json          # 插件元数据
4
├── commands/                 # 自定义斜杠命令（可选）
5
│   └── hello.md
6
├── agents/                   # 自定义代理（可选）
7
│   └── helper.md
8
├── skills/                   # 代理技能（可选）
9
│   └── my-skill/
10
│       └── SKILL.md
11
└── hooks/                    # 事件处理程序（可选）
12
    └── hooks.json

创建一个插件#

前置条件#

安装 @anthropic-ai/claude-code

1
npm install -g @anthropic-ai/claude-code # 或使用 pnpm 安装

购买 Claude Code 服务(使用 GLM Coding Plan 服务)

WARNING
在国内无法直接购买和使用 Claude 系列模型, 目前国内对于 Claude Code 支持度最好的是智谱的 🔗 GLM Coding Plan 服务, 性价比最高, 可以直接作为平替使用

购买 🔗 GLM Coding Lite 服务, 然后根据官方文档进行配置

插件市场#

插件市场(Plugin Marketplace) 指的是包含一系列插件的用于共享和分发的项目, 本质上是一个包含描述文件(.claude-plugin/marketplace.json)的项目, 我们可以通过将其发布到 Github 或者私有仓库中进行共享

创建插件市场#

1
mkdir ryan-plugin-marketplace
2
cd ryan-plugin-marketplace && pnpm init && git init

创建 .claude-plugin/marketplace.json 文件, 并填写以下内容

1
{
2
  "name": "ryan-plugin-marketplace",
3
  "owner": {
4
    "name": "Ryan",
5
    "email": "ryan@example.com"
6
  },
7
  "plugins": [
8
    {
9
      "name": "dev",
10
      "source": "./plugins/dev",
11
      "description": "Functions used in daily development",
12
      "version": "1.0.0",
13
      "author": {
14
        "name": "Ryan"
15
      }
16
    }
17
  ]
18
}

创建 plugins/dev/commands/hello.md

1
你好👋

将项目发布到 github

1
git add -A && git commit -m 'init: Initialization project'
2
git remote add origin git@github.com:SublimeCT/ryan-plugin-marketplace.git
3
git push -u origin main

安装插件#

插件市场的安装范围#

对当前用户的所有项目都生效:

1
claude
2

3
> /plugin marketplace add anthropics/claude-code

对某个项目生效(修改 .claude/settings.json):

1
{
2
  "extraKnownMarketplaces": {
3
    "my-marketplace": {
4
      "source": {
5
        "source": "github",
6
        "repo": "owner/repo"
7
      }
8
    }
9
  }
10
}

对某个项目生效, 但不提交到版本控制中(修改 .claude/settings.local.json):

1
{
2
  "extraKnownMarketplaces": {
3
    "my-marketplace": {
4
      "source": {
5
        "source": "github",
6
        "repo": "owner/repo"
7
      }
8
    }
9
  }
10
}

这里我们选择对当前用户的所有项目都生效的安装方式:

1
claude
2

3
> /plugin marketplace add xxx/ryan-plugin-marketplace
4
  ⎿  Successfully added marketplace: ryan-plugin-marketplace

插件的安装范围#

默认安装的插件会在所有项目中生效, 但有时我们想让插件只在某个项目中使用, Claude Code 提供了 --scope 参数指定插件的安装范围:

User scope(默认选项): 插件在当前用户下的所有项目都生效
Project scope(在交互式命令行界面中默认使用): 插件只在当前项目下生效, 配置保存在 .claude/settings.json, 会与团队共享
Local scope: 仅对当前仓库生效, 且不会提交到版本控制

这里我们选择 User scope:

1
claude plugin install dev@ryan-plugin-marketplace
2
✔ Successfully installed plugin: dev@ryan-plugin-marketplace

测试#

测试插件是否安装成功:

1
claude
2

3
 ▐▛███▜▌   Claude Code v2.0.37
4
▝▜█████▛▘  Sonnet 4.5 · API Usage Billing
5
  ▘▘ ▝▝    /Users/xxx/projects/openapi-codegen
6

7
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
8
> /dev
9
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
10
  /dev:base      base command (plugin:dev@ryan-plugin-marketplace)
11
  /dev:hello     你好👋 (plugin:dev@ryan-plugin-marketplace)

1
> /dev:hello is running…
2

3
⏺ 你好！我可以帮助你处理这个项目的任务。
4

5
  我看到这是一个基于 OpenAPI/Swagger 的代码生成工具项目。有什么我可以帮你的吗？比如：
6

7
  - 修复 bug
8
  - 添加新功能
9
  - 代码重构
10
  - 运行测试
11
  - 代码生成相关的问题
12
  - 或者其他任何开发任务
13

14
  请告诉我你需要什么帮助！

管理插件#

1
claude
2

3
> /plugin
4
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
5
│ Plugins                                                                                                                                  │
6
│                                                                                                                                          │
7
│   1. Browse and install plugins                                                                                                          │
8
│ ❯ 2. Manage and uninstall plugins                                                                                                        │
9
│   3. Add marketplace                                                                                                                     │
10
│   4. Manage marketplaces                                                                                                                 │
11
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
12
   Press ↑↓ to navigate · Enter to select · Esc to exit

我们选择 Manage and uninstall plugins 后, 就可以 对插件进行禁用 / 更新 / 卸载 了:

1
> /plugin
2
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
3
│ dev @ ryan-plugin-marketplace                                                                                                            │
4
│                                                                                                                                          │
5
│ Version: 1.0.0                                                                                                                           │
6
│                                                                                                                                          │
7
│ Functions used in daily development                                                                                                      │
8
│                                                                                                                                          │
9
│ Author: Ryan                                                                                                                             │
10
│                                                                                                                                          │
11
│ Status: Enabled                                                                                                                          │
12
│                                                                                                                                          │
13
│ Installed components:                                                                                                                    │
14
│ • Commands: base, hello                                                                                                                  │
15
│                                                                                                                                          │
16
│                                                                                                                                          │
17
│ ❯ Disable plugin                                                                                                                         │
18
│   Mark for update                                                                                                                        │
19
│   Update now                                                                                                                             │
20
│   Uninstall                                                                                                                              │
21
│   Back to plugin list                                                                                                                    │
22
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
23

24
 Navigate: ↑↓ • Select: Enter • Back: Esc