「Claude Code with mods in TypeScript | Claude by Anthropic」

今天我们将介绍 mods：一些能够改变 Claude Code 工作方式的小型 TypeScript 函数。mod 可以重写提示词、添加新的 UI、替换内置功能，或完全添加新的功能。你可以自己编写 mod，也可以让 Claude Code 帮你编写。Mods 包含在插件中，因此你可以像安装和分享任何插件一样安装和分享它们。它们可在 Claude Code CLI 和桌面应用中运行。Today we're introducing mods, small TypeScript functions that change how Claude Code works. A mod can rewrite a prompt, add new UI, replace a built-in feature, or add entirely new functionality. You can write a mod yourself, or ask Claude Code to write one for you. Mods ship inside plugins, so you install and share them like any plugin. They work in the Claude Code CLI and desktop app.

Mods 对你机器的访问权限与 Claude Code 本身相同。它们没有经过沙盒隔离，因此你只应从信任的来源安装 mods，就像在电脑上安装任何代码一样。Mods run with the same access to your machine as Claude Code itself. They aren’t sandboxed, and you should only install mods from sources you trust, the same way you'd install any code on your computer.

要了解模组能实现什么，请阅读我们的《构建你的第一个模组》指南。To see what mods can do, read our guide to building your first mod.

我们为何构建模组Why we built mods

开发者们希望在无需等待我们推出功能的情况下，更好地控制 Claude Code 的工作方式。Hooks 帮助用户获得了部分控制权，但 Hooks 无法重写事件、绘制新的 UI 或替代现有功能。而 Mods 可以。Developers have asked for more control over how Claude Code works, without waiting for us to ship a feature. Hooks helped give users some of this control, but hooks can't rewrite events, draw new UI, or replace features. Mods can.

我们希望 Claude Code 用起来像是为你量身打造的，因此你可以按照自己的工作方式对其进行定制。我们在发布前就在 GitHub 上分享了 mods 的设计，以听取开发者的反馈。感谢每一位提出意见的人。We want Claude Code to feel like yours, so you can shape it to the way you work. We shared the design for mods on GitHub before launch to get feedback from developers. Thank you to everyone who weighed in.

模组的工作原理How mods work

Claude Code 每次执行某项操作时，都会发出一个事件。示例包括调用工具、请求权限以及绘制屏幕的一部分。mod 是一个挂钩到这些事件之一的函数。mod 可以在事件之前、之后或代替事件运行。它还可以包装事件，在前后都运行代码。通过一个函数，mod 可以：Each time Claude Code does something, it emits an event. Examples include calling a tool, asking for permission, and drawing part of the screen. A mod is a function that hooks into one of these events. A mod can run before the event, after it, or instead of it. It can also wrap the event, running code both before and after. With one function, a mod can:

• 在提示词到达模型之前重写它。
  Rewrite a prompt before it reaches the model.
• 拦截、重写或重试工具调用。
  Block, rewrite, or retry a tool call.
• 批准或拒绝权限请求。
  Approve or deny a permission request.
• 在 Claude 读取工具输出之前，先从中删去机密信息。
  Redact secrets from tool output before Claude reads it.

模组还可以改变你所看到的内容。它可以编辑或替换 Claude Code 绘制的界面的一部分，例如工具结果或 Claude 提出的问题。它可以添加按钮和输入框，其他模组则可以在你按下这些按钮时做出响应。目前，模组可以针对终端、桌面应用，或同时针对两者。A mod can also change what you see. It can edit or replace part of the interface Claude Code draws, like a tool result or a question from Claude. It can add buttons and inputs, and other mods can respond when you press them. Today, a mod can target the terminal, the desktop app, or both.

当多个模组挂钩同一个事件时，它们会按照加载顺序运行。最先加载的模组最先看到该事件，最后获得结果。这样一来，你就可以叠加来自不同作者的模组。When several mods hook the same event, they run in the order they load. The first mod to load sees the event first and the result last. This lets you stack mods from different authors.

你还可以使用 Claude Code 来为 Claude Code 制作模组。让 Claude 创建一个模组，它就能编写 TypeScript、安装模组，并在你的会话中热重载该模组。You can also use Claude Code to mod Claude Code. Ask Claude to create a mod, and it can write the TypeScript, install it, and hot reload it in your session.

用你自己的功能替换内置功能Swap built-in features for your own

Claude Code 的一些内置功能现在以模块形式提供。例如，内置的 /diff 功能现在就是一个模块，因此你可以将其关闭（在 /plugin 中），或用自己的版本替换它。我们计划随着时间的推移将更多内置功能移至模块中，这样你就可以将 Claude Code 精简为一个小型核心，并只添加你想要的功能。Some built-in features of Claude Code now ship as mods. For example, the built-in /diff feature is now a mod, so you can turn it off (in /plugin) or replace it with your own version. We plan to move more built-in features to mods over time, so you can pare Claude Code down to a small core and add back only what you want.

面向团队和企业的 ModsMods for teams and enterprises

Mods 随插件一起提供，因此您现有的插件控制措施同样适用。管理员可以允许或阻止插件市场。在 Team 和 Enterprise 方案中，所有者可在管理控制台中进行设置。在 Claude API 和第三方 API 方案中，管理员会将托管设置推送到用户的设备。Mods ship inside plugins, so your existing plugin controls apply. Admins can allow or block plugin marketplaces. On Team and Enterprise plans, an owner sets this in the admin console. On Claude API and third-party API plans, admins push managed settings to users' machines.

在 Team 和 Enterprise 方案中，以及任何具有托管设置的机器上，一个名为 sec-default（“安全默认设置”）的内置 mod 会首先加载。它会阻止用户安装的 mod 执行高风险操作，例如覆盖你的权限拒绝规则。你可以查看源代码，了解它限制了哪些操作。管理员也可以改为先加载自己的 mod。如果这样做，请将 sec-default 添加到你的列表中，以保留其限制。On Team and Enterprise plans, and on any machine with managed settings, a built-in mod called sec-default (“security default”) loads first. It stops mods that users install from doing risky things, like overriding your permission deny rules. You can view the source code to see what it restricts. Admins can load their own mods first instead. If you do, add sec-default to your list to keep its restrictions.

团队还可以使用模组来构建自己的控件和功能。例如：Teams can also use mods to build their own controls and functionality. For example:

• CI/CD 状态：一个 mod 可以在对话旁边的窗格中显示你的流水线状态，并随着构建成功或失败而更新。
  CI/CD status: a mod can show your pipeline’s status in a pane beside the conversation, and update it as builds pass or fail.
• 生产环境安全措施：mod 可以要求在任何命令修改生产环境配置之前进行确认。
  Production safeguards: a mod can require confirmation before any command touches production config.
• 审计日志：最先加载的模组可以记录其他每个模组发出的所有调用。
  Audit logging: a mod that loads first can record every call that every other mod makes.

入门Getting started

Mods 今日已在 Claude Code CLI 和桌面应用中推出。你可以从 Claude 目录安装包含 mods 的插件，也可以在 CLI 中运行 /plugin。要分享 mod，请将其打包到插件中并提交到目录。Mods are available today in the Claude Code CLI and desktop app. Install plugins that include mods from the Claude directory or by running /plugin in the CLI. To share a mod, package it in a plugin and submit it to the directory. 

要构建你自己的模组，请阅读我们的入门指南或查看文档。To build your own mods, read our getting started guide or see the documentation.