Claude Code 专区效率辅助代码辅助技术文档Bug排查
Claude Code v2.1.311:修复启动卡顿与上下文压缩等问题
原标题:v2.1.311
变更内容
- 在
self-hosted-runner中添加了--hold-idle-file和--max-hold-min,以便在你的主机报告仍有进程在运行时保持空闲会话存活 - 为解释性输出样式添加了一条提示,在你要求 Claude 进行解释时显示
- 修复了当 CLAUDE.md 文件包含超长列表项时,启动时以及读取或编辑文件后出现的长时间卡死
- 修复了当 MCP 服务器未响应资源读取或某个技能仍在下载时,中断 Claude 要等到超时才生效的问题
- 修复了标准上下文会话在请求超出 200K tokens 时以“Usage credits required for 1M context”停止的问题;Claude Code 现在会压缩对话并继续
- 修复了在文件中更改数千行时,Write 和 Edit 执行后最多停顿 5 seconds 并报告更改了 0 行的问题
- 修复了子代理无法使用在子代理启动后才完成连接的服务器所提供的 MCP 工具的问题
- 修复了在会话早期编辑过这些文件后,自动压缩之后 Claude 立即看到过时的 MEMORY.md 和 CLAUDE.md 内容的问题
- 修复了
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 之后的附件被遗漏的问题
- 修复了 WebFetch 和 WebSearch 在 Cowork 云会话中因响应停滞而挂起的问题;未完成的请求现在会在 300 seconds 后失败
- 修复了在轮次之间崩溃的后台会话在仍处于附加、固定状态,或设置了计划任务或唤醒时未被重新启动的问题
- 修复了“background service did not respond”错误建议使用已禁用的
claude daemon restart的问题;现在改为建议claude daemon stop --any,并说明它会结束后台会话 - 修复了
claude respawn <id>在报告没有后台会话匹配该 id 之前就启动后台服务的问题 - 修复了当计划模型与会话模型不同时,
/effort在计划模式下未警告提示缓存未命中的问题 - 修复了
/ide在安装完成前或安装失败时声称 VS Code 扩展已安装的问题 - 修复了 Write 工具的文件预览在行宽超过终端时跳过行并错误计算隐藏行数的问题
- 修复了在代理的聊天标签页中按 ↑ 会召回仍在等待投递的消息、从而重新发送时发出第二份副本的问题
- 修复了当插件或你的设置指定了
agent时,Cowork 云会话在重启后丢失连接器和大多数工具的问题;Cowork 云会话现在会忽略该设置 - 修复了代理团队会话在使用
--resume、--continue、/resume或--session-id恢复时显示空任务列表(包括在/clear或崩溃之后),以及/branch写入原始会话列表的问题 - 修复了粘贴提及图像文件的文本(例如
! open /tmp/shot.png或/review look at /tmp/shot.png)时会附加图像并从提示中删除其路径的问题 - 修复了反馈草稿卡片在提示中已有文本时仍显示其 1/2/0 和 Esc 快捷键的问题,此时这些键作用于提示而不是卡片
- 修复了引号或括号中的单个反斜杠(如
"\"或(\))从 Claude 的回复中消失的问题 - 修复了设置
DISABLE_COMPACT时代理队友压缩其历史记录的问题 - 修复了设置
DISABLE_COMPACT时回退菜单提供“Summarize from here”和“Summarize up to here”的问题 - 修复了已完成的
/code-review或在子代理中运行的其他技能在云会话或后台会话重启时再次运行的问题 - 修复了在 Google Vertex AI、Microsoft Foundry 和 Claude Platform on AWS 上,长时间隐藏思考因端点发送思考进度更新而被误判为空闲截断的问题
- 修复了
/ide在实际未安装任何内容时声称已安装 JetBrains 插件的问题 - 修复了 Claude Pro 和 Max 订阅用户在其订阅无法使用时被要求联系管理员的问题;该消息现在指向账单设置
- 修复了在宽屏全屏终端中编辑后,即使差异窗格没有内容可显示也会自行打开的问题
- 修复了
/mcp在“Clear authentication”后将无需登录即可工作的远程服务器显示为失败的问题 - 修复了
/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失败的问题 - 自托管运行器:修复了当速率限制 (HTTP 429,或退出码为 75) 的 git 包装器阻止添加的只读仓库时,会话无法启动的问题;现在会在不带该仓库的情况下启动
- 通过在上次检查后一小时内启动时跳过两个网络请求,缩短了 Pro 和 Max 账户的启动时间
- 改进了
/teleport和claude --teleport,当已压缩的云会话从其最后一次压缩加载时会发出警告,因为其汇总的消息不在本地副本中 - 改进了后台会话进程退出时显示的消息:不再承诺不会到来的重启,并说明如何恢复该会话
- 改进了具有多个视图的工件:Claude 现在根据链接的
#name路由每个视图,不再声称切换视图时地址栏保持不变 - 改进了达到超时的 shell 命令:结果现在显示到目前为止的输出,并说明该命令仍在后台运行
- 改进了压缩:当模型的回复中没有摘要时,Claude Code 现在通常会在替换对话之前再次请求摘要
- 改进了 Artifact 工具在页面和文档之间的选择:解释性内容以及视觉或交互式工作成为工件页面;文档用于人们会继续编辑或传阅的写作
- 改进了仅以选项及其值作为参数的启动的启动时间,例如
claude --model opus - 改进了“Connection dropped” 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的彩虹效果改为仅在关键词能提高努力程度的地方出现,且在单词被引用或属于文件路径时不出现 - 将代理视图中的 Ctrl+D 改为与提示一致:在空输入时,按两次即退出
- 将
--output-format json和stream-json的输出改为将字符串内的 DEL、C1 控制字符和 Unicode 格式字符写成\uXXXX转义;解析后的值不变 - 更改了模型名称和 IDs,在后缀不起作用的模型上去掉
[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 minutes 前的 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 的遥测设置为关闭时,启动 Claude Code 会话时设置
DISABLE_TELEMETRY,使其不发送使用指标或错误报告,也不获取功能标志 - [VSCode] 将会话列表侧边栏改为在首次打开 Web 标签页时加载 Web 会话,而不是在启动时加载
- [Cloud sessions] 修复了在 Anthropic 托管环境中,例程在其所有者离开组织并重新加入后仍保持锁定状态的问题;所有者现在可以重新开启它们
- [Cloud sessions] 修复了当编辑对话框已关闭时,例程 API 令牌删除或重新生成失败不显示任何内容的问题;现在会显示错误提示
- [Cloud sessions] 修复了云环境对话框(包括管理对话框)接受重复名称的问题;现在会拒绝另一个已列出环境已使用的名称
- [Claude Tag] 为 Claude Tag 分析添加了技能视图,显示 Claude 在 Slack 频道中运行每个已附加技能的频率以及哪些未被使用,并在管理设置中提供使用情况链接
- [Claude Tag] 改进了在新会话中运行的 Claude Tag 例程:没有内容可报告的运行现在可以结束,而无需向频道发送一次性消息
- [Claude Tag] 更改了 Claude Tag 管理设置,对于你自己的 Slack 账户可以看到的私有 Slack 频道,显示锁而不是 #
- [Code Review] 改进了 Code Review 的检查运行,在自动重试时模型仍无法分析变更时说明不会再启动进一步的自动审查
- [Code Review] 改进了 Code Review 的可靠性:因暂时性服务器故障而无法启动会话的审查现在会自动重试一次,并且其检查运行会说明这一点
这条更新,对你有用吗
分享你的判断
正在确认评价状态
评论
仅支持文字,审核通过后展示。0/4000 字符
正在读取评论…