← 返回更新日志

Claude Code v2.1.284

2026-09-28 · GitHub 原文
## 有哪些变化 - 新增 Claude Sonnet 5.5(`claude-sonnet-5-5`),现已成为 Anthropic API 上默认的 Sonnet 模型,支持 1M 上下文;价格为每百万 token 输入/输出 $2/$10,缓存读取为每百万 token $0.20 - 在自动模式下,当提示需要读取工作目录之外的内容时,新增“是,但下次请再询问”选项,因此你可以允许本次读取,同时仍会在之后的读取操作中再次收到询问 - 当 Claude 应用网关运行此版本或更高版本时,在 `/usage` 和状态栏中的 Claude 应用网关消费限额里新增美元金额(例如“本月已消费 $271.40 / $500.00”);状态栏中的 `rate_limits.spend_limit` 也新增 `used_usd`、`limit_usd` 和 `period` - 新增 `effortSlider:decreaseEffort`、`increaseEffort` 和 `toggleUltracode` 键绑定操作,因此可以在 `keybindings.json` 中重新绑定 `/effort` 滑块的方向键和 Tab 键 - 面向 claude.ai 订阅用户,在 `/help` 和命令菜单中新增 `/rate-limit-options`,因此提到该命令的用量限制通知现在会指向一个可以找到的命令 - 在交互式终端中新增 `/mcp reconnect all`,可一次性重试所有连接失败或需要身份验证的 MCP 服务器 - 当托管策略的 `availableModels` 为空,或未包含 Claude Code 启动时使用的模型且未设置 `model` 或 `enforceAvailableModels` 时,新增 Claude 应用网关启动警告 - 为 Claude 应用网关 `telemetry.forward_to` 目标新增 `auth: { google: {} }`,因此可以使用网关的 Google Cloud 凭据,直接将遥测数据导出到 Google Cloud 的 OTLP 端点 - 在 Claude 应用网关与其身份提供商之间新增证书客户端身份验证(`private_key_jwt`),支持使用证书凭据而非客户端密钥的身份提供商 - 修复损坏的响应流显示原始错误(例如“JSON Parse error”或“undefined is not an object”),或将“undefined”写入回答,而不是重试或报告响应中断的问题 - 修复过载错误或服务器错误紧接在思考块之后到达时,直接以错误结束本轮而不是重试的问题 - 修复压缩后仍持续出现“Prompt is too long”错误的问题:当压缩后的请求仍然过长时,Claude Code 现在会再次压缩,并减少保留的近期对话内容 - 修复会话所使用的模型不可用且没有剩余备用模型时,只显示简单的“is currently unavailable”消息(云端会话中显示“Something went wrong”),而不是显示模型不可用通知及其 Learn more 链接的问题 - 修复 Agent SDK 会话在用户消息包含 `source` 格式错误的图片时崩溃,以及在遇到格式错误的文档块后后续每一轮都失败的问题;格式错误的图片现在会被替换为说明性备注 - 修复恢复的会话中 MCP 工具调用在服务器仍处于连接状态时失败并显示“No such tool available”的问题;现在会等待服务器最多 10 秒 - 修复计划用量端点在触发速率限制或拒绝登录后反复调用的问题:`/usage`、`/extra-usage` 和 IDE 用量视图现在会退避,而不是不断重新请求 - 修复 `claude mcp add` 在托管设置将 MCP 服务器限制为插件时仍报告成功的问题;现在会拒绝该操作并说明应如何处理,而不是保存一个永远不会加载的服务器 - 修复 `/plugin` 配置界面:布尔选项现在是真/假选择,而不是自由文本;数字选项会拒绝无效输入;←/→ 会修改选项字段,而不是切换标签页 - 修复 `ANTHROPIC_FOUNDRY_RESOURCE` 未经验证就被插入 Foundry 端点主机名的问题;现在会拒绝不是普通资源名称的值 - 修复 Claude Desktop 在 Claude 应用网关之后运行时不提供 1M 上下文选项的问题;网关现在会自动为 Desktop 标记每个支持 1M 上下文的模型 - 修复 Shell 模式下按 ↓ 会选中隐藏的后台任务标签,导致 Backspace 和 Ctrl+U 无法编辑提示的问题 - 修复启用大量插件时 Bash 工具在 Windows 上失败的问题:不再将不存在的插件 `bin/` 目录加入 PATH,也不会重复添加继承的条目 - 修复在旧版 git(2.39 之前)上,带有 `sparsePaths` 的插件市场被克隆为空并替换正常的本地副本,导致每次刷新都失败并显示“marketplace.json file is no longer present”的问题 - 修复全屏渲染问题:在转录模式下按 `[` 将对话写入滚动缓冲区时,会擦除会话上方已有的终端输出(macOS 和 Linux) - 修复全屏模式下向上滚动时,回复完成流式传输会导致滚动位置跳到上一条消息或底部的问题 - 修复 `/config` 和 `/plugin` 等对话框中的标签栏在窄终端中从单词中间截断标题和标签的问题;无法容纳的标签现在会完整地移动到下一行 - 修复 `/model` 选择器滚动到最后一个模型后,在列表下方显示“+1 model”的问题;该计数现在只包含可见行以下的模型 - 修复 `/keybindings` 将对页脚操作无效的 Backspace 和 Delete 绑定写入生成的 `keybindings.json` 的问题 - 修复重新绑定的代理面板关闭键(`footer:close`)在当前代理所在行输入“x”而不是执行其自身操作的问题 - 修复 Vim 模式下,`.` 在快速输入的文本(例如通过 SSH 或 tmux 输入)或未使用括号粘贴的文本中无法重复操作的问题;也修复了在没有输入任何内容时重复更改(例如 `cw` 后按 Esc)会使提示停留在 INSERT 模式的问题 - 修复 Vim 模式下,在最后一行执行 `dd` 或在提示末尾执行 `yy` 后,光标停留在图片占位符左括号上的问题;此时使用 `r` 或 `x` 会破坏或删除图片 - 修复终端刚恢复焦点时按下的按键会在 Remote Control 启用提示的短暂安全延迟重新启动前直接回答该提示的问题 - 修复 Claude Code 从主目录启动时,切换渲染器或更新后工作区信任对话框再次出现的问题 - 修复从项目外部符号链接到 `.claude/rules` 的规则会被跳过,且始终不会显示外部导入批准提示的问题;从项目外部符号链接的 `.claude` 目录现在也会请求相同的批准 - 修复来自插件市场、claude.ai 和 npm 的插件在托管设置 `allowManagedPermissionRulesOnly` 下通过 `allowed-tools` 预先批准自身工具的问题;只有来自官方 Anthropic 来源或由托管设置认可的来源的插件才会获得此预批准 - 修复首次 `claude plugin install` 失败时,如果无法满足依赖项版本范围,插件仍会被启用并记录的问题 - 修复调试日志在失败的钩子同时写入 stdout 时丢失其 stderr,以及失败钩子没有输出时完全不记录的问题;失败的钩子现在也会记录其状态码 - 修复 Elicitation 和 ElicitationResult 钩子返回 `{"decision":"block"}` 时被忽略的问题;现在会拒绝 MCP 引导请求,与退出码 2 的行为一致 - 修复未提供 `SendMessage` 工具的会话(例如由 Claude Desktop 启动的会话)仍被告知要使用该工具向其他会话发送消息的问题 - 修复通过 Remote Control 从 Claude 应用发送的照片在其排队消息被拉回终端提示进行编辑时丢失的问题;也修复了没有标题的照片会导致光标移动一个字符的问题 - 修复在自动用量限制等待期间输入消息时,如果该轮再次触发限制,会将等待状态从“达到用量限制时自动继续”设置的控制范围中移除的问题 - 修复用量限制警告向已经使用最高 Max 计划的用户建议 `/upgrade` 的问题;当 `/usage-credits` 可用时,警告和 `/upgrade` 本身现在都会指向 `/usage-credits` - 修复当会话运行 Claude Code 无法识别的模型 ID(例如代理后的自定义模型)时,Explore 子代理在 Claude API 上切换到 Opus 的问题;Explore 现在会继承该模型 - 修复自定步调模式下 `/loop` 状态更新经常不显示的问题,因为 Claude 只在推理中写入这些更新;Claude 现在会将每次更新以及循环停止时的结果作为可见文本写出 - 修复从 Claude 桌面应用在 macOS 或 Linux 上创建的 git worktree 启动 `/ultrareview` 时无法上传工作树的问题 - 修复 Linux 上工作目录禁止写入且包含禁止读取的目录时,沙盒 Bash 命令无法启动的问题 - 修复 artifact 数据库写入结果告诉 Claude 每个查看者都能看到对某个查看者私有 `data/users/` 子树的写入的问题;同时为 `as_level` 新增“view”级别 - 修复 Claude 应用网关对来自登录请求的所有请求返回 `431 Request Header Fields Too Large` 的问题,该登录请求的身份提供商列出了大量群组;现在支持最大 256 KiB 的请求头 - 改进用量限制等待:限制状态以及带用量积分选项的倒计时现在会在提示下方作为一个区块显示,限制消息也不再重复倒计时 - 改进未带前缀调用 Claude in Chrome 工具时显示的“No such tool available”错误;现在会指出应调用的工具名称 - 改进 Monitor 事件行,使其显示每个事件实际打印的内容,而不是重复描述;同时不再在每个事件之后重复未变化的“Waiting for N … to finish”行 - 改进 Workflow 工具对异步脚本钩子抛出错误时的沙盒强化 - 改进启动速度和内存使用:现在只构建设置文件实际使用的设置架构部分 - 改进 `/claude-api`:`hillclimb` 不再将轮次花费在评估无法测量的细微提示改写上;当你要求在 `report.html` 之外生成额外页面时,该页面会作为一个不从网络加载任何内容的本地文件构建 - 改进 `/tasks`、`/copy` 和 `/hooks` 等列表:当空间足够时,每个名称后的详细信息现在会对齐在同一列;空间不足时,则位于右边缘 - 改进 `claude plugin marketplace add`:当它用不同来源的同名市场替换已添加的市场时,会说明这一点以及如何撤销操作 - 改进托管设置要求登录(`forceLoginMethod` 或 `forceLoginOrgUUID`)但配置了 API 密钥、令牌或 `apiKeyHelper` 时的启动拒绝信息;现在会指出正在使用的凭据、凭据设置位置以及移除方式 - 改进自动记忆加载:在 `MEMORY.md` 和召回的记忆笔记中,中和不可见字符以及伪装成 Claude Code 自有标记的标签,避免它们传递给 Claude - 改进 `claude remote-control`:在尚未信任的文件夹中,现在会在终端请求工作区信任,而不是直接退出 - 改进 artifact 页面:Claude 会将设计计划写入页面而不是回复,并使用你已经为某个对象指定的名称作为页面标题 - 改进 Artifact 工具:当 Claude 收到 claude.ai 聊天或项目链接、聊天中的 artifact,或单独的 artifact ID 时,会请求正确的链接或内容,而不是直接停止 - 更改交互式终端和 VS Code 会话的启动方式:当未配置权限模式时,无论计划和提供商为何,现在都会以自动模式启动;`permissions.defaultMode` 仍然会覆盖该行为 - 将 Ultracode 改为 `/effort` 中独立的开关(Tab,或 `/effort ultracode [on|off]`):它不再强制使用 xhigh effort,并且会在任何 effort 级别保持开启 - 更改响应中途连接断开后的重试逻辑:现在与请求其余部分的重试共享同一个预算,因此失败的请求会更快放弃 - 更改 Sonnet 模型的安全防护标记消息时显示的通知:现在会解释触发原因,并提供编辑和重试选项 - 更改会话固定使用 Opus 模型且设置了 `ANTHROPIC_DEFAULT_OPUS_MODEL` 或 `modelOverrides` 时的安全相关模型切换:在 Anthropic API 上,API 现在会针对每种标记类型选择要切换到的模型,而不是使用固定模型 - 更改非交互式首次请求:即使 `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` 为 `0`,仍会为 `--allowedTools` 或 `mcp_tool` 钩子指定的连接中 MCP 服务器等待最多 2 秒 - 更改 `/recap`:当它从聊天线程(包括你自己的聊天线程)、例行任务或 webhook 中转发过来时,会用简短通知拒绝执行;在终端、Claude 应用、Remote Control、`-p` 或 SDK 主机中输入时,行为不变 - 更改 `/artifacts`:在标题旁显示筛选标签,并使用单词标签(All、Mine、Shared),与 `/config` 和 `/plugin` 使用相同的标签栏 - 更改 artifact 发布行为:除非网络共享路径(`\\host\share` 或 `/net` 自动挂载)位于通过 `--add-dir` 添加的映射网络驱动器上,否则拒绝发布其中的文件 - [VSCode] 新增可选的提示和回复时间显示;日期发生变化时会显示日期行(Claude Code: Show Message Timestamps 设置,默认关闭) - [VSCode] 在 Manage plugins 列表项中新增插件加载错误和备注,并提供弹窗用于禁用、卸载或复制错误 - [VSCode] 在 Effort 滑块下新增 Ultracode 开关,取代滑块中的 Ultracode 停止点;模型标签会在任何 effort 级别显示“· Ultracode” - [VSCode] 修复从 Memory 对话框重新加载 Claude 时,在编辑后的文件保存前就重启的问题 - [VSCode] 修复恢复的标签页打开另一个 Claude 进程仍在使用的对话的问题;现在会先询问 - [VSCode] 修复 Focus 视图中展开的区块在子代理工作时,或区块的第一步被裁剪出视图时自行关闭的问题 - [VSCode] 修复输入 `/model` 并按 Enter 后将用量文本打印到聊天中,而不是打开模型选择器的问题 - [VSCode] 修复在 Vertex、Bedrock 和 Foundry 上按下 Send 后 `/feedback` 被拒绝的问题;报告现在会像终端一样保存到本机 - [VSCode] 修复窗口重新加载后登录会等待 Python 扩展最多一分钟的问题 - [VSCode] 修复执行 Restart Extensions 后 Claude Code 标签页停止响应的问题;现在会重新打开原来的对话 - [VSCode] 修复没有记录发送者的其他代理消息以原始 XML 形式显示在聊天中的问题 - [VSCode] 修复重新加载后其他代理、会话或频道的消息消失的问题 - [VSCode] 修复用户自己的 `/mcp`、`/config` 或 `/settings` 命令被扩展对话框遮挡的问题 - [VSCode] 修复没有正在运行的请求时按 Escape 会停止所有后台代理的问题 - [VSCode] 修复插件安装链接替换同名的现有市场的问题 - [VSCode] 修复消息附带大型文本文件时,压缩后出现“Prompt is too long”错误的问题 - [VSCode] 修复路径包含非 ASCII 字符、空格或方括号的文件聊天链接无法打开的问题 - [VSCode] 更改 `claudeCode.environmentVariables` 设置中的 `CLAUDE_CONFIG_DIR`:现在只有绝对路径才会生效,并会传递给继续聊天的终端 - [Cloud sessions] 修复离线时例行任务的 Edit 和 Duplicate 控件仍显示例行任务正在加载的问题;现在会提示你处于离线状态 - [Claude Tag] 新增模型系列选项,例如线程、频道默认模型或私信中的“Opus (latest)”,因此该选择会跟随该系列中的最新模型 - [Claude Tag] 在分析消费预测图表中新增计入组织范围限制的消费金额,以及已使用的限制额度 - [Claude Tag] 修复早期 Claude in Slack 应用的进度卡片和链接预览在 GitHub Enterprise 主机名包含下划线时,遗漏仓库和 Create PR 按钮的问题 - [Claude Tag] 修复 Claude 在环境拒绝启动的频道中保持沉默的问题;现在会发布一次通知,要求联系管理员,并在被 @ 提及时重试 - [Claude Tag] 更改 Claude 的私密登录通知:对于尚未连接 Claude 账户的用户,每次 @ 提及时都会发布,而不是第一次之后保持沉默 - [Claude Tag] 改进管理员设置中的“Notify members now”:一次点击即可触达组织在 Enterprise Grid 中认领的每个工作区,以及大型工作区中的更多成员 - [Claude Tag] 改进自托管环境使用按需运行器时 Claude 的等待通知;现在会说明运行器正在启动、将重试启动,还是不会启动运行器 - [Claude Tag] 改进添加频道管理员失败时显示的错误信息,适用于无法确认频道所在 Slack 工作区已连接到组织的情况 - [Claude Tag] 改进管理员设置中的频道访问列表:显示自动加入模式关联的连接器、仓库和插件,以及每项来源 - [Claude Tag] 改进将仓库添加为频道管理员的流程:当 GitHub 登录无法确认你是仓库管理员时,页面会要求你使用 GitHub 登录 - [Code Review] 修复 Code Review 在其 GitHub App 下有未提交的审查仍处于拉取请求中时,放弃操作且不发布完成的审查的问题;现在会先重试发布