字节笔记本
2026年10月3日 · 约 6 分钟读完
Claude Code 上了 Mods：Skill 教模型，Mod 改引擎本身
Anthropic 在 Claude Code 2.1.287 里上了一个新概念叫 Mods，官宣帖三天拿了 1.9 万赞。社区反应最直接的两个证据：有人在 Claude 等待时玩上了 Doom 死斗模式（7 千赞），另一个是被要求"帮我看桌面文件"的 Dot 用户看完只想说"早该有这个了"。
Mods 到底是什么
一句话定义：跑在 Claude Code 进程里的 TypeScript 事件处理器，用插件包装，可以改行为、加 UI、替换内置功能。
判定标准很硬：一个插件里只要有 hooks/hooks.json 里的 modules 键指向 JS 代码，这个插件就叫 mod。register(on) 函数里用 on(event, matcher?, hook) 注册，hook 签名是 ($, e, next)，可以对引擎事件做 observe、rewrite 或 answer。
它能做的事：改写进模型的 prompt；拦截/改写/重试工具调用；批准或拒绝权限请求；从工具输出里打码密钥；加 pane、按钮、输入框；替换 /diff 这类内置功能。
需要 Claude Code v2.1.287+，默认开启。
内置 You Should Know
2.1.287 随 Mods 一起加的内置 mod，/plugin 里叫 cc-plugin-you-should-know，默认关闭。
做什么：主 Claude 在做较长任务时，另起一个 side agent 盯着主 agent 的输出。发现你或 Claude 可能漏掉、但"你应该知道"的点，就在输入框上方贴一条 note。
/plugin enable cc-plugin-you-should-know@builtin
限制：first-party sessions with telemetry on。走 Bedrock / Vertex 或关遥测的会话可能不在可用列表里。
官方三个示例 mod
官方 playground 仓库放了三个示例，分别演示三层能力：
token-weather：提示符上方显示上下文占用百分比、近 12 轮 sparkline、上一轮增量。演示最小 UI 能力。
blast-radius：拦住高危 Bash（rm -rf、git reset --hard、force push），先算影响面再让你决定 Proceed 或 Cancel。演示拦截工具调用。
replay-theater：记录本轮所有 Edit/Write 操作，结束后提示 /replay 逐步看 diff。演示观察不改写。
三个 README 都写是内部用 Claude 从"十个 idea 里挑出"后一次生成的。
Doom 等待室
社区开发者 Jarrod Watts 做了一个叫 intermission 的 mod：Claude 工作超过 2 秒，终端旁边自动开一个 pane，把你丢进共享 Doom deathmatch，局里其他人都同样在等自己的 Claude。Claude 做完操作，3 秒倒计时交还。
引擎是 Odamex + Freedoom（无头渲染，帧走共享内存画进 pane），需要 macOS 15+、Ghostty 或 kitty。
/plugin install intermission --marketplace jarrodwatts/intermission
这个 mod 之所以 7 千赞，不是因为 Doom 好玩，而是它第一次让人直观感受到"mod 能改引擎到什么程度"：一个等 Claude 干活的碎片时间，被变成了多人游戏大厅。
Mods 和 Skills / Hooks / Plugins 的区别
官方 overview 对照表：
| Plugin | Mod | Settings Hook | Skill | |
|---|---|---|---|---|
| 角色 | 安装/分发单位 | 进程内 TS 函数 | 生命周期上跑的 shell/HTTP/prompt | SKILL.md，Claude 读进去 |
| 触发 | 你安装 | 引擎事件 | 引擎事件，必跑 | 你 /name 或 Claude 决定 |
| 能做 | 打包一切 | 改 prompt、拦工具、画 UI、替换内置 | 拦/放、改参数 | 教流程和领域知识 |
| 画界面 | 看装的什么 | 能 | 不能 | 不能 |
一句话：
Skill 教模型，Hook 强制执行，Mod 改引擎本身，Plugin 把它们打成包发出去。
适合谁用
想让 Claude Code 更安全的人：blast-radius 这类 mod 把危险命令从"事后撤销"变成"事前拦截"。
重 prompt 工程的用户：改写进模型的 prompt 这件事终于有了进程内的正式入口，不用再绕 settings hook 或 proxy。
想做 agent 基础设施的团队：token-weather 的 usage API、replay-theater 的操作记录、intermission 的 pane 渲染，这三个方向都能长出正经的内部工具。
一句总结：Skills 教 Claude 怎么做，Hooks 规定 Claude 必须做什么，Mods 改的是 Claude Code 本身。这是 Claude Code 从"工具"走向"平台"的信号。
