Anthropic 为 Claude Code 新增了 Mods(模组)功能,这一变化的意义超出了一次普通的功能更新。插件(plugin)是在外部附加能力,钩子(hook)则从外部监听工具,而模组直接运行在 Claude Code 内部。这意味着它们可以重绘界面的一部分、添加按钮和侧边面板,并改变工具在会话中的行为方式。Claude Code 还能根据一段通俗的文字描述为你编写模组,因此即使不会编程也能做出一个。前提是 Claude Code 版本不低于 2.1.287,命令行界面和桌面应用的 Code 标签页均可使用。

什么是模组,它与插件和钩子有何不同

理解模组最简单的方式,是像游戏玩家看待 Grand Theft Auto(侠盗猎车手)这类游戏的改装那样:游戏本体保持不变,但你可以改变它的外观、添加功能,并在其上叠加新的系统。模组对 Claude Code 做的正是同样的事。

这使它们与 Claude Code 已有的两种扩展机制属于不同类别:

机制 运行位置 作用
插件 与 Claude Code 并行 添加自定义技能、MCP 服务器和斜杠命令
钩子 Claude Code 外部 监听会话事件并运行外部脚本,以允许、阻止或标注操作
模组 Claude Code 内部 监听同样的事件,但可以渲染按钮、文本小部件和专用面板,并改变行为

MCP 即模型上下文协议(Model Context Protocol),是让 Claude 连接外部工具和数据源的标准。Claude Code 在会话期间会不断发出事件:发送一条消息、启动一个子智能体、调用一个工具。钩子从外部响应这些事件。从技术上说,模组是插件的近亲,但由于它位于工具内部,它可以用界面变化而不只是脚本来响应同样的事件。

终端分为上下两部分,下方是复古第一人称射击游戏画面,上方是正在编辑的代码文件和进度条

▲ Claude 工作时运行的 Doom 模组

终端里的 Doom,以及它为何不只是个玩笑

社区开发者行动迅速。有人做了一个直接嵌入 Claude Code 的多人 Doom 服务器模组。当 Claude 开始一项耗时较长的任务,比如探索代码仓库、运行测试套件或同时编辑大量文件时,该模组会把你带入一场实时的死亡竞赛。Claude 一完成任务,模组就退出游戏,并报告你本局的击杀死亡比。

这听起来像是分散注意力,某种程度上确实如此。但有些智能体任务要运行 10 分钟左右,而这段等待往往以刷手机告终。更值得注意的是这个模组证明了什么:如果一款 3D 多人射击游戏都能在终端里运行,那么这套模组系统的集成深度和灵活性远远超过简单的附加组件。

去哪里找模组,以及如何检查它们

获取模组主要有三条途径:

  1. 社区市场,例如 aitmpl.com,上面列出了技能、智能体、MCP,以及一个收录 45 个以上组件的专门 Mods 标签页。条目通常会链接到 GitHub 上的源码仓库,方便你先阅读代码。
  2. Anthropic 的官方社区目录,会对提交内容进行自动验证和安全筛查。
  3. Claude Code 内置的模组与插件编写技能,可根据自然语言请求生成模组。

由于模组在 Claude Code 内部执行代码,未经审核的社区模组可能带来风险。运行安装命令之前,先打开仓库查看钩子文件(例如 hooks.js),留意是否有下载文件、发起意外网络请求或将远程脚本直接导入 shell 执行的内容。如果你说不清某条命令是做什么的,就不要安装这个模组。

带有半满状态栏、书签和沙漏图标的终端提示符,背后是淡化的文档页面

▲ 提示符上方的 Cache Tracker 倒计时

Cache Tracker:在提示词缓存过期前盯住它

Cache Tracker 在列表中的名称为 Prompt Cache Control,它解决的是一个许多 Claude Code 用户从未直接察觉的成本问题。Claude Code 没有内置的多轮记忆;每次提示时,它都会重新读取完整的对话历史。在长会话中,这意味着更高的延迟,以及大量 token 被花在重读你已经发送过的文本上。

提示词缓存的原理类似书签。历史记录中静态的部分被缓存起来,Claude 只需读取新增内容。问题在于缓存有生命周期,而这个周期取决于你的付费方式:

