Claude Code mods 入门教程：从零构建 Token Weather 上下文窗口预报插件

事件核心：发生了什么

Claude Code 此前已支持 settings、权限规则、斜杠命令、skills 和状态栏等定制方式，而 Mods 走得更远：它能重写或替换 Claude Code 的行为，甚至绘制自定义 UI。底层上，Mods 本质是 hooks，以 JavaScript 或 TypeScript 模块形式打包在插件中，随会话加载，能实时看到每一次事件。

教程要求 Claude Code 2.1.287 或更高版本，Mods 默认开启。它以「Token Weather」为例，在提示符上方绘制一条实时上下文窗口预报：天气图标、占用百分比、已用 token 数、近期轮次小图表，以及上一轮新增量，约 80 行代码。文中还展示了两个更大型的示例 Mod：Blast Radius 与 Replay Theater。值得注意的是，Claude Code 自身的部分功能（如 AGENTS.md 支持、对话旁的 /diff 面板）就是用 Mods 构建的，源码与测试公开在 anthropics/claude-code 仓库的 mods/ 目录下。

为什么重要

这代表 AI 编程工具正从「预设配置」转向「开放运行时」。与传统的 settings hook 每个事件跑一次 shell 命令、通过 stdin/stdout 传 JSON 不同，Mod 只加载一次并常驻会话，可保持状态、绘制动态 UI，还能反向调用 Claude Code——打开面板、运行进程、注册斜杠命令，甚至注册模型可调用的工具。这意味着开发者可以在不 fork 产品的前提下深度改造体验，生态延展性明显增强。

对开发者与创作者的影响

门槛被大幅拉低：教程强调你无需先掌握 API，只需向 Claude 描述「想看到什么」，它就能写出 Mod，并通过热重载在同一会话内即时调整。对开发者而言，上下文窗口可视化、危险命令守卫、代码审查视图等都能按个人习惯定制；对团队而言，这提供了把内部规范沉淀为插件的路径。目前公开信息显示，Mods 的 API 可能随版本变化，每次加载时类型声明会写入插件的 .claude-plugin/types/ 目录，该版本声明才是权威依据。

值得关注的后续

一是 Mods 生态能否形成公开分发与复用机制，而不只是单会话临时加载；二是 API 稳定性如何，频繁变动会影响插件长期维护成本；三是 Cursor、GitHub Copilot 等竞品是否跟进类似的「可编程钩子层」，这将是 AI 编程工具竞争的下一个分水岭。

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

来源：Anthropic：Claude.dev 开发者博客（RSS）