← 返回更新日志

Claude Code v2.1.280

2026-09-22 · GitHub 原文
## 有哪些变化 - 新增 Claude Opus 5.5(`claude-opus-5-5`),现为默认 Opus 模型——1M 上下文,每百万 token 收费 $4/$20,缓存读取每百万 token 收费 $0.20 - 为全屏模式下的更多列表添加鼠标支持:滚轮可滚动 `/skills` 列表,并且可以点击 `/plugin` 中某个技能的状态选项 - 新增 `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`,可更改会话中每个 MCP 服务器的 MCP 工具描述和服务器指令的 2,048 字符上限 - 在 `hook_execution_complete` OpenTelemetry 事件中加入钩子输出大小,以及被保存到文件中的超大输出数量 - 修复了通过符号链接路径写入时仍按其仓库内路径名判断的问题:提示现在会指出写入实际落点,`acceptEdits`、允许规则和自动模式也不再批准一个实际落点在外部的写入 - 修复了自动模式在安全检查拒绝审查某个操作时反复重试的问题;现在该操作只会被拒绝一次,并说明重试不会有帮助 - 修复了安全检查未给出答复时自动模式不停地反复拒绝操作的问题;现在重试会逐渐退避,连续十次后,本轮会显示消息并停止 - 修复了模型发送 `path`、`file_text`、`file_content` 或多余的 `description`,而不是 `file_path` 和 `content` 时,Write 调用验证失败的问题 - 修复了在大多数对话框(`/model`、`/effort`、`/config`、`/status`、`/usage`、`/plugin`、`/sandbox`、`/permissions`、`/artifacts`、`/mobile`、`/login`、`/upgrade`、`/usage-credits`、`/install-github-app`、`/setup-bedrock`、`/setup-vertex`)中连续按两次 Ctrl+C 或 Ctrl+D 会退出 Claude Code,而不是关闭对话框的问题 - 修复了某次点击本应只是将终端窗口置于前台,却同时触发指针下方项目的问题——涉及搜索选择器、标签栏、代理/工作流行、斜杠命令链接和建议下拉菜单 - 修复了多余的 `n` 会关闭对话框、而多余的 `y` 会确认对话框的问题;现在由 Enter 和 Esc 分别执行接受和取消操作(可在 `keybindings.json` 中将 `y`/`n` 绑定到 `confirm:yes`/`confirm:no` 以恢复原行为) - 修复了对话框中的文本字段会因某个按键上的键绑定而丢失所输入的字母、数字或空格的问题 - 修复了 Windows 终端中按 Enter 移除不可见字符后提示行显示混乱的问题;现在会重新绘制屏幕,以便你检查将要发送的确切文本 - 修复了清理不可见字符时移除波斯语和阿拉伯语文本用于将后缀连接到拉丁字母单词或数字上的零宽非连接符的问题,例如 `"PDF"` 的复数形式 - 修复了语音听写无法通过 Ctrl+C 停止的问题(提示已清空,但麦克风仍在录音)、转录处理期间 Esc 无法取消的问题,以及在转录视图和 vim NORMAL 模式下按住空格会启动听写的问题 - 修复了 Claude 工作期间从宿主应用(Claude Desktop、VS Code、SDK)切换模型会导致下一条提示未命中提示缓存的问题 - 修复了恢复的分叉子代理会重新构建工具列表,而不是重新发送其首次使用的工具列表的问题;这会破坏该代理的提示缓存 - 修复了在详细模式之外展开子代理交接消息时显示内部来源前导语的问题 - 修复了通过 GitHub 仓库或跟踪分支/标签的 git URL 更新插件后,`installed_plugins.json` 仍保留安装时提交的问题 - 修复了当 `manifest.json` 列出 `~/.claude/skills/` 中技能名称时,这些技能会被移动到 `~/.claude/skills/.trash/` 的问题 - 修复了会话反馈调查在浅色主题和 ANSI 主题下不显示悬停高亮的问题 - 修复了 `/workflows` 在打开唯一一次运行前短暂显示一行列表的问题 - 修复了全屏模式下鼠标滚轮无法滚动含有隐藏选项的选择列表(例如 `/model` 和 `/permissions`)的问题 - 修复了在 `/plugin` 和 `/skills` 中,已关闭的技能显示与加载失败插件相同的红色 ✘ 的问题;关闭状态现在显示为暗淡的 ◯ - 修复了多选选项的说明会缩进到选项编号下方,而不是标签下方的问题 - 修复了全屏模式下 `/plugin`、`/skills` 和 `/mcp` 中搜索框右边框消失的问题 - 修复了 `/mcp` 在服务器列表中对同一服务器显示 △、而在详细视图中显示 ⚠ 的问题;列表、详细视图和 `/plugin` 现在统一显示 ⚠ - 修复了 Home 和 End 在 `/config` 设置列表以及 `/model`、`/memory` 和权限提示等选择列表中不起作用的问题 - 修复了 `/skills` 菜单中的 PgUp/PgDn 会越过第一个或最后一个技能循环的问题;现在会停在边界处 - 修复了 Tab 会在 `/config` 列表中悄悄改变所选设置值的问题;现在 Tab 在此处不起作用 - 修复了每一轮对话都因 API 错误 `"role 'system' must precede an 'assistant' message"` 而失败的问题 - 修复了在不支持该字段的代理或网关后方使用 advisor 时,每一轮对话都会因 API Error 400 `"Input tag 'advisor_20260301'"` 失败的问题;请求现在会在不带该字段的情况下重试 - 修复了当保存的历史记录中包含关于无法加载 MCP 工具的格式错误通知时,会话每轮以及 `/compact` 都失败的问题 - 修复了恢复会话时,如果保存的记录包含格式错误的系统消息,或缺少文件列表的记忆保存通知,会导致崩溃的问题 - 修复了长期运行的全屏会话因“Claude Code exited after an unrecoverable interface error”退出的一个原因:损坏的缓存消息列表现在会被重新构建 - 修复了设置文件或编辑后重新读取的文件在读取过程中被命名管道替换时 Claude Code 会挂起的问题 - 修复了当已迁移到 `settings.json` 的偏好设置仍在 `~/.claude.json` 中保留 `null` 或 `"false"` 等值时,`/config` 崩溃以及部分开关偏好被误读的问题 - 修复了恢复包含未完成后台代理、Shell 或工作流的会话时,在用户输入任何内容前会自行启动模型回合的问题 - 修复了在无头模式和 SDK 会话中,当后台子代理即将完成其回合时,发送给它的消息会被悄悄丢失的问题 - 修复了启动后台子代理的对话在读取报告前被压缩时,已完成子代理的报告会丢失的问题 - 修复了启用 LSP 插件时后台子代理无法使用 LSP 工具的问题 - 修复了后台 Shell 任务会将无害的非零退出(例如 grep 未找到匹配项)报告为失败的问题 - 修复了当传递给后台会话的环境变量包含 NUL 字符时,后台会话(`claude --bg`)无法运行 git、钩子、插件及其他辅助程序的问题 - 修复了后台子代理运行时需要按三四次 Ctrl+C 才能退出的问题;现在按两次即可退出 - 修复了已发送的提示重新进入输入框时 IDE 选择会丢失的问题,例如按 Esc 编辑提示、回退到该提示,或启动钩子运行期间按 Esc - 修复了使用 Ctrl+S 暂存的 `!` Shell 模式提示恢复后变成普通提示的问题,以及暂存后立即使用 `/` 会列出文件路径的问题 - 修复了临时目录已满、不可写或归其他用户所有时,`claude agents` 显示空白且无响应屏幕而不是错误的问题 - 修复了通过 `claude mcp remove` 移除 MCP 服务器后,再以相同名称重新添加该服务器时仍显示需要身份验证,而不是重新连接的问题 - 修复了后台插件市场自动更新会忽略 git 凭据助手的问题,导致私有仓库市场每次运行都会被重新克隆,或始终无法更新 - 修复了当官方市场的快照文件是链接或过大时,`claude plugin update` 会清除插件记录的提交并将其版本改为“unknown”的问题 - 修复了组织策略无法加载时 Artifact 工具会悄然消失的问题(例如位于 Web 代理后方);Claude 现在会说明阻止它的原因 - 修复了重新发布 Artifact 时,如果重新发送该能力却未包含已存储的数据库访问规则或查看者配置文件范围,会悄悄重置或丢弃这些设置的问题;现在此类操作会被拒绝 - 修复了 `/ultrareview` 会将已停止的云端审查报告为已完成或可重试的错误,并在其会话已被删除或登录账户发生变化时等待完整超时的问题 - 修复了 Claude 应用在执行 `/compact` 或 `/clear` 后,Remote Control 和云端会话的上下文使用量立即显示缺失或过时数值的问题 - 修复了 Claude 应用中 Remote Control 和云端会话的差异视图在同时存在未提交更改时,会丢失分支已提交文件的问题 - 修复了云端和自托管运行器会话在长时间过载等待期间访问令牌轮换后,最终失败并显示“Authentication failed”的问题 - 修复了 Cowork 中的记忆写入冲突只向 Claude 显示约 10,800 字符记忆文件的开头和结尾的问题,导致重试写入时丢失中间内容 - 自托管运行器:修复了在 `--configure-git` 下生命周期钩子提交无法签名的问题 - Windows:修复了后台清理会删除用于重定位 `~/.claude/session-env`、`image-cache` 或其他清理目录的目录符号链接或 junction 的问题 - 自托管运行器:修复了恰好在 `--retire-at` 发布时结束的回合会丢失完成信号的问题;运行器现在会短暂等待回合报告后再停止会话 - 撤销了在全屏模式下使用 `ctrl+l` / `cmd+k` 清除记录视图的行为(该行为于 2.1.260 中加入);现在它们会再次重绘屏幕 - 改进 `/permissions`:查看、添加或删除规则后焦点会返回规则列表,删除规则和移除目录的确认现在默认选择 No - 改进 `/permissions` 的 Tab 导航:在规则列表中按 ←/→ 或 Tab 现在会切换标签页,而不会将焦点移到标签栏 - 改进 `/cost` 的缓存未命中原因,现在会说明思考模式和思考显示变化 - 改进 Artifact 工具:当 Claude 无法读取提供给它的 Artifact 链接时,会在继续之前告知用户 - 改进 `/install-github-app`:GitHub CLI 检查和仓库选择步骤现在会显示“Esc to cancel” - 改进 `/artifacts` 和 `/workflows` 列表:右边缘的滚动条会显示长列表中隐藏了多少内容,以及当前所在位置 - 改进工作流进度树:运行中的代理和阶段现在显示暗淡的圆点,而不是 ⟳ - 改进全屏模式下 `/plugin` 的 Add Marketplace 表单:不再在窗格内部绘制边框,其文本和按键提示现在与 `/plugin` 的其他部分对齐 - 改进全屏模式下 `/workflows` 的详细视图:不再在窗格分隔线下方绘制第二条水平线 - 改进未指定语言名称的代码块:现在会像行内代码一样着色,使命令区别于周围文本 - 改进工具仍在运行时发出的 `/btw` 问题:侧边问题现在知道该调用正在进行,而不会将其误判为失败 - 改进 UserPromptSubmit 钩子超时通知和调试日志,现在会指出超时的钩子命令 - 改进 `@` 文件建议:文件名包含查询内容的文件,现在会排在仅通过文件夹名称匹配的文件之前 - 改进 Artifact 页面:不再显示打印按钮、确认对话框或查看器阻止使用的设备功能;电子邮件和电话信息以文本显示;深色模式现在覆盖表单控件和滚动条 - 改进 `/ultrareview` 上传:关键文件的重命名副本(例如 `id_rsa copy` 或 `kubeconfig (1).yaml`)现在也会保留在本机 - 改进跨会话消息启动警告:说明 `--debug-file` 会将调试日志写入你选择的路径 - 更改 Pro 和 Team Standard 计划的默认模型:从 Sonnet 改为 Opus,与 Max、Team Premium 和 Enterprise 保持一致 - 更改 `/effort` 改为按模型设置之前保存的 effort 级别:不再应用于 Opus 5.5 等新发布的模型;这些模型会先使用默认级别,直到你选择一个级别 - 更改 Opus 4.7、Opus 4.8 和 Fable 5:不再在 `-p` 或 Agent SDK、项目设置、托管设置、`--settings` 的 `effortLevel` 或按模型设置中保留启动时的默认 effort - 更改 `/autocompact` 底部提示:现在会标明 ←/→,即用于调整其他有序值的按键 - 更改 `/fast` 底部提示:现在会标明 Space 是切换键 - 自托管运行器:更改生命周期钩子中的 git 行为,使其忽略运行器共享 git 文件中指定的钩子文件夹和程序;其中的本地路径和 `git://` 远程地址现在需要 `GIT_ALLOW_PROTOCOL` - 更改插件市场行为:添加名称仿冒保留市场名称的插件市场时会被拒绝;如果已经添加,也会停止加载 - 更改 `PermissionRequest` 钩子:agent 类型钩子不再在此处运行,因为其答复无法允许或拒绝请求;现在会显示错误,并指向 command 或 http 钩子 - [VSCode] 新增 Status 对话框,可通过输入 `/status` 打开,显示会话版本、账户、模型和服务器详细信息 - [VSCode] 新增 Sandbox 对话框,用于设置沙盒模式、无沙盒回退模式和排除的命令,可从面板菜单打开,或输入 `/sandbox` 打开 - [VSCode] 新增 Claude in Chrome 对话框,包含扩展状态、安装、重新连接和权限页面,以及默认启用设置;可从面板菜单打开,或输入 `/chrome` 打开 - [VSCode] 新增导出对话功能,可通过输入 `/export` 将对话复制或保存为纯文本 - [VSCode] 在 Slash commands 对话框中加入每个技能的来源、token 估算值和开/关状态,并可点击更改状态;输入 `/skills` 可打开该对话框 - [VSCode] 新增 `/plan`,可切换到计划模式、发送第一条规划提示,或显示会话计划 - [VSCode] 改进聊天框中的粘贴文本处理:超过 800 个字符或超过 2 个换行符的粘贴内容现在会被标记,以便 Claude 将其与用户输入的内容区分开 - [VSCode] 改进聊天框中的提示处理:粘贴文本中的不可见 Unicode 格式字符和标签字符会被移除并显示通知;其他内容也会在发送前移除这些字符 - [VSCode] 更改“Open in New Tab”:现在会将 Claude 打开在你正在使用的编辑器组旁边,而不是最后一个编辑器组之后 - [VSCode] 修复 effort 芯片显示过时的已保存 effort 级别,而不是会话实际运行级别的问题 - [VSCode] 修复 Python 扩展激活时挂起会导致 Claude Code 永远无法启动的问题;现在等待 60 秒后会在没有 Python 环境的情况下启动 - [VSCode] 修复计划批准卡片从不提供自动模式的问题:自动模式可用时,第一个选项现在是“Yes, and use auto mode”,与终端中的行为一致 - [VSCode] 修复通过键盘归档或取消归档会话后,会话列表中的方向键导航停止的问题 - [VSCode] 修复重新打开会话后,自己的消息中会显示粘贴标记行的问题 - [Claude Code 网页版] 更改管理员的 Routines 开关设置位置:现在位于 Admin settings → Capabilities → Remote sessions;Claude Code 管理员页面现在会链接到该位置 - [Claude Code 网页版] 修复在 GitHub Enterprise Server 仓库的云端会话中,运行约八小时后 `gh` 和 GitHub API 调用失败的问题;令牌现在会自动续期 - [Claude Code 网页版] 修复例行任务在计划运行开始前刚被编辑时,恢复现有会话仍使用旧提示和旧名称运行的问题 - [Claude Code 网页版] 修复云端会话记录中指向工作目录外部的文件链接会打开一个永远无法加载的文件卡片的问题;现在这类链接会被禁用并说明原因 - [Claude Code 网页版] 修复自动模式拒绝重试工具调用的问题:此前,已过期但未回答的审批提示,或被新消息取代的审批提示,会被记录为用户拒绝 - [Claude Code 网页版] 改进在 Claude 应用中查看云端会话的体验:Claude 现在会将为用户准备的文件保存到应用可以打开的位置 - [Claude Code 网页版] 移除了在组织管理员关闭 GitHub 后,于自托管环境中启动会话时显示的空仓库选择器 - [Claude Tag] 在频道中的 Claude 线程中加入 Slack 原生的 Working 指示器、Stop 按钮和线程标题;指示器会一直显示到 Claude 完成,Stop 会中断任务 - [Claude Tag] 新增简短通知:当访客加入或最后一名访客离开时,如果 Restrict 或 Channel only 访客设置改变了 Claude 在该频道中的响应方式,Slack 频道会显示该通知 - [Claude Tag] 修复已连接到 Claude 的 Slack 工作区加入 Enterprise Grid 后,计划例行任务会静默运行失败的问题 - [Claude Tag] 修复短暂的文件扫描故障(而不是文件本身)导致 Claude 要求重新上传 Slack 文件的问题;现在会重试扫描,并在扫描器不可用时告知用户 - [Claude Tag] 修复 Claude 的 Slack 回复中以 `+`、`-` 或 `*` 开头的项目符号会渲染为空项目并带有多余嵌套项目的问题;现在会显示为一个保留该字符的项目 - [Claude Tag] 修复云端环境设置脚本失败时 Slack 通知有时只显示笼统的“mention me to retry”的问题;现在会指出设置脚本,并说明需要先修复它 - [Claude Tag] 改进 Claude Tag 管理设置中的 GitHub 横幅,说明 GitHub 未连接的原因:未登录、应用未关联或未安装、登录已过期,或 SSO 未授权 - [代码审查] 改进 Code Review 检查运行结果:当 REVIEW.md 指令因超过大小限制而被截断或排除在审查之外时,现在会说明这一点,并指出文件名和限制大小