· 1 min read · AI应用观察

Claude Code mods教程上线:让AI助手显示用量、提醒危险操作

Claude.dev发布mods入门教程,演示上下文用量提示、危险命令确认和修改回放。需要Claude Code 2.1.287及以上,插件代码仍须审查。

AI 动手时,多看见一点过程#

AI 助手替人改文件,使用者常会关心两件事:它刚改了哪里,下一个操作会不会删错东西。Claude.dev 在 10 月 1 日发布的 mods 入门教程,介绍如何为 Claude Code 增加自定义提示和检查界面。教程要求 Claude Code 2.1.287 或更高版本,mods 默认开启;它面向开发工具用户,不能当成所有 Claude 聊天用户都已获得的新功能。

mods 是随插件分发的 JavaScript 或 TypeScript 模块。可以把它理解为装在编码助手里的小程序:会话发生一个动作时,它可以观察、改写或拒绝该动作,也可以绘制自己的界面。它能改变工作流程,使用门槛仍包含插件安装和代码检查。

教程解释,多个 hook 会串成一条处理链。hook 可以理解为动作发生时预留的处理入口。一个模块先处理事件,再交给后面的插件及 Claude Code;也可以直接回应,使后续动作不继续。相关事件包括工具调用、提交提示、任务轮次开始结束、会话开始结束和界面绘制。

与设置里每次启动一个外部命令的 hook 相比,mod 加载一次后留在会话里,能保存状态、更新界面、打开面板、注册命令或工具。模块在自己的沙箱中运行,通过宿主提供的接口访问外部能力。

教程还提醒接口会随版本变化。Claude Code 加载 mod 时会写出当前版本的类型声明,这些文件才是该版本的接口依据。作者用空文件夹起步演示制作过程,读者可请 Claude 协助编写,也可查看实现,但这不免除审查责任。

自定义插件把用量与修改过程放到使用者能看到的位置。

自定义插件把用量与修改过程放到使用者能看到的位置。

三个例子,把状态和后果展示出来#

第一个例子叫 Token Weather,用类似天气的状态提示上下文窗口用了多少。上下文窗口是模型一次能处理的材料容量;材料越来越多,接近上限时就需要留意后续整理。教程示例显示使用百分比、已用量与总容量、最近 12 轮的小图,以及上一轮增加多少内容。

示例按使用量分档:低于 25%、25% 至 49%、50% 至 74%、75% 至 89%,以及 90% 及以上。最高一档提醒即将需要压缩。这里的天气词只是显示方式,它表达容量状态,不代表答案质量评分。用量来自会话接口,与状态栏使用同一组数据;教程说常规读取免费,要求详细分解时才发送计数请求。

模块在会话开始与每轮结束后记录状态,并排除子代理轮次。历史数据放在宿主管理的状态中,使代码热重载后仍能保留。界面读取状态时会订阅更新,因此记录变化后自动重绘。教程要求声明状态类型,并通过插件验证与测试检查行为。临时开发目录会清理,想保留插件需要复制并按常规插件方式安装。

第二个例子 Blast Radius 会暂缓删除、强制推送、重置和数据库迁移等被识别为危险的命令,展示可能影响的文件或改动,让人选择继续或取消。信息来自相关工具的预演或检查命令。教程明确说它是辅助安全网,不能替代权限规则。它只读取命令文本,别名、脚本和某些间接执行方式可能绕过识别。

第三个例子 Replay Theater 记录一轮中每次编辑和写入前后的内容,结束后允许使用者逐项回看差异。它只观察,不拦截编辑。界面宽度足够时面板停在右侧,较窄时嵌入提示区。

分发方式沿用插件市场和安装流程。教程强调,mod 是发布者写的代码,在用户机器上的 Claude Code 里运行,拥有相应访问能力。安装前应先看仓库,只信任可靠来源;把插件分享出去和让它安全运行,是两件都要认真做的事。

用量提示、操作确认和修改回放分别回答不同的检查问题。

用量提示、操作确认和修改回放分别回答不同的检查问题。

业务人员能提需求,验收仍要有人负责#

以下是结合教程的应用判断。小企业若请同事用 Claude Code 维护网站、整理脚本或调整自动化流程,可以把需求说得很具体:删除前展示范围,修改后列出差异,长任务显示容量。业务负责人无需先背接口名,也能提出这些检查要求。

先从只观察、只显示的插件开始。例如展示已读取的资料或回看本轮修改,通常比一开始改写所有命令更容易验证。教程演示了自然语言描述后让 Claude 辅助生成插件的做法,产出的代码仍要验证、测试,并由能看懂的人检查。没有这样的人,优先使用现成工具已提供的权限和差异查看功能。

假设一家门店用 AI 协助调整订单导出脚本,修改回放可以帮助核对哪些规则动过,危险操作提示可以多给一次检查机会。这是场景建议,原文没有证明门店因此节省多少时间,也没有提供这类插件的商业收益。

不要把“可以取消”当成所有误操作都会被拦住。客户资料、正式网站和唯一一份业务文件需要备份及权限限制。只安装来源可信、用途清楚的插件,避免把未经检查的小程序直接放进重要工作环境。

价格、账户权益和地区限制,教程没有完整说明。团队应先确认自己已有工具版本和服务条件,再决定是否定制。对于只需要偶尔写一封邮件、总结一页材料的用户,这套开发工具插件暂时没有迫切必要。

验收时可以准备一份副本,让插件展示一次修改、一次取消操作,再检查文件是否按预期保留。过程中的提示要让业务同事也看得懂,例如写清将影响哪些文件,避免满屏陌生命令。插件升级后需要重新确认检查功能是否仍有效,版本接口变化可能影响表现。团队把这类检查安排进日常使用,比装完就忘记更有价值;若维护插件的工作超过了实际收益,就收回到工具自带功能。

先用可观察的检查功能,小范围验证后再考虑更深的定制。

先用可观察的检查功能,小范围验证后再考虑更深的定制。

消息参考来源

Comments

Copied
Copied to clipboard