从零构建 Token Weather 上下文窗口预报插件

核心亮点

Anthropic 的开发者博客发了一篇教程，教大家从零构建一个"Token Weather"上下文窗口预报插件。核心是用 Claude Code 的 mods 机制：以 hooks 形式运行在插件内的 JS/TS 模块，可以观察、重写或拒绝事件，甚至画出自定义 UI。前提是 Claude Code 2.1.287 或更高版本。

具体能力或事件经过

"Token Weather"这个名字很形象：它像天气预报一样，实时告诉你当前上下文窗口的"气压"——还剩多少 token、会不会溢出。教程一步步演示如何用 mod 拦截请求，在每次调用前读取上下文长度，并把剩余额度可视化出来，避免写到一半才发现窗口爆了。这是把"可观测性"直接做进了编码助手的例子。

技术细节

mod 本质是挂到 Claude Code 事件流的钩子。它能在请求前后拦截，重写提示词或工具调用结果，也能拒绝某些事件。画自定义 UI 则让状态展示不再依赖外部日志，而是直接显示在终端里。2.1.287 以上的版本才支持这套 hooks API，所以旧版用户需要先升级，这也是官方在推"可编程外壳"路线的一个信号。

与竞品对比

相比 Cursor 的规则文件或通用 Agent 的提示词模板，mods 把控制下沉到事件层，能做更细的拦截与改写。和传统的 IDE 插件比，它不需要单独编译扩展，几行 TS 就能分发，门槛低很多。对想把内部规范固化进工具的团队，这种"轻量钩子"比重量级插件更灵活，也更不容易和主程序版本冲突。

行业影响或适用场景

对企业，这类插件能把上下文预算、合规校验、成本控制固化进日常开发流程，减少人为疏忽。对个人开发者，它是低门槛的"二次开发"入口，可以把自己的小工具链挂到编码助手上。Agent 工具的竞争正从模型能力转向"可编程的工作流外壳"，Token Weather 这种小插件正是这一方向的生动注脚。