插件

插件让您能够使用可在项目和团队中共享的自定义功能来扩展 Claude Code。从市场安装插件以添加预构建的命令、代理、钩子、技能和 MCP 服务器，或创建您自己的插件来自动化您的工作流。

快速入门

前置条件

• 在您的机器上安装了 Claude Code
• 对命令行工具的基本熟悉

创建您的第一个插件

1. 创建市场结构

mkdir test-marketplace
cd test-marketplace

2. 创建插件目录

mkdir my-first-plugin
cd my-first-plugin

3. 创建插件清单

mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
  "name": "my-first-plugin",
  "description": "A simple greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}
EOF

4. 添加自定义命令

mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

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

5. 创建市场清单

cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
  "name": "test-marketplace",
  "owner": {
    "name": "Test User"
  },
  "plugins": [
    {
      "name": "my-first-plugin",
      "source": "./my-first-plugin",
      "description": "My first test plugin"
    }
  ]
}
EOF

6. 安装并测试您的插件

claude
> /plugin marketplace add ./test-marketplace
> /plugin install my-first-plugin@test-marketplace

插件结构概览

my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # 插件元数据
├── commands/                 # 自定义斜杠命令（可选）
│   └── hello.md
├── agents/                   # 自定义代理（可选）
│   └── helper.md
├── skills/                   # 代理技能（可选）
│   └── my-skill/
│       └── SKILL.md
└── hooks/                    # 事件处理程序（可选）
    └── hooks.json

安装和管理插件

添加市场

> /plugin marketplace add your-org/claude-plugins
> /plugin

安装插件

# 通过交互式菜单
> /plugin

# 通过直接命令
> /plugin install formatter@your-org
> /plugin enable plugin-name@marketplace-name
> /plugin disable plugin-name@marketplace-name
> /plugin uninstall plugin-name@marketplace-name

验证安装

安装插件后：

• 运行 /help 查看新命令
• 使用 /plugin → "管理插件" 查看插件详情

设置团队插件工作流

在存储库级别配置插件以确保整个团队的工具一致：

1. 将市场和插件配置添加到您的存储库的 .claude/settings.json
2. 团队成员信任存储库文件夹
3. 为所有团队成员自动安装插件

开发更复杂的插件

向您的插件添加技能

在您的插件根目录创建一个 skills/ 目录，并添加包含 SKILL.md 文件的技能文件夹。

在本地测试您的插件

# 卸载当前版本
> /plugin uninstall my-plugin@dev-marketplace

# 重新安装以测试更改
> /plugin install my-plugin@dev-marketplace

调试插件问题

• 检查结构：确保您的目录位于插件根目录
• 单独测试组件：分别检查每个命令、代理和钩子
• 使用验证和调试工具

共享您的插件

• 添加文档：包含一个 README.md
• 版本化您的插件：在 plugin.json 中使用语义版本控制
• 创建或使用市场：通过插件市场分发

官方插件市场

Anthropic 提供官方插件市场，包含经过审核的高质量插件。

添加官方插件市场

在 Claude Code 中执行以下命令添加官方市场：

> /plugin marketplace add anthropics/claude-code

执行成功后，会显示：Successfully added marketplace: claude-code-plugins

官方插件列表

以下是官方市场中的常用插件：

插件名称	描述	安装命令
ralph-wiggum	自主迭代开发循环，让 Claude 无需人工干预持续改进工作	/plugin install ralph-wiggum@claude-plugins-official
learning-output-style	学习和应用用户偏好的输出风格	/plugin install learning-output-style@claude-plugins-official

更多插件请访问 Anthropic Claude Code 插件仓库

市场管理命令

# 查看已添加的市场
> /plugin marketplace list

# 添加新市场
> /plugin marketplace add <org>/<repo>

# 移除市场
> /plugin marketplace remove <marketplace-name>

# 从市场安装插件
> /plugin install <plugin-name>@<marketplace-name>

# 卸载插件
> /plugin uninstall <plugin-name>@<marketplace-name>

# 启用/禁用插件
> /plugin enable <plugin-name>@<marketplace-name>
> /plugin disable <plugin-name>@<marketplace-name>

相关文档

• Ralph Wiggum 插件详细文档 - 自主迭代开发循环插件的完整使用指南