古法编程

Claude Code 更新日志：版本历史与功能修复汇总

Claude Code 的版本更新日志，自动同步自 GitHub CHANGELOG.md。每条记录包含新功能、改进和 Bug 修复，按版本号从新到旧排列。运行 claude --version 可查看当前安装的版本。本页覆盖主要版本，更早版本请查阅上游英文原文。

2.1.148 – 2026年5月22日

  • 修复了部分用户的 Bash 工具每次命令都返回退出码 127 的问题（2.1.147 引入的回归）

2.1.147 – 2026年5月21日

  • 固定的后台会话（claude agents 中的 Ctrl+T）现在空闲时保持存活，应用 Claude Code 更新时会在原地重启，且仅在固定会话耗尽后才因内存压力关闭
  • 将 /simplify 重命名为 /code-review。现在它会在选定的努力级别报告正确性错误（例如 /code-review high）；传入 --comment 可将结果作为内联 GitHub PR 评论发布。旧的清理和修复行为已移除
  • 改进了自动更新器：重试瞬态网络故障，失败时报告特定错误类别和操作系统错误码，更新失败时显示当前版本
  • 改进了大文件编辑的 diff 渲染性能
  • 提示历史不再记录连续重复的条目——用上箭头召回提示并再次提交不会添加重复副本
  • 修复了企业登录限制（forceLoginOrgUUID 和 forceLoginMethod 托管设置）未对第三方提供商及 API 密钥会话强制执行的问题
  • 修复了 ! 命令输出中 & 显示为 &，导致在无头机器上从 gcloud auth login 等命令复制粘贴 URL 失败的问题
  • 修复了未知斜杠命令在无头/SDK 模式下静默无动作的问题——现在会显示错误消息
  • 修复了 /help 在非全屏模式下于小终端渲染出损坏的标签页标题且每页只显示一个命令的问题
  • 修复了 shell 快照丢失以单个下划线开头的用户函数，导致引用它们的别名失效的问题
  • 修复了在 tools: frontmatter 中声明多个 Agent(...) 类型的插件 agent 只保留最后一个的问题
  • 修复了像 PowerShell(git push*) 这样的 hook if 条件从未匹配的问题——只有 PowerShell(*) 生效
  • 修复了 PowerShell 工具丢弃依赖默认格式化程序的命令的输出
  • 修复了在 Windows 上，对于 PowerShell 脚本调用的“是，并且不再询问”现在会写入一条在后续运行中实际匹配的规则
  • 修复了通过 winget 或 Microsoft Store 安装 pwsh 时 PowerShell 工具在 Windows 上以退出码 1 失败的问题
  • 修复了 /effort 打开时滑块处于错误级别的问题——现在从当前的 effort 级别开始
  • 修复了分页 MCP 服务器丢弃第 1 页之后的资源、模板和提示的问题
  • 修复了在 Windows Terminal 上 Claude 流式传输时附加的后台会话全屏闪烁的问题
  • 修复了在 Windows 上，删除后台任务工作树不再跟随 NTFS 接合点进入主仓库的问题
  • 修复了 /background 拒绝仅输入了技能或自定义斜杠命令的会话的问题
  • 修复了当用户或技能显式依赖 AskUserQuestion 时自动模式抑制了该问题；自动模式分类器现在将用户的答案视为意图信号
  • 修复了 /theme “新建自定义主题”和颜色编辑器对话框不响应 Esc 的问题
  • 修复了通过 Agent SDK 运行时流式会话结束时未捕获的异常
  • 修复了 Windows 上等待滚动稳定时的罕见挂起问题
  • 修复了 Windows 上后台会话结果包含宽字符（CJK）时 agent 视图列表中的重复行和陈旧行问题
  • 修复了粘贴的文本以不可读的 [Pasted text #N] 占位符传递给 agent 而非实际内容的问题
  • 修复了当插件的 manifest 列出与其默认目录重叠的路径时，claude plugin details 和 /plugin 中插件组件计数加倍的问题
  • 修复了后台会话在你已经以“不再询问”授权工具权限后重新提示的问题
  • 修复了 GNOME 终端右键和中键粘贴不插入文本的问题
  • 修复了 CLAUDE_CODE_SUBAGENT_MODEL 不适用于 agent teams 生成的队友进程的问题
  • 修复了斜杠命令后跟 Tab 或换行符被视为未知命令的问题
  • 修复了 /plugin、/status、/mobile、/sandbox 和 /permissions 菜单中的若干间距和布局问题
  • 修复了移除图片后模型反复重新读取不再存在的媒体的问题

2.1.145 – 2026年5月19日

  • 新增 claude agents --json 用于以 JSON 格式列出实时 Claude 会话，便于脚本处理（tmux-resurrect、状态栏、会话选择器）
  • 新增 claude_code.tool OTEL span 的 agent_id 和 parent_agent_id 属性，并修复了跟踪父子关系，使得后台子 agent span 正确嵌套在调度 Agent 工具 span 之下
  • 状态行 JSON 输入现在在检测到 GitHub 仓库和 PR 信息时包含它们
  • /plugin 的发现和浏览页面现在在安装前显示插件的命令、agent、技能、hooks 和 MCP/LSP 服务器
  • claude agents 终端标签页标题现在显示等待输入的数量，以便在 alt-tab 切换窗口时告诉你哪个 agent 需要关注
  • 斜杠命令和 @ 提及建议列表现在支持全屏模式下的鼠标悬停和点击
  • Stop 和 SubagentStop hook 输入现在包含 background_tasks 和 session_crons 字段
  • 修复了 Bash 命令中对非允许列表环境变量的裸变量赋值被自动批准，从而绕过权限提示的问题
  • 修复了 MCP 提示斜杠命令在缺少必需参数时显示原始服务器验证错误——现在错误会命名缺失的参数并显示预期用法
  • 修复了终端大小调整或重新聚焦后，微调器和经过时间显示冻结直到按键的问题
  • 修复了跨项目恢复提示在默认 Windows PowerShell 5.1 中失败的问题——现在 Windows 使用 ; 作为命令分隔符
  • 修复了语音按键通话在 agent 视图的回复窗格中不起作用的问题
  • 修复了同时创建多个任务时任务列表渲染顺序随机的问题
  • 修复了市场已安装时仍显示陈旧的“安装 Anthropic 市场失败”横幅的问题
  • 修复了在会话中运行 gh pr create 和其他 PR 状态更改命令后页脚中的 PR 徽章未立即更新的问题
  • 修复了包含非 ASCII 名称的 Agent Teams 队友因无效的标头编码而导致每次 API 调用失败的问题
  • 修复了 /review 使用已弃用的 projectCards GraphQL 查询，在包含经典项目的仓库上出错的问题
  • 修复了 claude plugin validate 未标记指向文件而非目录的 skills: 条目——现在错误会建议父目录
  • 修复了使用 context: fork 的技能可能反复调用自身而非运行，导致无限循环的问题
  • 改进了 Read 工具，当整个文件读取超过令牌限制时返回截断的第一页和“PARTIAL 视图”提示，而不是硬错误

2.1.144 – 2026年5月19日

  • 新增了对后台会话的 /resume 支持——通过 claude --bg 或 agent 视图启动的会话现在与交互式会话一起出现，标记为 bg
  • 后台子 agent 完成通知现在包含经过的持续时间（例如“Agent completed · 3h 2m 5s”）
  • /plugin 浏览和发现窗格现在显示插件上次更新时间
  • /model 现在仅更改当前会话的模型；在模型选择器中按 d 可为新会话设置默认模型
  • 将“extra usage”重命名为“usage credits”；/extra-usage 现在是 /usage-credits（旧名称仍然有效）
  • 修复了当 api.anthropic.com 不可达（强制门户、防火墙、VPN 问题）时启动挂起最多 75 秒的问题——侧信道 API 调用现在超时时间为 15 秒
  • 修复了错过的窗口大小调整事件（例如拖动 VS Code 分割窗格分隔符）后终端输出乱码的问题——现在在下一帧自行恢复，无需 Ctrl+L
  • 修复了在非常长的会话中可能出现的渐进式终端显示损坏（陈旧/乱码字形），仅通过终端大小调整或重启清除的问题
  • 通过减少旋转动画颜色数来减少 VS Code 中的终端渲染故障
  • 修复了当项目位于受“完全磁盘访问”保护的文件夹下时 macOS 后台会话崩溃并显示“exit 1 before init”的问题（2.1.143 引入的回归）
  • 修复了读取文件时其图片扩展名与内容不匹配（例如 HTML 保存为 .png）导致无法恢复的对话——现在回退为文本
  • 搜索期间的杂散工具错误更少：head/tail 文件视图现在满足编辑前读取检查，并且来自 egrep、fgrep、git grep 或 git diff 的“无匹配”结果（退出码 1）不再报告为命令失败
  • 修复了进入工作树或某些后台会话后 /branch 失败并显示“No conversation to branch”的问题
  • 修复了在 AskUserQuestion 笔记字段中按 Escape 会中止当前轮次而非返回答案选择的问题
  • 修复了通过 IDE 模型选择器或 applyFlagSettings 启动后更改模型选择不生效的问题
  • 恢复的会话现在保留它们使用的模型，而不是拾取另一个会话的 /model 选择
  • 修复了 Bedrock 和 Vertex 用户无法从 /model 选择器中选择“Opus (1M context)”的问题（2.1.129 引入的回归）
  • 修复了设置了 forceLoginMethod 和 forceLoginOrgUUID 的用户远程会话登录失败并显示“Can’t access this organization”的问题
  • 修复了具有分页 tools/list 响应的 MCP 服务器仅返回第一页，静默丢弃工具的问题
  • 修复了具有不受支持的 MIME 类型（例如 SVG）的 MCP 图片破坏对话的问题——现在保存到磁盘并在工具结果中引用
  • 修复了当构建在技能目录内运行时文件描述符耗尽的问题——非 .md 文件不再触发技能重新加载
  • 修复了会话来标题由插件监视器输出而非用户的第一个提示生成的问题
  • 修复了无头模式下 Skill 工具因权限错误失败的问题（2.1.141 引入的回归）
  • 修复了在全新机器上首次加载后，你自己设置中启用的插件显示“not cached”错误的问题；仅由项目的 .claude/settings.json 启用的插件现在显示可操作的 claude plugin install 提示
  • 修复了当 .mcp.json 无法解析（例如使用 VS Code 的 "servers" 键而非 "mcpServers"）时 claude mcp list 静默报告没有服务器的问题——现在显示配置错误
  • 修复了自定义 ANTHROPIC_BASE_URL 设置和 Bedrock Mantle 上的后台侧查询未使用 Haiku 的问题——现在当配置了第一方 API 密钥或未设置 Haiku 模型时正确回退
  • 修复了 Windows 上附加后台会话中的滚动问题——PgUp/PgDn、鼠标滚轮和 Ctrl+O 转录导航现在可以工作
  • 修复了附加到后台会话时关闭终端的崩溃问题
  • 修复了 Windows 上在 claude agents 中按 ← 键导致列表对键盘输入无响应的问题
  • 修复了 Windows Terminal 中具有 CJK 内容的 Agent View 切换窗格时左侧边缘出现鬼字符的问题
  • /bg 和 ← 分离现在保留通过 /add-dir 添加的目录
  • 修复了分离已在原地编辑的会话后 Edit/Write 立即拒绝并显示“background session hasn’t isolated its changes yet”的问题
  • 修复了在已停止的后台会话上运行 claude respawn <id> 显示“stopped”而非运行的问题
  • 修复了 /resume 选择器不显示从后台会话分支的会话的问题
  • 修复了从 claude agents 打开会话或运行 claude logs <id> 在后台服务无响应时挂起的问题——现在超时 10 秒并显示恢复提示
  • 修复了子 agent 生成的后台 Bash 任务在进程退出后仍在 SDK 任务面板中显示“Running”的问题
  • 修复了已完成或已停止的后台会话短暂无法唤醒后被永久标记为启动崩溃的问题
  • 修复了 claude agents 附加会话中的 Markdown 链接以纯文本而非可点击超链接渲染的问题
  • 修复了自定义 spinnerVerbs 应用于回合后持续时间消息的问题——那里恢复了，如“Worked for 5s”等过去时内置短语
  • claude agents / --bg 拒绝消息现在会指明具体的门控因素（非 TTY、环境变量或设置），而不是通用消息
  • claude --bg --name <label> 现在在后置生成确认中显示名称
  • claude agents：使用 Ctrl+R 重命名后台会话现在会立即更新附加会话的横幅
  • 后台会话工作树隔离保护现在适用于配置了 WorktreeCreate hook 的非 git VCS 用户
  • 插件市场添加/更新现在尊重 CLAUDE_CODE_PLUGIN_PREFER_HTTPS
  • /plugin 现在在启用、禁用或卸载插件后返回到已安装列表
  • /doctor 现在在命令 hook 缺少 command 字段时显示 exec 格式示例
  • 技能列表截断不再作为启动通知显示——运行 /doctor 查看完整分解
  • 改进了从罕见的响应前流暂停中恢复的能力——现在重试流一次，而不是回退到较慢的非流式请求
  • 改进了 SDK/无头 MCP 启动：预等待现在与启动重叠，而不是在第一次轮次前阻塞（使用慢 MCP 服务器时最多快 2 秒）
  • 调查后跟进提示现在在每个不忽略的调查响应后出现，带有上下文感知的文案，使用户更容易通过 /feedback 分享更多细节

2.1.143 – 2026年5月15日

  • 新增插件依赖强制执行：claude plugin disable 现在在另一个启用的插件依赖于目标时拒绝（带有可复制粘贴的禁用链提示），claude plugin enable 强制启用传递依赖
  • 新增 /plugin 市场浏览窗格的预计上下文成本（每轮和每次调用的令牌估算）
  • 新增 worktree.bgIsolation: "none" 设置，允许后台会话直接编辑工作副本，无需 EnterWorktree，适用于工作树不实用的仓库
  • PowerShell 工具现在传递 -ExecutionPolicy Bypass。通过 CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1 选择退出
  • 后台会话现在保留你从空闲唤醒后设置的模型和努力级别
  • 在附加的 agent 会话中，Shift+Tab 现在包括自动模式在循环中
  • 修复了损坏的 .credentials.json（具有非数组的 scopes 值）导致 CLI 启动挂起或静默中止 OAuth 令牌刷新的问题
  • 修复了 claude agents 在 Windows Terminal 和 WSL 中的右键粘贴问题
  • 修复了反复阻止的停止 hook 无限循环——现在在 8 次连续阻止后回合结束并显示警告（通过 CLAUDE_CODE_STOP_HOOK_BLOCK_CAP 覆盖）
  • 修复了当 Claude 在迭代之间空闲时，Esc/Ctrl+C 无法取消待定的 /loop 唤醒的问题
  • 修复了后台 shell 或委托的子 agent 仍在运行时 /goal 评估器触发的问题
  • 修复了 NO_COLOR/FORCE_COLOR 在 settings.json env 中剥离 Claude Code 自身 UI 颜色的问题——现在它们仅应用于子进程
  • 修复了在 Windows 上列出会话时 agent 视图生成重复 PowerShell 进程的问题
  • 修复了 /bg 不带提示向分支会话发送“continue”的问题——分支现在等待输入
  • 修复了 --agent <name> 在没有 plugin: 前缀时找不到插件贡献的 agent 的问题
  • 修复了从 agent 视图删除会话不删除其转录文件的问题
  • 修复了 Windows Terminal 中附加后台会话滚动时的陈旧片段渲染问题
  • 修复了主机睡眠或 macOS App Nap 后后台 agent 假阳性工作器停滞检测风暴的问题
  • 修复了 5xx 错误消息指向 status.claude.com 而非命名配置的网关或云提供商的问题
  • PowerShell 工具现在默认在 Windows 上为 Bedrock、Vertex 和 Foundry 用户启用。通过 CLAUDE_CODE_USE_POWERSHELL_TOOL=0 选择退出
  • claude agents 现在接受 --add-dir、--settings、--mcp-config 和 --plugin-dir 并将它们应用于仪表板和从它分派的后台会话
  • claude agents 接受 --permission-mode、--model、--effort 和 --dangerously-skip-permissions 为从视图分派的会话设置默认值
  • claude --bg --dangerously-skip-permissions 现在在退役→唤醒之间持久化
  • 修复了后台会话静默捕获 IDE 文件引用到热备用输入中，导致引用被前置到从 claude agents 分派的下一个提示的问题
  • 工作树清理在 git worktree remove 失败时不再回退到 rm -rf，防止丢失 gitignored 或进行中的文件
  • 修复了 macOS 上后台任务会话读取 ~/Documents、~/Desktop 或 ~/Downloads 下的文件时出现“Operation not permitted”错误的问题，即使已授予完全磁盘访问权限
  • /bg 现在保留 --mcp-config、--settings、--add-dir、--plugin-dir 和 --strict-mcp-config，因此后台会话在重新生成后保持其 MCP 服务器和设置
  • 从 claude agents 启动的后台会话现在遵循 settings.json 中的 permissions.defaultMode（之前被覆盖为自动模式）
  • 修复了在 Windows 上，当响应流式传输时在 claude agents 中按 ← 可能导致 agent 列表对所有输入无响应的问题
  • /bg 和 ← 分离现在保留 --fallback-model，因此后台工作器在过载时退回到后备模型而不是硬失败
  • /bg 和 ← 分离现在保留 --allow-dangerously-skip-permissions，因此分支工作器在其 Shift+Tab 循环中保持绕过权限可用
  • 修复了当 ~/.local/bin/claude 启动器缺失或不可执行时后台守护进程生成回退到运行中二进制文件的问题
  • 修复了 claude agents --allow-dangerously-skip-permissions 默认将分派会话设为绕过模式而非使其在权限循环中可用的问题

2.1.142 – 2026年5月14日

  • 新增 claude agents 标志：--add-dir、--settings、--mcp-config、--plugin-dir、--permission-mode、--model、--effort 和 --dangerously-skip-permissions 用于配置分派的后台会话
  • 快速模式现在默认使用 Opus 4.7（以前是 Opus 4.6）。设置 CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 将快速模式固定为 Opus 4.6
  • 具有根级别 SKILL.md 且没有 skills/ 子目录的插件现在作为技能显示
  • /plugin 详细信息窗格和 claude plugin details 现在显示插件提供的 LSP 服务器
  • /web-setup 在替换现有 GitHub App 连接之前会发出警告
  • 修复了 MCP_TOOL_TIMEOUT 未提高远程 HTTP 和 SSE MCP 服务器的每次请求获取超时的问题，无论配置值如何，工具调用都限制在 60 秒
  • 修复了后台会话无法识别预先存在的 git 工作树，在 EnterWorktree 拒绝创建重复项时阻止编辑的问题
  • 修复了 macOS 睡眠/唤醒后后台会话消失且守护进程重新连接失败的问题——守护进程现在检测时钟跳变而不是将其视为经过的空闲时间
  • 修复了二进制文件升级后守护进程未干净退出的问题（例如 brew upgrade），导致分派的 agent 在已删除路径上崩溃循环
  • 修复了当 Claude-in-Chrome 扩展连接但没有共享标签页时后台 agent 崩溃循环的问题
  • 修复了在附加的 claude agents 会话中点击链接的问题——后台工作器的无头浏览器 shim 在附加时不再应用
  • 修复了 claude agents 的“v 在编辑器中打开”使用守护进程的默认编辑器而不是你的 shell 的 $EDITOR/$VISUAL 的问题
  • 修复了带有网络驱动器工作目录的 Windows 上 claude agents 死锁的问题；启动期间 Ctrl+C 现在可以工作
  • 修复了从 Apple Terminal 或其他仅 256 色终端附加到 claude agents 会话时背景色渗出的问题
  • 修复了 claude --bg --dangerously-skip-permissions 在退役/唤醒之间不持久的问题
  • 修复了当第一条消息是链接时会话标题从 URL 派生的问题
  • 修复了远程客户端冗余的 set_model 请求在转录中注入重复 /model 面包屑的问题
  • 修复了使用 skills: ["./"] 的插件显示错误的“路径超出插件目录”错误的问题
  • 修复了在没有安装元数据时插件缓存清理删除活动插件版本目录的问题
  • 修复了 /plugin 浏览窗格对新发布的插件显示“0 installs”的问题
  • 修复了插件公告未命名每个覆盖默认文件夹的 plugin.json 键的问题
  • 改进了反应式压缩：第一次摘要尝试现在从原始请求的溢出大小种子开始，避免了浪费接近满上下文的重试
  • 改进了 hook 配置错误：为 SessionStart/Setup/SubagentStart 配置提示类型或 agent 类型的 hook 现在显示清晰的“改用命令类型 hook”错误
  • 移除了使用策略拒绝消息中的陈旧 /model claude-sonnet-4-20250514 建议

2.1.141 – 2026年5月13日

  • 新增 hook JSON 输出的 terminalSequence 字段，使 hook 可以在没有控制终端的情况下发出桌面通知、窗口标题和铃声
  • 新增 CLAUDE_CODE_PLUGIN_PREFER_HTTPS 用于通过 HTTPS 而非 SSH 克隆 GitHub 插件源，适用于没有 GitHub SSH 密钥的环境
  • 新增 ANTHROPIC_WORKSPACE_ID 环境变量用于工作负载身份联合——当联合规则覆盖多个工作区时，将颁发的令牌限定到特定工作区
  • 新增 claude agents --cwd <path> 将会话列表限定到目录
  • /feedback 现在可以包括最近的会话（最近 24 小时或 7 天），用于涉及当前会话的问题
  • 回退菜单：新增“Summarize up to here”以压缩早期上下文同时保持最近轮次完整
  • 自动模式权限对话框现在解释 permissions.ask 规则导致提示的原因
  • 在 IDE 连接时恢复了文件编辑权限提示上的“在 IDE 中查看 diff”选项
  • 通过 /bg 或 ←← 启动的后台 agent 现在保留当前权限模式而不是恢复为默认
  • claude agents：完成工作但留下后台 shell 运行的 agent 现在移至“已完成”而非停留在“工作中”
  • 改进了长时间思考期间的旋转反馈——10 秒后旋转器变为琥珀色以表示 Claude 仍在工作
  • 改进了插件菜单导航：→/Tab 切换标签页，↑ 移动到标签条，全屏模式下标签页标题和搜索框可点击
  • 修复了在 Bedrock/Vertex/Foundry/gateway 上未设置 ANTHROPIC_SMALL_FAST_MODEL 覆盖时后台侧查询发送不可用的 Haiku 模型 ID 的问题——现在回退到主循环模型
  • 修复了 Windows 上守护进程管道密钥文件被锁定或不可读时 claude daemon status 和 /doctor 抛出异常的问题——现在显示底层错误而非不透明的失败
  • 修复了通过添加标志的包装器启动时 claude agents 显示 agent 类型列表而非仪表板的问题
  • 修复了当工作目录被删除时 claude agents 打开崩溃的会话会触发冗余分派的问题
  • 修复了自定义 ANTHROPIC_BASE_URL 网关上的后台作业未自动命名的问题——现在在没有配置 Haiku 模型时使用主模型命名
  • 修复了一个会话中的 /model 静默更改其他并发会话的自动压缩阈值的问题
  • 修复了在工具权限提示打开时切换权限模式，当新设置允许该工具时未自动关闭提示的问题
  • 修复了在权限/对话框提示打开时按 Enter 也会在输入框中提交文本的问题
  • 修复了在 EnterWorktree 切换工作目录后 hook 接收到不存在的 transcript_path 的问题
  • 修复了单元格换行的 Markdown 表格回退到垂直键值布局而不是渲染为边框网格的问题（2.1.136 引入的回归）
  • 修复了取消的提示在自动恢复到输入框时被从键盘历史中移除，避免重复条目的问题
  • 修复了在收到任何响应之前使用 Ctrl+C/Esc 取消的提示从键盘历史中删除的问题
  • 修复了在 vim INSERT/VISUAL 模式下 Ctrl+C 不中断正在运行的轮次的问题
  • 修复了当 enter 被重新绑定到 chat:newline 时替代 chat:submit 键绑定（例如 meta+enter、ctrl+enter）不工作的问题
  • 修复了配置输出样式时提示建议被静默禁用的问题
  • 修复了 spinnerVerbs 设置不在轮次完成消息中生效的问题
  • 修复了 AskUserQuestion 弹出窗口隐藏前面聊天内容的最后一行的问题
  • 修复了 Web 搜索状态在搜索返回错误时显示“Did 0 searches”的问题
  • 修复了当任何行超过终端宽度时多行状态行输出丢失或损坏行的问题
  • 修复了 light-ansi 主题在浅色背景上对 diff 上下文行使用不可见的白色的问题——现在使用黑色
  • 修复了错误覆盖层转储了最小化包源代码，隐藏了原始错误消息的问题
  • 修复了输入反馈调查评分数字后按 Enter 将其作为聊天消息提交而非评分的问题
  • 修复了在 agent 面板上对选定的子 agent 按 x 会输入到提示中而不是停止该 agent 的问题
  • 修复了在用户第一个提示之前会话来标题从插件监视器通知派生的问题
  • 修复了“由 PermissionRequest hook 允许”在折叠的读/搜索组下每个工具调用重复一次的问题
  • 修复了 /tui 静默丢弃运行中的后台 shell 和子 agent 的问题——现在拒绝并要求等待它们完成
  • 修复了欢迎横幅在 Bedrock、Vertex、Foundry 和其他第三方提供商上显示“API Usage Billing”的问题——现在显示提供商名称
  • 修复了 /mcp 服务器列表在全屏模式下短终端上未将聚焦的服务器保持可见的问题
  • 修复了 /feedback 包中的编辑为包含会话 ID 等引用值生成无效 JSON 的问题
  • 修复了桌面和第三方提供商会话错误地从主机托管设置继承 apiKeyHelper/ANTHROPIC_AUTH_TOKEN 的问题
  • 修复了在记录器初始化之前触发时早期分析事件被静默丢弃的问题
  • 修复了当市场的 ref 上游不再存在且同时固定了 sha 时 claude plugin install 失败的问题
  • 修复了插件详细信息窗格对通过 .mcp.json 声明 MCP 服务器的插件显示 0 个 MCP 服务器的问题
  • 修复了具有未设置配置变量的插件 MCP 服务器显示通用连接失败而不是带有修复提示的“配置问题”消息的问题；格式错误的 .mcp.json 条目不再导致其他 MCP 服务器丢失
  • 修复了使用 POSIX shell 参数扩展（例如 ${var%pattern}）的 MCP 服务器配置被错误标记为缺少环境变量的问题
  • 修复了返回 403 的 MCP HTTP/SSE 服务器连接显示为“failed”而非“needs auth”的问题
  • 修复了可选的服务器事件流未能重新连接时远程 MCP 服务器不必要断开连接的问题——工具调用继续通过 POST
  • 修复了 worker 会话令牌在会话中轮转时所有远程控制 MCP 连接器以 401 失败的问题
  • 修复了远程控制在服务器拒绝陈旧令牌时自动重新注册受信任设备，而不是循环通过 /login 的问题
  • 修复了在 SDK/无头模式下启用 beta 跟踪时早期 OTel span 可能被静默丢弃的竞争条件
  • 修复了自定义 voice:pushToTalk 键绑定和 "space": null 解绑被静默忽略的问题
  • 修复了 Windows Alt+V 图片粘贴在剪贴板包含截图时报告“未找到图片”的问题
  • 修复了同时安装了 glibc 和 musl 平台包时 Linux 上的 SDK“Claude Code 原生二进制未找到”错误
  • Bedrock：awsCredentialExport 现在始终在配置时运行，而不是在环境 AWS 凭证解析时跳过，修复了跨账户访问的认证问题
  • [VSCode] 修复了聊天中麦克风在没有产生音频时没有反馈的问题——现在显示“未检测到音频”
  • [VSCode] 语音模式：WSL 错误现在建议为 WSLg 用户安装 sox libsox-fmt-pulse
  • claude agents：当预热的后台工作器不健康时启动会话不再失败——现在回退到全新启动
  • claude agents 不再显示后台新 REPL 留下的空白占位符会话，并在通过 ← 进入时在没有其他 agent 时显示入门文本
  • 从 ← 留下的空白空闲后台会话现在在 5 分钟后由守护进程自动退役

2.1.140 – 2026年5月12日

  • 改进了 Agent 工具 subagent_type 匹配，接受大小写和分隔符不敏感的值（例如 "Code Reviewer" 解析为 code-reviewer）
  • 更新了 agent 颜色调色板
  • 修复了设置 disableAllHooks 或 allowManagedHooksOnly 时 /goal 静默挂起的问题——现在显示清晰的消息而不是永不解析的指示器
  • 修复了设置热重新加载中的一个回归，其中符号链接的设置文件导致误归因的更改事件和杂散的 ConfigChange hook
  • 修复了后台服务即将空闲退出时 claude --bg 失败并显示“connection dropped mid-request”的问题
  • 修复了具有企业端点安全性的机器上后台服务启动失败的问题——允许更多时间
  • 修复了远程托管设置未在 401 上重试的问题——现在使用强制刷新的令牌重试一次
  • 修复了托管 extraKnownMarketplaces 自动更新策略未持久化到 known_marketplaces.json 的问题
  • 修复了 /loop 调度冗余唤醒以轮询已完成通知的后台任务的问题
  • 修复了 Windows 上缺少可执行文件（例如 gh）导致每次检查同步 where.exe 重新生成时事件循环反复停滞的回归
  • 修复了当 offset 作为空白填充或 + 前缀字符串传递时 Read 工具调用验证失败的问题
  • 修复了终端失去焦点时原生终端光标未保持在输入插入符号处的问题
  • 插件现在在默认组件文件夹（例如 commands/）因 plugin.json 设置了匹配键而被静默忽略时会发出警告。在 /doctor、claude plugin list 和 /plugin 中显示

2.1.139 – 2026年5月11日

  • 新增 agent 视图（研究预览）：所有 Claude Code 会话的单一列表——正在运行、等待你或已完成。运行 claude agents 开始。参见 https://code.claude.com/docs/en/agent-view
  • 新增 /goal 命令：设置完成条件，Claude 跨轮次一直工作直到满足。在交互式、-p 和 Remote Control 中工作。显示实时经过时间/轮次/令牌作为覆盖面板
  • 新增 /scroll-speed 命令，用于调整鼠标滚轮滚动速度，带有实时预览
  • 新增 claude plugin details <name> 以显示插件的组件清单和预计的每会话令牌成本
  • 新增转录视图导航：? 查看键盘快捷键，{/} 在用户提示之间跳转，v 切换快捷键面板
  • 新增 hook args: string[] 字段（exec 形式），直接生成命令而不通过 shell，因此路径占位符从不需引号
  • 新增 hook continueOnBlock 配置选项用于 PostToolUse——设置为 true 可将 hook 的拒绝原因反馈给 Claude 并继续当前轮次
  • MCP stdio 服务器现在在其环境中接收 CLAUDE_PROJECT_DIR，与 hooks 匹配。插件配置可以在命令中引用 ${CLAUDE_PROJECT_DIR}
  • 压缩提示现在要求模型保留敏感的用户指令
  • /mcp 重新连接现在无需重启即可拾取 .mcp.json 编辑，并在重新连接失败时显示 HTTP 状态和 URL
  • /context all 每技能令牌估计现在考虑模型的 tokenizer 并显示四舍五入的值
  • claude plugin install <name>@<marketplace> 现在自动刷新市场并在报告插件未找到之前重试
  • /plugin 已安装插件详细信息现在干净地显示 hook 事件名称和 MCP 服务器名称
  • /context 现在为插件来源的技能显示提供插件的名称
  • 远程 MCP 服务器在瞬态故障上的重新连接重试现在对所有用户启用
  • 来自子 agent 的 API 请求现在携带 x-claude-code-agent-id / x-claude-code-parent-agent-id 标头，并且 claude_code.llm_request OTEL span 包括 agent_id / parent_agent_id 属性
  • 当设置了 ANTHROPIC_API_KEY / apiKeyHelper / ANTHROPIC_AUTH_TOKEN 时，Remote Control、/schedule、claude.ai MCP 连接器和通知首选项现在被禁用，即使也存在 Claude.ai 登录。取消设置 API 密钥以使用这些功能
  • 修复了过期凭证和 forceRemoteSettingsRefresh 策略设置阻塞了 claude auth login/logout/status 且无法恢复的死锁
  • 修复了 autoAllowBashIfSandboxed 未自动批准带有 shell 扩展（如 $VAR 和 $(cmd)）的命令的问题
  • 修复了写入终端的 hook 可能损坏屏幕上交互式提示的错误；hook 现在在没有终端访问的情况下运行
  • 修复了 HTTP/SSE MCP 服务器流式传输非协议数据时无界内存增长的问题——响应体现在每个 SSE 帧上限为 16 MB
  • 修复了 Skill(name *) 权限规则——通配符形式现在作为前缀匹配工作，匹配 Bash(ls *) 行为
  • 修复了设置热重新加载未检测到符号链接的 ~/.claude/settings.json 编辑的问题
  • 修复了当市场键与清单名称不同时插件详情加载失败的问题
  • 修复了 /model 选择器的“Default”行未反映 ANTHROPIC_DEFAULT_OPUS_MODEL/ANTHROPIC_DEFAULT_SONNET_MODEL 覆盖的问题
  • 修复了响应完成后 5 分钟出现虚假的“流空闲超时”问题，原因是看门狗定时器在流取消时未被清除
  • 修复了配置了 10 个以上 MCP 服务器且缓存目录不可写时静默的 exit 1——错误消息现在包含底层原因
  • 修复了对话框中的标签页名称、列表指针和选择行上闪烁的键盘光标
  • 修复了鼠标点击后转录视图字母快捷键不工作的问题
  • 修复了 Bash 模式上箭头历史重复第一个条目并覆盖进行中的草稿的问题
  • 修复了粘贴或拖放多个图像只插入最后一个的问题
  • 修复了深色主题上不可读的深海军蓝超链接问题——它们现在适配活动主题
  • 修复了模型选择器为第三方用户（其模型设置为 opus 别名）显示冗余的“当前模型”行的问题
  • 修复了 PAYG 3P 提供商上的遗留 Opus 选择器条目解析为与默认条目相同的模型的问题
  • 修复了 Cursor 和 VS Code 1.92–1.104 中的鼠标滚轮滚动速度问题；触控板现在以稳定速率滚动，鼠标滚轮每格保持约 3 行
  • 修复了 Windows Terminal 和 VS Code 中附加后台会话时的滚动行为
  • 修复了断开连接的 MCP 服务器的资源在 @server: 自动完成中遗留的问题
  • 修复了两个文件 diff 片段多报告一截断行的问题
  • 修复了 Grep 结果未相对化 Windows 驱动器字母路径，以及计数模式对单一路径报告错误总数的问题
  • 修复了由于视觉单元格宽度计算错误，CJK/emoji 导致边框内文本溢出的问题
  • 修复了模糊匹配高亮拆分 emoji 和星形平面字符对的问题
  • 修复了包含正则表达式元字符的技能参数名称破坏参数替换的问题
  • 修复了 ProgressBar 为几乎满的小数单元格渲染整个块的问题
  • 修复了当最后一个订阅者在获取进行中时离开时任务轮询和 fs.watch 被复活的问题
  • 修复了当清单名称与源标识符不同时插件依赖解析留下陈旧计数的问题
  • 修复了会话具有无法解析的时间戳时 Insights 昼夜时间图表倾斜的问题
  • 修复了仅使用 cmd/super/win 修饰符的键绑定被标记为不可解析的问题
  • 修复了 claude_code.active_time.total OpenTelemetry 度量未在 --print 模式中发射的问题
  • 修复了 claude plugin update 未保留市场内跨插件符号链接的问题
  • [VSCode] 按 Cmd/Ctrl+Shift+T 重新打开最近关闭的会话标签页，可通过 claudeCode.enableReopenClosedSessionShortcut 配置

2.1.138 – 2026年5月9日

  • 内部修复

2.1.137 – 2026年5月9日

  • [VSCode] 修复了扩展在 Windows 上无法激活的问题

2.1.136 – 2026年5月8日

  • 新增 CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL 以重新为企业用户启用通过 OpenTelemetry 捕获响应的会话质量调查
  • 新增 settings.autoMode.hard_deny 用于自动模式分类器规则，无论用户意图或允许异常如何都无条件阻止
  • 修复了在 .mcp.json、插件和 claude.ai 连接器中配置的 MCP 服务器在 VS Code 扩展、JetBrains 插件和 Agent SDK 的 /clear 后静默消失的问题
  • 修复了罕见的登录循环，并发凭证写入可能覆盖新轮换的 OAuth 令牌并强制重新登录
  • 修复了多个服务器同时刷新时 MCP OAuth 刷新令牌丢失的问题——拥有多个远程 MCP 服务器的用户现在应该不需要每天重新认证
  • 修复了在工具调用后扩展思考发出已编辑思维块时的 API 错误（400）
  • 修复了当项目路径包含下划线时 --resume / --continue 找不到会话的问题
  • 修复了当匹配的 Edit(...) 允许规则存在时计划模式未阻止文件写入的问题
  • WSL2：当 xclip/wl-paste 无法读取图像数据时，现在通过 PowerShell 回退实现从 Windows 剪贴板粘贴图像
  • 修复了当缓存清理删除仍在运行会话中使用的版本时插件 Stop/UserPromptSubmit hook 失败的问题
  • 改进了跨斜杠命令对话框的视觉一致性：标准化的页脚提示、对话框间距和箭头键样式，对话框框架现在在加载期间立即出现而不是弹出
  • 修复了 bash 命令输出和 markdown 代码块中颜色出现在错误位置的问题
  • 修复了 ReasonML diff 在单词 diff 边界处渲染损坏的“undefined”文本伪影的问题
  • 修复了工作树退出对话框在删除工作树后警告错误目录中的未提交文件的问题
  • 修复了 @ 文件选择器在小型非 git 目录中没有匹配到会话中创建的文件的问题
  • 修复了 @ 文件选择器在条目超过 100 的目录中找不到文件的问题
  • 修复了全屏模式下输出被截断时失败的工具体调用不可点击展开的问题
  • 修复了在具有持久扩展键模式的终端上使用 Ctrl+G 打开外部编辑器后 Backspace 和 Ctrl+Backspace 交换的问题
  • 修复了 /usage 每周重置显示一天中的时间而非日历日期的问题
  • 修复了欢迎横幅省略号在 CJK 终端上导致列溢出的问题
  • 修复了会话历史包含带有格式错误输入字段的工具体调用时 /insights 崩溃的问题
  • 修复了工具体可折叠性分类在会话中更改时渲染器崩溃的问题
  • 修复了 plugin.json 中的 skills 条目隐藏了插件的默认 skills/ 目录的问题，列出文件路径现在显示错误而不是静默失败
  • 修复了 IDE shell 集成锁文件未尊重 CLAUDE_CONFIG_DIR 的问题
  • 修复了流式传输期间复制的终端输出中的尾部空白
  • 修复了插件卸载和启用/禁用未不区分大小写地匹配 slugs 的问题
  • 修复了工具错误截断标记对代理对字符串显示负计数的问题
  • 修复了来自 CLAUDE_ENV_FILE SessionStart hook 的环境变量在 /resume 或 /clear 后变得陈旧的问题
  • 修复了 /branch 在给定粘贴的多行名称时保存多行会话标题的问题
  • 修复了列边界处换行文本第二行上零散的导空格
  • 修复了 Esc 未关闭 /install-github-app、/desktop、/resume 和 /web-setup 中的对话框的问题
  • 修复了 /doctor MCP 架构错误未命名缺失字段或显示源文件路径的问题
  • 修复了 Bash 权限提示显示内部解析器诊断而非用户可读的说明的问题
  • 修复了带空格的插件斜杠命令（例如 /myplugin review）未解析为其命名空间形式的问题
  • 修复了 AskUserQuestion 在作为数组提供时丢弃多选答案的问题
  • 修复了 /clear <name> 未标记已清除会话以便 /resume 的问题
  • 修复了 CronList 输出缺少限定符和计划提示的问题
  • 修复了全屏模式下“跳到底部”覆盖在 CJK 字符上留下颜色伪影的问题
  • 修复了流式传输时宽 Markdown 表格在终端回滚中留下陈旧边框渲染的问题
  • 修复了当包含粘贴文本占位符的长提示被自动截断时粘贴文本被静默丢弃的问题
  • 修复了 /release-notes 在变更日志刷新失败后卡在旧版本上的问题
  • 修复了当服务器数量超过终端容纳量时 /mcp 服务器列表不滚动的问题
  • 修复了初始斜杠命令后中间输入斜杠命令自动完成不工作的问题
  • 修复了使用 autoScrollEnabled: false 时滚动到底部重新接合自动跟随的问题
  • 修复了提示建议在空输入时被 Enter 自动提交，而不是需要 Tab 或箭头接受的问题
  • 修复了键盘快捷键提示未反映 keybindings.json 中的重新绑定键的问题
  • 修复了 /settings 语言更改在确认后按 Escape 被还原的问题
  • 修复了 /terminal-setup 仅通过精确名称匹配出现在自动完成中而非部分前缀的问题
  • 修复了 AskUserQuestion 对话框上的“聊天关于这个”擦除了问题文本的问题
  • 修复了当服务器返回内容块时 MCP 工具结果不可见的问题
  • 改进了当 --worktree 与现有或陈旧工作树冲突时的错误消息
  • 将插件市场移除键更改为 d（匹配其他地方的删除）而不是与重试冲突的 r

2.1.133 – 2026年5月7日

  • 新增 worktree.baseRef 设置（fresh | head），用于选择 --worktree、EnterWorktree 和 agent 隔离工作树是源自 origin/<default> 还是本地 HEAD。注意： 默认值 fresh 将 EnterWorktree 的基准改回 origin/<default>（自 2.1.128 以来一直是本地 HEAD）——设置 worktree.baseRef: "head" 以在新工作树中保留未推送的提交
  • 新增 sandbox.bwrapPath 和 sandbox.socatPath 托管设置（Linux/WSL），用于指定自定义 bubblewrap 和 socat 二进制位置
  • 新增 parentSettingsBehavior 管理级键（'first-wins' | 'merge'），让管理员让 SDK managedSettings（父级）参与策略合并
  • Hooks 现在通过 effort.level JSON 输入字段和 $CLAUDE_EFFORT 环境变量接收活动的努力级别，Bash 工具命令可以读取 $CLAUDE_EFFORT
  • 改进了焦点模式行为
  • 通过释放内存压力下的热备用后台工作器来改进内存使用
  • 修复了刷新令牌竞争导致共享凭证被清除后所有并行会话以 401 结束的问题
  • 修复了限定在驱动器根目录（C:\）或 POSIX / 的 Edit/Write 允许规则错误匹配并始终提示的问题
  • 修复了由于时钟偏差或慢速磁盘导致历史记录或会话日志文件锁被损坏时的未处理拒绝（ECOMPROMISED）问题
  • 修复了在对话压缩期间按 Esc 显示虚假的“压缩对话时出错”通知的问题
  • 修复了 HTTP(S)_PROXY / NO_PROXY / mTLS 在完整 MCP OAuth 流程（包括发现、动态客户端注册、令牌交换和令牌刷新）中未被尊重的问题
  • 修复了通过 --add-dir / SDK additionalDirectories 传递的映射网络驱动器上的 Read/Write/Edit 被拒绝的问题
  • 修复了来自 claude.ai 的 Remote Control 停止/中断未像本地 Esc 那样完全取消 CLI 会话的问题，导致在中断卡住的工具或提示后排队的消息从未前进
  • 修复了一个会话中的 /effort 意外更改其他并发会话的努力级别的问题，以及 IDE 努力更改可能被静默丢弃的相关问题
  • 修复了子 agent 未通过 Skill 工具发现项目、用户或插件技能的问题
  • claude --help 现在列出 --remote-control 以及 --remote-control-session-name-prefix
  • [VSCode] 修复了当扩展版本未捆绑 Claude 二进制文件时 claudeCode.claudeProcessWrapper 失败并显示“Unsupported platform”的问题

2.1.132 – 2026年5月6日

  • 新增 CLAUDE_CODE_SESSION_ID 环境变量到 Bash 工具子进程环境，与传递给 hooks 的 session_id 匹配
  • 新增 CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 环境变量以选择退出全屏备选屏幕渲染器，将对话保留在终端的原生回滚中
  • 新增“Pasting…”页脚提示，当 Ctrl+V 图片粘贴正在从剪贴板读取时显示
  • 修复了外部 SIGINT（例如 IDE 停止按钮、kill -INT）未运行优雅关闭的问题——现在恢复终端模式并打印 --resume 提示而不是突然退出
  • 修复了在原生构建下关闭终端或 SSH 断开时未捕获的异常
  • 修复了当工具错误截断拆分了 emoji 时 --resume 失败并显示“no low surrogate in string”的问题；预损坏的会话在加载时会清理
  • 修复了 --permission-mode 标志在使用 -p --continue/--resume 恢复计划模式会话时被忽略的问题，以及在同一会话中退出计划模式后计划模式未重新应用的问题
  • 修复了全屏模式在笔记本电脑睡眠/唤醒或 Ctrl+Z/fg 后显示黑屏直到下一个按键或流输出的问题
  • 修复了当 Indic 连字或 ZWJ emoji 跨行换行时光标落在 Grapheme 簇中间（Ctrl+E/A/K/U/箭头键）的问题
  • 修复了 vim 操作符损坏包含分解（NFD）重音字符的文本的问题
  • 修复了以 / 开头的粘贴文本静默吞噬输入或触发未知命令回复的问题
  • 修复了焦点事件或鼠标跟踪报告与括号粘贴交错时粘贴将杂散转义序列转储到提示中的问题
  • 修复了由于上游 xterm.js 错误导致 Cursor 和 VS Code 1.92–1.104 中鼠标滚轮滚动过快的问题
  • 修复了 JetBrains IDE 2025.2 终端中的滚轮处理问题（伪箭头键、方向错误、失控加速）
  • 修复了 Linux/X11 上复制统计截图到剪贴板时 /usage Ctrl+S 挂起的问题
  • 修复了 /terminal-setup 在 Windows Terminal 中显示矛盾错误的问题——那里原生支持 Shift+Enter
  • 修复了 /effort 选择器未反映 CLAUDE_CODE_EFFORT_LEVEL 环境变量覆盖的问题
  • 修复了 /status 为某些用户显示错误的默认模型的问题
  • 修复了斜杠命令自动完成弹出窗口上限约为 3–5 个可见命令而非根据终端高度缩放的问题
  • 修复了状态行 context_window 令牌计数反映累积会话总数而非当前上下文使用量的问题
  • 修复了 Alt+T（思考切换）在未启用“Option as Meta”的 macOS 终端（iTerm2、Terminal.app 默认值）上不工作的问题
  • 修复了在 Windows 上从 claude agents 重新打开后台会话后键盘输入死锁的问题
  • 修复了 stdio MCP 服务器将非协议数据写入 stdout 时无界内存增长（10GB+ RSS）的问题
  • 修复了连接但 tools/list 失败的 MCP 服务器静默显示 0 个工具的问题——现在重试一次并在 /mcp 中显示“connected · tools fetch failed”
  • 修复了未经授权的 claude.ai MCP 连接器显示为“failed”而非“needs auth”，以及无头 -p 模式重试非瞬态 4xx 连接失败的问题
  • 改进了斜杠命令对话框和 /login、/upgrade、/extra-usage 对话框间距的视觉一致性
  • 更新了 /tui fullscreen 启动横幅以描述其他渲染器优势（更低内存使用、鼠标支持、选择时自动复制）
  • 修复了设置 ENABLE_PROMPT_CACHING_1H 时的 Bedrock 和 Vertex 400 错误

2.1.131 – 2026年5月6日

  • 修复了 VS Code 扩展在 Windows 上因捆绑 SDK 中的硬编码构建路径而无法激活的问题（createRequire polyfill bug）
  • 修复了 Mantle 端点认证因缺少 x-api-key 标头而失败的问题

2.1.129 – 2026年5月6日

  • 新增 --plugin-url <url> 标志，从 URL 获取插件 .zip 存档用于当前会话
  • 新增 CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 环境变量，在自动检测失败的终端（例如 Emacs eat）上强制启用同步输出
  • 新增 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE：当在 Homebrew 或 WinGet 安装上设置时，Claude Code 在后台运行升级命令并提示重启
  • 插件清单：themes 和 monitors 现在应在 "experimental": { ... } 下声明。顶层声明仍然有效，但 claude plugin validate 会警告
  • 网关 /v1/models 发现用于 /model 选择器现在通过 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 选择加入（在 2.1.126–2.1.128 中是自动的）
  • Ctrl+R 历史选择器现在默认为搜索所有项目中的所有提示，匹配 2.1.124 之前的行为。按 Ctrl+S 缩小到当前项目或会话
  • 第三方部署（Bedrock、Vertex、Foundry 或 ANTHROPIC_BASE_URL 网关）不再看到指向第一方 Anthropic 表面的旋转提示
  • skillOverrides 设置现在起作用：off 隐藏模型和 /，user-invocable-only 仅隐藏模型，name-only 折叠描述
  • claude_code.pull_request.count OTel 度量现在计算通过 MCP 工具创建的 PR/MR，而不仅仅是 shell 命令
  • 策略拒绝错误消息现在包括 API 请求 ID 以方便支持调试
  • 修复了无法识别的 400 状态码的 API 错误显示原始 JSON 而非底层错误消息的问题
  • 修复了 /clear 在对话后未重置终端标签页标题的问题
  • 修复了权限或其他对话框活动时 /rename 的会话标题标签消失的问题
  • 修复了子 agent 运行时提示下方的 agent 面板被隐藏的问题（2.1.122 引入的回归）
  • 修复了外部编辑器传递（Ctrl+G）空白化提示上方的对话历史的问题
  • 修复了 /context 将其渲染的 ASCII 可视化网格转储到对话中的问题，每次调用浪费约 1.6k 令牌
  • 修复了 /agents 库列表的箭头键导航：突出显示的 agent 在列表超出视口时现在保持可见
  • 修复了 /branch 成功消息不包括新分支的会话 ID 以便 /resume 的问题
  • 修复了全屏模式下带有键帽/ZWJ/肤色 emoji 的粗体标题丢失尾部字符的问题
  • 修复了服务器管理的设置策略未应用于其存储的 OAuth 凭证缺少 user:inference 范围的 Enterprise/Team 用户的问题
  • 修复了从睡眠唤醒后的 OAuth 刷新竞争，可能注销所有正在运行的会话
  • 修复了 1 小时提示缓存 TTL 被静默降级为 5 分钟的问题
  • 修复了更改 /effort 或 /model 后 /clear 或压缩后缓存未命中警告虚假出现的问题
  • 修复了 Bash(mkdir *)、Bash(touch *) 和类似的允许规则未对项目内路径生效的问题
  • 修复了带有 *:// 方案通配符的 deniedMcpServers 模式不匹配混合大小写主机名的问题
  • 修复了在 --debug 中语音模式期间无害的 WebSocket 警告被记录为错误的问题
  • [VSCode] 修复了 /clear 未清除对话上下文和显示转录的问题

2.1.128 – 2026年5月4日

  • 裸 /color（无参数）现在选择一个随机会话颜色
  • /mcp 现在显示已连接服务器的工具数量，并标记连接但带有 0 个工具的服务器
  • --plugin-dir 现在除了目录外还接受 .zip 插件存档
  • --channels 现在可与控制台（API 密钥）认证一起使用——控制台组织需设置 channelsEnabled: true 以启用
  • 更新了 /model 选择器：折叠了重复的 Opus 4.7 条目，当前 Opus 现在显示为“Opus”而不是“Opus 4.7”
  • 子进程（Bash、hooks、MCP、LSP）不再继承 OTEL_* 环境变量，因此通过 Bash 工具运行的 OTEL 仪器化应用不再拾取 CLI 自身的 OTLP 端点
  • MCP：workspace 现在是保留服务器名称——具有该名称的现有服务器将跳过并发出警告
  • 重新连接 MCP 服务器不再用完整工具名称列表淹没对话——重新宣布的工具按服务器前缀汇总
  • SDK 主机现在接收 Bash 权限提示的持久的 localSettings 建议，因此“始终允许”写入 .claude/settings.local.json
  • EnterWorktree 现在从本地 HEAD 创建新分支如文档所述，而不是 origin/<default-branch>——未推送的提交不再丢失
  • 自动模式：当分类器无法评估操作时，错误现在包括提示（重试、/compact 或使用 --debug 运行）
  • 修复了焦点模式在提交新提示时短暂调暗先前响应的问题
  • 修复了在 Kitty 和其他解释 OSC 9 作为通知的终端上每次 /exit 时出现杂散的“4;0;”桌面通知的问题
  • 修复了 Remote Control 在速率限制时显示空的“Opening your options…”消息而不是可操作的升级选项的问题
  • 修复了当图像读取失败时拖放图像上传挂起在“Pasting text…”的问题
  • 修复了通过 stdin 将非常大的输入（>10 MB）管道到 claude -p 时崩溃循环的问题
  • 修复了全屏模式下长 URL 在每个包装行上不单独可点击的问题
  • 修复了 /plugin 组件面板对通过 --plugin-dir 加载的插件显示“Marketplace ‘inline’ not found”的问题
  • 修复了服务器同时返回结构化内容和内容块时 MCP 工具结果丢失图像的问题
  • 修复了列表项内的围栏代码块在复制粘贴时将前导空白带入剪贴板的问题
  • 修复了 /config 中的标签导航失去焦点的问题——标签头现在保持聚焦，因此箭头和 Esc 继续工作
  • 修复了在不支持 OSC 8 超链接的终端上 Markdown 链接标签丢失的问题——链接现在渲染为 label (url) 而不是只有 URL
  • 修复了 1M 上下文模型上具有较小自动压缩窗口的会话被错误地阻止为“Prompt is too long”的问题，在达到实际 API 限制之前
  • 修复了并行 shell 工具调用：失败的只读命令（grep、git diff、ls）不再取消兄弟调用
  • 修复了不支持努力级别的模型上横幅显示“with X effort”的问题
  • 修复了 3P 提供商的 /fast 模糊匹配到不相关的技能而不是显示“not available”的问题
  • 修复了 Bedrock 默认模型解析为 global.* 而不是区域适当前缀的问题
  • 修复了 vim 模式：NORMAL 模式下 Space 现在将光标向右移动，匹配标准 vi/vim 行为
  • 修复了终端进度指示器（OSC 9;4）在工具调用之间闪烁关闭的问题——现在在整个轮次中保持可见
  • 修复了 /rename 在无参数时在最后一个条目是压缩边界的已恢复会话上失败的问题
  • 修复了在 --resume/--continue 后之前会话的陈旧的“remote-control is active”状态行出现的问题
  • 修复了指向已删除缓存目录的陈旧 installed_plugins.json 条目污染 PATH 的问题
  • 修复了当 CLAUDE_CODE_SHELL_PREFIX 已设置且参数包含空格或 shell 元字符时 MCP stdio 服务器接收损坏的参数的问题
  • 修复了子 agent 进度摘要缺少提示缓存（约缓存创建减少 3 倍）的问题
  • 修复了 /plugin update 从未检测到 npm 来源插件的新版本的问题
  • 修复了子 agent 转录静态时摘要反复触发的问题，限制空闲子 agent 的最坏情况令牌成本
  • 无头 --output-format stream-json：init.plugin_errors 现在除了依赖降级之外还包括 --plugin-dir 加载失败

2.1.126 – 2026年5月1日

  • /model 选择器现在列出来自网关 /v1/models 端点的模型，当 ANTHROPIC_BASE_URL 指向 Anthropic 兼容网关时
  • 新增 claude project purge [path] 以删除项目的所有 Claude Code 状态（转录、任务、文件历史、配置条目）——支持 --dry-run、-y/--yes、-i/--interactive 和 --all
  • --dangerously-skip-permissions 现在绕过对 .claude/、.git/、.vscode/、shell 配置文件和以前受保护的其他路径的写入提示（灾难性删除命令仍作为安全网提示）
  • claude auth login 现在接受粘贴到终端的 OAuth 代码，当浏览器回调无法到达 localhost 时（WSL2、SSH、容器）
  • claude_code.skill_activated OpenTelemetry 事件现在为用户键入的斜杠命令触发，并携带新的 invocation_trigger 属性（"user-slash"、"claude-proactive" 或 "nested-skill"）
  • 自动模式：当权限检查停滞时，旋转器现在变为红色，而不是看起来像工具在运行
  • 主机托管部署（CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST）不再在 Bedrock/Vertex/Foundry 上自动禁用分析
  • Windows：现在检测到通过 Microsoft Store、不带 PATH 的 MSI 或 .NET global tool 安装的 PowerShell 7
  • Windows：当 PowerShell 工具启用时，Claude 现在将 PowerShell 视为主 shell，而不是默认使用 Bash
  • Read 工具：移除了每个文件的恶意软件评估提醒，该提醒可能导致旧模型上出现虚假拒绝和“这不是恶意软件”评论
  • 安全： 修复了当更高优先级的托管设置来源缺少 sandbox 块时 allowManagedDomainsOnly / allowManagedReadPathsOnly 被忽略的问题
  • 修复了粘贴大于 2000px 的图片破坏会话的问题——图片现在在粘贴时缩小，历史中的过大图片自动移除并重试请求
  • 修复了在“组织不允许 OAuth”错误时显示登录屏幕的问题——现在显示联系管理员的指导
  • 修复了慢速或代理连接、仅 IPv6 开发容器以及浏览器回调无法到达 localhost 时 OAuth 登录超时失败的问题
  • 修复了并发凭证写入可能清除有效 OAuth 刷新令牌的罕见竞争问题
  • 修复了 API 重试倒计时在尝试之间卡在“0s”而不是倒计时的问题
  • 修复了在请求进行中唤醒 Mac 睡眠后的“流空闲超时”错误
  • 修复了后台和远程会话在长模型思考暂停期间错误中止并显示“流空闲超时”的问题
  • 修复了一连串空轮次后助手可以完成思考但不显示任何输出的挂起问题
  • 修复了 Cursor 和 VS Code 1.92–1.104 集成终端中触控板滚动过快的问题
  • 修复了 claude.ai MCP 连接器被卡在需要认证状态的手动服务器抑制的问题
  • 修复了 Windows 上无闪烁模式下日语/韩语/中文文本渲染为乱码的问题
  • 修复了按 Ctrl+L 时清除提示输入的问题——现在只强制屏幕重绘，匹配 readline 行为
  • 修复了延迟工具（WebSearch、WebFetch 等）在具有 context: fork 的技能和其他子 agent 的第一轮中不可用的问题
  • 修复了使用 --channels 启动的交互式会话中计划模式工具不可用的问题
  • 修复了 /plugin 卸载报告“Enabled”而不是“Uninstalled”的问题
  • 当 linter 一次接触许多文件时，限制了文件修改提醒的总大小
  • 修复了 /remote-control 重试看起来卡在“connecting…”上的问题——每次重试现在显示其结果
  • 修复了 Remote Control 失败通知未显示初始连接失败的错误原因的问题
  • Windows：剪贴板写入不再在进程命令行参数中暴露复制的内容，这些参数对 EDR/SIEM 遥测可见；还修复了 >22KB 选择未到达剪贴板的问题
  • PowerShell 工具：裸 --（例如 git diff -- file）不再被错误标记为 --% 停止解析令牌
  • 修复了 Agent SDK 在模型在并行工具体调用批次中发出格式错误的工具名称时挂起的问题

2.1.123 – 2026年4月29日

  • 修复了设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 时 OAuth 认证陷入 401 重试循环的问题

2.1.122 – 2026年4月28日

  • 新增 ANTHROPIC_BEDROCK_SERVICE_TIER 环境变量以选择 Bedrock 服务层级（default、flex 或 priority），作为 X-Amzn-Bedrock-Service-Tier 标头发送
  • 将 PR URL 粘贴到 /resume 搜索框中现在可以找到创建该 PR 的会话（GitHub、GitHub Enterprise、GitLab 和 Bitbucket）
  • /mcp 现在显示被具有相同 URL 的手动添加服务器隐藏的 claude.ai 连接器，并附有删除重复项的提示
  • 澄清了在浏览器登录流程后 MCP 服务器仍未授权时 /mcp 显示的消息
  • OpenTelemetry：api_request/api_error 日志事件上的数字属性现在作为数字发出，而不是字符串
  • OpenTelemetry：新增 claude_code.at_mention 日志事件用于 @ 提及解析
  • 修复了 /branch 产生在源会话包含来自回退时间线的条目时失败并显示“tool_use ids were found without tool_result blocks”的分支的问题
  • 修复了 /model 未为 Bedrock 应用程序推理配置文件 ARN 显示 Effort 选项的问题，以及这些 ARN 未接收 output_config.effort
  • 修复了 Vertex AI / Bedrock 在会话标题生成和其他结构化输出查询中返回 invalid_request_error: output_config: Extra inputs are not permitted 的问题
  • 修复了代理网关后用户 Vertex AI count_tokens 端点返回 400 错误的问题
  • 修复了 spinnerTipsOverride.excludeDefault 未抑制基于时间的旋转提示的问题
  • 修复了 ToolSearch 在非阻塞模式下会话启动后连接 MCP 工具丢失的问题
  • 修复了 bash 模式下的 !exit / !quit 终止 CLI 而不是作为 shell 命令运行的问题
  • 修复了发送到较新模型的图像被调整为每边 2576px 而不是正确的 2000px 最大值的问题
  • 修复了远程控制会话空闲状态每秒重绘两次的问题，可能淹没 tmux -CC 控制管道并暂停终端
  • 修复了由于陈旧视图偏好导致某些会话中助手消息显示为空的问题
  • 修复了 settings.json 中格式错误的 hooks 条目不再使整个文件无效的问题
  • 语音模式：绑定到 Caps Lock 的键绑定现在显示错误，因为终端不将 Caps Lock 作为按键事件传递

2.1.121 – 2026年4月28日

  • 新增 MCP 服务器配置的 alwaysLoad 选项——当为 true 时，该服务器的所有工具跳过工具搜索延迟并始终可用
  • 新增 claude plugin prune 以删除孤立的自动安装插件依赖；plugin uninstall --prune 级联
  • 新增 /skills 的输入过滤搜索框，以便在长列表中查找技能而无需滚动
  • PostToolUse hooks 现在可以通过 hookSpecificOutput.updatedToolOutput 替换所有工具的输出（以前仅 MCP）
  • 全屏模式：在提示中键入不再跳回底部，如果你已滚动读取早期输出
  • 溢出终端的对话框现在可滚动，全屏和非全屏模式下均支持箭头键、PgUp/PgDn、home/end 和鼠标滚轮
  • 全屏模式下点击跨行换行的长 URL 的任意行现在打开完整 URL
  • SDK 和 claude -p：CLAUDE_CODE_FORK_SUBAGENT=1 现在在非交互式会话中工作
  • --dangerously-skip-permissions 不再提示写入 .claude/skills/、.claude/agents/ 和 .claude/commands/
  • /terminal-setup 现在启用 iTerm2 的“Applications in terminal may access clipboard”设置，使 /copy 工作（包括从 tmux）
  • 在启动期间遇到瞬态错误的 MCP 服务器现在自动重试最多 3 次，而不是保持断开连接
  • 终端标签页会话标题现在根据你配置的 language 设置生成
  • 具有相同上游 URL 的 Claude.ai 连接器现在被去重而不是显示为重复项
  • Vertex AI：支持基于 X.509 证书的工作负载身份联合（mTLS ADC）
  • 升级后启动更快：从发行说明闪屏移除了最近活动面板
  • LSP 诊断摘要现在可点击/ctrl+o 展开并显示展开提示
  • SDK：mcp_authenticate 现在支持 redirectUri 用于自定义方案完成和 claude.ai 连接器
  • OpenTelemetry：向 LLM 请求 span 添加了 stop_reason、gen_ai.response.finish_reasons 和 user_system_prompt（通过 OTEL_LOG_USER_PROMPTS 控制）
  • [VSCode] 语音听写现在在未配置 Claude Code 语言时尊重 accessibility.voice.speechLanguage 设置
  • [VSCode] /context 现在打开原生令牌使用对话框
  • 修复了处理许多图像时无界内存增长（多 GB RSS）的问题
  • 修复了具有大型转录历史的机器上 /usage 泄漏最多约 2GB 内存的问题
  • 修复了长时间运行的工具未能发出清晰进度事件时的内存泄漏问题
  • 修复了当 Claude 启动的目录在会话中途被删除或移动时 Bash 工具变得永久不可用的问题
  • 修复了外部构建中 --resume 在启动时崩溃的问题
  • 修复了当转录行由于不干净关闭而损坏时 --resume 在大会话上失败的问题——现在跳过损坏行
  • 修复了使用 Bedrock 应用程序推理配置文件 ARN 时 thinking.type.enabled is not supported 错误
  • 修复了 Microsoft 365 MCP OAuth 因重复或不支持的 prompt 参数而失败的问题
  • 修复了在 tmux、GNOME Terminal、Windows Terminal 和 Konsole 上非全屏模式下按 Ctrl+L 或触发重绘时的回滚重复问题
  • 修复了启动时连接器列表获取遇到瞬态认证错误时 claude.ai MCP 连接器静默消失的问题
  • 修复了远程会话中内置工具的“始终允许”规则在 worker 重启后不存活的问题
  • 修复了在原生构建下通过 managed-settings.json 设置 NO_PROXY 时未受到所有 HTTP 客户端尊重的问题
  • 修复了即使接受后托管设置批准提示退出会话的问题——现在应用设置并继续
  • 修复了陈旧 OAuth 令牌后 /usage 返回“rate limited”的问题——现在自动刷新
  • 修复了 settings.json 中无效的旧枚举值使整个设置文件无效的问题
  • 修复了无闪烁模式关闭时 /usage 对话框内容被裁剪的问题
  • 修复了全屏渲染器关闭时 /focus 显示“Unknown command”的问题——现在解释如何启用
  • 修复了运行中的二进制在会话中途被删除时嵌入的 grep/find/rg shell 包装器失败的问题——现在回退到已安装的工具
  • 减少了大目录树上 Bash 工具中 find 的峰值文件描述符使用量

2.1.120 – 2026年4月28日

  • Windows：不再需要 Git for Windows（Git Bash）——缺少时，Claude Code 使用 PowerShell 作为 shell 工具
  • 新增 claude ultrareview [target] 子命令，用于从 CI 或脚本非交互地运行 /ultrareview——将发现结果打印到 stdout（--json 获取原始输出），完成时退出 0，失败时退出 1
  • 技能现在可以在其内容中引用当前努力级别 ${CLAUDE_EFFORT}
  • 为子进程设置 AI_AGENT 环境变量，使 gh 可以将流量归因于 Claude Code
  • 推荐安装桌面应用或创建技能/agent 的旋转提示现在在你已经拥有它们时隐藏
  • 当终端发送箭头键而不是滚动事件时，显示“使用 PgUp/PgDn 滚动”提示
  • 当你配置了许多但未授权的 claude.ai 连接器时，会话启动更快
  • 自动模式拒绝消息现在链接到配置文档
  • claude plugin validate 现在接受 marketplace.json 顶层中的 $schema、version 和 description，以及 plugin.json 中的 $schema
  • 自动模式中的自动压缩现在显示 auto（小写，无令牌计数）而不是误导性的令牌值
  • 修复了在 stdio MCP 工具调用期间按 Esc 关闭整个服务器连接的问题（2.1.105 引入的回归）
  • 修复了使用 claude --resume 启动后 /rewind 和其他交互式覆盖层不响应键盘输入的问题
  • 修复了非全屏模式下的终端回滚重复问题（调整大小、对话框关闭、长会话）
  • 修复了 DISABLE_TELEMETRY / CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 未抑制 API 和企业用户的使用指标遥测的问题
  • 修复了自动模式中多行 bash 命令（同时包含管道和重定向）的假阳性“危险 rm 操作”权限提示的问题
  • 修复了全屏模式下长选择菜单裁剪在终端下方的问题——现在滚动时焦点选项保持在屏幕上
  • 修复了全屏中写入工具输出在点击“+N lines”时折叠而不是展开的问题
  • 修复了斜杠命令选择器在键入时跳动的问题，并改进高亮以仅匹配连续的蓝色子串
  • 修复了 /plugin 市场在一个条目使用无法识别的源格式时加载失败的问题——该条目显示，但安装它提示你更新
  • [VSCode] /usage 现在打开原生帐户和使用对话框而不是返回纯文本会话费用
  • [VSCode] 语音听写现在尊重 ~/.claude/settings.json 中的 language 设置
  • 修复了 find 在 Bash 工具中在大目录树上耗尽打开文件描述符的问题，导致主机范围崩溃（macOS/Linux 原生构建）

2.1.119 – 2026年4月23日

  • /config 设置（主题、编辑器模式、详细等）现在持久化到 ~/.claude/settings.json 并参与项目/本地/策略覆盖优先级
  • 新增 prUrlTemplate 设置，将页脚 PR 徽章指向自定义代码审查 URL 而不是 github.com
  • 新增 CLAUDE_CODE_HIDE_CWD 环境变量，隐藏启动徽标中的工作目录
  • --from-pr 现在接受 GitLab 合并请求、Bitbucket 拉取请求和 GitHub Enterprise PR URL
  • --print 模式现在遵循 agent 的 tools: 和 disallowedTools: frontmatter，匹配交互模式行为
  • --agent <name> 现在对内置 agent 遵循 agent 定义的 permissionMode
  • PowerShell 工具命令现在可在权限模式中自动批准，匹配 Bash 行为
  • Hooks：PostToolUse 和 PostToolUseFailure hook 输入现在包括 duration_ms（工具执行时间，不包括权限提示和 PreToolUse hooks）
  • 子 agent 和 SDK MCP 服务器重新配置现在并行连接服务器而不是串行连接
  • 由另一个插件的版本约束固定的插件现在自动更新到最高的满足 git 标签
  • Vim 模式：INSERT 中 Esc 不再将排队的消息拉回输入；再次按 Esc 中断
  • 斜杠命令建议现在高亮匹配查询的字符
  • 斜杠命令选择器现在将长描述换行到第二行而不是截断
  • owner/repo#N 简写现在使用你的 git 远程主机而不是总指向 github.com
  • 安全：blockedMarketplaces 现在正确执行 hostPattern 和 pathPattern 条目
  • OpenTelemetry：tool_result 和 tool_decision 事件现在包括 tool_use_id；tool_result 还包括 tool_input_size_bytes
  • 状态行：stdin JSON 现在包括 effort.level 和 thinking.enabled
  • 修复了粘贴 CRLF 内容（Windows 剪贴板、Xcode 控制台）在每行之间插入额外空白行的问题
  • 修复了在括号粘贴内使用 kitty 键盘协议序列的终端中多行粘贴丢失换行的问题
  • 修复了在原生 macOS/Linux 构建上当 Bash 工具通过权限被拒绝时 Glob 和 Grep 工具消失的问题
  • 修复了全屏模式下向上滚动每次工具完成时弹回底部的问题
  • 修复了 OAuth 发现请求返回非 JSON 正文时 MCP HTTP 连接失败并显示“Invalid OAuth error response”的问题
  • 修复了 Rewind 覆盖层对带有图像附件的消息显示“(no prompt)”的问题
  • 修复了自动模式用冲突的“立即执行”指令覆盖计划模式的问题
  • 修复了发出无响应负载的异步 PostToolUse hooks 将会话转录写入空条目的问题
  • 修复了当子 agent 任务通知在队列中孤立时旋转器保持不消失的问题
  • 工具搜索现在默认在 Vertex AI 上禁用，以避免不支持的 beta 标头错误（通过 ENABLE_TOOL_SEARCH 选择加入）
  • 修复了在带有绝对路径的斜杠命令中使用 @ 文件 Tab 补全替换整个提示的问题
  • 修复了在 Docker 或 SSH 上的 macOS Terminal.app 启动时提示中出现的杂散 p 字符的问题
  • 修复了 ${ENV_VAR} 占位符在 HTTP/SSE/WebSocket MCP 服务器的 headers 中在请求前未替换的问题
  • 修复了通过 --client-secret 存储的 MCP OAuth 客户端密钥在需要 client_secret_post 的服务器令牌交换期间未发送的问题
  • 修复了 /skills Enter 键关闭对话框而不是在提示中预填充 /<skill-name> 的问题
  • 修复了 /agents 详情视图错误地将子 agent 不可用的内置工具标记为“Unrecognized”的问题
  • 修复了插件缓存不完整时 Windows 上插件中的 MCP 服务器未生成的问题
  • 修复了 /export 显示当前默认模型而不是对话实际使用的模型的问题
  • 修复了详细输出设置重启后不持久的问题
  • 修复了 /usage 进度条与“Resets …”标签重叠的问题
  • 修复了插件 MCP 服务器在 ${user_config.*} 引用留空的可选字段时失败的问题
  • 修复了列表项包含句子尾数字时数字绕到自己行的问题
  • 修复了 /plan 和 /plan open 在进入计划模式时未对现有计划起作用的问题
  • 修复了在自动压缩之前调用的技能被针对下一条用户消息重新执行的问题
  • 修复了 /reload-plugins 和 /doctor 报告已禁用插件的加载错误的问题
  • 修复了带有 isolation: "worktree" 的 Agent 工具重用先前会话中陈旧工作树的问题
  • 修复了已禁用的 MCP 服务器在 /status 中显示为“failed”的问题
  • 修复了 TaskList 以任意的文件系统顺序返回任务而不是按 ID 排序的问题
  • 修复了当 gh 输出包含提及“rate limit”的 PR 标题时虚假的“GitHub API rate limit exceeded”提示的问题
  • 修复了 SDK/bridge read_file 未正确强制实施增长中文件的大小上限的问题
  • 修复了在 git 工作树中工作时 PR 未链接到会话的问题
  • 修复了 /doctor 警告由更高优先级作用域覆盖的 MCP 服务器条目的问题
  • Windows：移除了错误的“Windows requires ‘cmd /c’ wrapper”MCP 配置警告
  • [VSCode] 修复了在 macOS 上显示麦克风权限提示时语音听写的第一次录制无输出的问题

2.1.118 – 2026年4月23日

  • 新增 vim 可视模式（v）和可视行模式（V），支持选择、操作符和可视反馈
  • 合并 /cost 和 /stats 到 /usage——两者仍然作为输入快捷键打开相关标签页
  • 从 /theme 创建和切换命名的自定义主题，或手工编辑 ~/.claude/themes/ 中的 JSON 文件；插件也可以通过 themes/ 目录发布主题
  • Hooks 现在可以通过 type: "mcp_tool" 直接调用 MCP 工具
  • 新增 DISABLE_UPDATES 环境变量，完全阻止所有更新路径，包括手动 claude update——比 DISABLE_AUTOUPDATER 更严格
  • WSL 在 Windows 上现在可以通过 wslInheritsWindowsSettings 策略键继承 Windows 端的托管设置
  • 自动模式：在 autoMode.allow、autoMode.soft_deny 或 autoMode.environment 中包含 "$defaults"，以在内置列表旁边添加自定义规则而不是替换它
  • 在自动模式选择加入提示中添加了“不再询问”选项
  • 新增 claude plugin tag 以创建带版本验证的插件发布 git 标签
  • --continue/--resume 现在可以找到通过 /add-dir 添加当前目录的会话
  • /color 现在在 Remote Control 连接时将会话强调色同步到 claude.ai/code
  • /model 选择器在使用自定义 ANTHROPIC_BASE_URL 网关时现在遵循 ANTHROPIC_DEFAULT_*_MODEL_NAME/_DESCRIPTION 覆盖
  • 当自动更新由于另一个插件的版本约束而跳过插件时，跳过现在出现在 /doctor 和 /plugin 的错误标签中
  • 修复了 /mcp 菜单隐藏带有 headersHelper 配置和服务器的 OAuth 身份验证/重新身份验证操作，以及带有自定义标头的 HTTP/SSE MCP 服务器在瞬态 401 后卡在“needs authentication”状态的问题
  • 修复了其 OAuth 令牌响应省略 expires_in 的 MCP 服务器需要每小时重新认证的问题
  • 修复了 MCP 升级授权在服务器 insufficient_scope 403 命名当前令牌已拥有的作用域时静默刷新而不是提示重新同意的问题
  • 修复了 MCP 服务器 OAuth 流程超时或被取消时未处理的 promise 拒绝的问题
  • 修复了竞争下 MCP OAuth 刷新在没有跨进程锁的情况下进行的问题
  • 修复了 macOS 密钥链竞争中并发 MCP 令牌刷新可能覆盖新刷新的 OAuth 令牌，导致意外的“请运行 /login”提示的问题
  • 修复了服务器在本地过期时间之前撤销令牌时 OAuth 令牌刷新失败的问题
  • 修复了 Linux/Windows 上凭证保存崩溃损坏 ~/.claude/.credentials.json 的问题
  • 修复了使用 CLAUDE_CODE_OAUTH_TOKEN 启动的会话中 /login 无效果的问题——环境令牌现在被清除，以便磁盘凭证生效
  • 修复了“new messages”滚动药丸和 /plugin 徽章中不可读的文本的问题
  • 修复了使用 --dangerously-skip-permissions 运行时计划接受对话框提供“auto mode”而不是“bypass permissions”的问题
  • 修复了 agent 类型 hook 在配置用于 Stop 或 SubagentStop 之外的事件时失败并显示“Messages are required for agent hooks”的问题
  • 修复了 prompt hook 在 agent-hook 验证子 agent 做出的工具调用上重新触发的问题
  • 修复了 /fork 将完整父对话写入每个分支的磁盘的问题——现在写入指针并在读取时水合
  • 修复了 Alt+K / Alt+X / Alt+^ / Alt+_ 冻结键盘输入的问题
  • 修复了连接远程会话覆盖了 ~/.claude/settings.json 中你的本地 model 设置的问题
  • 修复了类型提示在粘贴以 / 开头的文件路径时显示“No commands match”错误的问题
  • 修复了在已安装的插件上运行 plugin install 未重新解析以错误版本安装的依赖的问题
  • 修复了文件监视器在无效路径或 fd 耗尽时未处理的错误的问题
  • 修复了 JWT 刷新期间瞬态 CCR 初始化故障导致 Remote Control 会话归档的问题
  • 修复了通过 SendMessage 恢复的子 agent 未恢复它们被生成的显式 cwd 的问题

2.1.117 – 2026年4月22日

  • 分叉子 agent 现在可以在外部构建中通过设置 CLAUDE_CODE_FORK_SUBAGENT=1 启用
  • Agent frontmatter mcpServers 现在通过 --agent 为主线程 agent 会话加载
  • 改进了 /model：选择现在在重启后持续存在，即使项目固定了不同的模型；启动标头显示活动模型来自项目还是托管设置固定
  • /resume 命令现在在重新读取之前提供总结陈旧大会话的选项，匹配现有的 --resume 行为
  • 当同时配置本地和 claude.ai MCP 服务器时，启动更快（并行连接现在默认）
  • 在已安装的插件上运行 plugin install 现在安装任何缺失的依赖，而不是停在“already installed”
  • 插件依赖错误现在显示“not installed”并带安装提示，claude plugin marketplace add 现在自动从已配置的市场解析缺失依赖
  • 托管设置 blockedMarketplaces 和 strictKnownMarketplaces 现在在插件安装、更新、刷新和自动更新上强制执行
  • Advisor 工具（实验性）：对话框现在带有“experimental”标签、了解更多链接，启用时显示启动通知；会话不再在每个提示和 /compact 时卡在“Advisor tool result content could not be processed”错误
  • cleanupPeriodDays 保留清扫现在也覆盖 ~/.claude/tasks/、~/.claude/shell-snapshots/ 和 ~/.claude/backups/
  • OpenTelemetry：user_prompt 事件现在包括斜杠命令的 command_name 和 command_source；cost.usage、token.usage、api_request 和 api_error 现在在模型支持努力级别时包括 effort 属性。除非设置 OTEL_LOG_TOOL_DETAILS=1，自定义/MCP 命令名称会被编辑
  • macOS 和 Linux 上的原生构建：Glob 和 Grep 工具被通过 Bash 工具可用的嵌入式 bfs 和 ugrep 替换——搜索更快，无需单独的工具往返（Windows 和 npm 安装构建不变）
  • Windows：每个进程缓存 where.exe 可执行文件查找，加快子进程启动
  • Pro/Max 订阅者在 Opus 4.6 和 Sonnet 4.6 上的默认努力级别现在为 high（之前为 medium）
  • 修复了访问令牌在会话中过期时 Plain-CLI OAuth 会话因“请运行 /login”而死亡的问题——令牌现在在 401 上响应式刷新
  • 修复了 WebFetch 在非常大的 HTML 页面上挂起的问题——在 HTML 到 Markdown 转换之前截断输入
  • 修复了代理返回 HTTP 204 No Content 时的崩溃——现在显示清晰的错误而不是 TypeError
  • 修复了使用 CLAUDE_CODE_OAUTH_TOKEN 环境变量启动且该令牌过期时 /login 无效果的问题
  • 修复了提示输入撤销（Ctrl+\_）在刚输入后不工作，并且在每个撤销步骤跳过一个状态的问题
  • 修复了在 Bun 下运行时 NO_PROXY 未受到远程 API 请求尊重的问题
  • 修复了慢速连接上键名作为合并文本到达时罕见的误触发 escape/return 的问题
  • 修复了 SDK reload_plugins 串行重新连接所有用户 MCP 服务器的问题
  • 修复了当 Opus 4.7 禁用思考时由 Bedrock 应用程序推理配置文件支持的请求因 400 失败的问题
  • 修复了 MCP elicitation/create 请求在中途服务器完成连接时在打印/SDK 模式下自动取消的问题
  • 修复了运行与主 agent 不同模型的子 agent 错误地用恶意软件警告标记文件读取的问题
  • 修复了存在后台任务时空闲重渲染循环的问题，减少了 Linux 上的内存增长
  • [VSCode] 修复了配置多个大市场时“Manage Plugins”面板损坏的问题
  • 修复了 Opus 4.7 会话显示夸大的 /context 百分比并过早自动压缩的问题——Claude Code 之前按 200K 上下文窗口计算，而非 Opus 4.7 的原生 1M

2.1.116 – 2026年4月20日

  • 大型会话上的 /resume 速度显著提升（40MB+ 会话提升多达 67%），并更高效地处理包含许多死胡同分支的会话
  • 配置多个 stdio 服务器时 MCP 启动更快；resources/templates/list 现在推迟到首次 @ 提及时执行
  • 在 VS Code、Cursor 和 Windsurf 终端中全屏滚动更流畅 —— /terminal-setup 现在可以配置编辑器的滚动灵敏度
  • 思考指示器现在内联显示进度（“仍在思考”、“思考更多”、“几乎完成思考”），取代了独立的提示行
  • /config 搜索现在匹配选项值（例如搜索 “vim” 可找到编辑器模式设置）
  • /doctor 现在可以在 Claude 响应时打开，无需等待当前回合结束
  • /reload-plugins 和后台插件自动更新现在会自动从已添加的市场安装缺失的插件依赖
  • Bash 工具现在会在 gh 命令触发 GitHub API 速率限制时显示提示，以便 agent 可以退避而不是重试
  • 设置中的使用量选项卡现在会立即显示你的 5 小时和每周使用量，并且在获取端点受限时不再失败
  • 当作为主线程 agent 运行（通过 --agent）时，Agent frontmatter 的 hooks: 现在也会触发
  • 斜杠命令菜单在过滤器没有结果时现在会显示“没有匹配的命令”，而不是直接消失
  • 安全：沙箱自动允许不再绕过以 /、$HOME 或其他关键系统目录为目标的 rm/rmdir 危险路径安全检查
  • 修复了天城文和其他印度文字在终端 UI 中渲染时列对齐损坏的问题
  • 修复了在支持 Kitty 键盘协议的终端中 Ctrl± 不触发撤销的问题
  • 修复了在支持 Kitty 键盘协议的终端中 Cmd+左右箭头不跳转到行首/尾的问题
  • 修复了通过包装进程（如 npx、bun run）启动 Claude Code 时 Ctrl+Z 导致终端挂起的问题
  • 修复了内联模式下的回滚重复问题（调整终端大小或大段输出爆发会重复早期的对话历史）
  • 修复了在较短的终端高度下，模态搜索对话框溢出屏幕、隐藏搜索框和键盘提示的问题
  • 修复了在 VS Code 集成终端滚动期间出现零散的空白单元格和消失的 composer 边框问题
  • 修复了间歇性的 API 400 错误（与缓存控制 TTL 排序相关，可能在请求设置期间并行请求完成时发生）
  • 修复了 /branch 拒绝转录大于 50MB 的对话的问题
  • 修复了 /resume 在大文件会话上静默显示空对话而不是报告加载错误的问题
  • 修复了 /plugin 已安装选项卡在处于"需要注意"或"收藏"下时显示重复项目的问题
  • 修复了在会话中途进入 worktree 后 /update 和 /tui 无法工作的问题

2.1.114 – 2026年4月18日

  • 修复了 agent teams 队友请求工具权限时权限对话框崩溃的问题

2.1.113 – 2026年4月17日

  • 将 CLI 更改为生成原生的 Claude Code 二进制文件（通过按平台的选项依赖）而不是打包的 JavaScript
  • 新增 sandbox.network.deniedDomains 设置，即使在宽泛的 allowedDomains 通配符允许的情况下也能阻止特定域名
  • 全屏模式：Shift+↑/↓ 现在在将选区扩展过可见边缘时会滚动视图
  • Ctrl+A 和 Ctrl+E 现在在多行输入中移动到当前逻辑行的开头/结尾，与 readline 行为一致
  • Windows：Ctrl+Backspace 现在删除前一个单词
  • 响应和 bash 输出中的长 URL 现在在跨行换行时保持可点击（在支持 OSC 8 超链接的终端中）
  • 改进了 /loop：按 Esc 现在可取消挂起的唤醒，并且唤醒显示为“Claude 正在恢复 /loop 唤醒”以增加清晰度
  • /extra-usage 现在可从远程控制（移动/网页）客户端使用
  • 远程控制客户端现在可以查询 @ 文件的自动完成建议
  • 改进了 /ultrareview：通过并行检查实现更快的启动，在启动对话框中显示 diffstat，并有动画启动状态
  • 中途停滞的子 agent 现在在 10 分钟后以明确错误失败，而不是静默挂起
  • Bash 工具：首行为注释的多行命令现在在转录中显示完整命令，封闭了一个 UI 欺骗向量
  • 运行 cd <current-directory> && git … 在 cd 为无操作时不再触发权限提示
  • 安全：在 macOS 上，/private/{etc,var,tmp,home} 路径现在在 Bash(rm:*) 允许规则下被视为危险的删除目标
  • 安全：Bash 拒绝规则现在匹配包裹在 env/sudo/watch/ionice/setsid 和类似 exec 包装器中的命令
  • 安全：Bash(find:*) 允许规则不再自动批准 find -exec/-delete
  • 修复了 MCP 并发调用超时处理（一个工具调用的消息可能静默解除另一个调用的看门狗）
  • 修复了 Cmd-backspace / Ctrl+U 以重新恢复删除从光标到行首的内容
  • 修复了当单元格包含带管道符的内联代码跨度时 markdown 表格损坏的问题
  • 修复了在提示中编写未发送文本时会话 recap 自动触发的问题
  • 修复了 /copy “完整响应”没有对齐 markdown 表格列以便粘贴到 GitHub、Notion 或 Slack 的问题
  • 修复了在查看运行中的子 agent 时输入的消息被隐藏并错误归因于父 AI 的问题
  • 修复了 Bash dangerouslyDisableSandbox 在没有权限提示的情况下运行沙箱外命令的问题
  • 修复了 /effort auto 确认——现在显示“努力级别设置为最大”以匹配状态栏标签
  • 修复了“已复制 N 个字符”的 toast 高估了表情符号和其他多代码单元字符的问题
  • 修复了 /insights 在 Windows 上因 EBUSY 而崩溃的问题
  • 修复了退出确认对话框将一次性的定时任务错误标记为重复的问题——现在会显示倒计时
  • 修复了全屏模式下斜杠/@完成菜单未能与提示框边界对齐的问题
  • 修复了 CLAUDE_CODE_EXTRA_BODY output_config.effort 在调用不支持 effort 的模型及 Vertex AI 的子 agent 时导致 400 错误的问题
  • 修复了在设置了 NO_COLOR 时提示光标消失的问题
  • 修复了 ToolSearch 排名问题，使得粘贴的 MCP 工具名称会显现出实际工具而不是描述匹配的兄弟工具
  • 修复了压缩已恢复的长上下文会话因“长上下文请求需要额外使用量”而失败的问题
  • 修复了当依赖版本与已安装插件冲突时 plugin install 会成功的问题——现在报告 range-conflict
  • 修复了“使用 Ultraplan 优化”未在转录中显示远程会话 URL 的问题
  • 修复了处理失败的 SDK 图像内容块导致会话崩溃的问题——现在降级为文本占位符
  • 修复了当 Claude Code 退出时远程控制会话未归档的问题
  • 修复了通过 Bedrock 应用程序推理配置文件 ARN 使用 Opus 4.7 时的 thinking.type.enabled is not supported 400 错误

2.1.112 – 2026年4月16日

  • 修复了自动模式下“claude-opus-4-7 暂时不可用”的问题

2.1.111 – 2026年4月16日

  • Claude Opus 4.7 xhigh 现在可用！使用 /effort 调整速度与智能的平衡
  • 使用 Opus 4.7 时，Max 订阅者现在可以使用自动模式
  • 为 Opus 4.7 添加了 xhigh 努力级别，介于 high 和 max 之间。可通过 /effort、--effort 和模型选择器使用；其他模型回退到 high
  • /effort 在没有参数调用时现在打开一个交互式滑块，可通过方向键在级别间导航，按 Enter 确认
  • 新增了“自动（匹配终端）”主题选项，匹配终端的深色/浅色模式——可通过 /theme 选择
  • 新增 /less-permission-prompts 技能——扫描转录中的常见只读 Bash 和 MCP 工具调用，并提出针对 .claude/settings.json 的优先允许列表
  • 新增 /ultrareview，用于在云端使用并行的多 agent 分析和批判进行全面的代码审查——无参数调用可审查当前分支，或 /ultrareview <PR#> 获取并审查特定的 GitHub PR
  • 自动模式不再需要 --enable-auto-mode
  • Windows：PowerShell 工具正逐步推出。通过 CLAUDE_CODE_USE_POWERSHELL_TOOL 选择加入或退出。Linux 和 macOS 上设置 CLAUDE_CODE_USE_POWERSHELL_TOOL=1 启用（需要 PATH 中有 pwsh）
  • 带有 glob 模式的只读 bash 命令（如 ls *.ts）和以 cd <project-dir> && 开头的命令不再触发权限提示
  • 在遇到近乎失误的拼写错误调用时建议最接近的匹配子命令（例如 claude udpate → “你是说 claude update 吗？”）
  • 计划文件现在根据你的提示命名（例如 fix-auth-race-snug-otter.md），而不仅仅是随机单词
  • 改进了 /setup-vertex 和 /setup-bedrock，当设置了 CLAUDE_CONFIG_DIR 时显示实际的 settings.json 路径，在重新运行时从现有固定中播种候选模型，并为支持的模型提供“1M 上下文”选项
  • /skills 菜单现在支持按估计的令牌数排序——按 t 切换
  • Ctrl+U 现在清除整个输入缓冲区（以前：删除到行首）；按 Ctrl+Y 恢复
  • Ctrl+L 除了清除提示输入外，现在还会强制全屏重绘
  • 转录视图底部现在显示 [（转储到回滚区）和 v（在编辑器中打开）快捷键
  • 截断的长粘贴文本的“+N lines”标记现在是全宽规则，以便更易扫描
  • Headless --output-format stream-json 在因依赖未满足而降级插件时，初始化事件现在包括 plugin_errors
  • 新增 OTEL_LOG_RAW_API_BODIES 环境变量以发射完整的 API 请求和响应主体作为 OpenTelemetry 日志事件进行调试
  • 抑制了正常操作期间在 TUI 中可能出现的杂散的解压缩、网络和瞬态错误消息
  • 撤销了 v2.1.110 对非流式回退重试的上限——它在 API 超载期间用漫长的等待换取了更多的直接失败
  • 修复了在 iTerm2 + tmux 设置中发送终端通知时出现的终端显示撕裂（随机字符，输入漂移）的问题
  • 修复了在非 git 工作目录中 @ 文件建议在每一轮都重新扫描整个项目的问题，以及在新初始化的无跟踪文件的 git 仓库中仅显示配置文件的缺陷
  • 修复了编辑前的 LSP 诊断在编辑后出现，导致模型重新读取其刚编辑的文件的问题
  • 修复了使用 Tab 补全 /resume 立即恢复任意带标题的会话而不是显示会话选择器的问题
  • 修复了 /context 渲染时行之间有多余空行的问题
  • 修复了 /clear 会丢弃由 /rename 设置的会话名称，导致状态行输出丢失 session_name 的问题
  • 改进了插件错误处理：依赖错误现在可以区分冲突的、无效的和过于复杂的版本要求；修复了 plugin update 后的陈旧解析版本；plugin install 现在可以从中途终端的先前安装中恢复
  • 修复了 Claude 调用不存在的 commit 技能，并未配置自定义 /commit 命令的用户显示“Unknown skill: commit”的问题
  • 修复了在引用 status.claude.com 时 Bedrock/Vertex/Foundry 上出现的 429 速率限制错误（它仅涵盖 Anthropic 运营的提供商）
  • 修复了在关闭一个反馈调查后立刻接连出现另一个的问题
  • 修复了当终端跨行换行时 bash/PowerShell/MCP 工具输出中的裸 URL 无法点击的问题
  • Windows：CLAUDE_ENV_FILE 和 SessionStart hook 环境变量文件现在生效（之前是无操作）
  • Windows：带有驱动器字母路径的权限规则现在被正确地在根锚定，并且只有驱动器字母大小写不同的路径现在被认为是同一路径

2.1.110 – 2026年4月15日

  • 新增 /tui 命令和 tui 设置——运行 /tui fullscreen 切换到无闪烁渲染，在同一对话中
  • 新增推送通知工具——当 Remote Control 和“Push when Claude decides”配置启用时，Claude 可以发送移动推送通知
  • 将 Ctrl+O 改为仅切换正常和详细转录；焦点视图现在通过新的 /focus 命令单独切换
  • 新增 autoScrollEnabled 配置，禁用全屏模式下的对话自动滚动
  • 新增选项，在 Ctrl+G 外部编辑器中将 Claude 的最后响应作为注释上下文显示（通过 /config 启用）
  • 改进了 /plugin 已安装选项卡——需要注意的项目和收藏夹出现在顶部，禁用的项目隐藏在折叠后，按 f 可以收藏所选项目
  • 改进了 /doctor，当在一个设置的作用域中定义了具有不同端点的 MCP 服务器时发出警告
  • --resume/--continue 现在复活未到期的定时任务
  • /context、/exit 和 /reload-plugins 现在可从远程控制（移动/网页）客户端使用
  • 写入工具现在在你于 IDE 的 diff 中编辑提议的内容后接受它时通知模型
  • Bash 工具现在强制执行文档化最大超时而不是接受任意大的值
  • SDK/headless 会话现在从环境中读取 TRACEPARENT/TRACESTATE 以进行分布式跟踪链接
  • 会话 recap 现在为禁用遥测的用户启用（Bedrock、Vertex、Foundry、DISABLE_TELEMETRY）。通过 /config 或 CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 选择退出

2.1.109 – 2026年4月15日

  • 改进了扩展思考指示器，新增旋转进度提示

2.1.108 – 2026年4月14日

  • 新增 ENABLE_PROMPT_CACHING_1H 环境变量，支持在 API Key、Bedrock、Vertex 和 Foundry 上启用 1 小时提示缓存 TTL（ENABLE_PROMPT_CACHING_1H_BEDROCK 已废弃但仍可用）；新增 FORCE_PROMPT_CACHING_5M 强制使用 5 分钟 TTL
  • 新增 recap 功能，在回到会话时提供上下文，可在 /config 中配置，也可用 /recap 手动触发；若遥测已禁用可设 CLAUDE_CODE_ENABLE_AWAY_SUMMARY 强制启用
  • 模型现在可以通过 Skill 工具发现并调用内置斜杠命令，如 /init、/review、/security-review
  • /undo 现在是 /rewind 的别名
  • 改进了 /model，在会话中途切换模型前会提示警告（下一个响应会重新读取完整历史记录，不使用缓存）
  • 改进了 /resume 选择器，默认显示当前目录的会话；按 Ctrl+A 显示所有项目
  • 改进了错误信息：服务器速率限制和计划用量限制现在会分别提示；5xx/529 错误会显示 status.claude.com 链接；未知斜杠命令会提示最接近的匹配
  • 通过按需加载语言语法，减少了文件读取、编辑和语法高亮的内存占用
  • 在查看详细转录时（Ctrl+O）新增了"verbose"标识
  • 通过 DISABLE_PROMPT_CACHING* 禁用提示缓存时，启动时会显示警告
  • 修复了 /login 代码提示框中无法粘贴的问题（2.1.105 版本引入的回归）
  • 修复了设置 DISABLE_TELEMETRY 的订阅用户回退到 5 分钟提示缓存 TTL 而非 1 小时的问题
  • 修复了安全分类器的转录超出上下文窗口时，Agent 工具在自动模式下提示权限的问题
  • 修复了 CLAUDE_ENV_FILE（如 ~/.zprofile）以 # 注释行结尾时 Bash 工具无输出的问题
  • 修复了 claude --resume <session-id> 丢失通过 /rename 设置的自定义名称和颜色的问题
  • 修复了第一条消息是简短问候时会话标题显示占位示例文本的问题
  • 修复了 --teleport 后终端转义码在提示输入框中显示为乱码的问题
  • 修复了 /feedback 重试：按 Enter 重新提交失败后无需再次编辑描述
  • 修复了 --teleport 和 --resume <id> 前置条件错误（如 git 树脏、会话未找到）时静默退出而不显示错误的问题
  • 修复了 Web UI 中设置的 Remote Control 会话标题在第三条消息后被自动生成的标题覆盖的问题
  • 修复了转录包含自引用消息时 --resume 截断会话的问题
  • 修复了转录写入失败（如磁盘满）被静默丢弃而非记录日志的问题
  • 修复了配置 language 设置时响应中变音符（重音、变音、软音符）被丢弃的问题
  • 修复了由托管设置强制启用的策略管理插件从非首次安装的项目运行时从不自动更新的问题

2.1.107 – 2026年4月14日

  • 在长时间操作期间更早显示思考提示

2.1.105 – 2026年4月13日

  • 为 EnterWorktree 工具新增 path 参数，可切换到当前仓库的现有 worktree
  • 新增 PreCompact hook 支持：hook 现在可以通过退出代码 2 或返回 {"decision":"block"} 来阻止压缩
  • 新增插件后台监控支持，通过顶层 monitors 清单键在会话开始或技能调用时自动启用
  • /proactive 现在是 /loop 的别名
  • 改进了卡住的 API 流处理：5 分钟无数据后流中止并回退到非流式，而非无限挂起
  • 改进了网络错误消息：连接错误现在立即显示重试消息而非静默旋转
  • 改进了文件写入显示：长单行写入（如压缩 JSON）现在在 UI 中截断而非分页
  • 改进了 /doctor 布局，新增状态图标；按 f 让 Claude 修复报告的问题
  • 改进了 /config 标签和描述的清晰度
  • 改进了 skill 描述处理：提升列表上限从 250 到 1536 字符，并在描述被截断时显示启动警告
  • 改进了 WebFetch，去除获取页面中 <style> 和 <script> 的内容，避免 CSS 密集页面在到达实际文本前耗尽内容预算
  • 改进了陈旧代理 worktree 清理，移除 PR 已被 squash 合并的 worktree
  • 改进了 MCP 大输出截断提示，提供特定格式的处理方法（如 JSON 用 jq，文本用计算的 Read 块大小）
  • 修复了在 Claude 工作时排队的消息中附加的图片被丢弃的问题
  • 修复了长对话中提示输入换行到第二行时屏幕变空白的问题
  • 修复了全屏模式下选择多行助手响应时首行空格被复制的问题
  • 修复了助手消息的首行空格被截断，破坏 ASCII 艺术和缩进图表的问题
  • 修复了命令打印可点击文件链接（如 Python rich/loguru 日志）时 Bash 输出乱码的问题
  • 修复了使用 ESC 前缀 alt 编码的终端 alt+enter 不插入换行，以及 Ctrl+J 不插入换行的问题（2.1.100 版本回归）
  • 修复了 EnterWorktree/ExitWorktree 工具显示重复"Creating worktree"文本的问题
  • 修复了焦点模式中排队的用户提示消失的问题
  • 修复了文件监视器在触发后清理时遗漏，导致一次性定时任务反复触发的问题
  • 修复了 Team/Enterprise 用户收到第一条消息后，入站频道通知被静默丢弃的问题
  • 修复了带有 package.json 和锁文件的市场插件在安装/更新后未自动安装依赖的问题
  • 修复了市场自动更新在插件进程持有文件时使官方市场处于损坏状态的问题
  • 修复了退出 /resume、--worktree 或 /branch 后"用……恢复此会话"提示不打印的问题
  • 修复了在较长提示末尾输入时反馈调查快捷键触发的问题
  • 修复了发出非 JSON 格式输出的 stdio MCP 服务器挂起会话而非快速失败并显示"Connection closed"的问题
  • 修复了 MCP 服务器异步连接时无头/远程触发会话第一轮缺少 MCP 工具的问题
  • 修复了 /model 选择器在非美国区域 AWS Bedrock 上仍在发现推理配置文件时，将无效的 us.* 模型 ID 持久化到 settings.json 的问题
  • 修复了 API Key、Bedrock 和 Vertex 用户的 429 速率限制错误显示原始 JSON 而非友好消息的问题
  • 修复了恢复包含格式错误文本块的会话时崩溃的问题
  • 修复了短终端高度下 /help 丢失标签栏、快捷键标题和页脚的问题
  • 修复了 keybindings.json 中格式错误的键绑定条目值被静默加载而非显示明确错误的问题
  • 修复了一个项目的 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 永久禁用机器上所有项目使用指标的问题

2.1.101 – 2026年4月10日

  • 新增 /team-onboarding 命令，从本地 Claude Code 使用记录生成团队上手指南
  • 新增默认信任 OS CA 证书存储，企业 TLS 代理无需额外设置即可工作（设置 CLAUDE_CODE_CERT_STORE=bundled 只使用内置 CA）
  • /ultraplan 和其他远程会话功能现在自动创建默认云环境，无需提前在网页端设置
  • 改进了简洁模式，当 Claude 以纯文本而非结构化消息响应时重试一次
  • 改进了焦点模式，Claude 知道你只看到最终消息，因此会写出更独立完整的摘要
  • 改进了工具不可用错误消息，解释原因以及在当前上下文中调用不可用工具时如何继续
  • 改进了速率限制重试消息，显示触发的限制以及何时重置，而非不透明的秒数倒计时
  • 改进了拒绝错误消息，当可用时包含 API 提供的解释
  • 改进了 claude -p --resume <name>，接受通过 /rename 或 --name 设置的会话标题
  • 改进了设置弹性：settings.json 中无法识别的 hook 事件名不再导致整个文件被忽略
  • 改进了托管设置中强制启用的插件 hook，在设置了 allowManagedHooksOnly 时也能运行
  • 改进了 /plugin 和 claude plugin update，在无法刷新市场时显示警告而非静默报告陈旧版本
  • 改进了计划模式，当用户的组织或认证设置无法访问 Claude Code 网页时隐藏"用 Ultraplan 优化"选项
  • 修复了 POSIX which 回退中 LSP 二进制检测使用的命令注入漏洞
  • 修复了长会话在虚拟滚动器中保留数十个历史消息列表副本导致的内存泄漏
  • 修复了大会话 --resume/--continue 在加载器锚定到死胡同分支而非活跃对话时丢失对话上下文的问题
  • 修复了在子代理消息落在主链写入间隙附近时 --resume 链恢复跨入无关子代理对话的问题
  • 修复了持久化的 Edit/Write 工具结果缺少 file_path 时 --resume 崩溃的问题
  • 修复了中止慢速后端（本地 LLM、扩展思考、慢速网关）的硬编码 5 分钟请求超时，无论 API_TIMEOUT_MS 设置如何
  • 修复了 permissions.deny 规则无法覆盖 PreToolUse hook 的 permissionDecision: "ask" 的问题——此前 hook 可以将拒绝降级为提示
  • 修复了没有 user 的 --setting-sources 导致后台清理忽略 cleanupPeriodDays 并删除超过 30 天会话历史的问题
  • 修复了当 ANTHROPIC_AUTH_TOKEN、apiKeyHelper 或 ANTHROPIC_CUSTOM_HEADERS 设置了 Authorization 头时 Bedrock SigV4 认证 403 失败的问题
  • 修复了之前会话的 worktree 清理遗留陈旧目录导致 claude -w <name> 失败并显示"already exists"的问题
  • 修复了子代理未从动态注入的服务器继承 MCP 工具的问题
  • 修复了在隔离 worktree 中运行的子代理被拒绝访问其自身 worktree 内文件的 Read/Edit 权限的问题
  • 修复了新启动后沙箱 Bash 命令失败并显示 mktemp: No such file or directory 的问题
  • 修复了在验证 outputSchema 的 MCP 客户端中 claude mcp serve 工具调用失败并显示"Tool execution failed"的问题
  • 修复了 RemoteTrigger 工具的 run 动作发送空请求体被服务器拒绝的问题
  • 修复了多个 /resume 选择器问题：窄默认视图隐藏其他项目的会话，Windows Terminal 上预览不可达，worktree 中 cwd 不正确，会话未找到错误未在 stderr 中显示，终端标题未设置，恢复提示与提示输入重叠
  • 修复了嵌入式 ripgrep 二进制路径变得陈旧时 Grep 工具 ENOENT 的问题（VS Code 扩展自动更新、macOS App Translocation）；现在回退到系统 rg 并在会话中自愈
  • 修复了 /btw 在每次使用时将整个对话的副本写入磁盘的问题
  • 修复了 /context 的 Free space 和 Messages 分解与标题百分比不一致的问题
  • 修复了若干插件问题：重复 name: frontmatter 的斜杠命令解析到错误插件，/plugin update 因 ENAMETOOLONG 失败，Discover 显示已安装插件，目录源插件从陈旧版本缓存加载，技能未遵循 context: fork 和 agent frontmatter 字段
  • 修复了 /mcp 菜单为配置了 headersHelper 的 MCP 服务器提供特定于 OAuth 的操作；现在提供 Reconnect 以重新调用 helper 脚本
  • 修复了 ctrl+]、ctrl+\ 和 ctrl+^ 键绑定在发送原始 C0 控制字节的终端（Terminal.app、默认 iTerm2、xterm）中不触发的问题
  • 修复了 /login OAuth URL 渲染带有填充导致无法干净鼠标选择的问题
  • 修复了渲染问题：非全屏模式下可见区域上方的内容更改时闪烁，非全屏模式下长会话期间终端回滚被清除，以及鼠标滚动转义序列偶尔作为文本泄漏到提示中
  • 修复了 settings.json env 值为数字而非字符串时崩溃的问题
  • 修复了应用内设置写入（例如 /add-dir --remember、/config）未刷新内存快照，阻止删除目录在会话中被撤销的问题
  • 修复了自定义键绑定（~/.claude/keybindings.json）未在 Bedrock、Vertex 和其他第三方提供商上加载的问题
  • 修复了 claude --continue -p 未正确延续由 -p 或 SDK 创建的会话的问题
  • 修复了若干 Remote Control 问题：worktree 在会话崩溃时被移除，连接失败未在转录中持久化，简洁模式下本地会话出现虚假的“Disconnected”指示器，以及当仅设置 CLAUDE_CODE_ORGANIZATION_UUID 时 /remote-control 通过 SSH 失败
  • 修复了 /insights 有时在其响应中省略报告文件链接的问题
  • [VSCode] 修复了最后一个编辑器标签页关闭时聊天输入下方的文件附件未清除的问题

2.1.98 – 2026年4月9日

  • 新增交互式 Google Vertex AI 设置向导，从登录界面选择"第三方平台"时可访问，引导完成 GCP 认证、项目和区域配置、凭证验证和模型固定
  • 新增 CLAUDE_CODE_PERFORCE_MODE 环境变量：设置后，Edit/Write/NotebookEdit 在只读文件上失败时会显示 p4 edit 提示而非静默覆盖
  • 新增 Monitor 工具，用于从后台脚本流式传输事件
  • 新增带有 PID 命名空间隔离的子进程沙箱（Linux，设置 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 时），以及 CLAUDE_CODE_SCRIPT_CAPS 环境变量限制每个会话的脚本调用次数
  • 新增 --exclude-dynamic-system-prompt-sections 标志用于打印模式，改善跨用户提示缓存
  • 当当前目录在链接的 git worktree 内部时，状态栏 JSON 输入中新增 workspace.git_worktree
  • 在启用 OTEL 追踪时，为 Bash 工具子进程新增 W3C TRACEPARENT 环境变量，使子进程 span 正确挂载到 Claude Code 的追踪树
  • LSP：Claude Code 现在通过初始化请求中的 clientInfo 向语言服务器标识自身
  • 修复了 Bash 工具权限绕过，其中反斜杠转义的标志可以被自动允许为只读并导致任意代码执行
  • 修复了复合 Bash 命令绕过自动和绕过权限模式中安全检查及显式 ask 规则的强制权限提示
  • 修复了带有 env-var 前缀的只读命令未在变量已知安全（LANG、TZ、NO_COLOR 等）时提示的问题
  • 修复了重定向到 /dev/tcp/... 或 /dev/udp/... 未改为提示自动允许的问题
  • 修复了停滞的流式响应超时但未回退到非流式模式的问题
  • 修复了 429 重试在服务器返回小 Retry-After 时在大约 13 秒内耗尽所有尝试的问题——现在指数退避作为最小值应用
  • 修复了 MCP OAuth oauth.authServerMetadataUrl 配置覆盖在重启后令牌刷新时不生效的问题，影响 ADFS 和类似 IdP
  • 修复了 kitty 键盘协议激活时 xterm 和 VS Code 集成终端上大写字母降为小写的问题
  • 修复了 macOS 文本替换删除触发词而非插入替换文本的问题
  • 修复了 --dangerously-skip-permissions 在通过 Bash 批准写入受保护路径后静默降级为接受编辑模式的问题
  • 修复了托管设置允许规则在管理员删除后仍保持活动直到进程重启的问题
  • 修复了 permissions.additionalDirectories 更改未在会话中生效的问题——移除的目录立即失去访问权限，添加的无需重启即可工作
  • 修复了从 additionalDirectories 移除目录会撤销通过 --add-dir 传递的同一目录的访问权限的问题
  • 修复了 Bash(cmd:*) 和 Bash(git commit *) 通配符权限规则未能匹配带有额外空格或标签的命令的问题
  • 修复了 Bash(...) 拒绝规则对混合了 cd 和其他段的管道命令降级为提示的问题
  • 修复了 cut -d /、paste -d /、column -s /、awk '{print $1}' file 和包含 % 的文件名出现假 Bash 权限提示的问题
  • 修复了名称匹配 JavaScript 原型属性（例如 toString）的权限规则导致 settings.json 被静默忽略的问题
  • 修复了使用 --dangerously-skip-permissions 时 agent team 成员未继承领导者的权限模式的问题
  • 修复了全屏模式下悬停在 MCP 工具结果上时崩溃的问题
  • 修复了在全屏模式下复制换行的 URL 在换行处插入空格的问题
  • 修复了当编辑的文件大于 10KB 时 --resume 上文件编辑 diff 从 UI 消失的问题
  • 修复了数个 /resume 选择器问题：--resume <name> 打开不可编辑，过滤器重载清除搜索状态，空列表吞噬箭头键，跨项目陈旧性，以及瞬态任务状态文本替换对话摘要
  • 修复了 /export 不遵循绝对路径和 ~，并静默将用户提供的扩展名重写为 .txt 的问题
  • 修复了 /effort max 因未知或未来模型 ID 被拒绝的问题
  • 修复了当插件 frontmatter name 为 YAML 布尔关键字时斜杠命令选择器损坏的问题
  • 修复了速率限制升级文本在消息重装后被隐藏的问题
  • 修复了具有 _meta["anthropic/maxResultSizeChars"] 的 MCP 工具不绕过基于令牌的持久层的问题
  • 修复了在重新按住 push-to-talk 键而前一个转录仍在处理时语音模式将数十个空格字符泄漏到输入中的问题
  • 修复了 DISABLE_AUTOUPDATER 未完全抑制 npm 注册表版本检查和在 npm 安装上的符号链接修改的问题
  • 修复了 Remote Control 权限处理程序条目在会话生命周期内保留导致的内存泄漏
  • 修复了以错误失败的后台子 agent 未向父 agent 报告部分进度的问题
  • 修复了提示类型 Stop/SubagentStop hooks 在长会话上失败，以及 hook 评估器 API 错误显示“JSON validation failed”而非真实消息的问题
  • 修复了被忽略时反馈调查渲染的问题
  • 修复了 Bash grep -f FILE / rg -f FILE 在读取工作目录之外的模式文件时未提示的问题
  • 修复了陈旧子 agent worktree 清理移除了包含未跟踪文件的 worktree 的问题
  • 修复了 sandbox.network.allowMachLookup 在 macOS 上未生效的问题
  • 改进了 /resume 过滤器提示标签，并在过滤器指示器中添加了项目/worktree/分支名称
  • 改进了页脚指示器（焦点、通知）保持在模式指示器行上，而不是在窄终端宽度上换行
  • 改进了 /agents 的标签布局：Running 标签显示实时子 agent，Library 标签添加了运行 agent 和查看运行实例操作
  • 改进了 /reload-plugins 以拾取插件提供的技能而无需重启
  • 改进了接受编辑模式，自动批准以安全 env 变量或进程包装器为前缀的文件系统命令
  • 改进了 Vim 模式：NORMAL 模式下的 j/k 现在在输入边界导航历史并选择页脚药丸
  • 改进了转录中 hook 错误以包含 stderr 的第一行，方便无需 --debug 的自我诊断
  • 改进了 OTEL 跟踪：交互 span 现在在并发 SDK 调用下正确包装完整轮次，无头轮次每轮结束 span
  • 改进了转录条目携带最终令牌使用量而非流式占位符
  • 更新了 /claude-api 技能以涵盖托管 Agent 以及 Claude API
  • [VSCode] 修复了当设置了 CLAUDE_CODE_GIT_BASH_PATH 或 Git 安装在默认位置时 Windows 上的错误“requires git-bash”错误
  • 修复了 CLAUDE_CODE_MAX_CONTEXT_TOKENS 在设置 DISABLE_COMPACT 时遵循该设置
  • 当设置 DISABLE_COMPACT 时删除了 /compact 提示

常见问题

Claude Code 最新版本是什么？怎么更新？

当前最新版本是 2.1.148（2026 年 5 月 22 日）。运行 claude --version 查看本地版本。原生安装会自动更新；也可以手动运行 claude update。Homebrew 用户执行 brew upgrade claude-code，WinGet 用户执行 winget upgrade Anthropic.ClaudeCode。

如何查看某个 Bug 修复在哪个版本？

使用浏览器的页面搜索（Ctrl/Cmd+F）输入相关关键词（如 /resume、MCP、PowerShell）即可定位到对应版本的条目。也可直接访问 GitHub CHANGELOG.md 获取完整历史。

更新后需要重启 Claude Code 吗？

大多数更新通过热重载生效，但涉及核心二进制或配置结构的更新可能需要重启会话。若遇到异常行为，建议重启 Claude Code 或运行 /doctor 检查健康状况。