Claude Code Mods 实测：一句话给 AI 编辑器装外挂

Claude Code 支持 Mods 意味着什么

Anthropic 官方宣布，Claude Code 从 2.1.287 及更高版本开始正式支持 Mods（模组）。简单来说，Mod 就是挂在 Claude Code 里的一小段代码，能够直接修改它的界面和行为，打包在 Plugin 这个「盒子」里进行分发。

这是一个容易混淆的概念，有必要先理清三者的区别：Skill 是给 Claude 的一份说明书，MCP 是给它的一件工具，而 Mod 改的是 Claude Code 本身。换句话说，前两者扩展的是模型的能力，Mod 动的则是这个客户端程序的皮肤和交互逻辑。

据 B站 UP 主 Axton 的实测演示，这项功能最吸引人的地方在于「不写代码」——你可以用一句自然语言让 Claude 当场做出一个带面板、按钮甚至小游戏的 Mod，门槛被压到了极低。

MCP（Model Context Protocol）是 Anthropic 提出的一套开放协议，允许外部服务以标准化方式向 Claude 暴露工具和数据源——比如让 Claude 能搜索网页、查询数据库或调用 API。Skill 则是通过系统提示或指令文件，告诉 Claude 在特定场景下该怎么思考和行动，本质是调整模型的"软件层"。两者作用的对象都是模型本身的能力边界。Mod 的切入点完全不同：它运行在客户端程序层，直接操控 Claude Code 这个应用的 UI 渲染和事件钩子，无论模型能力如何，界面该长什么样、哪个操作要被拦截，都由 Mod 代码说了算。这种分层设计让三者可以同时存在、互不干扰。

从空文件夹做出第一个 Mod

整个流程比想象中简单。在 Claude Desktop 的 Code 标签页新建一个空文件夹（比如 First MOD），选择信任这个目录，然后直接提要求：「做一张侧栏的专注卡，中间一个数字，点一下加 1，能清零也能关掉」。

这里有个关键细节值得强调：当 Claude 写完代码准备生效时，界面会弹出一个「是否允许热重载」的开关，这个开关必须你自己在界面上手动点允许。Claude Code 的权限规则不会自动替你放行，这是它安全设计的一部分。

点了允许之后，右边栏就会长出一块卡片，标题是「我的第一个 MOD」，中间数字为 0。点一下变 1、再点变 2，点关闭就收起，输入斜杠命令又能重新弹出。

不过临时做出来的 Mod 有个限制：新开一个会话，这张卡片不会自己回来，需要让 Claude 重新加载保存好的源码并再次授权。要想「装一次、每个会话都在」，就得走插件市场正式安装的路子。

临时加载 vs 正式安装

Axton 换了一个社区做的 Mod「TokenCraft」来演示正式安装，只有两步：先添加插件市场，再安装。装好后输入框上方会出现一个「我的世界」风格的像素小世界，小人、血条、经验条、物品栏一应俱全。Claude 读目录干活时，小人就在挖矿，调用工具时物品栏的 TNT 加 1、经验条增长。

差别的核心在于加载方式：专注卡是在单个会话里临时加载，而 TokenCraft 装进了用户配置，一次安装后每个会话都生效。自己做的 Mod 按官方说明打包成本地插件市场，也能用同样的命令常驻安装。

「热重载」（Hot Reload）是指在程序运行时动态替换模块代码，而无需重启整个应用。Claude Code 将这一机制引入 Mod 系统，使得开发者修改 Mod 源码后可以立即看到效果，省去了反复退出重进的繁琐步骤。之所以需要用户手动点击授权，而非自动生效，是因为热重载本质上是在运行中的进程里执行新代码，具有较高的权限敏感性——恶意代码可以借此时机在用户不知情的情况下注入。这个需要手动确认的设计，确保了每一次代码变更都经过用户明确同意，是最小权限原则在交互层面的体现。

Mod 能做的四件事

为什么一句话就能让界面长出按钮和画面？原理并不神秘。Claude Code 本身是一个一直在跑的程序，你每发一条消息，它都会走过一条固定的时间线：输入 → 模型思考 → 调用工具 → 这一轮结束。Mod 就是挂在这条时间线节点上的代码，具体能做四件事：

• 看：读取当前会话，看到真实的上下文用量、每一次工具调用；
• 画：在右边画一块面板，或在输入框上方画一条状态带，放上文字和按钮；
• 拦：工具要执行时先把它停住，等你点确定或取消，取消还会把理由告诉 Claude；
• 写：读写你电脑上的文件、运行命令。

后面所有案例，本质上都落在这四件事上。

「看」：上下文天气

