变更内容
- 新增
CLAUDE_CODE_DISABLE_WEB_FETCH环境变量,用于关闭 WebFetch 工具 - 新增
claude --desktop用于在当前目录打开 Claude 桌面应用,或在某个会话中--continue/--resume <id> - 新增
claude plugin configure <plugin>用于显示插件的选项以及哪些未设置,或通过 stdin 读取新值并保存--values-stdin - 新增
<server>.<key>=<value>到claude plugin install --config,因此捆绑的.mcpbMCP 服务器自身的设置可以在安装时设定,并且启动时无需访问/plugin→ 配置 - 新增
allowedProviders托管设置,用于限制一台机器可以使用哪些 API 提供商(Anthropic API、自定义端点、Bedrock、Mantle、Vertex AI、Foundry、AWS 上的 Claude Platform 或 Cloud gateway) - 新增
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES环境变量,用于限制对超时的非流式回退请求的重新发送次数 - 修复
claude -p与CLAUDE_CODE_FORK_SUBAGENT=1:子智能体自身的 Agent 调用现在在前台运行,因此子智能体可以获取子级的结果 - 修复了通过 SSH 安装和更新插件及市场时忽略在
GIT_SSH中或 git 配置的core.sshCommand - 中设置的 ssh 程序的问题
- 修复了当操作系统拒绝读取托管设置文件时 Claude Code 拒绝启动的问题;现在它会发出警告并在没有该文件策略的情况下启动。其他读取错误和无法解析的文件会停止所有会话
- 修复
claude plugin disable和enable使用完整的name@marketplaceid 时以另一种字母大小写更改设置条目,而不是已安装插件自身的条目 - 修复了通过 Remote Control 发送的消息所附带的文件在单次下载失败后被丢弃的问题;网络错误、超时或服务器错误现在最多重试两次
- 修复了在会话中途使用
set_model请求(例如 Agent SDK 的setModel)切换模型后,新模型停留在内置输出 token 限制和自动压缩窗口,直到重启的问题 - 修复了脱敏日志和记录显示包含
@的 URL 密码的一部分,或当 URL 将其@写为%40 - 时显示全部密码的问题
/teleport修复了来自 worktree 和 - 拉取的 SSH 密码短语和新主机提示接管终端的问题;这些拉取现在会快速失败而不是询问
-p修复了在 SDK 和 - 会话中途关闭已添加的 MCP 服务器后其工具仍可用的问题
claude -p --permission-prompt-tool:后台子智能体的权限请求现在会发送到提示工具,而不是被自动拒绝 - 已修复
claude mcp list和claude mcp get,以及未找到错误claude mcp remove,login和logout,打印来自 MCP 服务器名称和值的换行符和终端转义序列 - 修复了沙箱自动允许在许多内联脚本每次运行时都请求批准(
python3 -c,node -e),仅仅因为它们包含= - 修复了 fork 子智能体不保留会话的计划模式或
dontAsk模式:fork 现在在其父级的权限模式下运行,且无法退出计划模式 - 已修复
claude remote-control --help显示--[no-]chrome默认为机器的/chrome设置;生成的会话保持 Claude in Chrome 关闭,除非传入--chromeis passed - 修复了自动模式下的后台子智能体在每次报告后提示第二次冗余回复
- 修复了云会话创建和
/remote-env仅读取账户环境中最新的 20 个 - 修复了 Remote Control 在消息到达时就将其标记为已读,而不是在 Claude 开始处理它时,以及在终端退出时丢失仍排队的消息(现在会在下次恢复时到达)
- 修复了安装插件时使用
claude plugin install或/plugin将其放入已安装插件的缓存或数据文件夹,当它们的 id 仅在.,-,@或(macOS、Windows)大写字母上不同时;现在会拒绝安装 - 修复了当计划在同一响应中写入时,hooks 和 SDK 权限回调在 ExitPlanMode 上看到缺失或过期的计划
- 修复了云会话中第一条回复延迟数十毫秒到达的问题,这是 2.1.283 中的回归
- 修复了使用
ANTHROPIC_AUTH_TOKEN对 Anthropic API 进行身份验证的会话从不加载组织的策略 - 修复了失败的
agent(),parallel()或pipeline()调用(工作流脚本稍后等待,或根本不等待)被当作未处理的 promise rejection,这可能会结束后台会话 - 修复了同步 hooks 挂起 Claude Code 的问题,当 hook 启动的后台进程(例如
some-daemon &)保持其输出打开时;现在 hook 会在其自身进程退出后不久完成 - 修复了 WebFetch 将限速域名的安全检查报告为网络或企业策略阻止
- 修复了全屏 ctrl+o 转录在打开包含数百次文件读取或搜索的轮次时短暂冻结的问题;转录打开时仍在运行的工具调用现在会在完成时显示其结果
- 修复了 Amazon Bedrock 流中途
modelTimeoutException和serviceUnavailableException错误显示原始 JSON 正文而不是错误消息 - 已修复
/autofix-pr以及/schedule在尚未检查安装状态的仓库上提示 Claude GitHub App 未安装 - 已修复在
/artifacts中取消某行(x)的链接会将其文件从 artifact 中解除关联,因此再次发布同一文件会创建新的 artifact 而不是更新它 - 已修复 Artifact 工具在对话回退(Esc Esc)后发布时覆盖文件较新内容的问题,该内容是 Claude 仅在回退的轮次中读取的;现在会拒绝发布,直到 Claude 重新读取该文件
- 已修复一个
Artifact允许规则(“不再询问”)让 Artifact 工具在工作目录之外发布文件而不询问的问题;请添加该文件的文件夹并设置--add-dir以使该规则覆盖它 - 已修复
/cost以及 SDKmodelUsage在服务器以与客户端预期不同的回退模型回应拒绝时,将某一轮次报告为错误模型的问题 - 已修复 Artifact 工具,使发布页面时不再允许 Claude 在未重新读取源文件的情况下覆盖它,前提是 Claude 之前的读取被中断或文件此后已更改
- 已修复自动模式跳过其分类器的问题,涉及 Artifact 工具的资源上传以及读取他人的 artifact,前提是你此前已在另一种权限模式下批准过该 artifact
- 已修复来自
/ultrareview的误导性“core.worktree is set”错误,该错误发生在项目文件夹短暂无法读取时 - 已修复
/ultrareview在 macOS 和 Linux 上无法从 git worktree 上传工作树的问题,该 worktree 的每工作树配置设置了core.longpaths - 已修复 Artifact 工具在重试临时服务器错误后有时将发布报告为与另一会话冲突的问题,而实际上第一次尝试已成功
- 已修复
/ultrareview上传包含对凭据文件的未提交更改的问题,这些文件的扩展名前带有冒号,例如server:8443.key - 已修复当两个会话同时恢复由崩溃进程留下的登录刷新锁时的罕见认证失败
- 已修复 PowerShell 工具在命令解析器启动失败时(例如机器内存不足)其权限检查跳过拒绝和询问规则、并为后续检查缓存该失败的问题
- 已修复
/ultrareview在 macOS 和 Linux 上上传时,遇到一些不常见的文件名会运行缓慢,并且它们的凭据文件检查会漏掉带有许多备份或编辑器标记的文件或文件夹名 - 修复了已取消的 shell 命令或 hook 仍在启动并运行到结束的问题,当取消在它正在被设置时到达
- 修复了 vim 模式:在外部编辑器(Ctrl+G)中编辑后,
x或r在 NORMAL 模式下不再破坏提示末尾的粘贴文本占位符 - 修复了被 API 输出内容过滤器拦截的响应被重新发送并重试的问题,有时会持续数分钟,而不是立即显示过滤器的错误
- 修复了插件静默跳过捆绑的
.mcpbMCP 服务器仍需配置:/plugin,安装消息和claude plugin install现在会说明并指向 Configure - 修复了压缩或恢复会话失败、打开时没有历史记录,或在其保存的记录包含字段缺失或格式错误的压缩标记或循环唤醒条目时崩溃的问题
- WSL:修复了
/ultrareview当更改的文件名包含冒号或以点或空格结尾时,拒绝在 Linux 卷上上传检出 - 修复了
CLAUDE_CODE_RESUME_INTERRUPTED_TURN重新运行一个已结束于--max-turns - 修复了浏览器显示成功后登录可能永远等待的问题
- Windows:修复了
/ultrareview在某些情况下上传以你的主文件夹为根的仓库的链接工作树 - 修复了云会话在任何文件上传之前就报告上传文件夹缺失的问题
- 修复了从
claude agents发送到等待权限提示的后台会话的回复有时会批准待处理命令的问题 - 修复了
claude attach,logs,stop,respawn和rm当选项出现在命令名之前时,以命令名作为提示启动新会话的问题,例如来自 shell 别名 - 修复了
claude mcp list遗漏 WebSocket(ws)MCP 服务器的问题;现在每个都会列出其 URL 和健康状态 - 修复了
claude mcp get对于配置条目省略了type字段的 stdio 服务器,不显示 Type、Command、Args 或 Environment 的问题 - 修复了
.claude/settings.local.json当配置了 git 的 trace2 输出时,allow 规则在 git 仓库之外被阻止的问题 - 修复了
/claude-apieval runner 脚手架和报告构建器通过植入在输出文件处的符号链接或硬链接写入的问题 - 修复了
/claude-apieval runner 脚手架在max_tokens处截断的响应被计入分数平均值的问题;它们现在被标记为截断并单独计数 - 修复了
当回复使用它来缩进文本(例如 markdown 表格中的行标签)时,在终端中显示为字面文本 - 修复了在非全屏模式下长时间会话中途出现的短暂卡顿(最长一秒),该问题会再次出现
/clear或/compact - 修复了已批准的 Edit 在其目标是设备(例如符号链接到 /dev/null 的文件)时始终无法生效的问题,且批准来自 IDE diff 视图或修改了该编辑
- 修复了当流式传输持续失败时,失败的 API 请求被重试多达 21 次的问题;非流式回退现在共享该请求的重试预算,而不是获得一组全新的重试
- 改进了 Chrome 中的 Claude:原生宿主现在会报告你计算机的名称,因此已连接的浏览器可以按计算机来标记,而不是显示为 "Browser 1" / "Browser 2"
- 改进了 Bedrock 和 Vertex AI 会话:当管理员移除对默认模型的访问权限时,会切换到同一层级中可用的较旧模型,而不是失败;会话标题和摘要现在也随之回退
- 改进了插件市场错误:现在会说明 git 地址被拒绝的原因,而不是引用企业策略
- 改进了对插件、市场以及当前仓库远程地址的 git URL 验证
- 改进了 Artifact 工具结果:它们现在建议在写入或编辑页面的同一步骤中发布,这可以节省一次往返
- 改进了 Remote Control:一个
/btw向由 Claude Desktop 等应用托管的会话提出的侧边问题,现在能看到正在进行的回合,而不仅仅是最后一个已完成的回合 - 改进了 Claude 以 BMP、HEIC、HEIF、AVIF 或 TIFF 文件发送的图片:Claude 应用现在会在 Claude Code 可转换它们的地方显示预览
- 改进了自动模式下的子智能体:子智能体的运行现在会在将其报告交还给调用方后立即结束,而不是进行无人接收的额外回合
- 改进了 Bedrock 和 Vertex 的启动模型检查:你的账户无法使用的模型现在会被记住长达一天,而不是在每次启动时重新检查
- 改进了 Artifact 工具发布结果以减少 token 用量:关于更新 artifact 的说明更短,并且每次发布后不再重复说明在哪里找到你的 artifacts
- 改进了非流式回退请求期间的 SDK 存活状态:在开启部分消息的情况下,一个
pingstream event 现在每 30 秒在 Anthropic API、AWS 上的 Claude Platform 和网关上发送一次 - 改进
/resume和claude --resume对于在后台运行的会话:它们现在会打开该会话而不是拒绝,并且随claude --resume <id> "prompt"给出的提示会作为其下一轮发送给它 - 改进了配置了大量权限拒绝规则和 MCP 工具时的每轮性能
- 改进了在长会话中退出 ctrl+o 转录视图时的响应速度(当全屏渲染关闭时)
- 改进了 Bedrock、Vertex 和 Mantle 的启动模型检查,使其发送与常规请求相同的 User-Agent、x-app 和 session ID 请求头
- 更改了 MCP 工具,使将自身的
_meta['anthropic/alwaysLoad']设为 false 的工具在其--mcp-config、Agent SDK 或插件服务器设置为alwaysLoad - 更改了后台 Bash 和 PowerShell 命令,使其在时间限制后停止(其
timeout为run_in_background,默认 30 分钟,最大 2 小时);当某个命令被停止时,Claude 会收到通知 - 更改了 Code Review 的拉取请求审查和
/ultrareview使其在disableWorkflows开启时运行,除非运行审查的机器由其自身管理员(MDM 或 managed-settings 文件)设置了该项 - 更改了位于自定义
ANTHROPIC_BASE_URL后的会话,使其使用拥有 1M 上下文窗口的模型的该窗口(Opus 4.7+、Sonnet 5+、Fable);如果你的网关在 200K 处停止,请运行/autocompact 200k如果你的网关在 200K 处停止 - 更改了 Team 和 Enterprise 会话,以及 Claude Code 无法确定其登录计划的会话,使其在启动时无法加载组织策略的情况下,暂缓 WebFetch 直到组织策略加载完成
- 更改了 /memory,使 Auto-memory 不再能从后台会话或由 Claude Code 自身工具启动的会话中开启;在这些地方将其关闭仍然有效
- 更改了将自动模式设为默认权限模式的一次性提示,使其在第三方提供商上以及遥测关闭时也会显示(当你的用户设置默认为另一种模式时)
- 更改了
claude -p以及第三方提供商上或遥测关闭时的 Python Agent SDK 会话,使其在未配置权限模式时以自动模式启动,与交互式会话一样;--permission-mode仍会覆盖它 - 更改了 Bedrock、Mantle 和 AWS 上的 Claude Platform 请求,使其在基础 URL 使用非默认端口时将端口包含在 SigV4 签名的 Host 请求头中
- 更改了 MCP 服务器名称
widgets在云会话和自托管 runner 中保留:其下你自己的服务器,或一个相近拼写如widgets_,不再加载,因此重命名它 - 已更改
/ultrareview在 macOS 和 Linux 上,上传本地检出时不再包含符号引用;当前分支为符号引用的检出现在会被拒绝并给出说明 - Windows:更改了项目和本地设置
env不再设置ALLUSERSPROFILE,SystemDrive,或CommonProgramFiles变量;改为在用户或托管设置中设置它们 - 已更改
/tasks将 Claude Code 自身运行的后台工作折叠到一个“System tasks”行下;按 Enter 可显示这些任务 - 已更改
/ultrareview在 macOS 和 Linux 上要求 git 2.31 或更新版本才能上传本地仓库;使用以下方式创建的检出--separate-git-dir现在会被拒绝,而不是用旧方法上传 - 已更改
/ultrareview在 macOS 和 Linux 上的上传,在 git 2.31 或更新版本上将部分克隆作为工作树快照发送,而不是在 git 版本看起来太旧时回退或拒绝 - 已更改
/ultrareview在 macOS 和 Linux 上的上传,在较旧 git 版本上拒绝缺少部分工作树文件的部分克隆,而不是获取它们;未使用以下方式创建的克隆--filter上传 - 更改了 Bedrock、Vertex 和 Mantle 启动模型检查,使其像其他 Claude Code 请求一样标识自己为 Claude Code
- 已更改
claude mcp get隐藏插件提供的 stdio MCP 服务器的命令、参数和环境值;变量名仍然显示 - 已更改
/claude-api使其无法再从 Remote Control 客户端运行 - 已更改
/config chrome=true引导你前往 /config 面板,而不是默认在 Chrome 中启用 Claude;/config chrome=false在它开启时仍会将其关闭 - 更改了沙箱设置,使项目设置无法扩大或关闭管理员要求的沙箱、替换托管拒绝列表背后的代理、扩展严格允许列表,或重新打开托管的读取拒绝
- [VSCode] 当窗口重新加载中断了恢复标签页的最后一条消息且不会有后续回复时,在其下方添加了一条说明
- [VSCode] 在 Manage plugins 中添加了插件选项表单:安装带有选项的插件时会询问未设置的选项,其行上的齿轮图标可在之后更改它们
- [VSCode] 添加了按需诊断工具,使面板中的 Claude 可以随时读取 Problems 面板当前的错误和警告,而不仅仅是在编辑文件之后
- [VSCode] 修复了在输入斜杠命令后按 Enter 会运行由模糊匹配选中的无关菜单项,或什么都不做的问题
- [VSCode] 修复了在长时间会话中打开的智能体记录会丢失智能体较新消息的问题
- [VSCode] 修复了引用 Claude Code 或 IDE 标签的消息在聊天中丢失其余文本的问题
- [VSCode] 修复了在 Claude 工作时发送的消息在会话重新打开后从对话中消失的问题
- [VSCode] 修复了切换账户后会话列表的 Web 标签页仍显示上一个账户会话的问题
- [VSCode] 修复了在启动 VS Code 时恢复的标签页会重新运行被中断的回合的问题
CLAUDE_CODE_RESUME_INTERRUPTED_TURN已设置,即使 Continue After Reload 处于关闭状态 - [VSCode] 修复了点击命令行菜单某一行后按 Escape 会停止正在运行的回合而不是关闭菜单的问题
- [VSCode] 修复了打开 Past conversations 会用其保存的副本替换实时对话的问题
- [VSCode] 修复了扩展重启后重新加载的 Claude 标签页保持空白而不是提示如何恢复的问题
- [VSCode] 修复了打开已在另一个窗口或应用中打开的对话时会无警告地启动其第二个副本的问题;现在会先询问
- [VSCode] 修复了钩子阻止或停止提示的原因在窗口重新加载后消失的问题
- [VSCode] 修复了标签页卡在无法恢复的对话上的问题:现在错误会说明情况并提供开始新对话的选项
- [VSCode] 修复了当编辑器在工具运行前对扩展的自动保存无响应时,每次文件 Read、Write 和 Edit 都会停滞十分钟然后被跳过的问题
- [VSCode] 修复了智能体映射用会话的模型而不是子智能体实际运行的模型来标记子智能体的问题(例如在
CLAUDE_CODE_SUBAGENT_MODEL_FORCE或智能体自身的model下) - [VSCode] 修复了从 Manage plugins 对话框卸载插件时会移除错误的安装,或对为项目安装的插件卸载失败的问题
- [VSCode] 修复了返回并再次选择相同登录方式后登录仍停留在授权码步骤的问题
- [VSCode] 修复了当长时间会话裁剪其最旧行时聊天面板停滞的问题
- [VSCode] 修复了当许多智能体运行时对话从会话中消失的问题
- [VSCode] 修复了在使用 /rename、通过 SessionStart 钩子或在 claude.ai 上重命名会话后,编辑器标签页仍保留旧名称的问题
- [VSCode] 修复了智能体映射的对话记录视图遗漏发送给运行中智能体的消息的问题
- [VSCode] 改进了管理插件对话框:插件操作失败时现在会弹出窗口进行说明,并在有可用修复方案时提供该方案
- [VSCode] 将管理插件对话框改为在移除市场或关闭项目共享的插件前先询问
.claude/settings.json会开启 - [Cloud sessions] 修复了例程上的 Run now 在运行开始前被拒绝时显示内部错误文本的问题;现在它会显示与例程失败通知相同的说明
- [Cloud sessions] 更改了
MCP_DISCOVERY_CACHE=1,当在云环境变量中而非设置文件中设置时,会在会话重启后复用连接器的工具列表;其他 MCP 服务器不再被缓存,而是在启动时连接 - [Claude Tag] 为 Enterprise 计划 Standard 或 Usage-Based Chat 席位且同时拥有 Cowork 的成员添加了与 Claude 的直接消息;不再需要包含 Claude Code 的席位
- [Claude Tag] 修复了管理设置中的 Default model 设置以及频道的 Configure 页面提供组织无法使用的模型、从而导致保存或新会话失败的问题
- [Claude Tag] 修复了 Claude 的 Slack 消息下方关于它使用回退模型作答及原因的说明在 Claude 之后编辑该消息时消失的问题
- [Code Review] 修复了 Code Review 的“Add a repository”对话框中的组织菜单只显示少数几个 GitHub 组织的问题;现在滚动时会加载更多
- [Code Review] 改进了 Code Review 检查运行,使其在你的仓库的 REVIEW.md 未被应用时进行说明,例如在非常大的拉取请求上或当 REVIEW.md 是符号链接时