Claude Code v2.1.311 发布：修复启动卡顿与 1M 上下文报错等问题

Claude Code：GitHub Releases· ashwin-ant·2026-10-27 05:51· 58 分钟前AI 评分44

v2.1.311

AI 导读

Claude Code v2.1.311 发布，为自托管 runner 新增 --hold-idle-file 和 --max-hold-min 参数，用于在宿主机报告残留进程时保持空闲会话。

正文 · 原文

变更内容

• 新增 --hold-idle-file 和 --max-hold-min 到 self-hosted-runner，用于在宿主机报告其遗留运行的进程时保持空闲会话
• 新增 Explanatory 输出样式的提示，在你向 Claude 请求解释时显示
• 修复了当 CLAUDE.md 文件包含超长列表项时，启动时以及读取或编辑文件后出现的长时间卡顿
• 修复了当 MCP 服务器未响应资源读取或技能仍在下载时，中断 Claude 直到超时才生效的问题
• 修复了标准上下文会话在请求超过 200K token 时以“Usage credits required for 1M context”停止的问题；Claude Code 现在会压缩对话并继续
• 修复了在文件中修改数千行时，Write 和 Edit 执行后卡顿长达 5 秒并报告更改 0 行的问题
• 修复了子代理无法使用在子代理启动后才完成连接的服务器上的 MCP 工具的问题
• 修复了在会话早期编辑过 MEMORY.md 和 CLAUDE.md 后，自动压缩后 Claude 立即看到过时内容的问题
• 修复了 claude -p 和 SDK 会话保存转录消息顺序错乱或保留已撤回消息的问题
• 修复了 SubagentStop 钩子对每个运行中的子代理每分钟运行约两次，而不是在完成时运行一次的问题
• 修复了 @ 文件选择器忽略重新包含 git 忽略文件的 .ignore/.rgignore 否定规则的问题
• 修复了子代理的隔离工作树在其启动的后台子代理仍在使用时被移除的问题
• 修复了自动模式下等待自身 shell 的后台代理在每次唤醒时启动新的主对话轮次的问题
• 修复了 Bash 工具描述声称工作目录在调用之间始终保留的问题
• 修复了环境块命名了命令实际不运行的 shell 的问题，例如 Bash 工具使用 zsh 时却命名为 fish
• 修复了在仓库根目录下运行时，claude mcp add、claude mcp remove 和 /mcp 命名当前文件夹而非 ~/.claude.json 中持有本地作用域服务器的项目条目
• 修复了 claude mcp list 和 claude mcp get 在连接失败行（例如 ENOENT: ENOENT: …）上重复显示错误代码的问题
• 修复了当网络代理阻止启动请求时，Remote Control 会话停留在“Connecting”约两分钟的问题
• 修复了 Claude 发送到云会话或 Remote Control 会话的消息在 Claude 移动应用中显示为你自己的消息的问题
• 修复了当通过 Remote Control 或发送到云会话的消息所附文件因磁盘已满而无法保存时，Claude 未被告知原因，或消息中超过前 20 个的附件被遗漏的问题
• 修复了 Cowork 云会话中 WebFetch 和 WebSearch 因响应停滞而挂起的问题；未完成的请求现在会在 300 秒后失败
• 修复了在轮次之间崩溃的后台会话在已附加、固定或设置了计划任务或唤醒时未被重启的问题
• 修复了“background service did not respond”错误建议使用已禁用的 claude daemon restart 的问题；现在建议使用 claude daemon stop --any 并说明它会结束后台会话
• 修复了 claude respawn <id> 在报告没有后台会话匹配该 id 之前就启动后台服务的问题
• 修复了当计划模型与会话模型不同时，/effort 在计划模式下未警告提示缓存未命中的问题
• 修复了 /ide 在安装完成前或安装失败时声称 VS Code 扩展已安装的问题
• 修复了 Write 工具的文件预览在行宽超过终端时跳过行并错误统计隐藏行的问题
• 修复了在 agent 的聊天标签页中按 ↑ 会召回仍在等待投递的消息，导致重新发送时发出第二份副本的问题
• 修复了当插件或你的设置指定了 agent 时，Cowork 云会话在重启后丢失连接器和大部分工具的问题；Cowork 云会话现在会忽略该设置
• 修复了 agent teams 会话在通过 --resume、--continue、/resume 或 --session-id 返回时（包括在 /clear 或崩溃之后）显示空任务列表的问题，以及 /branch 写入原始会话列表的问题
• 修复了粘贴提及图片文件（例如 ! open /tmp/shot.png 或 /review look at /tmp/shot.png）的文本时会附加该图片并从提示中丢弃其路径的问题
• 修复了反馈草稿卡片在提示中已有文本时仍显示其 1/2/0 和 Esc 快捷键的问题，此时这些按键作用于提示而非卡片
• 修复了引号或括号中的单个反斜杠（例如 "\" 或 (\)）从 Claude 的回复中消失的问题
• 修复了设置 DISABLE_COMPACT 时 agent 队友压缩其历史记录的问题
• 修复了设置 DISABLE_COMPACT 时回退菜单仍提供“Summarize from here”和“Summarize up to here”的问题
• 修复了已完成的 /code-review 或其他在子 agent 中运行的技能在云会话或后台会话重启时再次运行的问题
• 修复了在 Google Vertex AI、Microsoft Foundry 和 AWS 上的 Claude Platform 上，长时间隐藏思考因端点发送思考进度更新而被误判为空闲截断的问题
• 修复了 /ide 在未安装任何内容时声称已安装 JetBrains 插件的问题
• 修复了 Claude Pro 和 Max 订阅者在订阅无法使用时被要求联系管理员的问题；现在该消息会指向账单设置
• 修复了在宽屏全屏终端中编辑后 diff 窗格在无内容可显示时自行打开的问题
• 修复了在“Clear authentication”后 /mcp 将无需登录即可工作的远程服务器显示为失败的问题
• 修复了 /mcp 对 Claude Code 未发送任何凭据的远程服务器显示“authenticated”的问题
• 修复了当空的 .mcp.json 位于顶部时，--plugin-dir 插件文件夹被加载为单个插件的问题
• 修复了 /usage 在“What's contributing to your limits usage?”下从不显示大型提示缓存未命中的问题
• 修复了从支持链接的终端打开后台会话后，状态栏链接仍为纯文本的问题
• 修复了 /rewind 确认提示在后续消息从对话中移除时称对话“will be forked”的问题
• 修复了 /rewind 警告错误地称手动编辑和 Bash 编辑从不受代码恢复影响的问题
• 修复了屏幕阅读器模式下计划批准会发送你已用 Escape 关闭的反馈的问题
• 修复了 Claude Code 重试 API 标记为不可重试的请求的问题，这可能会使一轮对话挂起数分钟，或在无人值守重试模式（CLAUDE_CODE_RETRY_WATCHDOG）下无限期挂起
• Linux：修复了当 --plugin-dir 文件夹同时也是添加的目录且 permissions.blockReadsOutsideWorkingDirectories 开启时，沙箱 Bash 命令因 bwrap: Can't create file 而失败的问题
• 自托管 runner：修复了当速率限制（HTTP 429，或 git 包装器以 75 退出）阻止添加的只读仓库时会话无法启动的问题；现在会在没有该仓库的情况下启动
• 通过在上次检查后一小时内启动时跳过两个网络请求，改进了 Pro 和 Max 账户的启动时间
• 改进了 /teleport 和 claude --teleport，在压缩过的云会话从其上次压缩处加载时发出警告，以便其摘要的消息不在本地副本中
• 改进了后台会话进程退出时显示的消息：它们不再承诺不会到来的重启，并说明如何恢复该会话
• 改进了多视图的 artifacts：Claude 现在会根据链接的 #name 路由每个视图，并且不再说切换视图时地址栏保持不变
• 改进了达到超时的 shell 命令：结果现在会显示到目前为止的输出，并说明该命令仍在后台运行
• 改进了压缩：当模型的回复中没有摘要时，Claude Code 现在通常会在替换对话之前再请求一次摘要
• 改进了 Artifact 工具在页面和文档之间的选择：讲解类以及视觉或交互类工作会变成 artifact 页面；文档则用于人们会持续编辑或传阅的写作
• 改进了仅以选项及其值为参数的启动的启动时间，例如 claude --model opus
• 改进了“连接断开”API 错误：现在会说明首先应检查哪里（正在使用的代理或网关，否则是 VPN 或防火墙；仅限 Anthropic API，Bedrock、Vertex 和 Foundry 保持不变）
• 改进了屏幕阅读器模式：在 /permissions 中删除规则时会立即显示“Deleted allow rule …”
• 改进了粘贴的登录码被拒绝时显示的消息：现在会说明该代码可能已过期或已被使用，并提示重新登录
• 改进了 Slack 连接器发送：Claude 现在会在向你未指定的频道发送消息之前，检查该频道的主题以了解发布规则
• 改进了屏幕阅读器模式：Claude 的问题会以“Questions: Color (answered), Pages”的形式列出，不带箭头或符号
• 将交互式终端中的 ultrathink 改为通过 Anthropic 的 API 在 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.1 上以 xhigh 努力程度运行其回合；在 Claude 工作时输入，会提高该回合剩余部分的努力程度
• 将 ultrathink 彩虹效果改为仅在该关键字能够提高努力程度时出现，并且当该词被引用或属于文件路径的一部分时不出现
• 将 agent 视图中的 Ctrl+D 改为与提示符一致：在空输入上按两次即可退出
• 将 --output-format json 和 stream-json 的输出改为将字符串内的 DEL、C1 控制字符和 Unicode 格式字符写为 \uXXXX 转义；解析后的值不变
• 将模型名称和 ID 改为在该后缀无效的模型上去掉 [1m] 后缀及其标签；该后缀仍会被接受
• 将关于设置文件中权限规则的启动警告改为每位用户显示一次，直到该规则发生变化
• 将 /code-review 改为告诉 Claude 把努力程度放在首位，并且仅在要求时使用 max
• 将设置文件中以及某个 mod 的 $.env.set 中的 DISABLE_COMPACT 改为只能关闭压缩，不能重新开启
• 将 Bedrock、Mantle、Vertex 和 Foundry 上的 Claude Code 改为从 downloads.claude.ai 上的签名文件加载模型设置；设置 CLAUDE_CODE_MODEL_CATALOG=off 可关闭此功能
• 将关闭功能标志获取并设置 CLAUDE_CODE_SYNC_SKILLS 的会话改为复用本机另一个会话最多 10 分钟前获取的 claude.ai 技能列表
• 将全屏列表中点击滚动条箭头和滚动条的行为改为在松开鼠标按钮时生效，因此在松开前移出滚动条会取消该点击
• 将 claude purge 改为说明它仅删除此计算机上的数据，而不删除 Anthropic 存储的任何内容
• [VSCode] 为 Claude 回复中的代码块添加了语法着色，适用于浅色、深色和高对比度深色主题
• [VSCode] 为缓慢的 UserPromptSubmit 钩子添加了“Running UserPromptSubmit hooks”加载状态和屏幕阅读器播报
• [VSCode] 修复了从 VS Code 或 JetBrains 面板发送的自定义技能和自定义斜杠命令遗漏普通消息所包含的打开文件或选中行的问题（#102799）
• [VSCode] 修复了在 macOS 和 Linux 上，登录 shell 运行其启动文件以读取 PATH 时扩展宿主卡死的问题
• [VSCode] 修复了点击工具结果中的图片或关闭其预览时，也会在编辑器标签页中打开该结果的文本的问题
• [VSCode] 修复了使用发送按钮发送消息后语音听写仍在继续录制的问题；现在发送会先停止听写，与按 Enter 键的行为一致
• [VSCode] 更改了扩展，使其在 VS Code 遥测设置关闭时以 DISABLE_TELEMETRY 启动 Claude Code 会话，从而不发送使用指标或错误报告，也不获取功能标志
• [VSCode] 更改了会话列表侧边栏，使其在首次打开 Web 标签页时加载 Web 会话，而不是在启动时加载
• [Cloud sessions] 修复了在 Anthropic 托管环境中的例程在其所有者离开组织并重新加入后仍保持锁定的问题；所有者现在可以重新启用它们
• [Cloud sessions] 修复了当编辑对话框已关闭时，例程 API 令牌删除或重新生成失败却不显示任何内容的问题；现在会显示错误提示
• [Cloud sessions] 修复了云环境对话框（包括管理员对话框）接受重复名称的问题；现在会拒绝其他已列出环境已使用的名称
• [Claude Tag] 在 Claude Tag 分析中新增了 Skills 视图，显示 Claude 在 Slack 频道中运行每个已附加技能的频率以及哪些未被使用，并在管理员设置中提供 Usage 链接
• [Claude Tag] 改进了在新会话中运行的 Claude Tag 例程：没有内容可报告的运行现在可以结束，而无需向频道发送一条无用的消息
• [Claude Tag] 更改了 Claude Tag 管理员设置，对于你自己的 Slack 账户可见的私有 Slack 频道，显示锁图标而不是 #
• [Code Review] 改进了 Code Review 的检查运行，当模型在自动重试时仍无法分析更改时，会说明不会启动进一步的自动审查
• [Code Review] 改进了 Code Review 的可靠性：因临时服务器故障导致会话启动失败的审查现在会自动重试一次，其检查运行会说明这一点

来源：Claude Code：GitHub Releases · github.com