访问方式 大致的缓存生命周期
Claude 订阅 约 1 小时
API 额度 约 5 分钟

两者相差大约 12 倍。缓存一旦过期,下一次提示就要为完整重读付费。Cache Tracker 在提示符上方添加了一个抬头显示区,实时显示缓存命中百分比、从缓存读取的 token 数,以及距离过期的倒计时,这样你可以保持会话"热度",或者有意识地决定暂停。

安装方法

从 aitmpl.com 安装只需一条命令:

npx claude-code-templates@latest --mod observability/prompt-cache-control claude

在一个新的终端里运行它。该命令会把模组文件复制到工作区并启动 Claude Code。首次启动时,Claude Code 会要求你确认信任该工作区文件夹。模组的钩子会在你第一次输入提示时激活。在一次用简单问题("如何记录错误日志")进行的测试中,状态栏显示缓存徽标为 50%,已读取 23.3k token,计时器显示 1 小时缓存还剩 09:47,并附有"warm: keep going"(缓存仍热,继续即可)的提示。

管理已安装的模组

在 Claude Code 提示符处输入 /plugins 即可打开插件管理器。它有 Discover(发现)、Installed(已安装)、Marketplaces(市场)、Errors(错误)和 Stats(统计)几个标签页。Installed 标签页列出每个模组,并提供检查、禁用或移除的选项。

Next Steps:你接下来该运行的命令

Next Steps 会读取项目状态,并直接在终端里建议下一步该做什么。这些建议是具体而非笼统的:一条确切的斜杠命令、一条终端指令,或一个要运行的技能脚本。在大型、多阶段的代码库上,它能让你免于记忆命令序列。在小型脚本任务上,它似乎也有帮助,原因很简单:它始终把下一步操作放在你眼前。

Deck:提示符上方的控制面板

Deck 把输入提示符上方的那一行变成了仪表盘。它跟踪:

  • 相对于 5 小时会话上限的用量
  • 相对于 7 天滚动配额的用量
  • 上下文窗口的消耗百分比
  • 当前使用的模型
  • 当前的 effort(投入程度)设置

它还带有一只像素风宠物。Claude 工作时宠物会动起来;当 Claude 等待你确认时,它会举起一个红色感叹号。如果你对提示置之不理,宠物会明显变红、变得生气。Deck 提供几种状态栏样式,以及一种可折叠的单行视图,供终端空间紧张时使用。在一次构建记账 Web 应用的过程中与它并行运行可以看到,这个面板无需任何额外命令就能让配额、上下文和权限状态始终可见。

让 Claude 根据你自己的习惯设计模组

最个性化的途径是让 Claude Code 研究你实际的工作方式。输入类似"查看我过去的会话,建议一些对我有帮助的模组"的提示词,Claude 就会扫描历史会话记录,寻找重复的命令和耗时的环节。在一个例子中,分析发现一名开发者一周内输入了 14 次"再跑一遍测试",反复出现 pnpm 警告,并且在等待测试套件上损失了大约 6 分钟。Claude 据此提议做一个一键运行测试的按钮模组。

接受建议后,Claude 会当场写出完整的模组代码。第一版未必完美,但你可以通过对话不断打磨,直到它合用为止。这可能正是模组最有价值的地方:不是作为下载来的成品,而是围绕每位工程师的工作流量身定制的工具。

要点与建议

模组尚处早期,这个生态看起来很可能会像当年的浏览器扩展那样,与插件和 MCP 工具一同成长。目前,一条稳妥的起步路径是:

  1. 将 Claude Code 更新到 2.1.287 或更高版本。
  2. 浏览 aitmpl.com 或 Anthropic 的目录,并阅读你打算安装的任何东西的源码。
  3. 如果你经常进行长会话,安装 Cache Tracker,尤其是在使用 API 额度时,因为缓存大约 5 分钟就会过期。
  4. 试试 Deck 以查看配额和上下文占用,如果你在复杂代码库间工作,再试试 Next Steps。
  5. 让 Claude Code 回顾你过去的会话,并针对你重复最多的任务提议一个模组。

把每一个社区模组都当作你主动选择运行的代码来对待,并用 /plugins 禁用那些不值得保留的模组。