读这篇文章前，你可以先想一个问题：  

如果每次换项目都要重新配置一遍 Claude Code 的 skills 和 agents，是不是很烦？

如果你还在用老方式管理 Claude Code 的 skills 和 agents，那真的亏大了。

新版本 Claude Code 推出了全新的“插件（Plugins）体系”，把零散配置变成标准化插件，跨项目复用、团队分享都变得超级简单。

这篇文章我会手把手带你：

✅ 安装插件市场

✅ 安装并使用插件

✅ 安装外部独立技能（firecrawl + context7）

✅ 制作并验证你自己的第一个技能

全程实操，干饭教程，跟着做就能学会。

📌 本文中 CC = Claude Code

一、插件（Plugins）——新版本的核心变化

在新版 Claude Code 中，skills 和 agents 的管理方式发生了根本性变化：

它们不再是独立的文件夹，而是被统一纳入了更强大、更模块化的“插件（Plugins）”体系。

简单说就是：把你以前常用的零散配置（Skills、Agents 等），打包成标准化的“插件”，方便跨项目使用，也能分享给团队或社区。

1.1 Claude Code 的用户级目录结构

~/.claude/├── plugins/                    # 🌟 所有插件的“大本营”│   ├── marketplaces/           # 🌍 存放所有已添加的插件市场│   │   └── <marketplace-name>/ # 每个市场一个独立目录│   │       └── .claude-plugin/│   │           └── marketplace.json  # 市场的元数据清单│   ├── installed_plugins.json  # 📋 记录所有已安装插件的列表│   └── known_marketplaces.json #🧾 记录所有已知的插件市场源

这个结构你不需要手动创建，CC 会自动管理。

二、实战：安装与使用插件

就像在手机上安装 App 一样简单。

2.1 添加一个插件市场

指令格式：

/plugin marketplace add <marketplace-url-or-git-repo>

实际例子——添加 Anthropic 官方的 skills 市场：

/plugin marketplace add anthropics/skills

执行这条命令需要一些时间，它会去 GitHub 上克隆这个项目到你的用户主目录下。

2.2 浏览并安装插件

有两种方式：

方式一：直接用指令安装

/plugin install <plugin-name>

📌  这种方式要求你要能记住插件的名字，这对我们初学者来说，简直太为难了，所以，可以用方式二

方式二：交互式界面安装

输入/plugins，进入所有插件市场的管理界面：

用左右箭头切换到Marketplaces标签，用向下箭头选中anthropic-agent-skills，回车进入。

如果没有安装某个插件（如example-skills），选择Browse plugins，然后选中后回车即可安装。

2.3 重新加载插件

安装完成后，必须先加载才能使用：

/reload-plugins

加载完成后，插件内的所有 skills、agents、commands 便会自动生效。

💡 小提示：新版本中的调用命名规则为 /pluginName:commandName

如：

⚠️ 如果你看到某个技能（如 frontend-design）有两个，那是因为官方自带市场和插件市场都安装了，功能相同，用哪个都可以。

2.4 查看已安装的插件和技能

查看已安装的插件列表：

查看已安装的 skills 列表：

输入/skills或在对话中问“你加载了哪些技能？”

三、进阶：安装外部独立 Skills

📌 需要了解：某些工具并没有打包进插件市场中，而是以独立的 skill 存在。

比如firecrawl-cli和context7。这两个skill非常重要，建议必须安装起来

3.1 安装 firecrawl-cli

Firecrawl 是联网搜索和网页抓取工具，让 AI 开发前先搜索最新技术信息。

安装命令：

npx -y firecrawl-cli@latest init --all --browser

安装过程：

会自动打开浏览器让你认证登录

登录后回到命令行窗口

自动安装 firecrawl skills

安装完成后，进入 CC，输入/skills就能看到 firecrawl 系列技能了。

它安装的目录位置：

3.2 安装 context7

Context7 是一个技术文档查询工具，让 AI 能获取到各种框架和库的最新官方文档，避免用过时的 API 写代码。

安装命令：

npx ctx7@latest setup

它会问你是安装 MCP 服务还是 CLI + Skills。这里选择 CLI + Skills。

💡 你会发现，现在越来越多工具已经从 MCP 转向 CLI + Skills 的方式了。

在弹出的网页中授权（不用自己获取和输入 API Key，非常方便）：

回到终端，选择你用哪个智能体，这里选 Claude Code：

然后开始下载find-docsskill。

⚠️ 注意：有时因为网络问题下载失败，重新执行 npx ctx7@latest setup 即可。

