一、Claude Code 变成”乐高”
2026年10月1日,Anthropic为 Claude Code 上线了 Mods——一个用 JavaScript / TypeScript 写的插件系统,让开发者直接改造 Claude Code 本身。
官方原话很直白:
“写几行 TypeScript 就能做一个 Mod,或者直接让 Claude 帮你写。“
配合10月15次密集发布(v2.1.287 → v2.1.303),Claude Code 正在从“固定产品”变成“可扩展平台”。
二、Mods 是什么:hooks 跟着插件走
Mod 的本质是 hooks(钩子),但随插件分发,而且常驻会话。
统一钩子签名:
on("tool.call", { tool: "Bash" }, async ($, e, next) => { return next(e); });
三个参数:
- $:Mods API(ui / session / state / store / fs / process / http / tool)
- e:本次事件的数据
- next:把事件传给下一个插件,最后回到 Claude Code 本身
Mod 可以在事件之前、之后、代替它运行,也可以 wrap(前后都跑)。
三、3种玩法
| 模式 | 做法 | 典型用途 |
|---|---|---|
| 观察 | 先 next(e) 再看结果 |
记录每次文件编辑、审计工具调用 |
| 改写 | 改了事件再往下传 | 把危险命令换成安全版本 |
| 拦截 | 不调 next,直接返回结果 | 拒绝某个工具调用、批准/拒绝权限请求 |
与旧的 settings hooks 的关键区别:
| 维度 | 旧 hooks | Mods |
|---|---|---|
| 运行方式 | 每个事件跑一次shell命令 | 加载一次常驻会话 |
| 数据传输 | stdin/stdout 传 JSON | 直接调用 API |
| 状态 | 无 | $.state 持久化 |
| UI | 不能 | 能画会刷新的 UI |
| 替换内置功能 | 不能 | 能 |
四、钩子覆盖面
可挂载的事件非常全:
- tool.call——工具调用
- prompt.submit——用户提交提示
- skill.prompt——技能展开
- turn.start / turn.complete——回合开始/结束
- session.start——会话生命周期
- agent.spawn——子agent生成
- prompt.change——提示变更
- command.run——斜杠命令
- ui.render——界面每一块怎么画都归它管
多个 Mod 挂同一事件时,按加载顺序排队——先加载的先看到事件,结果最后回来。不同作者的 Mod 可以叠加。
五、第一个官方 Mod:”You Should Know”
这个 Mod 的设计非常巧妙:
它起一个独立的 agent,监视 Claude 的输出,当检测到用户可能错过的重要信息时,发一条“Heads up”提醒。
启用方式:
/plugin enable cc-plugin-you-should-know@builtin
@builtin 后缀表示随 Claude Code 内置发布,非外部来源。
关键意义:这是”第二个agent监视第一个agent“模式的早期实践——自动化监督模型输出,不改模型。
其他官方示例:Token Weather、Blast Radius、Replay Theater。
官方还把部分内置功能做成了 Mod:/diff、agents-md、telemetry、sec-default——可在 /plugin 里关掉或换成自己的实现。
六、⚠️ 安全模型:无沙箱,与 Claude Code 同权
这是最需要注意的部分。官方明确:
- Mods 没有沙箱
- 对机器的访问权与 Claude Code 本身一样
- 只装你信任的来源——”和装本机任意代码一个道理”
- 因为能拦截工具调用,恶意或糟糕的 Mod 可能影响用户账号能访问的一切
边界说明(入门文补充):
- 模块侧没有 DOM
- 也没有裸 Node
- 对外只能通过 $ API(ui/session/state/fs/process)
关键区分:“API 面约束”不等于”进程隔离”。
企业级控制:组织可以控制哪些 Mod 被允许加载——这是规模化采用的关键(类似VS Code扩展或npm包的供应链风险)。
七、10月15次发布完整清单
| 版本 | 日期 | 核心更新 |
|---|---|---|
| v2.1.303 | 10/18 | bug修复 + 可靠性改进 |
| v2.1.302 | 10/16 | auto mode控制改进 + /config新增idleCompaction项 |
| v2.1.301 | 10/15 | 无人值守重试更智能,触及用量上限自动停止 |
| v2.1.300 | 10/14 | virtual text不干扰提交 + agent view定制 |
| v2.1.299 | 10/14 | idle compaction(闲置约54分钟自动压缩200K+对话) |
| v2.1.296 | 10/9 | 代码设置跨Claude Desktop和gateway同步 |
| v2.1.295 | 10/8 | onFailure: “block”——hook失败时阻止动作 |
| v2.1.294 | 10/8 | 修复instruction式prompt hook的阻塞逻辑 |
| v2.1.293 | 10/7 | Claude Haiku 5.5成为API默认Haiku模型(1M上下文) |
| v2.1.292 | — | claude plugin install –marketplace + Agent tool加effort参数 |
| v2.1.288 | — | /code-review –max-findings |all + Ctrl+C清空的prompt按↑恢复草稿 |
八、5个独家角度
1. “从固定产品到可扩展平台”
关键证据:Anthropic自己把核心命令(如 /diff)做成了 Mod——这说明钩子覆盖面是深度的,不是薄附加。
战略意义:
- Claude Code从”工具“变成”平台“
- 直接对标VS Code扩展生态、open-source agent的定制能力
2. “第二agent监视第一agent”的早期实践
“You Should Know”展示了工具内中间件能做什么:
- 自动化监督模型输出
- 不修改模型
- 成本未披露——起一个额外agent是否消耗额外token?官方未说明
这与10/20已发的OpenAI 4个Agent misalignment形成有趣对仗——一个agent监督另一个agent,正是当前AI治理的核心技术方向。
3. “idle compaction”解决的真实痛点
问题:prompt cache有过期时间(通常5分钟),对话闲置后缓存失效,全部token要重新处理。
解法:闲置约54分钟时自动压缩对话,在缓存过期前完成。
价值:长会话的成本和延迟显著改善——对长时间运行的Agent任务尤其重要。
4. Hooks”失败即阻止”是安全加固
v2.1.295 的 onFailure: "block":hook失败时阻止动作,而不是放行。
这是”fail-safe“设计——对比”fail-open“(失败就跳过检查)——安全默认值的正确方向。
配合v2.1.294修复instruction式prompt hook的阻塞逻辑——之前”要求阻塞”的规则实际没生效,这是个安全漏洞级别的修复。
5. “生态分叉”的风险与机会
Mods API 由 Anthropic 明确声明”可能在版本间变化“——社区Mod需要频繁适配。
参考:已有开源项目(如 eunuch-mode)严格锁定版本(2.1.287)并逐版本记录以应对breaking change。
机会:早期Mod生态可能出现细分龙头(如专门做安全审计的Mod)。
九、5个值得记住的关键事实
- Mods上线:2026-10-01(v2.1.287+默认开启)
- 10月发布次数:15次(v2.1.287 → v2.1.303)
- 安全模型:无沙箱、与Claude Code同权
- 核心突破:idle compaction(54分钟)+ onFailure: block
- 默认模型:Claude Haiku 5.5(v2.1.293起,1M上下文)
十、5个常见疑问
Q1:Mods 会不会太危险?
需要客观看待:
- 风险真实:无沙箱+同权+能拦截工具调用
- 但这是既定选择:Anthropic 明确说“只装信任来源”
- 企业有控制手段:组织级allowlist
类比:VS Code扩展、npm包、浏览器扩展——同等级风险,同等级管控。
Q2:和旧hooks相比,Mods强在哪?
3个本质差异:
- 常驻——能保持状态($.state)
- 能画UI——旧hooks完全做不到
- 能替换内置功能——如 /diff
旧hooks是”每次跑个shell命令“,Mods是”插件里的常驻中间件“。
Q3:3个官方示例能做什么?
官方未详细说明,但从命名推断:
- Token Weather——token用量可视化
- Blast Radius——改动影响范围分析
- Replay Theater——会话回放
以GitHub官方仓库源码为准。
Q4:对企业有什么价值?
3个典型场景:
- 安全护栏——
onFailure: "block"+ 自定义拦截规则 - 合规审计——记录每次工具调用(观察模式)
- 工作流定制——把公司内部规范写进 hook,自动执行
关键:企业级 allowlist 是规模化采用的前提。
Q5:Mods 会和 MCP / Skills 怎么共存?
三层:
| 层 | 作用 |
|---|---|
| Skills | 教模型怎么做 |
| MCP | 提供外部工具和数据 |
| Mods | 改变Claude Code本身的行为和界面 |
Mods是元层——它能拦截和改写前两层的调用。
十一、为什么这条值得收藏
Mods是2026 Q4 AI Coding工具最重要的平台化事件。三个层面意义:
1. “AI编程工具”从工具变平台
当15次/10月的发布密度+官方把核心功能做成Mod:
- Claude Code开始构建自己的插件生态
- 竞争维度从”模型能力“转向”可扩展性“
- 直接对标VS Code的扩展生态
2. “第二agent监督第一agent”的技术路径
“You Should Know”是工具内中间件的关键实践——
- 不改模型
- 用额外的agent做输出监督
- 与10/20已发的OpenAI 4个misalignment形成对仗——这是”AI监督AI”的可落地形态
3. 安全治理的”fail-safe”方向
v2.1.295 的 onFailure: "block" + v2.1.294 修复阻塞逻辑:
- hook失败 → 阻止(不是放行)
- instruction式阻塞规则真正生效
这与今日已发的纳德拉”紧急刹车”、India CERT-In”网络层”、OpenAI 4事件构成同一共识:失败要安全、要可拦、要可审计。
对于AI开发者:
- 立即试用Mods——写一个安全审计Mod(观察模式记录工具调用)
- 用idle compaction解决长会话成本问题
- 关注onFailure: “block”——把安全规则写进hook而非prompt
对于企业IT:
- 建立Mod allowlist——这是规模化采用的前提
- 评估无沙箱同权的供应链风险
- 优先用官方内置Mod(@builtin)验证
对于AI行业观察者:
- Claude Code 15次/10月的迭代节奏是平台化的信号
- Mod生态可能出现垂直龙头
- API版本间会变——第三方Mod需要持续适配
当Claude Code能用几行 TypeScript改变自己的行为和界面,当15次发布把核心命令都Mod化,当第一个官方Mod就是”让另一个agent监督这个agent“——AI编程工具正式进入平台时代。
📚 信息来源
- Claude Code官方博客 10/01:Getting started with Claude Code Mods(Addy Osmani撰写,官方一手)
- spring4all中文 10/03:Claude Code Mods:几行 TypeScript 就能改提示、拦工具、画界面(独家中文详细)
- 今日头条/编程充电站 10/02:Claude Code 变”乐高”了!Mod模块上线(独家3示例+代码结构)
- TPS Report 10/03:Anthropic adds Mods to Claude Code(独家安全模型+支持面)
- Havoptic:Claude Code Release Notes — October 2026(10月15次发布完整清单)
- GitHub conorbronsdon/eunuch-mode:The Claude Code mods API this mod uses(第三方Mod的API文档+版本锁定实践)
本文为编辑独立撰写的AI工具分析。Mods功能与安全模型来自Anthropic官方博客10/1(Addy Osmani撰写)+ 3家媒体转述。10月15次发布清单来自Havoptic汇总的Claude Code Release Notes。Claude Mods API由Anthropic明确声明”可能在版本间变化”,第三方Mod需持续适配。无沙箱+同权是官方明示的安全模型。3个官方示例(Token Weather/Blast Radius/Replay Theater)的具体功能官方未详细说明,以GitHub官方仓库源码为准。“You Should Know”是否消耗额外token官方未披露。本文不构成任何投资或商业建议。