Claude Code v2.1.325 发布：修复 zstd 解码安全问题及多项稳定性缺陷

Claude Code：GitHub Releases· claude-code-publisher[bot]·2026-11-14 04:40· 1 小时前AI 评分40

v2.1.325

AI 导读

Claude Code v2.1.325 修复了 zstd 压缩响应解码中的安全问题，并解决了子智能体模型被错误切换、第三方网关每轮报上下文长度错误、恢复会话丢失近期对话等多处缺陷。该版本还改进了组织策略拦截提示、/security-review 在 bare 仓库 worktree 中的报错，以及 /stats、/insights、/voice 等命令的显示与行为问题。

正文 · 原文

变更内容

• 修复了 zstd 压缩响应解码方式中的安全问题
• 在 VS Code 及类似集成终端中新增了关于重新运行 notebook 单元格的加载提示，在 Claude 读取或编辑 Jupyter notebook 后显示一次
• 在组织策略阻止请求时显示的错误下方新增一行说明如何继续：运行 /rewind 并修改消息，或运行 /clear
• 当沙箱化的 git checkout、git stash 或 autostash pull 无法更新受保护文件（例如 .claude 中的文件）时，为 Claude 新增了提示
• 修复了 /security-review 和技能的内联 git 命令在 bare 仓库的 worktree、--separate-git-dir 检出和 Android repo 检出中报错停止的问题
• 修复了当模型设置为 opusplan 或 haiku 时，拥有自己模型的子智能体被切换到 plan 模式模型的问题
• 修复了使用不同模型的子智能体按主会话模型计算文件读取和 MCP 结果大小的问题
• 修复了许多第三方网关和 Foundry 上的会话在每一轮都报上下文长度错误而不会压缩的问题
• 修复了 Claude Code 未正常退出后，恢复的会话中近期轮次有时丢失的问题
• 修复了工作目录被删除后 shell 命令仍在启动目录中运行的问题；现在命令会报错失败并可重新发出
• 修复了当 plansDirectory 文件夹无法接收已批准的 plan 编辑时该编辑丢失的问题：现在 plan 会保存到默认 plans 文件夹，并给出警告说明保存位置和原因
• 修复了新安装时已保存的 sonnet[1m] 模型设置被改写为 API 拒绝的模型 id 的问题
• 修复了当计划任务在回复后回复时，焦点视图隐藏对你的提示的回复的问题
• 修复了关闭全屏时后台子智能体视图中有时缺少提示的问题
• 修复了列表和权限提示中的长选项在换行时被部分覆盖的问题，以及首次运行界面在窄终端中丢失行的问题
• 修复了关于权限规则的启动警告和“N 个 MCP 服务器需要身份验证”通知在滚动出视图时被记录为已读的问题
• 修复了当智能体名称或工作文件夹包含控制字符或换行符时，欢迎标题显示控制字符或跨行拆分的问题
• 修复了 Claude 尝试执行只有你能运行的命令时显示的红色错误：现在会有一行暗色文字说明该命令仅在你于提示符中输入时运行
• 修复了 /stats 显示的活跃天数总计多一天的问题
• 修复了 /insights 在没有会话符合分析条件时仍称报告已就绪，以及在其 HTML 报告中写入两个未转义值的问题
• 修复了当托管设置、--settings 或项目的 .claude/settings.json 或 .claude/settings.local.json 保持语音模式不变时，/voice 仍称语音模式已更改的问题；现在会说明是什么使其保持不变
• 修复了 IDE 欢迎对话框在 Windows 和 Linux 上为快速启动显示 Cmd+Esc 的问题
• 修复了当组织策略拒绝云会话时仍显示 Slack 应用提示的问题
• 修复了在没有终端可读取按键时 claude purge 静默挂起的问题，以及当 stdin 被管道传输时其项目选择器和 -i 提示忽略键盘的问题
• 修复了 claude plugin eval --output-dir '' 将报告写入当前文件夹的问题；现在会报错退出
• 修复了终端上 claude -p 文本输出传递除文本样式之外的控制序列的问题；管道和文件不受影响
• 修复了配置目录中残留的 .oauth_refresh.lock.owner.tmp.* 文件不断堆积的问题
• 修复了在无密钥的 Console 登录下，/fast 显示“Fast mode has been disabled by your organization”的问题，此时 Claude Code 并未向服务器发起请求
• 修复了在 Claude Code 无法核实的情况下（例如没有网络）/model 声称你的组织限制了某个模型的问题
• 修复了在浏览器步骤后立即按 Esc 时，/login 中的“Sign in with your Console account”替换掉你现有登录的问题
• 修复了在登录失败或取消的某些情况下，浏览器仍显示登录成功页面的问题
• 修复了 claude auth status 及其他短命令在 Console 配置文件上遗留锁、导致下一个会话卡住约一分钟的问题
• 修复了在 claude.ai 登录上启动的后台会话使用（并计费）启动后台服务的 shell 中的 API 密钥或令牌的问题
• 修复了更多会话在后台切换到其他登录方式的情况；此类切换现已被拒绝，并会给出说明哪些方式可用的提示
• 修复了在后台切换被拒绝后，退出对话框中第二次按 Enter 会停止后台工作的问题
• 修复了当 allowedProviders 托管设置不允许时，Amazon Bedrock 上的令牌计数仍将对话发送到 Bedrock 的问题
• 修复了在没有 HOME 环境变量启动 Claude Code 时，AWS credential_process 辅助工具和 Google Cloud 默认凭证失败的问题
• 修复了在子代理的计划获批后，会话有时回退到较早权限模式的问题
• 修复了 Agent SDK applyFlagSettings() 调用中一个无效值会静默丢弃此前所有调用设置的问题；现在会拒绝此类调用并报错
• 修复了当已完成的拉取请求只需你自己审查或合并时，会话却显示为等待输入的问题
• 修复了无法识别的 teammateMode 设置值被忽略且无警告的问题：claude -p、启动警告和 claude doctor 现在会将其列为已跳过条目（仍不应用）
• 修复了在新主目录中首次运行时，--worktree 跳过 CLAUDE_CODE_PLUGIN_SEED_DIR 中来自插件的 WorktreeCreate 钩子的问题
• 修复了简要模式会话（如 Dispatch）在本轮已回复后再次发送回复的问题
• 修复了在云会话中，当插件以不同 URL 列出某个正常工作的 Atlassian、Asana 或 Sentry 连接器时，Claude 却称其失败的问题
• 修复了在文件夹移动或预热启动后，Claude Desktop 和 SDK 会话将文件夹自身的 MCP 服务器（.mcp.json，本地）列为宿主添加或完全不列出，且不连接 WebSocket 服务器的问题
• 修复了插件重载在连接过程中移除某插件的 MCP 服务器后，/mcp 仍列出该服务器的问题
• 修复了在仅短暂被拒的令牌刷新后，MCP 服务器一直处于“needs authentication”状态、其 mcp_tool 钩子被跳过的问题
• 修复了在工具调用期间服务器连接被替换后，无头模式下 MCP 引导请求未经询问即被取消的问题
• 修复了在工具调用重新连接 MCP 服务器后，来自 SDK 宿主的 MCP 工具调用返回“Not connected”的问题
• 修复了 MCP 任务在其问题被 Esc 关闭或再次询问后卡住的问题：页脚现在会提示需要你的输入，在 /tasks 中按 Enter 会再次显示该问题
• 修复了在另一次对同一服务器的调用丢失连接后，后台 MCP 任务停止更新的问题（当后续调用重新连接时）
• 修复了后台 MCP 任务的问题在你仍在输入消息时弹出覆盖的问题；现在它会等到你发送或清空草稿，且加载指示器和轮次计时器会继续运行
• 修复了在较旧 git 版本（如 2.34）上，worktree.sparsePaths 以及稀疏插件和 marketplace 克隆遗漏仓库根文件的问题
• 修复了自托管运行器会话中，当会话进行中添加了某个仓库时，多个仓库无法使用该仓库的问题
• 修复了 Claude 在读取你自己的 artifact 或其数据之前请求权限的问题
• 修复了 Artifact 工具的拒绝与询问权限规则以及钩子在部分云会话中不生效的问题
• 修复了 Code Mode 脚本忽略通过 EnterWorktree 进入的 worktree、将 ~ 路径写入项目，以及在 MCP 服务器登录过期后仍让 /mcp 显示其已连接的问题
• 修复了在权限对话框或计划批准中通过 Yes 输入的词语在 Code Mode 中无法传达给 Claude 的问题
• 修复了当你恢复一个在 Code Mode 脚本执行期间结束的会话时 Claude 自行开始工作的问题；现在它会等待你的下一条提示
• 修复了工具调用运行期间发送的消息缺少 OpenTelemetry user_prompt 事件的问题。该事件现在包含 delivery.mode: "mid_turn" 以及正在运行的轮次的 prompt.id
• 修复了在 VS Code 中排队消息合并为一个轮次时，或某条消息带有图片时，OpenTelemetry user_prompt 事件遗漏较早消息文本的问题
• 修复了斜杠命令的 allowed-tools 授权会应用于在其轮次期间或之后被唤醒的后台代理的问题
• 修复了 /feedback 和 /bug 仅在上传的其他会话由已登录的账户或组织记录时才上传的问题
• 修复了相对拒绝与询问权限规则（例如 Read(./.env)）在 cd 之后不再覆盖项目的问题；它们现在也适用于添加的目录
• 修复了以 mcp__plugin_*_ 开头的拒绝与询问权限规则遗漏插件 MCP 服务器或大小写不同的工具的问题
• 修复了在自托管运行器和 claude remote-control 会话中，Claude Code 重启后到达的权限批准未应用拒绝规则的问题
• 修复了在仓库的某些子文件夹中启动 Claude Code 时，已提交的 .claude/settings.local.json 可能被视为用户自己的文件的问题
• 修复了部分拒绝与询问规则不适用于某些 Bash 命令的问题
• 修复了 Bash 权限检查中的一个缺口，某些复合命令可能未经询问就运行；现在这些命令会请求权限
• 修复了 Bash 允许规则可能运行与其指定程序不同的程序的问题
• 修复了云会话中连接器工具的批准提示在插件仍在加载时被自动应答的问题
• 修复了在设置了允许规则或此前已批准上传时，某些子代理未经询问就更改组织外部人员可见的 artifact 或向其上传文件的问题
• 修复了当 Artifact 已选择“不再询问”时，某些 artifact 发布跳过对组织外部人员可见页面的确认的问题
• 修复了自动模式仅判断对组织外部人员可见的 artifact 的第一次更改的问题；其 yes 现在仅覆盖该次更改
• 修复了针对代理和技能的托管 strictPluginOnlyCustomization 锁定在已在运行的会话中不生效的问题
• 修复了沙箱命令在某些情况下能够写入原生更新程序下载文件夹的问题
• 修复了 Bash 沙箱未能完全保护 worktree 的设置和钩子的情况
• 修复了 Bash 沙箱未能完全保护链接 worktree 的共享 git 文件夹的情况
• 修复了在某些异常 git 状态下 /teleport 的 stash 选择问题：现在它会停止并说明该怎么做
• Windows：修复了当 PATH 条目位于你的账户无法打开的文件夹下时，启动可能停滞约一秒的问题
• 修复了 Windows 上 /resume 拒绝或隐藏文件夹以不同盘符大小写或斜杠记录的会话的问题
• 修复了 Windows 上会话内 /resume 在会话以不同盘符大小写记录时丢弃项目已保存信任的问题
• Linux：修复了当工作目录位于 denyRead 内某个 allowRead 文件夹之下（例如符号链接的主目录下）时，沙箱化 Bash 命令因 bwrap: Can't create file 而失败的问题
• 修复了 Claude Desktop 的第三方部署一直停留在“Stopping”状态直到令牌续期完成的问题（一旦包含此版本）
• 改进了在输出令牌上限处被截断的子代理：现在会要求它们更简洁地重新给出完整答案，而不是只返回答案的结尾
• 改进了使用无密钥 Console 登录或其他 Anthropic 配置文件登录时的启动：仍然有效的令牌会被直接读取，而无需等待凭据锁
• 改进了账户邮箱检查：现在还会在命令运行的脚本、文件写入、网络抓取和 MCP 调用中拒绝将你的邮箱作为客户端的身份
• 改进了私有插件市场的 HTTPS authentication failed 消息：现在会说明 git 的终端提示和 askpass 程序已被禁用，并且在较新的 git 版本中也会显示
• 改进了添加市场确认、插件推荐提示和插件安装警告，说明插件可以在你的计算机上运行代码，并访问你的文件和 shell
• 改进了 claude --desktop 登录错误，指明阻止 Claude 账户登录生效的 API 密钥、提供商或设置
• 改进了 macOS 和 Windows 上的 /voice“No audio detected”消息：现在会说明在哪里选择麦克风
• 改进了 MCP 任务：现在会在任务等待你的回答时告知 Claude，并能为你指向 /tasks
• 改进了 claude remote-control：现在它自行停止时以状态码 4 退出（单会话运行仍以 0 退出），无法注册时以 69 退出，以便服务管理器可以重新启动它
• 改进了后台会话无法使用其会话的 API 密钥或令牌时显示的消息：不再建议将密钥添加到设置中
• 改进了内置 dataviz 技能中关于静态图像以及具有自然顺序的部分（如年龄段）的部分与整体建议
• 将沙箱化 Bash 命令改为默认遵循正常的权限流程；设置 sandbox.autoAllowBashIfSandboxed: true 可继续在无提示的情况下运行它们
• 更改了启用沙箱的托管设置：要在无提示的情况下继续运行命令，请在最高优先级的托管源中设置 sandbox.autoAllowBashIfSandboxed: true
• 更改了只读 git 命令：在不是项目仓库或你未信任的仓库中会先询问；请用 --add-dir 而非 additionalDirectories 设置来指定它，以便在无提示的情况下运行它们
• 更改了计划任务和 /loop：在运行声明了 allowed-tools 或钩子的技能前会先询问；将 Skill(name) 添加到 permissions.allow 以无人值守运行
• 更改了 Desktop、IDE 和 SDK 宿主中的“Always allow”：仅当保存该规则会再次允许该命令时，才会单独提供规则，因此依赖某条规则的计划任务现在可以等待你
• 更改了沙箱：拒绝沙箱化写入已添加目录中的 .claude 设置、技能、代理、命令和钩子，与在启动文件夹中的行为一致
• 更改了工作树隔离：隔离的工作树会话或代理现在会被拒绝执行 git bisect run、git maintenance register|start 和 scalar 的设置命令，并会被告知哪些仍然可用
• 更改了插件 MCP 包（.mcpb、.dxt）解压到 plugins 目录下，而不是插件文件夹中的 .mcpb-cache，以便只读插件文件夹可以加载；通过 URL 获取的包会重新下载一次
• 更改了托管设置声明、启用并列入 prependPlugins 或 appendPlugins 的远程市场插件，将其视为组织的插件；pluginDigests 已弃用并被忽略
• 更改了插件加载，跳过并通过 claude plugin validate 报告插件文件夹中的某些不安全路径和链接
• 更改了嵌套技能加载：.claude/skills 文件夹中的 --plugin-dir 插件不再从在其上层启动的会话中加载；请改为在插件文件夹中启动 Claude Code
• 更改了 EnterWorktree，使其拒绝经过项目内符号链接的 WorktreeCreate 钩子路径；让钩子打印真实路径
• 更改了 tmux 和 iTerm2 队友，以及从 agents 视图用 ← 打开的新会话，使其在会话的文件夹中启动，而不是在 shell 上次运行的位置启动 cd
• 更改了终端中的提示建议，使其在连续 8 轮由后台或计划任务启动后降低刷新频率，从而节省用量，直到你按键或返回终端
• 更改了在后台 MCP 任务的问题上按 Esc 的行为为“稍后回答”：不会向服务器发送任何内容，问题保留在 /tasks 中
• 更改了 CLAUDE_CODE_MAX_CONTEXT_TOKENS，使其也为以 claude- 开头的未识别模型 ID 设置上下文窗口，例如网关的 claude-sonnet-latest
• 更改了 /login，使其请求更改隐私设置的权限
• 更改了 /cost、$.session.usage()、--max-budget-usd 以及成本和 token 指标，使其统计 mod 的 $.model.complete 和 $.model.classify 调用
• 更改了 Claude Code 沙箱为其自身用途启动的程序（例如其网络桥接），使其在环境中不包含 Claude Code 的登录令牌和 API 密钥的情况下运行
• 更改了 ripgrep、本地 git 命令和沙箱运行时自身的辅助程序，使其在环境中不包含 mTLS 客户端密钥的密码短语的情况下运行
• Remote Control：更改了 /resume 和 /teleport，使其在已连接的会话有分享链接或无法检查时先断开连接；运行 /remote-control 以重新连接
• 更改了 Claude Code on the web、云端计划任务和 Cowork 云会话，使其在存在 sandbox.failIfUnavailable 的情况下仍能启动：托管容器没有命令沙箱
• 更改了通过云或自托管会话的连接对设置、权限规则、钩子或状态的请求，使其返回更少信息或被拒绝；会话中生效的内容不变
• 更改了无缓存账户数据的 claude -p，使其在首次请求前等待该数据，因此在干净环境中首次运行可能会晚几秒启动
• 更改了 Claude 的指令，使其将你需要的文件保留在其临时暂存文件夹之外，该文件夹可能会被清空
• 更改了市场 ref，使其接受分支或标签上任意提交的完整 ID；此版本之前的客户端无法克隆此类固定版本，因此以这种方式固定的市场会在那里停止加载
• 更改了插件市场和插件下载，使其在 ALL_PROXY 是唯一设置的代理时使用 CONNECT 隧道；拒绝 CONNECT 的代理现在会导致它们失败
• 更改了在挂载到容器的工作树或子模块中运行的 -p 和 SDK，使其仅在文件夹受信任后才应用 .claude/settings.local.json 允许规则
• 更改了自托管运行器，使其拒绝会话文件夹或仓库路径为符号链接的会话，checkout 钩子的检出除外
• 从云会话和 Remote Control 下的支出限制和共享预算错误中移除了“请你的管理员提高它”
• [VSCode] 在终端显示提示建议的所有位置添加了提示建议：Tab 接受建议的下一个提示；Claude Code 的 settings.json 中的 promptSuggestionEnabled: false 可将其关闭
• [VSCode] 添加了不创建 API 密钥的 Console 登录
• [VSCode] 添加了一个字段，用于在 SSH、WSL 和容器窗口中从面板登录 MCP 服务器时粘贴重定向 URL
• [VSCode] 修复了在 Claude Code 于另一个模型上重启或通过 Remote Control 切换模型后，模型选择器的勾选标记仍停留在旧模型上的问题
• [VSCode] 修复了 effort 选择器提供高于你的组织或 maxEffortLevel 设置所设 effort 上限的级别的问题
• [VSCode] 修复了登录界面提供托管 allowedProviders 设置所拒绝的登录方式的问题
• [VSCode] 修复了 MCP 工具的权限提示未说明 Claude Code 在安全检查触发该问题时为何询问的问题
• [VSCode] 修复了组织设置加载失败时提示重新运行命令的消息；现在改为提示重试，与标签页中的“重试”链接保持一致
• [VSCode] 改进了不受信任文件夹的提示说明：现在会说明扩展为何被关闭以及如何开启
• [VSCode] 改进了系统拒绝运行 Claude Code 时显示的错误：现在会说明你的 IT 团队可以允许被阻止的程序
• [VSCode] 改进了登录卡片，说明当浏览器对 localhost 显示连接错误时该怎么做
• [VSCode] 将安装链接的 marketplace 确认按钮改为“信任 marketplace 并继续”
• [Claude Code on the web] 修复了新的云端会话将通过工具搜索加载的 MCP 工具描述截断在 4,096 个字符的问题；现在上限为 16,384，与其他 Claude Code 会话一致
• [Claude Tag] 修复了在 Slack 中粘贴的 artifact 链接不显示卡片的问题，该问题发生在发布者的 Claude 登录在其组织不管理的工作区中已过期时；现在会显示普通卡片

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