成功后，它会把find-docs技能放在.claude/skills目录下（不是走 marketplaces 安装的）。

再次进入 CC，就能看到find-docs技能了：

四、进阶：制作自己的插件与技能

这是让个人能力发挥更大价值的关键一步。

4.1 插件的目录结构

你只需遵循一个简单的目录结构：

your-plugin/├── .claude-plugin/│   └── plugin.json          # 插件元数据（必需）├── agents/                  # 存放 Agent 定义├── skills/                  # 存放 Skill 定义└── commands/                # 存放 Slash Commands

4.2 手把手创建一个自定义技能

我们从一个简单的my-helper技能开始。

第1步：创建技能文件夹

mkdir -p ~/.claude/skills/my-helper

第2步：创建 SKILL.md 文件

用记事本或任意文本编辑器：

notepad ~/.claude/skills/my-helper/SKILL.md

第3步：写入以下内容

name: my-helperdescription: 我的自定义助手技能# 我的助手技能当用户请求"帮我写日报"时，执行以下步骤：1. 询问今天的重点工作内容2. 整理成结构化的日报格式3. 输出 Markdown 格式的日报

下面是我编辑好的SKILL.md用Markdown软件(Typora)打开后再截的图片

💡 如果你要做商业级的 skill，建议写得更完善。可以用 /skill-creator做商业级的 skill，建议写得更完善。可以用 /skill-creator 来辅助创建。如果不了解这个技能，可以看上一篇《Claude Code最强技能指南：从零学会Skill，让AI告别“即兴表演”》。

第4步：验证技能是否生效

方法一：斜杠命令查看

进入 CC，输入/看是否有my-helper

方法二：直接询问

问 CC：“你加载了哪些技能？”

🧠 关键知识点：你会发现所有技能只显示名称和描述，每个只占 100-200 token。这就是 CC 的渐进式加载机制——只在你真正用到某个技能时，才加载完整的指令内容。这样对话上下文永远不会爆炸。

方法三：用 /skills 命令

输入/skills查看结构化的技能列表

通过上面的加载的skills列表后面的token数量可以看出，CC的渐进式加载只会占用极少的token数，绝大数多skill都没有超过150个token，这与加载完整的skill来说，其大小不超过整个skill的1%，这种机制是极其明智的策略。

方法四：测试技能行为

直接触发关键词，比如输入“帮我写日报”，观察是否按 SKILL.md 中定义的逻辑响应：

如果它先问你“哪个项目？”“今天做了什么？”“格式要求是什么？”，说明你的技能已经成功生效了！

五、市场（Marketplaces）——去哪里找？

在理解 Marketplaces 之前，我们先来把 tools、skills、agents 和 plugins 做一个对比，这样就能清晰知道它们各自的作用。

5.1 一图看懂区别

有了 Plugins 这种“打包单元”，自然就产生了两个需求：

从哪里找到别人做好的插件？

怎么把自己的插件分享出去？

这就是 Marketplaces 要解决的问题——去哪里找。

5.2 安装一个 Marketplace

指令格式：

/plugin marketplace add <marketplace-url-or-git-repo>

实际例子：

/plugin marketplace add anthropics/skills

这条命令的作用是：把anthropics/skills这个插件市场安装到本地的 CC 中。

5.3 怎么看市场里有什么？

每个开放的插件市场都会有一个 README 文件，它会告诉你：

这个市场里包含哪些插件（Plugins）

每个插件又包含哪些 Skills、Tools、Agents

从 README 中可以清楚地看到：

• 这个市场提供了哪些插件

• 每个插件解决什么问题

• 如何使用这些插件

📌 总结一下关系：  

Marketplace = 插件市场的“目录”  

Plugin = 一个功能包  

Skills / Tools / Agents = 插件里的具体能力

写在最后

通过这篇文章，你应该已经掌握了：

✅ Claude Code 插件体系的核心概念和目录结构

✅ 安装市场、插件、技能的完整流程（指令 + 交互界面）

✅ 安装外部独立技能（firecrawl + context7）

✅ 制作并验证自己的第一个技能（my-helper）

✅ 理解 Marketplaces 的作用和用法

下一步，你可以尝试：

把自己的工作流打包成真正的插件（不只是本地 skill）

分享给团队或发布到社区市场

如果这篇文章对你有帮助，欢迎点赞、在看、转发～

也欢迎在评论区留言交流你的使用心得或踩坑经验。

📎 本文所有命令和示例均基于 Claude Code 最新版本。如遇变化，以官方文档为准。