Claude Code v2.1.302 发布
v2.1.302
Claude Code 发布 v2.1.302,新增 CLAUDE_CODE_AUTO_MODE_MODEL 环境变量以选择客户端自动模式分类器所用模型,并在 /config 中加入 Idle compaction 开关。该版本还修复了压缩对话时停止回合报“Prompt is too long”、中途切换 Vertex 或 Bedrock 后请求失败、Read 工具将超过 128 MB 的图片源整体载入内存等问题,并改进多插件启动速度与自动模式服务端分类器处理。
正文 · AI 翻译
## 变更内容
- 新增 `CLAUDE_CODE_AUTO_MODE_MODEL`,用于选择客户端自动模式分类器所使用的模型;它不会改变服务端自动模式所使用的模型 - 在 `/config` 中新增 `Idle compaction` 一行,用于关闭或重新开启空闲压缩;空闲压缩后显示的提示现在会说明如何关闭该功能 - 在 `/design-sync` 和 `/design-login` 中新增提示:独立版 Claude Design(claude.ai/design)将于 2026 年 12 月 14 日关闭 - 修复了在对话正在压缩时停止回合会报“Prompt is too long”错误的问题 - 修复了在会话中途切换到 Vertex 或 Bedrock 后,请求失败并报“diagnostics: Extra inputs are not permitted”的问题 - 修复了 Read 工具会将任意大小的图片文件,或名称类似图片的管道或设备,整体加载到内存中的问题; 现在会拒绝超过 128 MB 的图片源 - 修复了当网关为 Opus 4 或 4.1 加上前缀(例如 `anthropic/claude-opus-4-1`)时,`/autocompact` 和 `/effort` 保存到错误模型的问题 - 修复了会话中途添加的工具通过 ToolSearch 再次加载或压缩后重新加载时,提示缓存未命中的问题 - 修复了 `claude plugin` 及其他子命令有时会在排队的设置或配置写入完成前退出,从而可能丢失更改或留下 `.tmp` 文件的问题 - 修复了当 git 默认使用 reftable 引用格式时,插件市场每次刷新都会重新克隆,以及新安装的 git 插件显示版本为“unknown”的问题 - 修复了 PowerShell 工具无法在插件的 `bin/` 文件夹中找到命令的问题,以及当搜索无结果(rg、grep、findstr、 git grep)被管道传入 `Select-Object` 或其他格式化 cmdlet 时会报错的问题 - 修复了桌面应用中的 Claude 在无法使用相应选项时,仍引导你前往 claude.ai 设置或 `/mcp` 来授权或重新连接 MCP 服务器的问题 - 修复了当 Claude 发送空的编辑列表时,产物发布有时会失败的问题,以及当产物较新版本拒绝更新后,Claude 以错误方式重试产物更新的问题 - 修复了大多数自动模式分类器拦截时,OpenTelemetry `tool_decision` 事件中缺少 `classifier_category` 的问题,以及当 `OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT` 较低时,新的 `tool_decision` 属性会挤掉 `tool_use_id`、 `tool_source` 和 `tool_parameters` 的问题 - 修复了在代理视图中向下滚动长列表或折叠某个分区后,行内容保持空白的问题 - 修复了未登录时 `claude remote-control --help` 不打印用法说明就退出的问题 - 修复了在云会话中(该功能不可用)`/design consent` 和 `/design revoke` 失败时建议使用 `/design-login` 的问题;现在该消息会指向 claude.ai/design/settings - 修复了当服务器协商协议版本 2026-07-28 但省略 `resultType`、`ttlMs` 或 `cacheScope` 时,MCP 服务器显示没有工具或所有工具调用都失败的问题 - 修复了提示建议在仅通过额度付费的模型上消耗使用额度的问题:在回复按额度计费后,现在会跳过这些提示建议 - 修复了用反引号书写的 URL 在换行时只有第一行可点击的问题; 在支持超链接的终端中,整个 URL 现在是一个链接 - 修复了 `claude plugin details @builtin` 在找不到插件时建议使用 `claude plugin list` 的问题,因为该命令从不显示内置插件;现在它会指向 `/plugin` - 修复了链接起始处的 emoji 导致换行时多出一列宽度的问题,该问题会在问题预览中隐藏链接,并把表格变成列表 - 修复了在 git 2.56 或更高版本下,当游离的 `.git` 文件指向不存在的目录时,工作树隔离拒绝创建或恢复工作树的问题 - 修复了云会话在新进程中恢复后,成本和用量从零重新开始的问题 - 自托管运行器:修复了在复用存储为 git reftable 格式的检出目录的会话中,git fetch 失败并报“bad object refs/heads”的问题 - Windows:修复了在 exFAT 或 FAT32 驱动器上的项目中,每次文件写入都被拒绝或询问的问题, 包括使用 `--plugin-dir` 启动的会话 - 改进了启用大量插件时的启动时间:插件命令和代理文件加载所需的文件系统调用现在少得多,在 Windows 上尤为明显 - 改进了带服务端分类器的自动模式:对于安全检查来说过长的对话现在会被压缩,而不是每次受检查的工具调用都被拒绝 - 改进了从其他文件夹重新打开的后台会话没有 LLM 网关时的提示消息:现在会说明原因,而不是显示“Not logged in” - 更改了 `claude -p` 和 Agent SDK 会话:在第三方提供商上、遥测关闭或全新安装时,没有权限模式的会话现在以 `default` 模式启动;`--permission-mode auto` 仍保持自动模式 - 更改了 fork 子代理(`subagent_type: "fork"`):在 `claude -p`、Agent SDK、桌面应用和 VS Code 中现在默认开启,与终端中已有的行为一致; `CLAUDE_CODE_FORK_SUBAGENT=0` 可将其关闭,而 `claude mcp serve` 从不提供它们 - 更改了桌面应用和 VS Code:现在始终像终端一样在后台运行主对话的子代理,而不是让 Claude 自行选择;在 `claude -p`、Agent SDK、桌面应用和 VS Code 中,子代理自身的 Agent 调用现在默认在前台运行 - 更改了 `← for agents` 页脚提示:会话打开 10 秒后隐藏;等待你处理的代理数量仍会显示 - 更改了 Claude in Chrome 说明在系统提示中的位置,以便新对话可以从共享提示缓存中读取它们 - 更改了提示和代理钩子:同一事件最多同时运行 12 个; 其余排队等待 - 更改了组织策略关闭 `/feedback` 时显示的消息:现在指向 GitHub issues,而不是组织管理员 - [VSCode] 修复了列表中未闭合代码块之后的文本在回复流式传输时显示为纯文本、随后又变成代码的问题 - [VSCode] 修复了当服务器 URL 包含查询字符串时,从面板登录 MCP 服务器会打开损坏的授权页面的问题 - [VSCode] 修复了在无法访问装有 Claude 扩展的浏览器时,`@browser` 横幅却显示“Browser connected”的问题 - [云会话] 在例程页面上新增了横幅,说明其上次运行为何没有启动,例如你的组织达到了并发云会话的上限 - [云会话] 修复了云会话中“Rewind to here”除最新消息外对每条消息都失败的问题; 自托管运行器需要 Claude Code v2.1.246 或更高版本 - [云会话] 修复了云会话中的拉取请求状态栏问题:当 GitHub 重新检查存在合并冲突的拉取请求时,状态栏会将其错误地切回就绪状态 - [云会话] 修复了例行运行在云会话意外停止后显示为“已完成”,以及在开始前被归档时显示为“已取消”而非失败的问题 - [云会话] 修复了云会话中的差异视图在会话的 GitHub 仓库被重命名或移动后丢失更改或无法加载的问题 - [云会话] 修复了计划例行运行中途失败后,在一小时或更久之后从头再次运行的问题, 这可能会重复执行工作,例如将同一份报告发布两次 - [云会话] 修复了打开的云会话有时不显示从另一台设备发送的消息,直到你重新加载页面或点击离开再返回的问题 - [云会话] 改进了云会话启动失败时显示的错误:现在会显示“连接丢失”或“服务器错误”,而不是“出了点问题” - [远程控制] 修复了在你的计算机离线后,远程控制会话中子代理窗格无限旋转的问题;现在会显示远程控制已断开 - [Claude 标签] 修复了在 Slack 频道或私信中,Claude 通过编辑其较早的一条消息来回复提及后,“正在思考……”仍持续显示的问题 - [Claude 标签] 修复了 Claude 的 Slack 回复中,编号或项目符号步骤下代码块中的 URL 被尖括号包裹,导致复制的命令无法使用的问题 - [Claude 标签] 修复了在 Slack 中附加的 HEIC、SVG、 TIFF 和 BMP 图像始终无法到达 Claude 的问题;现在它们会像其他文件类型一样,作为文件出现在其工作文件中 - [Claude 标签] 修复了在按角色限制 Claude 标签的组织中,新任频道管理员失去 Slack 中 Claude 访问权限的问题;管理员角色现在也会授予 Slack 中的 Claude 标签权限 - [Claude 标签] 修复了 MCP 服务器共享同一主机的自定义连接器在 Claude 标签管理设置中显示为单个连接器的问题;现在每个服务器都是独立的连接器 - [Claude 标签] 修复了 Slack 中的 Claude 有时在单次 Slack 查询停滞时,用“私信暂时不可用”回复私信并丢弃该消息的问题;现在会先重试 - [Claude 标签] 修复了在 Slack Enterprise Grid 上与 Claude 的私信忽略 Slack 工作区下拉菜单的问题; 现在它们会在你最近打开 Claude 的已连接工作区下运行 - [Claude 标签] 修复了 Slack 中 Claude 关于频道每月支出限额的通知称频道管理员可以提高限额的问题;现在会指明组织所有者并链接到用量页面 - [Claude 标签] 修复了 Claude 的 Slack 回复中的链接会吞掉紧随其后的闭合粗体或斜体标记或全角标点,导致链接和格式损坏的问题 - [Claude 标签] 改进了 Claude 标签管理设置中的仓库搜索,现在可覆盖最多 100 个已连接的 GitHub 账户,并能找到 GitHub App 安装中前 5,000 个之后的私有仓库 - [Claude 标签] 改进了 Claude 标签管理设置中的“添加地点”,可立即列出你输入或粘贴的频道, 而不只是在组织的完整频道列表加载完成后才能使用 - [Claude 标签] 改进了 Claude 标签管理设置中工作区或频道页面上的“添加 > 域名”,使其在该页面加载后即可使用,而不必等到所有频道都加载完成 - [Claude 标签] 更改了 Claude 标签管理设置,将 Claude 的访问权限整理为四个标签页:捆绑包、连接器、技能和插件,以及频道 - [Claude 标签] 更改了组织设置中的“角色”页面,将为 Claude 标签频道管理员创建的角色归入组织自有角色下方的一个折叠区域 - [代码审查] 修复了代码审查设置在离开去连接 GitHub 后无法恢复的问题;返回管理设置后,现在会重新打开仓库选择器