Claude Code Mods

Claude Code Mods 通过 JavaScript 或 TypeScript 事件处理器改变 Claude Code 的行为和界面。Anthropic 于 2026 年 10 月 1 日宣布这项功能。Mod 随插件安装和分发，适合把重复的交互要求做成实际功能，例如显示 CI 状态、记录工具调用次数，或在调用前检查参数。

核心能力

事件处理器可以观察事件、改写事件，或接管默认行为。官方示例包括改写提示词、检查工具调用、添加命令，以及在多个处理器之间共享状态。界面扩展可以添加面板、按钮和输入框，也能替换部分现有显示。部分内置功能已有公开的 Mod 实现，例如 diff 界面。

Mods 要求 Claude Code v2.1.287 或更新版本。终端 CLI 和桌面应用 Code 标签可显示自定义界面，但存在官方列明的例外。在其他受支持会话中，处理器可能执行而界面不显示；不要假设 VS Code 聊天面板会渲染自定义面板。

快速开始与实际流程

先阅读官方概览及创建教程。从观察工具调用次数的小 Mod 开始，比一开始接管权限流程更容易验证。用 claude --version 确认版本，检查插件文件，再运行 claude plugin validate ./some-mod 查看它处理的事件和请求的 API 调用。校验输出有助于审阅，但不能证明任意代码安全。

从可信来源安装插件后，如果通过 shell 更新了插件，在已有会话运行 /reload-plugins。用 /plugin 确认加载情况，执行一个小任务，检查事件和显示是否符合预期；异常时禁用插件。团队可先尝试 CI 状态面板，再逐步加入改变执行行为的处理器。

费用与限制

Mod 属于 Claude Code 插件系统，本词条没有确认独立的 Mod 定价。Claude Code 套餐或 API 费用仍适用；Mod 自身调用模型也可能消耗额度。

Mods 使用用户权限运行，没有沙箱隔离，能够读取文件和环境中的秘密、发起网络请求及改变会话行为。组织插件规则和托管设置仍然适用；官方发布说明介绍了托管环境中的安全默认 Mod。团队部署前应阅读当前管理文档，尤其是加载顺序和权限规则。

常见问题与替代方案

与 Skills 有什么区别？ Skills 是 Markdown 指令；Mods 执行事件处理代码，还能绘制交互界面。

何时选 MCP？ 要把外部服务提供为工具时，MCP 更贴近需求。一个插件可以同时包含这些组件。

从哪里学起？ Claude Code 是宿主产品，Claude.dev 提供首个 Mod 教程。GitHub Copilot 是其他编码助手选择，但不能当作兼容 Mod 的运行时。

可查看开发工具分类。下一步是制作只观察事件的小 Mod，核对它调用的能力，确认结果后再加入行为改写。