最近在做一个自动化逆向恶意软件的项目,我觉得直接基于 claude code的能力配置一些专用skill、mcp工具就可以,遂有了这篇文章。
Claude Code 插件开发与使用
插件结构
my-plugin/
├── .claude-plugin/
│ ├── plugin.json # 必需:插件元数据
│ └── marketplace.json # 可选:市场配置(用于分发)
├── commands/ # 可选:Slash 命令
├── agents/ # 可选:子代理定义
├── skills/ # 可选:Agent Skills
│ └── skill-name/
│ └── SKILL.md
├── hooks/ # 可选:事件处理
└── .mcp.json # 可选:MCP 服务器配置
编写插件
1. 创建 plugin.json
在 .claude-plugin/plugin.json 中定义插件元数据:
{
"name": "my-plugin",
"version": "1.0.0",
"description": "插件描述",
"author": {
"name": "作者名"
}
}2. 创建 Skill
在 skills/skill-name/SKILL.md 中定义技能:
---
name: skill-name
description: 简洁描述技能用途,Claude 会根据此决定何时调用
---
技能的具体指令内容...3. 创建 Marketplace(可选)
在 .claude-plugin/marketplace.json 中定义市场:
{
"name": "my-marketplace",
"owner": {
"name": "维护者"
},
"plugins": [
{
"name": "my-plugin",
"source": "./",
"description": "插件描述"
}
]
}安装插件
CLI 方式
# 添加市场
claude plugin marketplace add <路径或仓库>
# 从市场安装
claude plugin install <插件名>@<市场名>
# 示例
claude plugin marketplace add D:/code/analyze
claude plugin install malware-analysis-tools@malware-analysisClaude Code 内部方式
# 添加市场
/plugin marketplace add <路径或仓库>
# 从市场安装
/plugin install <插件名>@<市场名>
# 示例
/plugin marketplace add D:/code/analyze
/plugin install malware-analysis-tools@malware-analysis安装范围
# 用户级别(默认)
claude plugin install plugin@market
# 项目级别
claude plugin install -s project plugin@market
# 本地级别
claude plugin install -s local plugin@marketWindows 路径注意事项
使用相对路径安装目录形式的插件:
# 推荐使用相对路径
claude plugin marketplace add ./path/to/plugin
claude plugin marketplace add ../marketplace
# 避免使用绝对路径(可能因权限或路径格式问题失败)临时加载(不安装)
# 临时加载插件目录(当前会话有效)
claude --plugin-dir ./path/to/plugin更新插件
# CLI 方式
claude plugin update <插件名>
# 更新所有插件
claude plugin update
# 内部方式
/plugin update <插件名>常用命令
# 查看已安装插件
claude plugin list
# 查看市场列表
claude plugin marketplace list
# 启用/禁用插件
claude plugin enable <插件名>
claude plugin disable <插件名>
# 卸载插件
claude plugin uninstall <插件名>
# 验证插件配置
claude plugin validate <路径>调试技巧
- 使用
--plugin-dir临时加载测试 - 检查 skills 目录位置是否在插件根目录
- 确认 SKILL.md 文件名大写且包含有效的 frontmatter
- 验证 JSON 格式正确