Claude Code v2.1.323 发布：新增实验性 Code Mode 与插件版本约束

Anthropic 的 Claude Code 于 2026 年 11 月 12 日发布 v2.1.323。该版本引入实验性、需主动开启的 Code Mode，并给插件清单增加 engines["claude-code"] 版本约束，同时扩展 claude plugin validate 的检查能力。发布说明还列出钩子心跳、权限判定、沙箱与登录状态等多项修复。

实验性 Code Mode：让 Claude 写 JavaScript 调用工具

v2.1.323 新增 Code Mode，定位为实验性且需要主动选择加入（opt-in）。在该模式下，Claude 会编写 JavaScript 来调用自己的工具，而不是以常规方式发起工具调用。发布说明给出了专门文档地址，用户可据此开启该模式，组织管理员也可据此为整个组织关闭。

原文没有说明 Code Mode 的默认状态细节之外的行为差异、性能表现或适用模型范围，只明确它是实验性功能并需要手动开启。因此它当前更适合被理解为面向愿意尝鲜的用户的试验能力，而非默认工作方式。

插件版本约束与校验能力增强

插件清单 plugin.json 新增 engines["claude-code"] 字段。声明了版本范围的插件，如果不在其标注的 Claude Code 版本范围内，将不会被安装、更新或加载；安装和更新时会选择符合范围的最新版本。这为插件作者提供了对宿主版本的最低或区间约束手段。

claude plugin validate 新增对插件 TypeScript 钩子模块的类型检查，每条发现以警告形式呈现，使用 –strict 时则会因这些发现而失败。该命令还会检查 mod 的 engine.create 钩子所添加、保留或替换的 $ 名词。此外，claude plugin install –json 结果新增 unsetOptionCount，用于表示尚未设置的用户配置项数量。

长任务心跳与托管设置新增项

在 claude -p 和 SDK 会话中，当钩子长时间运行时，现在每 30 秒发送一次进度心跳，避免 Claude Desktop 等宿主把该轮次判定为挂起而结束。发布说明注明，这一能力要等 Claude Desktop 包含该版本后才会生效。

托管设置新增对 CLAUDE_CODE_AUTO_MODE_MODEL 的支持，面向第三方提供商上的 Claude Desktop 会话，同样需要 Claude Desktop 包含该版本后生效。另有 CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES（自 2.1.318 起可用），设为 1 可关闭子智能体进度摘要及写入这些摘要的请求；CLAUDE_CODE_RESUME_HINT_COMMAND 则允许启动 Claude Code 的程序自定义退出提示中显示的恢复命令。

权限、沙箱与自动模式的多项修复

本次修复涉及多处权限判定。Bash 允许规则若在变量值中带 *（如 Bash(PORT=* npm run dev)），启动时会给出警告；带附加通配符的允许规则（如 Bash(ls*)）在某些情况下跳过权限提示的问题被修复，而命名变量的规则（如 Bash(NODE_ENV*）现在会询问。Bash 拒绝与询问规则漏掉经 sudo、env 等包装器执行的命令的问题也已修复。

自动模式方面，当自动模式不可用时，–permission-mode auto 或设置中的 defaultMode: auto 过去可能以允许更多操作的模式启动，现在改为以先询问的 Manual 模式启动。在 ANTHROPIC_BASE_URL 网关后运行自动模式时，若模型网关名包含 haiku 且不是 claude-haiku-5-5，该模型现在会被拒绝。沙箱方面，修复了会话中途沙箱可能被关闭、sandbox.excludedCommands 让未列名命令在沙箱外运行等问题。

登录状态、会话恢复与界面细节

发布说明包含大量与登录和会话连续性相关的修复：claude plugin 命令和 claude mcp list 在令牌续期期间结束时把用户登出 Console 配置的问题；命名 Anthropic 配置的会话在后台被切换到其他登录的问题；后台会话在配置缺失或变更时把对话发到另一登录的问题。现在这类情况会停止并给出说明。

界面与交互方面，diff 面板新增 /diff 关闭提示，? 快捷键指南加入聚焦和关闭面板的按键；全屏渲染下长提示把多行状态栏挤出屏幕、权限与计划对话框下名称标签遮挡部分智能体名等问题被修复。Artifact 工具的资源上传新增 .docx 支持，WebFetch 则修复了丢弃空表格单元格导致后续值错列的问题。

知序观察

观察：Code Mode 把工具调用从结构化调用改为生成 JavaScript，若成熟，可能改变 Claude Code 扩展工具链的方式，但当前仍是实验性且需手动开启，实际效果尚待验证。插件 engines 约束与校验增强，则显示插件生态开始引入版本兼容治理。本次发布说明以大量权限、沙箱和登录修复为主，反映这些环节仍是使用中的高频问题区域，但不宜据此推断具体故障来源。