一、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个典型场景:

  1. 安全护栏——onFailure: "block" + 自定义拦截规则
  2. 合规审计——记录每次工具调用(观察模式)
  3. 工作流定制——把公司内部规范写进 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编程工具正式进入平台时代。

📚 信息来源

  1. Claude Code官方博客 10/01:Getting started with Claude Code Mods(Addy Osmani撰写,官方一手)
  2. spring4all中文 10/03:Claude Code Mods:几行 TypeScript 就能改提示、拦工具、画界面(独家中文详细)
  3. 今日头条/编程充电站 10/02:Claude Code 变”乐高”了!Mod模块上线(独家3示例+代码结构)
  4. TPS Report 10/03:Anthropic adds Mods to Claude Code(独家安全模型+支持面)
  5. Havoptic:Claude Code Release Notes — October 2026(10月15次发布完整清单)
  6. 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官方未披露。本文不构成任何投资或商业建议。