Axton 用一句话让 Claude 做了个「上下文天气」，输入框上方出现一行小天气预报，显示占用百分比。随着对话推进，柱状图逐根排出，数值和底部官方状态栏同源——这是上下文的真实占用，而非费用。再补一句还能把配色改成青蓝色。这个 Mod 的价值在于让你对上下文余量心里有数，蓝色才是安全底线。

「拦」：爆炸半径安全网

官方开源的 Mod「Blast Radius（爆炸半径）」展示了「拦」的能力。当你让 Claude 删除 build 文件夹时，右边会弹出一块面板，列出命令 rm -rf build、将删除约 20 个文件（约 11 兆），清单一条条列出，底下是 Proceed 和 Cancel 按钮。

点 Cancel，Claude 会回复文件夹仍在、没有删除。官方设计它盯的是 rm、git reset、git clean、强推、数据库迁移等不可逆的重要操作，是动手之前的一张安全网。但要注意：它不是权限系统，真要彻底禁止某条命令，仍得靠权限规则，不能完全依赖它。它的意义在于，AI 在干危险的事之前，至少会先停下来问你一句。

「写」+「看」：改名回放与口播时长尺

官方的 Replay Theater 把「看」和「画」合起来用。让 Claude 把三个文件里的函数批量改名后，输入框上方出现 Replay 按钮，点开能像幻灯片一样一步步回看本轮改动——不过它只是回看，不能撤销。

「写」的典型是 Axton 现场做的「口播时长尺」：让 Claude 在右边用彩色横条画出每一节的时长，顶部大字显示总时长。当他要求「把第三节砍掉一半」，Claude 改稿的同时绿条明显变短，总时长从 1 分 12 秒更新到 9 分 42 秒。中间还有个小插曲——它第一次砍过头了，又自己补了回来。

更有意思的是反向交互。在一个故事板面板里，Axton 选中第三张卡片、移到第一位、改成蓝色并保存，Claude 读完后准确说出了新顺序，还点评「把结果放前面是短视频的倒序钩子」。它并非看懂了屏幕，而是「点按钮」的操作被 Mod 写成了本地 JSON 文件，Claude 读了这个文件。这意味着面板和按钮不只是 AI 的输出，也能变成你给 AI 的输入，聊天框不再是唯一通道。

终端里更像游戏：Boss fight 与像素宠物

桌面版用 SVG 作画，而终端能画像素格，于是玩法更花哨。在一个埋了 5 个 bug 的练手项目里，运行测试后右边跳出一只像素 Boss「Merge Conflict Org」，满血 5 格。每修好一个 bug 并重新跑测试，Boss 就挨一下、掉一格血，全部跑通后 Boss 倒下，弹出 Victory。

另一个像素宠物 Cold Pet 则从一颗一级的蛋开始，Claude 每调用一次工具就吃一口，处理测试过程中进化成二级 Blob。这两个 Mod 都是本地读事件，不联网、不额外消耗 Token。

终端里有个踩坑点：用 plugin dir 加载 Mod 时千万不要加 Safe Mode（安全模式），否则 Mod 加载不出来。

装别人的 Mod 前，先看源码

想找现成 Mod，官方 GitHub 仓库 Claude Code Playground 里有不少，社区也整理了插件市场，看图监控、各种像素小游戏都有。

但有一条安全提醒必须记住：Mod 是真的在你电脑上跑代码。安装别人的 Mod 前，最好先让 Claude 把源码读一遍，或在终端运行 claude plugin validate，它会列出这个 Mod 挂了哪些事件、调用了什么、联不联网、读不读写文件、起不起进程，一看就心里有数。

当然，Mod 也不是越炫越好。Axton 坦言试过一个看着很酷的终端游戏 Mod，结果只有六个字评价：「好难玩，好难看」。

claude plugin validate 的校验原理值得了解：该命令会静态分析 Mod 的 manifest 文件和入口代码，列出它声明订阅的生命周期事件（如 onToolCall、onSessionStart）、请求的系统权限（文件读写路径、网络访问域名、子进程调用）等元信息。这类「权限清单」机制类似于手机应用在安装时列出所需权限，让用户在运行前就能判断一个 Mod 的实际意图是否与其宣称功能相符。如果一个只是「显示 token 用量」的 Mod 却申请了网络访问和任意文件写入权限，这就是需要警惕的危险信号。

写在最后

Mod 机制把 Claude Code 从一个固定的 AI 编辑器，变成了一个可以自定义界面和交互的开放平台。更重要的是，它降低了定制门槛——不会写代码的人也能用自然语言描述需求，让 AI 当场造出工具。无论是提升安全感的「爆炸半径」、帮内容创作者控时长的「口播尺」，还是纯粹好玩的像素 Boss，背后都是「看、画、拦、写」这四件事的组合。今晚你就可以打开 Claude Code，建一个空文件夹，做出属于自己的第一个 Mod。