Claude Code 专区效率辅助代码辅助技术文档Bug排查技术复盘
Claude Code 版本 2.1.317:新增成本报告与 MCP 断连修复
原标题:v2.1.317
变更内容
- 新增了一项警告,当新的云端计划任务获得你未要求的连接器时,在
/schedule中显示该警告并说明如何移除它们 - 新增了一项检查,在 Web 或 shell 工具调用将你的账户电子邮件地址发送到网络之前会先询问
- 为 Agent SDK 钩子回调新增了
onFailure: "block",因此失败的回调会阻止该操作,而不是让它继续运行 - 在 Claude 桌面版的 Code 选项卡中新增了一项通知,当你所在组织的远程托管设置尚未为该会话加载时会显示;加载完成后还会再显示一条通知
- 新增了一项通知,当自动模式的检查对某个子代理的工具调用没有答案时会显示,此前这种情况会在主视图中不留下任何内容
- 向 OTel 指标、事件和跨度中新增了
anthropic.plan、anthropic.seat_type、anthropic.provider和anthropic.custom_base_url - 向 Claude 应用网关管理 API
GET /v1/organizations/analytics/cost新增了费用报告,可按日期范围读取过去的总支出、按开发者、按天或按 IdP 组查看 - 新增了每日记录,记录在设置了
admin:的 Claude 应用网关上每位开发者的 IdP 组,保留admin.identity_retention_days,费用报告按此分组 - 新增了
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID:在自托管运行器上将其设为1,可让会话内的claude -p使用该会话的 ID 和转录记录,与早期版本中的行为一致 - 修复了项目级和本地 MCP 服务器在某些 Claude 桌面会话中于第一轮后断开连接的问题
- 修复了当设置为基准 URL 的 LLM 网关对其服务端安全检查返回 403 或 422 时,自动模式在每一轮都失败的问题(带有 apiKeyHelper 的 403 不受影响)
- 修复了
claude auth status在缓慢的令牌刷新保存之前就退出的问题,这可能导致你在下次运行时被登出 - 修复了项目的
effortLevel设置被应用提前启动、随后在项目中打开的会话忽略的问题,例如桌面应用 Code 选项卡中的新会话 - 修复了在会话很多的项中,当所链接的会话早于第一页时,
claude --from-pr报告“No conversations found”的问题 - 修复了两个同时出现的权限提示中第二个在 claude.ai 和移动应用上不显示文件路径或命令的问题
- 修复了 Remote Control 和 SDK 主机在模组的工具调用上提供“don't ask again”选项的问题
- 修复了云端和 SDK 会话中,在标题生成期间收到新消息或 Stop 时会话标题丢失的问题
- 修复了当 Claude 在其请求中省略某个字段时,自定节奏的
/loop唤醒有时未被安排的问题 - 修复了云端会话中的自动模式在 Artifact 工具通过 outputs 文件夹上传、写入数据库或保存文件时停下来等待批准的问题
- 修复了从 claude.ai 同步的技能在无法写入磁盘时每十分钟丢失或被重新下载的问题
- 修复了
/schedule在创建或更新云端计划任务后,未在其结果中包含该任务的下次运行时间和链接的问题 - 修复了屏幕阅读器模式下,屏幕阅读器在每次变化时朗读正在运行的子代理的已用时间和令牌数的问题
- 修复了区域或网络封锁(HTTP 403)被显示为登录失败的问题;该错误现在会说明封锁原因
- 修复了当同步的插件包含同一服务器时,Claude 在云端会话中称正常工作的 claude.ai 连接器需要授权或已失败的问题
- 修复了磁盘已满或配额不足导致转录或 ~/.claude.json 写入丢失时,
claude -p以 0 退出的问题;现在它会打印错误,并且在文本和 json 输出中以 1 退出。完整的 NFS 导出可能会缺失 - 修复了启动后第一秒左右对设置文件所做的编辑在再次更改设置文件之前不生效的问题
- 修复了在某些运行会跳过清理的机器上旧转录未被清理的问题,例如使用
--setting-sources的运行 - 修复了已删除的代理团队收件箱被队友的延迟消息重新创建的问题
- 修复了重新创建的代理队友被先前的关闭批准从团队中移除的问题
- 修复了在计划任务被关闭后无法列出或删除已存储的计划任务的问题
- 修复了 Claude 在被要求删除
/team-onboarding指南但未指明哪一个时,删除了你最近更新的指南的问题 - 修复了 Claude 在服务器拒绝删除时仍称
/team-onboarding指南已被删除的问题 - 修复了 Claude 应用网关隐藏 Amazon Bedrock 的“Input is too long.”错误的问题,这会导致会话每一轮都以“upstream rejected the request”失败,而不是进行压缩
- 修复了自托管运行器会话在计划等待批准期间重启时会丢失最近几轮或整个对话的问题
- 修复了在 CLAUDE.md 非常大且自上次发送后发生变化的会话中,自动压缩后出现“Prompt is too long”的问题
- 修复了注册了许多命令的插件在无头会话中内存占用高和启动缓慢的问题
- 修复了 stdio MCP 服务器在其 env 配置将该变量设为空时收到空
AWS_BEARER_TOKEN_BEDROCK的问题;现在该变量会被取消设置,因此服务器可以使用机器自身的 AWS 凭证 - 修复了根证书续期后,在某些 TLS-inspecting 代理后面 API 请求因“unable to get local issuer certificate”而失败的问题
- 修复了超长对话在压缩必须缩短其自身请求时丢失先前摘要的问题
- 修复了 PDF 自身的元数据可能导致 Read 和 @ 提及低估其页数的问题
- 修复了
DISABLE_PROMPT_CACHING_OPUS和DISABLE_PROMPT_CACHING_SONNET对默认模型的[1m]、其他区域和未标日期拼写不起作用的问题 - 修复了当你拥有 200 个或更多自己的共享工件时,
/artifacts和 Artifact 工具的共享列表不显示任何共享工件的问题 - 修复了 Claude 在搜索达到时间限制时将部分 Grep 和 Glob 结果视为完整的问题
- 修复了通过代理向
https://端点进行的 OpenTelemetry 导出在另一次导出仍在进行时开始就永远不会被发送的问题 - 修复了在代理封锁(HTTP 403) OpenTelemetry 向
http://端点导出时出现大量连接尝试的问题 - 修复了 OpenTelemetry 导出在从不响应的代理后面无限挂起的问题;现在它们会在 10 seconds 后超时,或进行最长 30 seconds 的
OTEL_EXPORTER_OTLP_TIMEOUT - 修复了恢复的会话再次向 Claude 告知它已经知道的文件更改的问题
- 修复了 Claude 在恢复的会话中,由于之前的调用因工具被关闭而失败,有时不再使用内置工具的问题
- 修复了
/remote-control回答“Unknown command”而不是说明 Remote Control 已被disableRemoteControl设置关闭的问题 - 修复了 tmux 或 iTerm2 窗格中的代理团队队友在主会话处于手动模式时以自动模式启动的问题
- 修复了后台会话在升级或退役时有时丢失刚刚做出的权限模式更改的问题
- 修复了在提示符处按下 Ctrl+C 清除已输入文本时,停止所有正在运行的后台代理的问题
- 修复了 /feedback 在报告正在发送时显示“Enter to confirm”的问题
- 修复了已停止的 shell 命令的子进程有时被两次发送 SIGTERM 的问题,这可能导致某些程序跳过其清理
- 修复了在云端或自托管运行器会话中运行
claude -p时共享该会话的 ID 的问题:它会写入会话的转录,重启后可能恢复错误的对话 - 修复了在云端或自托管运行器会话中运行
claude -p时生成自己的标题并将其发送给该会话的问题 - 改进了在 Microsoft Foundry 上无法加载 Azure 凭证时显示的错误:现在它会提示检查或刷新凭证,并报告为
cloud_credential_error - 改进了
/design-sync,当你的设计系统已迁移到 Claude 时会提前说明,并在开始构建前停止,而不是在上传时失败 - 改进了必需 Claude 应用网关无法访问时的启动错误:它指向网络问题而非登录问题,并会在无法验证网关的 TLS 证书时予以说明
- 改进了退出时显示的“Resume this session with”提示,使其重复你启动时使用的标志(例如
--chrome --debug) 位于--resume之前 - 改进了自托管运行器从服务器错误中恢复的方式:在遇到 501 或 529 以外的 5xx 后,运行器的下一次轮询现在会打开新连接,而不是重用失败的那个连接
- 改进了自托管运行器会话从服务器错误中恢复的方式:在遇到 501 或 529 以外的 5xx 后,会话现在会打开新连接,而不是重用失败的那个连接
- 改进了自托管运行器会话在连接停止响应时的恢复方式:心跳得不到响应后,会话现在会打开新连接,而不是逐个尝试每个空闲连接
- 更改了 SendMessage,使发送给正在运行的后台代理的消息能更早到达:其正在运行的命令会移到后台,而不会被停止
- 更改了使用与主对话不同模型的子代理和队友,使其使用该模型已保存的努力级别或其默认值,而不是会话的努力级别
- 更改了退出行为,对插件监视器跳过“Background work is running”提示
- 更改了内置
plugin-authoring技能,在你构建的模组可用后一次性提供帮助分享该模组的选项 - 移除了 Read 工具的“file unchanged since your last Read”存根:再次读取未更改的文件会返回其内容
- Windows:修复了在某些原生路径查找失败的卷上每次工具调用都被拒绝的问题;工作目录检查现在改为比较文件夹的标识
- Windows:修复了在非由 Claude 桌面版启动的会话中,会话暂存区和其他临时路径随项目路径长度增长的问题,这会使克隆到其中的仓库触及 260-character 路径限制
- 网关:修复了在开发者所在组的共享预算用尽后,状态行和
/usage将开发者自己的支出限额显示为已使用 100% 的问题 - 自托管运行器:修复了当会话迁移到新运行器且该轮早于
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS时,Claude 看不到被中断的工具调用的问题 - 自托管运行器:修复了在会话服务拒绝保存切换时,已关闭的 MCP 服务器在会话迁移到新机器后重新开启的问题
- Remote Control:改进了应用未设置时的分支名称:长名称会保留其“(fork)”结尾,而在使用
claude remote-control启动的会话中,“Name (fork)”的分支名为“Name (fork 2)” - [VSCode] 修复了分支对话丢失消息的问题:并行运行的 Claude 工具调用中只保留了一个,压缩保留的最后几条消息丢失,这可能导致 Claude 的回答缺少它所回答的问题
- [VSCode] 修复了当 Claude 未能及时完成启动时消息丢失的问题:扩展现在会在显示错误之前再启动一次 Claude
- [VSCode] 修复了当请求因其区域或网络被阻止时登录屏幕打开的问题
- [VSCode] 修复了账户面板显示计划名称时第二个单词被小写的问题
- [VSCode] 修复了 Claude 选项卡中的文件链接在聊天上方打开而不是在其他编辑器组中打开的问题
- [VSCode] 修复了当
chat.fontSize调高时,Claude 面板中的附件标签、菜单、横幅和对话框仍保持小尺寸的问题 - [VSCode] 修复了在遥测关闭时
ultrathink不提高其轮次的努力级别或不显示其彩虹效果的问题 - [Cloud sessions] 为云端会话新增了链接卡片,因此你可以打开或拒绝 MCP 服务器要求你访问的链接,而不是让该请求无人处理
- [Cloud sessions] 将管理设置中的组织环境对话框改为个人对话框的简短布局:每个部分从一行打开,未保存的输入在关闭前会询问
- [Cloud sessions] 修复了为已有网络密钥的主机添加网络密钥时会静默替换它的问题;“Add secret”表单现在会拒绝并指向现有密钥
- [Cloud sessions] 修复了新计划任务忽略你组织默认环境的问题:表单现在会以管理员选择的那个为初始值,而不是 Anthropic 托管的默认环境
- [Remote Control] 修复了在你重启
claude remote-control后,如果你在上一条消息后一分钟内发送,发给空闲会话的下一条消息得不到回应的问题 - [Claude Tag] 更改了新粘贴到 Slack 中的工件链接,改为显示更简单的卡片,带有 Open 按钮,可在 Claude 中打开工件,而不是 Slack 的侧边面板
这条更新,对你有用吗
分享你的判断
正在确认评价状态
评论
仅支持文字,审核通过后展示。0/4000 字符
正在读取评论…