生活分享

Claude Code 2.1.323 更新:实验性 Code Mode、插件版本限制与更严格的沙盒权限

据 Anthropic 更新日志,Claude Code 2.1.323 加入实验性 Code Mode 与插件版本范围检查,并收紧沙盒、MCP 和权限行为。使用 Claude Code 的开发者、插件作者和团队管理员,升级前宜了解哪些设置与工作流程可能受影响。

新闻日期: 阅读时间约 5 分钟

LINE 分享
目录
  1. 1. 这次更新的重点
  2. 2. 安全与权限行为的变动
  3. 3. 升级前可能受影响的设置
  4. 4. 企业与管理端的小幅新增

这次更新的重点

Anthropic 在更新日志中表示,Claude Code 2.1.323 新增 Code Mode,这是一项实验性、需主动选用的功能,Claude 会编写 JavaScript 来调用其工具。日志指向一个说明文档页面,可用来开启此功能,或针对整个组织将其关闭。

在插件(为 Claude Code 增加功能的扩展包)方面,Anthropic 表示插件的配置文件 plugin.json 现在支持 engines["claude-code"]:超出所标示 Claude Code 版本范围的插件不会被安装、更新或加载,安装与更新会选取符合范围的最新版本。用于检查插件的 claude plugin validate 命令,也新增了对插件 TypeScript hooks 模块的类型检查(hooks 是在特定时机自动运行的自定义程序),每项发现都以警告呈现,加上 --strict 则会失败。

其他新增项目包括:Artifact 工具资产上传支持 .docx;当模型所需的用量额度被关闭或用完时,会出现包含停止、改用用量额度、升级选项的菜单;在 claude -p 与 SDK 会话中,hooks 长时间运行时每 30 秒发送一次进度心跳。Anthropic 称,这可避免 Claude Desktop 等宿主端把该回合视为卡住(待其纳入此版本后)。

安全与权限行为的变动

Anthropic 的日志列出多项收紧措施。沙盒是限制命令能访问哪些文件和资源的隔离环境;在 macOS 与 Linux 的沙盒中,git worktree add、move、remove 现在会以只读方式失败(worktree 是同一个 git 仓库的额外工作目录),在会话未启动或未获授权的 worktree 中提交也一样。“不再询问”所生成的允许规则,如果看起来含有机密,或会被保存到受 git 跟踪的 settings.local.json,则只在该会话内有效、不会被保存。

MCP 服务器是让 Claude 连接外部工具与服务的接口。完成 MCP 服务器登录的工具现在会要求用户确认,即使在 bypass 与 auto 模式下也一样;无人可询问时(例如 dontAsk 模式)须使用 /mcp。项目 .mcp.json 中 MCP 服务器的批准改为按确切名称匹配,以其他拼写写成的批准项会再次询问。此外,worktree 创建会拒绝 .git 目录为链接或含硬链接的检出,Anthropic 建议改用普通 clone。

Anthropic 还表示,Claude Code 自带的 ripgrep 与大多数内部 git 命令现在运行时不带大多数登录令牌与 API 密钥,因此这类 git 命令下的认证辅助程序或 hook 不再能找到它们。另有一项:对后台会话执行 /logout,过去没有效果,现在会登出电脑上的所有会话、删除已保存的 MCP 登录与插件机密,并结束该会话。

升级前可能受影响的设置

下表整理了日志中可能需要调整设置的部分变动。其中“上下文窗口”指模型一次能处理的内容量。

依 Anthropic 更新日志整理的部分变动
项目日志所述变动可能受影响者
未知模型的上下文窗口假设值由 200K 改为 1M;可用 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 保持 200K使用 Claude Code 不认识的模型 ID 的人
其他厂商较小窗口模型窗口填满后可能每回合都失败,直到 /clear使用其他厂商模型的会话
代理服务器组织设置与策略请求不再使用仅由 ALL_PROXY 设置的代理;需设置 HTTPS_PROXY处于代理网络中的团队
自托管 runner被取代工作单的按需 runner 退出码恢复为 1(2.1.321、2.1.322 曾改为 0)依退出码判断结果的自动化流程
子代理状态栏subagentStatusLine 设置已移除,含该键的配置文件仍照常加载自定义状态栏的用户
插件 agent 设置已弃用;仍有效,但会在启动等处警告插件作者

企业与管理端的小幅新增

Anthropic 表示,Claude Tag 在 Slack 启动的会话已纳入 Enterprise 方案的 Compliance API(测试版),管理员可列出会话并读取逐字记录。Code Review 管理设置新增 Download CSV 按钮,可按月、周或日导出单个仓库、单个 GitHub 组织或全部的审查成本。VS Code 扩展则新增信任提示:在未受信任的文件夹首次使用前会先询问,拒绝则该文件夹的设置与 MCP 服务器不会被使用。

常见问题

Code Mode 是默认开启的吗?

不是。据 Anthropic 更新日志,Code Mode 是实验性、需主动选用的功能;组织也可按其文档页面的说明将其关闭。

我的插件会因这次更新无法使用吗?

据 Anthropic 说明,若插件在 plugin.json 中以 engines["claude-code"] 标示版本范围,超出范围的 Claude Code 版本将不会安装、更新或加载该插件。未标示者,日志未提及受影响。

为什么部分与 git 相关的 hook 可能找不到凭据?

Anthropic 表示,Claude Code 自带的 ripgrep 与大多数内部 git 命令现在运行时不带大多数登录令牌与 API 密钥,因此其下的认证辅助程序或 hook 不再能找到它们。

使用其他厂商的模型要注意什么?

Anthropic 表示,不认识的模型 ID 假设窗口改为 1M;若该模型窗口较小,填满后可能每回合失败,需要 /clear。日志建议事先设置 CLAUDE_CODE_DISABLE_1M_CONTEXT=1。

去哪里查看完整的变更内容?

本文只整理了 Anthropic 官方 Claude Code 更新日志中的部分重点,完整清单与细节请以官方更新日志和文档为准。

查看同分类最新消息

觉得这篇整理实用吗?分享给需要的朋友

LINE 分享

资料来源

本文依据上方所列参考来源与标示之核实日期整理;票价、时刻、功能规格或服务条款可能变动,出发、预订或购买前请至相关官方网站确认最新信息。

生活分享