Claude Code 功能汇总：TypeScript 模块、草稿恢复与插件钩子（十月 2026）

Claude Code 功能一览

十月的前三个版本将一项重要的扩展功能与日常开发中的细节改进结合起来。Claude Code 2.1.287 引入了模组；2.1.288 新增了草稿恢复和审查控制；2.1.289 扩展了插件钩子支持，并解决了模组加载和权限问题。

下表可帮助你根据想要改进的工作流程找到切入点。

这些版本针对同一工作流程的不同环节进行了改进。模组让插件能够改变 Claude Code 的行为，而草稿恢复则降低了提示词编辑中误操作的影响。当这些扩展与智能体、工具和组织管理的设置交互时，后续的钩子和权限修复就尤为相关。

TypeScript 模组扩展插件行为

Claude Code 2.1.287 引入了 Claude Mods，发行说明将其描述为“插件现在可以修改更深层的行为”。模组是打包在插件中的小型 TypeScript 函数，可同时用于 CLI 和桌面应用。

该 十月 1 日的模组公告 介绍了多项能力：重写提示词、添加 UI、替换内置功能，以及阻止、重写或重试工具调用。当你需要改变 Claude Code 在任务执行过程中的行为时，这些能力使模组成为相关的选择。

对于熟悉钩子的开发者，有助于理解两者区别的是文档明确列出的模组作用范围：它们可以修改提示词、UI、内置行为和工具调用。 Claude Code 钩子指南 为评估哪种扩展机制适合项目提供了参考。

创建和测试模组

该 带版本标记的 2.1.287 模组 README 记载了一个导出的 register(on, options) 函数，以及采用以下形式的处理程序： ($, e, next)。插件目录结构包括 .claude-plugin/plugin.json, hooks/hooks.json，以及位于以下目录中的 TypeScript 文件： hooks/.

文档列出的开发命令如下：

/plugin-types
claude --plugin-dir mods/diff
claude plugin test mods/diff

/plugin-types 写入声明。另外两个命令是该快照提供的示例，用于通过示例插件目录运行 Claude Code，以及测试该插件。

该快照还警告，API 可能在不同版本之间发生变化，且不会另行通知。请将带版本标记的文档作为实现参考的一部分，尤其是在升级依赖模组 API 的插件时。

访问、信任与内置模组

mod 以 Claude Code 对机器的访问权限运行，且不受沙箱隔离。Anthropic 的公告建议仅从可信来源安装 mod。启用 mod 前，请审查其源代码和来源，尤其是在它能够改写或重试工具调用时。

版本 2.1.287 还新增了 “你应该知道”， 这是一个内置 mod，其辅助智能体会指出用户或 Claude 可能遗漏的事项。启用命令为：

/plugin enable cc-plugin-you-should-know@builtin

公告注明，该功能可用于启用了遥测的第一方会话。这一适用条件很重要：公告并未确认该功能在所有会话配置中都可用。

草稿恢复与代码审查控制

Claude Code 2.1.288 为交互式工作新增了两项实用控制功能：恢复被 Ctrl+C 清除的提示词，以及选择要报告的代码审查发现数量。

恢复被 Ctrl+C 清除的提示词

如果 Ctrl+C 清除了提示词，请在 提示词为空时按上箭头键 以恢复草稿。恢复内容包括粘贴的文本和图片。

该版本说明描述了针对已清除提示词的特定恢复操作。它并未确认存在通用的草稿存档功能，也未说明会话以各种方式结束时的恢复行为。只需记住这个顺序：Ctrl+C 清除提示词，然后在提示词为空时按上箭头键即可恢复。

当提示词包含键入指令以外的内容时，这一点尤其有用。恢复行为明确涵盖粘贴的材料和图片，因此该功能可以恢复这份已清除草稿中的这些内容。

设置审查发现数量

新增的 /code-review --max-findings <n>|all 选项控制一次审查报告多少项发现。您可以选择一个数量、请求所有发现，或恢复默认设置：

/code-review --max-findings 5
/code-review --max-findings all
/code-review --max-findings default

该设置会持续生效，直到您使用以下命令重置它： default。在进行不同审查时，请将其视为持续生效的偏好设置。

版本说明未指定默认数量，因此没有可引用的、已确认的默认数量。如果您希望有明确的报告上限，请设置具体数量；如果您希望恢复内置行为，请使用重置命令。 CLI 参考文档 可为更广泛的命令行工作流提供有用的配套参考。

插件钩子提供更清晰的智能体跟踪信息

Claude Code 2.1.289 新增了与队友创建和智能体状态有关的插件钩子信息。相关变化包括 agent.spawn 用于队友、在各插件钩子事件中使用统一的智能体 ID，以及在以下内容中提供空闲或等待状态： $.agent.list().

对于插件作者而言，这些新增内容提供了更多智能体活动信息。一致的 ID 为各事件提供共同的智能体标识符，而空闲和等待状态则为以下命令返回的列表补充了详细信息： $.agent.list()。这份简要说明未提供完整的实现示例，因此应将这些新增内容视为 API 能力，而非现成的编排方案。

mod 加载与 UI 修复

同一版本修复了升级后的首次会话中已安装 mod 无法加载的问题。它还解决了本地市场插件副本过时以及若干 mod UI 故障。

