8.0
热点
AI SCORE
工具产品2026-10-05 12:30
Claude Code mods解析：何时需要构建插件
dev.to · AI#Claude Code#插件#Anthropic
Editor brief · 编辑速览
Anthropic于2026年10月1日推出mods，定位为修改Claude Code外观和行为的插件，可监听、修改或接管工具调用和prompt提交事件。
Mods 是什么
用 Claude Code 干了一个小时，你翻回 transcript 想回答三个问题：改了什么、上下文还剩多少、以及 Claude 跑了什么你会想叫停的。这三个答案都在里面，只是埋在每一条工具调用下面。
Anthropic 在 2026 年 10 月 1 日发布的 Mods，让你可以把这些答案放到你已经在看的地方。Claude Code mods overview 把 mod 定义为"一个改变 Claude Code 外观和行为的插件"，由 JavaScript 或 TypeScript 处理器构建，运行在工具调用或提交 prompt 等事件上，"可以监听事件、修改事件、或接管事件"。
当你想要在观察 agent 工作的地方直接看到某个你一直往上翻的信号时（上下文剩余量、危险命令、改了什么），就建一个 mod。当 settings hook、status-line 脚本或 skill 已经能搞定这件事，就跳过 mod。
一个 mod 就是一个插件，它的函数运行在 Claude Code 内部，响应工具调用和 prompt 等事件。
好的第一个 mod 都很小：上下文区间、危险命令守卫、上一个回合的编辑回放。
Mods 以你的权限运行，没有沙箱隔离，也不在 VS Code 扩展的聊天面板中绘制任何内容。
mod 是一个里面有代码的插件。Create a mod 指南说插件的 hooks/hooks.json 中的 modules 键"是让这个插件变成 mod 的东西"，一个小型 mod 有三个文件：plugin.json、hooks.json 和 register.js。
每个 hook 监听、改写或回答它收到的每个事件。
register.js 中的每个函数都是一个 hook，接收 ($, e, next)：mods API、事件和下一个处理器。Hook 可以监听事件、改写事件，或者直接回答事件使正常行为永不运行。绘图、命令、模型调用、文件和网络访问都通过 $ 进行："Hook 没有其他方式做这些事情，这就是为什么 Claude Code 可以在你安装之前就列出 mod 的功能。"Overview 的工作示例用两个 hook 来计数工具调用并在 spinner 上显示 "Thinking · tool calls: 3…"，大约十几行代码没有注释。"Mods 需要 Claude Code v2.1.287 或更高版本，且默认开启。"
Claude Code 已经有 hooks 了，mods 文档称之为 settings hooks：settings 文件中的一条 shell 命令、HTTP 请求或 prompt，在生命周期事件上运行。Anthropic 的发布帖子指出了它们的限制："Hooks 帮助用户获得了一部分控制权，但 hooks 无法改写事件、绘制新 UI 或替换功能。Mods 可以。"
Overview 列出了 mod 能做到而 settings hooks、skills、status lines 和 MCP servers 做不到的五件事：
Mods 起源于 GitHub 上 2026 年 9 月 3 日提出的"function hooks"提案，现标题为"Mods - make Claude 10x more extensible"。9 月 9 日讨论中敲定了名称："我们将把这个功能称为 'Claude Mods'。"10 月 1 日发布"我们上线了！"
许多早期分享的 mods 都很有趣或偏仪表风格。OneWave 在推广自己的一套 mods 时开源了十个，包括 "burn-meter"、"boss-fight" 和 "code-pet"，并把 mods 描述为改变"它工作时你看到的内容"。在 Reddit 上，Claude Fables 把会话最新一刻"以短艺术场景的形式在 prompt 上方的区间中重现"。
选择能交付你的信号的最简单方案。引文来自 overview 的表格和 status line 文档。
只有 mod 能绘制面板、区间或按钮，或者在没有 Claude 回合的情况下运行命令，而且"一个插件可以包含所有这些"，所以你可以组合它们。关于文档工作的 skills 方面，参见 Claude skills for documentation 的排名。
一个反对意见是 mods 是装饰性的：settings hooks、MCP servers 和 skills 已经覆盖了所有改变 agent 行为的东西。证据在一定程度上支持这个观点：文档让你去找 settings hook 来阻止、允许或记录。内置的 status line 已经"接收 stdin 上的 JSON 会话数据并显示你的脚本打印的内容"，包括上下文使用量和成本。Codev 项目中一个开放未决的提案给一个用于角色注入的 mod 评级为"No gain; keep the flag (cross-harness)"，并说"shell hook、role flag 和 render gate 仍然是 cross-harness 的底线"。
这个反对意见在控制流方面站不住脚。文档的比较表格说 settings hook 可以决定工具调用是否继续，并可以改变它的参数。Mod 还可以暂停调用同时问你一个问题、不运行工具而直接回答它、以及在 Claude 仍在工作时运行 /command。Status line 在"新助手消息到达"等事件上重新运行，所以它可以显示状态但不能暂停、更改或回答工具调用。如果你的 status line 和 CLAUDE.md 已经显示了你需要的内容，就保留它们，在它们够不到的信号上建 mod。
Anthropic 分享的示例"按原样提供，没有支持"，MindStudio 的 mods 设置指南警告说堆叠多个 mods 会让界面变得混乱，所以要建一个解决真实工作流问题的 mod。
一位开发者的第一个 mod，在 dev.to 上写的那样，开头是"我想要一件事：不用输入 /context 就能看到我的上下文窗口"。Anthropic 的 token-weather 示例"在 prompt 上方绘制你的上下文窗口预报"。
blast-radius 示例"暂停一个危险的 shell 命令，如 rm -rf 或 force push，并显示它会改变什么，有按钮可以继续或取消"。在 r/claude 上分享的一个守卫 mod"在任何 commit、push 或 deploy 之前要求我确认"，并且"在模型读取之前从工具输出中删除 API keys"。
replay-theater 示例"添加了一个 /replay 命令，逐步回放 Claude 在上一个回合中做的文件编辑"，不需要翻看就能回答改了什么。
mod 是 hooks/hooks.json 中有 modules 键的 plugin。Hook 是 mod 内部的函数，Claude Code 在事件发生时调用它。Settings hook 是旧的那一种：settings 文件中的脚本，可以阻止、允许或记录事件，或者改变工具调用的参数，但不能在界面中绘制内容。
不需要。在会话中描述这个 mod，"Claude 从一个名为 plugin-authoring 的内置 skill 出发"，把它写到 ~/.claude/dev-mods/ 下，然后 Claude Code 问你是否启用热重载。那个 mod"只在创建它的会话中加载"，所以把它复制出来保存。Dev.to 的那位作者还是遇到了静默失败和 PATH 不匹配："这让我困惑了二十分钟。"
"Mod 是以你的权限运行的代码"，并且"Mods 没有沙箱隔离。"Mod 可以"在你被问到之前批准工具调用"、"读取你的密钥"和"消耗你的用量"，但不能改变权限提示。安装前在它的文件夹上运行 claude plugin validate："hooks: 和 calls: 行"列出了它做什么，而不实际运行它。
像从市场安装任何插件一样安装，例如 /plugin install token-chart@your-org。要关闭 mods，在 /plugin 中禁用一个、一次会话用 --safe-mode 启动、或者设置 "disableAllHooks": true 来停止你在所有会话中安装的每个 mod。该设置也会停止你的 settings hooks 和自定义 status line；内置的和组织管理的 mods 继续运行。
Hooks 在那里运行，但 mod 绘制的内容不会出现在扩展的聊天面板、claude -p 或云会话中。它出现在终端中，包括编辑器的集成终端和 JetBrains 插件，以及桌面应用的 Code tab 中，但在 WSL 会话中和仅终端元素不显示。2026 年 10 月 4 日打开的 issue #99423 报告说在扩展中"一个正确加载和热重载的 mod 什么都绘制不出来"。
能。管理员可以通过托管设置限制 mods，包括 allowManagedModsOnly。在 Team 和 Enterprise 计划以及有托管设置的机器上，内置的 cc-plugin-sec-default mod 在用户安装的每个 mod 之前加载，并"保护你的组织管理的内容不受用户安装的 mods 影响"。
会。Create a mod 指南说"事件和方法可能在版本之间变化，所以当它们不一致时相信这些文件而不是任何页面，包括这一个。"在更新 Claude Code 后重新验证你的 mods。
选一件你在上一次长会话中翻找的东西，然后让 Claude 写一个显示它的 mod。
如果那件事是 agent 是否留下了文档，你可以建一个工具调用 hook，注意到对 .md 或 .mdx 文件的编辑，并在 prompt 上方显示"docs touched: 3 files, not reviewed"，或者建一个 /docs-check 命令运行文档检查工具。EkLine 没有发布那个 mod；那只是一个想法。EkLine 的 Docs Agent 覆盖了 pull request 这边：当 GitHub 上打开一个 pull request，它决定你的文档是否需要更新，并根据其置信度保持沉默、发布建议或触发更新。它可通过请求在所有计划中使用；阅读自动文档审查 pull request 的工作原理。