在更新 Claude Code 后验证扩展时，这些修复值得关注。请将升级后的首次会话纳入检查，并确认已安装插件与预期的本地市场版本一致。

版本 2.1.288 已经新增了 $.ui.selection()。它会返回最近一次全屏文本选择的内容；当该选择内容位于单个对话记录行内时，还会返回该行。这为 mod 作者提供了选择内容信息，并明确说明了获取关联行的条件。

受管理机器上的权限处理

版本 2.1.289 还修复了涉及用户安装的 mod 的权限行为。在组织管理的机器上，复合 shell 命令中嵌套部分的拒绝和询问规则会保留，不会被 mod 的批准覆盖。

其他修复涉及 Read 通过 IDE 符号链接时的拒绝规则，以及沙箱自动允许机制下 Bash 的拒绝或询问规则。这些变化值得与新的 mod 能力一并关注：扩展行为和权限执行都是评估升级的一部分。

会话导航、MCP 与网关兼容性

Claude Code 的几项较小的新功能影响了导航和集成工作。

在 2.1.287 中，智能体视图新增了一个 n:<text> 筛选器，可匹配会话名称和任务。随后，版本 2.1.288 新增了 Ctrl+F 用于按名称搜索会话，以及 Alt+↑/↓ 用于在智能体视图的各组之间跳转。这些快捷键和重命名操作可在以下位置重新绑定： keybindings.json.

对于恢复的会话，2.1.288 包含若干 --resume 修复，可保留恢复的上下文、最终回复和先前的思考内容。这些是针对恢复工作可靠性的改进，与恢复被 Ctrl+C 清除的提示词是不同的功能。

MCP URL 提示

版本 2.1.287 为使用以下协议的 MCP 服务器新增了 URL 提示： 2025-11-25。如果服务器无法继续连接，版本说明提供了 "bareElicitationCapability": true 作为兼容性设置。

该设置是与此版本的 MCP 变化相关的故障排查细节。请结合受影响服务器的情况检查它，而不要将其视为通用配置要求。 MCP 指南 可作为相关集成工作流的入门参考。

结构化输出

版本 2.1.288 引入了 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS，可为拒绝结构化输出的网关等环境禁用结构化输出。

这份简要说明介绍了该环境变量的用途，但未给出具体赋值或 shell 命令。如果结构化输出被拒绝的问题影响您的环境，可以调查这一配置选项；版本说明并未确认每个网关都需要它。

需要留意的使用限额

除十月的功能变化外，九月还调整了订阅使用限额。自九月 14 起，每周限额已永久调整为 比促销前水平高 25% ，适用于 Pro、Max、Team 和按席位计费的 Enterprise。

此前临时实施的 50% 增幅 从五月 13 持续到 2026 年九月 13，于太平洋时间下午 11:59 点结束。Free 和按用量计费的 Enterprise 席位不在该促销范围内。

检查当前额度时，请区分这些百分比。永久增幅和已结束的促销采用不同的数值；十月的版本更新并未确认恢复到促销期间的水平。

使用 /usage 以查看您的限额。有关相关订阅限制的更多背景信息，请参阅 Claude Code 速率限制指南.

要点

• Claude Code 2.1.287 引入了 TypeScript mod ，它们随插件一起提供，可以修改 CLI 和桌面应用中的提示词、UI、内置功能和工具调用。
• mod 不受沙箱隔离。 它们以 Claude Code 对机器的访问权限运行，公告建议仅从可信来源安装。
• 版本 2.1.288 可恢复已清除的草稿： Ctrl+C 清除提示词后，在提示词为空时按上箭头键即可恢复，包括粘贴的文本和图片。
• 审查发现数量可配置，且设置会持续生效。 使用 /code-review --max-findings 5, all，或 default；默认数量未予说明。
• 版本 2.1.289 扩展了与智能体相关的插件钩子 ，并修复了 mod 加载、UI 和权限处理问题。使用 /usage 来检查当前限额，并将其与这些功能变化分开考虑。

常见问题

什么是 Claude Code mod？

Claude Code mod 是打包在插件中的小型 TypeScript 函数，可以改写提示词、添加 UI、替换内置功能，以及阻止、改写或重试工具调用。它们适用于 CLI 和桌面应用，以 Claude Code 对机器的访问权限运行，且不受沙箱隔离。

如何创建和测试 TypeScript mod？

2.1.287 快照文档介绍了一个导出的 register(on, options) 函数、形式为以下内容的处理函数 ($, e, next)，以及包含以下内容的插件 .claude-plugin/plugin.json, hooks/hooks.json，并将 TypeScript 放在以下目录中 hooks/。使用 /plugin-types 以生成声明；文档中的示例命令为 claude --plugin-dir mods/diff 和 claude plugin test mods/diff.

如何恢复意外被 Ctrl+C 清除的提示词？

在 Claude Code 2.1.288 中，Ctrl+C 清除提示词后，在提示词为空时按上箭头键。这会恢复已清除的草稿，包括粘贴的文本和图片。

如何更改或重置代码审查发现数量上限？

使用 /code-review --max-findings 5 以设置具体数量上限，或使用 /code-review --max-findings all 来请求所有发现。该选择会持续生效，直到使用 /code-review --max-findings default，且版本说明未指定默认数量。