更新日志¶

本页整理了 Claude Code 各版本的重要更新。数据来源于 GitHub Releases。

💡 建议保持 Claude Code 更新到最新版本，新版本通常包含性能改进和 Bug 修复：

1

npm update -g @anthropic-ai/claude-code

📦 2.1.128（2026-05-04）¶

📝 笔记定位：/mcp 工具计数与保留名称 · MCP 重连精简 · zip 插件支持 · 子代理摘要与 worktree · OTEL 隔离 · Channels 控制台认证 · Auto mode 提示

✨ 新功能¶

• /color 随机颜色：不带参数的 /color 现在随机选择一个会话颜色
• /mcp 工具计数显示：/mcp 现在显示已连接服务器的工具数量，并标记连接但工具数为 0 的服务器
• --plugin-dir 支持 .zip 插件：除目录外，现在也接受 .zip 格式的插件归档文件
• --channels 控制台认证支持：--channels 现在可用于控制台（API Key）认证——使用托管设置的控制台组织需设置 channelsEnabled: true 以启用
• /model 选择器优化：合并重复的 Opus 4.7 条目，当前 Opus 显示为 "Opus" 而非 "Opus 4.7"

🔧 改进¶

• OTEL 环境变量隔离：子进程（Bash、hooks、MCP、LSP）不再继承 OTEL_* 环境变量，通过 Bash 工具运行的 OTEL 仪表化应用不再误用 CLI 的 OTLP 端点
• MCP workspace 保留名称：workspace 现在是 MCP 服务器保留名称——已存在同名服务器将被跳过并给出警告
• MCP 重连工具列表精简：重连 MCP 服务器不再在每次重连时向会话注入完整工具列表——重宣告的工具按服务器前缀汇总
• SDK Bash 权限持久化：SDK 宿主现在收到持久的 localSettings 建议用于 Bash 权限提示，"Always allow" 写入 .claude/settings.local.json
• EnterWorktree 从本地 HEAD 创建分支：现在按文档从本地 HEAD 创建新分支，而非 origin/<default-branch>——未推送的提交不再丢失
• Auto mode 错误提示增强：当分类器无法评估操作时，错误信息现在包含提示（重试、/compact 或使用 --debug 运行）
• 子代理进度摘要优化：修复子代理摘要缺少 prompt cache 的问题（约 3 倍 cache_creation 减少）；修复子代理 transcript 静态时摘要重复触发，限制空闲子代理的最坏 token 开销

🐛 修复¶

• 修复 focus mode 在提交新 prompt 时短暂暗化上一个响应
• 修复 Kitty 等将 OSC 9 解析为通知的终端中，每次 /exit 时出现多余的 "4;0;" 桌面通知
• 修复 Remote Control 在速率限制时显示空白 "Opening your options…" 而非可操作的升级选项
• 修复图片拖放上传在图片读取失败时卡在 "Pasting text…"
• 修复通过 stdin 向 claude -p 管道输入超大数据（>10 MB）时的崩溃循环
• 修复全屏模式下长 URL 在换行时无法逐行点击
• 修复 /plugin Components 面板对通过 --plugin-dir 加载的插件显示 "Marketplace 'inline' not found"
• 修复 MCP 工具结果在服务器同时返回结构化内容和内容块时丢弃图片
• 修复 fenced code blocks 在列表项内时复制粘贴携带前导空白
• 修复 /config 中 tab 导航焦点丢失——tab 标题页保持焦点以便箭头键和 Esc 继续工作
• 修复不支持 OSC 8 超链接的终端上 markdown 链接标签丢失——链接现在渲染为 label (url) 而非仅 URL
• 修复使用 1M 上下文模型但 autocompact 窗口较小时在达到实际 API 限制前被错误阻止 "Prompt is too long"
• 修复并行 shell 工具调用：失败的只读命令（grep、git diff、ls）不再取消同级调用
• 修复在不支持 effort 的模型上 banner 显示 "with X effort"
• 修复 /fast 在第三方 provider 上模糊匹配到无关 skill 而非显示 "not available"
• 修复 Bedrock 默认模型解析为 global.* 而非区域适配的前缀
• 修复 vim mode：NORMAL 模式下 Space 现在将光标右移，匹配标准 vi/vim 行为
• 修复终端进度指示器（OSC 9;4）在工具调用间闪烁——现在在整个 turn 内保持可见
• 修复不带参数的 /rename 在最后条目为 compact 边界的恢复会话上失败
• 修复 --resume/--continue 后出现先前会话的残留 "remote-control is active" 状态行
• 修复指向已删除缓存目录的过期 installed_plugins.json 条目污染 PATH
• 修复设置 CLAUDE_CODE_SHELL_PREFIX 且参数包含空格或 shell 元字符时 MCP stdio 服务器收到损坏参数
• 修复 /plugin update 从未检测到 npm 来源插件的新版本
• 修复 Headless --output-format stream-json：init.plugin_errors 现在包含 --plugin-dir 加载失败，而不仅是依赖降级

📦 2.1.126（2026-05-01）¶

📝 笔记定位：网关模型列表 · 项目清理命令 · OAuth 终端粘贴 · 权限范围扩展 · PowerShell 增强 · OTel Skill 审计 · 托管安全修复

✨ 新功能¶

• /model 网关模型列表：当 ANTHROPIC_BASE_URL 指向 Anthropic 兼容网关时，模型选择器现在从网关的 /v1/models 端点列出可用模型
• claude project purge 命令：新增 claude project purge [path] 删除项目所有 Claude Code 状态（transcripts、tasks、文件历史、配置条目），支持 --dry-run、-y/--yes、-i/--interactive 和 --all
• --dangerously-skip-permissions 范围扩展：现在绕过对 .claude/、.git/、.vscode/、shell 配置文件等受保护路径的写入提示（灾难性删除命令仍会提示作为安全网）
• claude auth login 终端粘贴 OAuth code：当浏览器回调无法到达 localhost（WSL2、SSH、容器）时，现在支持在终端中粘贴 OAuth code
• OpenTelemetry skill_activated 事件增强：现在对用户输入的斜杠命令也触发，并新增 invocation_trigger 属性（"user-slash"、"claude-proactive" 或 "nested-skill"）
• Auto mode 权限检查指示：spinner 在权限检查阻塞时变为红色，而非看起来像工具正在运行
• 主机托管部署分析保留：CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 不再在 Bedrock/Vertex/Foundry 上自动禁用分析
• Windows PowerShell 检测改进：现在可检测通过 Microsoft Store、不带 PATH 的 MSI 或 .NET global tool 安装的 PowerShell 7
• Windows PowerShell 优先：当 PowerShell 工具启用时，Claude 现在将 PowerShell 作为主 shell 而非默认 Bash
• Read tool 移除恶意软件评估提醒：移除了可能导致旧模型误判的每文件恶意软件评估提示

🔒 安全¶

• 修复 allowManagedDomainsOnly / allowManagedReadPathsOnly 在更高优先级的托管设置源缺少 sandbox 块时被忽略

🐛 修复¶

• 修复粘贴超过 2000px 的图片导致会话中断——图片现在在粘贴时自动缩放，历史中的超大图片自动移除并重试
• 修复"OAuth not allowed for organization"错误时显示登录页面——现在显示联系管理员指引
• 修复 OAuth 登录在慢速或代理连接、仅 IPv6 开发容器以及浏览器回调无法到达 localhost 时超时
• 修复并发凭证写入可能清除有效 OAuth refresh token 的罕见竞争条件
• 修复 API 重试倒计时卡在"0s"而非在重试间正确倒数
• 修复 Mac 从睡眠唤醒后请求中出现的"Stream idle timeout"错误
• 修复后台和远程会话在长时间模型思考暂停期间错误中止"Stream idle timeout"
• 修复助手完成思考但显示空白的连续空轮次后无输出
• 修复 Cursor 和 VS Code 1.92–1.104 集成终端中触控板滚动过快
• 修复 claude.ai MCP 连接器被卡在 needs-auth 状态的手动服务器抑制
• 修复 Windows 无闪烁模式下日语/韩语/中文字符渲染为乱码
• 修复 Ctrl+L 清空 prompt 输入——现在仅强制屏幕重绘，匹配 readline 行为
• 修复延迟工具（WebSearch、WebFetch 等）在 context: fork 的 skill 和其他子代理首轮不可用
• 修复 plan-mode 工具在通过 --channels 启动的交互式会话中不可用
• 修复某些消息工具不可用时远程会话 transcript 为空白
• 修复 /plugin Uninstall 显示"Enabled"而非"Uninstalled"
• 修复 linter 同时修改多文件时文件修改提醒总量过大
• 修复 /remote-control 重试卡在"connecting…"——每次重试现在显示结果，未注册可信设备失败提前捕获
• 修复 Remote Control 初始连接失败通知不显示错误原因
• Windows：剪贴板写入不再在 EDR/SIEM 遥测可见的进程命令行参数中暴露复制内容；同时修复超过 22KB 的选区无法到达剪贴板
• PowerShell 工具：裸 --（如 git diff -- file）不再被误标记为 --% stop-parsing token
• 修复 Agent SDK 在模型在并行工具调用批次中发出格式错误的工具名时挂起

📦 2.1.123（2026-04-29）¶

🐛 修复¶

• 修复 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 设置时 OAuth 认证因 401 重试循环失败

📦 2.1.122（2026-04-29）¶

📝 笔记定位：Bedrock 服务层级 · /resume PR 搜索 · OTel 事件增强

✨ 新功能¶

• ANTHROPIC_BEDROCK_SERVICE_TIER 环境变量：选择 Bedrock 服务层级（default、flex 或 priority），以 X-Amzn-Bedrock-Service-Tier 头发送
• /resume PR URL 搜索：在 /resume 搜索框粘贴 PR URL 现在可找到创建该 PR 的会话（支持 GitHub、GitHub Enterprise、GitLab 和 Bitbucket）
• /mcp 连接器去重提示：当 claude.ai 连接器被手动添加的同 URL 服务器隐藏时显示提示
• OpenTelemetry 数值属性：api_request/api_error 日志事件的数值属性现在以数字类型而非字符串输出
• OpenTelemetry @-mention 事件：新增 claude_code.at_mention 日志事件用于 @-mention 解析

🐛 修复¶

• 修复 /branch 在源会话包含回退时间线条目时生成失败（"tool_use ids were found without tool_result blocks"）
• 修复 /model 在 Bedrock application inference profile ARN 上不显示 Effort 选项，且 ARN 不接收 output_config.effort
• 修复 Vertex AI / Bedrock 在 session-title 生成等结构化输出查询时返回 invalid_request_error: output_config: Extra inputs are not permitted
• 修复 Vertex AI count_tokens 端点对代理网关用户返回 400 错误
• 修复 spinnerTipsOverride.excludeDefault 未抑制基于时间的 spinner 提示
• 修复 ToolSearch 在非阻塞模式下遗漏会话启动后连接的 MCP 工具
• 修复 !exit / !quit 在 bash 模式下终止 CLI 而非作为 shell 命令运行
• 修复发送到新模型的图片被调整为 2576px 而非正确的 2000px 最大值
• 修复远程控制会话空闲状态每秒重绘两次，可能淹没 tmux -CC 控制管道并暂停终端
• 修复助手消息因过期视图偏好而在某些会话中显示为空白
• 修复 settings.json 中格式错误的 hooks 条目不再使整个文件失效
• 修复语音模式下绑定到 Caps Lock 的键绑定现在显示错误（终端不传递 Caps Lock 键事件）

📦 2.1.121（2026-04-28）¶

📝 笔记定位：MCP alwaysLoad 与自动重试 · PostToolUse 替换输出 · 插件清理 · SDK Forked Subagent · 权限放宽 · /skills 搜索 · 内存泄漏修复

✨ 新功能¶

• MCP alwaysLoad 选项：设为 true 时，该服务器的所有工具跳过工具搜索延迟，始终可用
• claude plugin prune 命令：移除孤立的自动安装插件依赖；plugin uninstall --prune 级联清理
• /skills 搜索过滤：新增输入搜索框，在长列表中快速定位 skill
• PostToolUse hooks 替换工具输出：所有工具的 PostToolUse hooks 现在可通过 hookSpecificOutput.updatedToolOutput 替换工具输出（之前仅限 MCP）
• Fullscreen 模式滚动优化：在向上滚动阅读后，输入 prompt 不再跳回底部
• 对话框滚动支持：溢出终端的对话框现在支持方向键、PgUp/PgDn、Home/End 和鼠标滚轮滚动（全屏和非全屏模式）
• 全屏模式长 URL 点击：跨行换行的 URL 现在点击任意行都可打开完整 URL
• SDK CLAUDE_CODE_FORK_SUBAGENT=1：非交互式会话中也可使用 forked subagent
• --dangerously-skip-permissions 放宽：不再提示对 .claude/skills/、.claude/agents/ 和 .claude/commands/ 的写入
• /terminal-setup iTerm2 剪贴板：启用 iTerm2 的"Applications in terminal may access clipboard"设置，使 /copy 在 tmux 中也可用
• MCP 服务器启动自动重试：瞬态错误时自动重试最多 3 次，而非保持断开
• 终端标签页标题本地化：现在按配置的 language 设置生成
• claude.ai 连接器去重：相同上游 URL 的连接器自动去重
• Vertex AI X.509 证书支持：支持基于证书的 Workload Identity Federation（mTLS ADC）
• LSP 诊断摘要展开：点击/Ctrl+O 可展开，并显示展开提示
• SDK mcp_authenticate redirectUri：支持自定义 scheme 完成和 claude.ai 连接器
• OpenTelemetry span 增强：LLM 请求 span 新增 stop_reason、gen_ai.response.finish_reasons 和 user_system_prompt

⚡ 性能¶

• 启动加速：移除 release-notes splash 中的 Recent Activity 面板
• /usage 内存泄漏修复：修复泄漏高达约 2GB 内存
• 无界内存增长修复：修复处理大量图片时的无界内存增长（多 GB RSS）
• 长时间工具内存泄漏修复：修复长时间运行工具未发出明确进度事件时的内存泄漏

🔧 改进¶

• 默认 effort 调整：Pro/Max 订阅用户在 Opus 4.6 和 Sonnet 4.6 上默认 effort 从 medium 提升至 high

🐛 修复¶

• 修复 Bash 工具在 Claude 启动目录被删除或移动后永久不可用
• 修复 --resume 在外部构建中启动崩溃
• 修复 --resume 在大会话因非正常关闭导致行损坏时失败（现在跳过损坏行）
• 修复使用 Bedrock application inference profile ARN 时 thinking.type.enabled is not supported 错误
• 修复 Microsoft 365 MCP OAuth 因重复或不支持的 prompt 参数失败
• 修复在 tmux、GNOME Terminal、Windows Terminal 和 Konsole 中按 Ctrl+L 或触发重绘时的回滚重复
• 修复 claude.ai MCP 连接器在启动时遇到瞬态认证错误时静默消失
• 修复远程会话中内置工具的 "Always allow" 规则在 worker 重启后不保留
• 修复 NO_PROXY 在原生构建中通过 managed-settings.json 设置时不被所有 HTTP 客户端尊重
• 修复托管设置审批提示即使被接受也退出会话（现在应用设置并继续）
• 修复 /usage 在过期 OAuth token 后返回 "rate limited"（现在自动刷新）
• 修复 settings.json 中无效的遗留枚举值使整个设置文件失效
• 修复 /usage 对话框在无闪烁模式关闭时内容被裁剪
• 修复 /focus 在全屏渲染器关闭时显示 "Unknown command"（现在解释如何启用）
• 修复嵌入式 grep/find/rg shell wrapper 在运行中二进制被删除时失败（现在回退到已安装工具）
• 减少大型目录树中 Bash 工具 find 的峰值文件描述符使用

📦 2.1.119（2026-04-24）¶

📝 笔记定位：/config 持久化 · PostToolUse duration_ms · 插件清理命令 · /skills 搜索过滤 · --from-pr 扩展

✨ 新功能¶

• /config 设置持久化：/config 中的设置（主题、编辑器模式、verbose 等）现在持久化到 ~/.claude/settings.json 并参与项目/本地/策略覆盖优先级
• prUrlTemplate 设置：将底部 PR 徽章指向自定义代码审查 URL
• CLAUDE_CODE_HIDE_CWD 环境变量：在启动 logo 中隐藏工作目录
• --from-pr 扩展支持：现在接受 GitLab merge-request、Bitbucket pull-request 和 GitHub Enterprise PR URL
• --print 模式 agent 遵从：--print 模式现在遵循 agent 的 tools: 和 disallowedTools: frontmatter
• --agent 权限模式：--agent <name> 现在遵循 agent 定义的 permissionMode
• PowerShell 工具命令自动批准：PowerShell 工具命令现在可在权限模式下自动批准
• PostToolUse hooks duration_ms：PostToolUse 和 PostToolUseFailure hook 输入现在包含 duration_ms（工具执行时间，排除权限提示和 PreToolUse hooks）
• Subagent/SDK MCP 并行连接：子代理和 SDK MCP 服务器重新配置现在并行连接
• 插件版本约束自动更新：被另一插件版本约束固定的插件现在自动更新到最高满足版本
• Vim 模式改进：INSERT 模式下 Esc 不再将排队消息拉回输入；再按一次 Esc 中断
• 斜杠命令建议高亮：现在高亮显示与查询匹配的字符
• 斜杠命令选择器换行：长描述换行到第二行而非截断
• owner/repo#N 链接主机检测：现在使用 git remote 的主机而非总是指向 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 工具消失
• 修复全屏模式中每次工具完成后滚动回底部
• 修复 MCP HTTP 连接在服务器对 OAuth discovery 请求返回非 JSON body 时失败（"Invalid OAuth error response"）
• 修复 Rewind overlay 对包含图片附件的消息显示 "(no prompt)"
• 修复 auto mode 以冲突的 "Execute immediately" 指令覆盖 plan mode
• 修复异步 PostToolUse hooks 无响应时向会话 transcript 写入空条目
• 修复 spinner 在子代理任务通知孤立时持续显示
• 修复 ToolSearch 在 Vertex AI 上默认禁用（因不支持的 beta header 错误，可通过 ENABLE_TOOL_SEARCH 选择启用）
• 修复 @-file Tab 补全在斜杠命令中使用绝对路径时替换整个 prompt
• 修复 macOS Terminal.app 中通过 Docker 或 SSH 启动时 prompt 出现杂散 p 字符
• 修复 ${ENV_VAR} 占位符在 HTTP/SSE/WebSocket MCP 服务器的 headers 中未替换
• 修复 MCP OAuth --client-secret 存储的 client secret 在需要 client_secret_post 的服务器 token 交换时未发送
• 修复 /skills Enter 键关闭对话框而非在 prompt 中预填 /<skill-name>
• 修复 /agents 详情视图将主代理不可用的内置工具误标为 "Unrecognized"
• 修复 Windows 上插件缓存不完整时插件 MCP 服务器不启动
• 修复 /export 显示当前默认模型而非对话实际使用的模型
• 修复 verbose 输出设置重启后不持久化
• 修复 /usage 进度条与 "Resets ..." 标签重叠
• 修复插件 MCP 服务器在 ${user_config.*} 引用可选字段为空时失败
• 修复包含句末数字的列表项将数字换到单独一行
• 修复 /plan 和 /plan open 在进入 plan mode 时不作用于现有计划
• 修复 auto-compaction 前调用的 skill 在下一条用户消息上重新执行
• 修复 /reload-plugins 和 /doctor 对已禁用插件报告加载错误
• 修复 Agent 工具 isolation: "worktree" 重用先前会话的过期 worktree
• 修复禁用的 MCP 服务器在 /status 中显示为 "failed"
• 修复 TaskList 以任意文件系统顺序返回任务而非按 ID 排序
• 修复 gh 输出中 PR 标题提到 "rate limit" 时的虚假 "GitHub API rate limit exceeded" 提示
• 修复 SDK/bridge read_file 未正确执行对增长文件的大小上限检查
• 修复在 git worktree 中工作时 PR 未关联到会话
• 修复 /doctor 对被更高优先级作用域覆盖的 MCP 服务器条目发出警告
• Windows：移除虚假的 "Windows requires 'cmd /c' wrapper" MCP 配置警告
• VS Code：修复语音听写在 macOS 上首次录音因麦克风权限提示显示而无输出

📦 2.1.118（2026-04-23）¶

📝 笔记定位：Hook mcp_tool 类型 · PostToolUse 替换输出 · MCP OAuth 修复 · DISABLE_UPDATES · Auto mode $defaults · WSL 设置继承 · Vim 可视模式 · /usage 合并

✨ 新功能¶

• Vim 可视模式：新增 visual mode（v）和 visual-line mode（V），支持选择、操作符和视觉反馈
• /usage 命令合并：/cost 和 /stats 合并为 /usage，两者仍作为快捷键打开对应标签页
• 自定义主题：从 /theme 创建和切换命名自定义主题，或手动编辑 ~/.claude/themes/ 中的 JSON 文件；插件也可通过 themes/ 目录分发主题
• Hooks 调用 MCP 工具：hooks 现在可通过 type: "mcp_tool" 直接调用 MCP 工具
• DISABLE_UPDATES 环境变量：完全阻止所有更新路径（包括手动 claude update），比 DISABLE_AUTOUPDATER 更严格
• WSL 继承 Windows 设置：WSL on Windows 现在可通过 wslInheritsWindowsSettings 策略键继承 Windows 侧的托管设置
• Auto mode "$defaults"：在 autoMode.allow、autoMode.soft_deny 或 autoMode.environment 中包含 "$defaults" 可在内置列表旁添加自定义规则
• Auto mode "Don't ask again" 选项：在 auto mode 选择加入提示中新增不再询问选项
• claude plugin tag 命令：为插件创建发布 git tag，带版本验证
• --continue/--resume 搜索扩展：现在找到通过 /add-dir 添加当前目录的会话
• /color 同步：将会话强调色同步到 claude.ai/code（Remote Control 连接时）
• /model 自定义网关：模型选择器在使用自定义 ANTHROPIC_BASE_URL 网关时遵循 ANTHROPIC_DEFAULT_*_MODEL_NAME/_DESCRIPTION 覆盖
• 插件版本约束跳过提示：自动更新因另一插件版本约束而跳过时，在 /doctor 和 /plugin Errors 标签页显示

🐛 修复¶

• 修复 /mcp 菜单对使用 headersHelper 配置的服务器隐藏 OAuth 操作，以及带自定义 headers 的 HTTP/SSE MCP 服务器在瞬态 401 后卡在 "needs authentication"
• 修复 MCP 服务器 OAuth token 响应缺少 expires_in 时每小时需要重新认证
• 修复 MCP step-up authorization 在服务器 insufficient_scope 403 指定 token 已有 scope 时静默刷新而非提示重新同意
• 修复 MCP 服务器 OAuth 流超时或取消时未处理的 promise rejection
• 修复 MCP OAuth 刷新在竞争条件下缺少跨进程锁
• 修复 macOS keychain 竞争条件（并发 MCP token 刷新覆盖刚刷新的 OAuth token，导致意外的 "Please run /login" 提示）
• 修复 OAuth token 刷新在服务器撤销 token 后失败
• 修复 Linux/Windows 上凭据保存崩溃导致 ~/.claude/.credentials.json 损坏
• 修复 /login 在 CLAUDE_CODE_OAUTH_TOKEN 启动的会话中无效（现在清除 env token 使磁盘凭据生效）
• 修复 "new messages" 滚动药丸和 /plugin 徽章中文字不可读
• 修复 plan 接受对话框在使用 --dangerously-skip-permissions 时提供 "auto mode" 而非 "bypass permissions"
• 修复 agent-type hooks 在配置为 Stop 或 SubagentStop 以外的事件时报 "Messages are required for agent hooks"
• 修复 prompt hooks 被 agent-hook verifier 子代理的工具调用重新触发
• 修复 /fork 将完整父对话写入磁盘（现在写入指针并在读取时加载）
• 修复 Alt+K / Alt+X / Alt+^ / Alt+_ 冻结键盘输入
• 修复连接远程会话时覆盖本地 model 设置
• 修复粘贴以 / 开头的文件路径时 typeahead 显示 "No commands match" 错误
• 修复 plugin install 对已安装插件未重新解析安装了错误版本的依赖
• 修复无效路径或 fd 耗尽时文件监视器的未处理错误
• 修复 Remote Control 会话在 JWT 刷新期间瞬态 CCR 初始化问题后被归档
• 修复通过 SendMessage 恢复的子代理未恢复其生成时的显式 cwd

📦 2.1.117（2026-04-22）¶

📝 笔记定位：Forked Subagent · Agent MCP 加载 · /model 持久化 · /resume 智能摘要 · MCP 并发连接 · 插件依赖改进 · 原生构建搜索 · Opus 4.7 上下文窗口 · 清理周期扩展 · OpenTelemetry 增强

⚡ 性能¶

• 原生构建内嵌搜索工具：macOS/Linux 原生构建中 Glob 和 Grep 工具被内嵌的 bfs 和 ugrep 替代，通过 Bash tool 直接调用，无需单独工具往返（Windows 和 npm 安装版本不变）
• MCP 并发连接默认启用：同时配置本地和 claude.ai MCP 服务器时启动更快
• Windows where.exe 缓存：按进程缓存可执行文件查找结果，加速子进程启动

✨ 新功能¶

• Forked Subagent 外部构建支持：通过 CLAUDE_CODE_FORK_SUBAGENT=1 在外部构建中启用 forked subagent
• Agent frontmatter mcpServers 加载：通过 --agent 运行主线程代理时加载 agent frontmatter 中声明的 MCP 服务器
• Advisor Tool 改进（实验性）：对话框增加"实验性"标签和学习链接；启动时通知；修复会话卡在"Advisor tool result content could not be processed"错误
• cleanupPeriodDays 清理范围扩展：现在也清理 ~/.claude/tasks/、~/.claude/shell-snapshots/ 和 ~/.claude/backups/

🔧 改进¶

• /model 选择持久化：模型选择跨重启保留，即使项目固定了不同模型；启动头信息显示活动模型来源（项目或托管设置固定）
• /resume 智能摘要：恢复过期的大型会话前提供摘要选项，与 --resume 行为一致
• 插件依赖改进：plugin install 对已安装插件现在安装缺失依赖而非停在"already installed"；依赖错误提示"not installed"并给出安装提示；plugin marketplace add 自动从已配置市场解析缺失依赖
• 托管设置市场管控：blockedMarketplaces 和 strictKnownMarketplaces 现在在插件安装、更新、刷新和自动更新时强制执行
• OpenTelemetry 增强：user_prompt 事件新增 command_name 和 command_source（斜杠命令）；cost.usage、token.usage、api_request 和 api_error 新增 effort 属性；自定义/MCP 命令名默认脱敏（需 OTEL_LOG_TOOL_DETAILS=1 显示）
• Opus/Sonnet 4.6 默认 effort 调整：Pro/Max 订阅用户使用 Opus 4.6 和 Sonnet 4.6 时默认 effort 从 medium 提升至 high

🐛 修复¶

• 修复 Plain-CLI OAuth 会话在访问令牌过期时报"Please run /login"——现在在 401 时自动刷新令牌
• 修复 WebFetch 在超大 HTML 页面上挂起——在 HTML 转 Markdown 前截断输入
• 修复代理返回 HTTP 204 No Content 时崩溃——现在显示清晰错误而非 TypeError
• 修复 CLAUDE_CODE_OAUTH_TOKEN 环境变量启动时 /login 无效（令牌过期场景）
• 修复 prompt 输入撤销（Ctrl+_）在刚输入后无反应，以及每步撤销跳过一个状态
• 修复 NO_PROXY 在 Bun 运行时不被远程 API 请求尊重
• 修复慢速连接下按键名以合并文本到达时的虚假 escape/return 触发
• 修复 SDK reload_plugins 串行重连所有用户 MCP 服务器
• 修复 Bedrock application-inference-profile 在 Opus 4.7 且禁用思考时 400 错误
• 修复 MCP elicitation/create 请求在 print/SDK 模式下服务器连接完成后自动取消
• 修复 subagent 运行不同模型时错误触发文件读取恶意软件警告
• 修复有后台任务时空闲重渲染循环，减少 Linux 内存增长
• 修复 VS Code "Manage Plugins" 面板在配置多个大型市场时崩溃
• 修复 Opus 4.7 会话显示虚高的 /context 百分比并过早自动压缩——按 200K 上下文窗口计算而非 Opus 4.7 原生 1M

📦 2.1.116（2026-04-20）¶

📝 笔记定位：/resume 性能 · MCP 启动 · 思考进度 · /config 搜索 · 插件依赖 · 沙箱安全

⚡ 性能¶

• /resume 速度提升 66%+：大型会话（40MB+）加载更快，更高效处理含多个死分支的会话
• MCP 启动加速：配置多个 stdio 服务器时启动更快；resources/templates/list 延迟到首次 @ 提及时加载
• 终端滚动优化：VS Code、Cursor 和 Windsurf 中全屏滚动更流畅，/terminal-setup 可配置编辑器滚动灵敏度

✨ 新功能¶

• 思考进度内联显示：思考旋转器内联显示进度（"still thinking"、"thinking more"、"almost done thinking"）
• /config 搜索增强：可匹配选项值（如搜索 "vim" 可找到编辑器模式设置）
• /doctor 异步打开：无需等待当前轮次完成，可在 Claude 响应时打开
• 插件依赖自动安装：/reload-plugins 和后台插件自动更新可从已添加的市场自动安装缺失的依赖
• GitHub API 限流提示：gh 命令触发 GitHub API 限流时显示提示，便于 Agent 主动退避
• Usage 标签页即时显示：Settings 中的 Usage 标签页立即显示 5 小时和每周用量，限流时不再失败
• Agent 前置事项钩子：通过 --agent 运行主线程代理时，hooks: 前置事项可触发
• 斜杠命令无匹配提示：筛选结果为零时显示 "No commands match"

🔒 安全¶

• 沙箱 rm/rmdir 加固：针对 /、$HOME 或其他关键系统目录不再绕过危险路径安全检查

🐛 修复¶

• 修复天城文字和印度文字在终端 UI 中列对齐错误
• 修复 VS Code 集成终端滚动时的空白单元格和界面消失问题
• 修复短终端高度时模态搜索对话框溢出屏幕、遮盖搜索框和键盘提示
• 修复 Ctrl+- 在 Kitty 协议终端（iTerm2、Ghostty、WezTerm 等）中不触发撤销
• 修复 Cmd+Left/Right 在 Kitty 协议终端（Warp、kitty、Ghostty、WezTerm）中不跳转行首/行尾
• 修复通过包装进程启动（npx、bun run）时 Ctrl+Z 挂起终端
• 修复内联模式中终端调整大小或大量输出时的回滚重复问题
• 修复并行请求期间的间歇性 API 400 错误（缓存控制 TTL 顺序）
• 修复 /branch 拒绝大于 50MB 的会话文本记录
• 修复 /resume 在大型会话文件上无声显示空对话
• 修复 /plugin Installed 标签页重复显示条目
• 修复 /update 和 /tui 在进入工作树后不工作

📦 2.1.114（2026-04-17）¶

🐛 修复¶

• 修复 Agent Teams 队友请求工具权限时权限对话框崩溃

📦 2.1.113（2026-04-17）¶

📝 笔记定位：原生二进制 / Windows 特性 · Remote Control 扩展 · /loop & /ultrareview · Subagent 卡死处理 · Sandbox 安全收紧 · MCP 并发与 ToolSearch · 插件依赖冲突 · 长上下文恢复 compact · 终端快捷键

✨ 新功能¶

• 原生二进制分发：CLI 现在通过每平台可选依赖生成原生 Claude Code 二进制，而非 bundled JavaScript
• sandbox.network.deniedDomains 设置：即使更广泛的 allowedDomains 通配符允许时，仍可阻止特定域名

🔧 改进¶

• Fullscreen Shift+↑/↓ 滚动：扩展选择超出可视边缘时滚动视口
• Ctrl+A / Ctrl+E readline 行为：在多行输入中移到当前逻辑行的开头/结尾
• Windows Ctrl+Backspace：删除前一个单词
• 长 URL 跨行换行可点击：在支持 OSC 8 hyperlinks 的终端中保持可点击
• /loop 改进：Esc 取消待执行唤醒，唤醒显示为 "Claude resuming /loop wakeup"
• /extra-usage Remote Control 支持：现在可在移动/Web 客户端使用
• Remote Control @-file 自动补全：客户端可查询 @-file 补全建议
• /ultrareview 改进：并行检查更快启动、启动对话框显示 diffstat、启动状态动画化
• Subagent 卡死检测：mid-stream 卡死的 subagent 在 10 分钟后明确报错而非静默挂起
• Bash 多行注释命令：首行为注释的多行命令现在在 transcript 中显示完整命令，关闭 UI 欺骗向量
• cd <current-dir> && git …：当 cd 是 no-op 时不再触发权限提示
• macOS 安全加固：/private/{etc,var,tmp,home} 路径在 Bash(rm:*) allow 规则下视为危险删除目标
• Bash deny 规则匹配 wrappers：现在匹配被 env/sudo/watch/ionice/setsid 等 exec wrapper 包裹的命令
• Bash(find:*) 安全收紧：allow 规则不再自动批准 find -exec / -delete

🐛 修复¶

• 修复 MCP 并发调用超时处理（一个工具调用的消息可能默默撤销另一个调用的看门狗）
• 修复 Cmd-backspace / Ctrl+U 重新支持从光标删除到行首
• 修复 markdown 表格在单元格包含含管道字符的行内代码 span 时断裂
• 修复 session recap 在编写未发送的 prompt 文本时自动触发
• 修复 /copy "Full response" 未为粘贴到 GitHub/Notion/Slack 对齐 markdown 表格列
• 修复在查看运行中的 subagent 时输入的消息被隐藏并误归属于父 AI
• 修复 Bash dangerouslyDisableSandbox 在 sandbox 外运行命令时未触发权限提示
• 修复 /effort auto 确认信息（现在显示 "Effort level set to max" 与状态栏一致）
• 修复"已复制 N 字符"提示对 emoji 等多 code-unit 字符过度计数
• 修复 /insights 在 Windows 上以 EBUSY 崩溃
• 修复退出确认对话框将一次性计划任务误标为重复任务（现显示倒计时）
• 修复 fullscreen 模式下斜杠/@ 补全菜单未紧贴 prompt 边框
• 修复 CLAUDE_CODE_EXTRA_BODY output_config.effort 在 subagent 调用不支持 effort 的模型和 Vertex AI 上引发 400 错误
• 修复 NO_COLOR 设置时 prompt 光标消失
• 修复 ToolSearch 排名（粘贴的 MCP 工具名现在返回实际工具而非描述匹配的兄弟工具）
• 修复 compact 已恢复的长上下文会话失败（"Extra usage is required for long context requests"）
• 修复 plugin install 在依赖版本与已安装插件冲突时仍成功——现在报告 range-conflict
• 修复 "Refine with Ultraplan" 未在 transcript 显示远程会话 URL
• 修复 SDK 图像内容块处理失败时崩溃会话（现在降级为文本占位符）
• 修复 Remote Control 会话不流式传输 subagent transcripts
• 修复 Remote Control 会话在 Claude Code 退出时未归档
• 修复通过 Bedrock Application Inference Profile ARN 使用 Opus 4.7 时 thinking.type.enabled is not supported 400 错误

📦 2.1.112（2026-04-16）¶

🐛 修复¶

• 修复 auto mode 下 "claude-opus-4-7 is temporarily unavailable" 错误

📦 2.1.111（2026-04-16）¶

📝 笔记定位：思考力度控制 · /effort 滑块 · /ultrareview · PowerShell 工具 · Bash 免确认 · /less-permission-prompts · API 调试 · 插件诊断 · 会话恢复

✨ 新功能¶

• /effort 交互式滑块：不带参数调用 /effort 时打开交互式滑块，支持方向键在等级间导航，Enter 确认
• Opus 4.7 xhigh 推理等级：为 Opus 4.7 新增 xhigh 推理等级，介于 high 和 max 之间，可通过 /effort、--effort 和模型选择器使用
• Auto（匹配终端）主题：新增 "Auto (match terminal)" 主题选项，自动匹配终端的深色/浅色模式，从 /theme 中选择
• /less-permission-prompts skill：扫描 transcript 中常见的只读 Bash 和 MCP tool 调用，为 .claude/settings.json 生成优先级排序的允许列表建议
• /ultrareview：使用云端并行多 Agent 分析和评审运行全面代码审查，不带参数审查当前分支，或 /ultrareview <PR#> 获取并审查指定 GitHub PR
• Auto mode 免 Flag：auto mode 不再需要 --enable-auto-mode 参数
• Windows PowerShell tool：PowerShell 工具逐步推出中，通过 CLAUDE_CODE_USE_POWERSHELL_TOOL 选择加入或退出
• 只读 Bash 命令免确认：带 glob 模式的只读 Bash 命令（如 ls *.ts）以及以 cd <project-dir> && 开头的命令不再触发权限确认
• 子命令拼写建议：输入 claude <word> 拼写接近但不对时，建议最接近的子命令（如 claude udpate → "你是想说 claude update？"）
• Plan 文件命名改进：Plan 文件现在根据 prompt 命名（如 fix-auth-race-snug-otter.md），而非纯随机词
• Ctrl+U 清空输入：Ctrl+U 现在清空整个输入缓冲区（之前：删除到行首），按 Ctrl+Y 恢复
• Ctrl+L 全屏重绘：Ctrl+L 在清空 prompt 输入的同时强制全屏重绘
• /skills 按 Token 数排序：/skills 菜单现在支持按估算 token 数排序，按 t 键切换
• OTEL_LOG_RAW_API_BODIES 环境变量：将完整的 API 请求和响应体作为 OpenTelemetry 日志事件输出，用于调试
• /setup-vertex 和 /setup-bedrock 改进：当 CLAUDE_CONFIG_DIR 设置时显示实际的 settings.json 路径；重新运行时从已有 pin 中获取候选模型
• Transcript 底部快捷键提示：Transcript 视图底部现在显示 [（导出到终端回滚）和 v（在编辑器中打开）快捷键
• 长粘贴截断标记改进：截断长粘贴的 "+N lines" 标记改为全宽分隔线，更易扫描
• plugin_errors 事件字段：headless --output-format stream-json 在插件因未满足依赖而被降级时，init 事件中包含 plugin_errors

🔧 改进¶

• 抑制 TUI 在正常操作期间可能出现的虚假解压、网络和瞬态错误信息
• 撤销 v2.1.110 中对非流式回退重试的上限设置——该上限在 API 过载时以更多直接失败替代了长时间等待

🐛 修复¶

• 修复 iTerm2 + tmux 环境下发送终端通知时的显示撕裂问题（随机字符、输入漂移）
• 修复 @ 文件建议在非 git 工作目录中每轮都重新扫描整个项目
• 修复编辑前的 LSP 诊断信息在编辑后出现，导致模型重新读取刚编辑的文件
• 修复 Tab 补全 /resume 时立即恢复任意标题的 session 而非显示 session 选择器
• 修复 /context 网格渲染在行间多出空行
• 修复 /clear 丢失通过 /rename 设置的 session 名称
• 修复 Claude 调用不存在的 commit skill 并显示 "Unknown skill: commit" 的问题
• 修复 Bedrock/Vertex/Foundry 上的 429 限流错误引用 status.claude.com（该站点仅涵盖 Anthropic 运营的提供商）
• 修复关闭反馈调查后连续弹出的问题
• 修复 bash/PowerShell/MCP tool 输出中的裸 URL 在终端跨行换行时不可点击
• Windows：CLAUDE_ENV_FILE 和 SessionStart hook 环境文件现在生效（之前无效）
• Windows：带盘符路径的权限规则现在正确根锚定，仅盘符大小写不同的路径被识别为同一路径
• 插件依赖错误现在区分冲突、无效和过于复杂的版本要求；修复 plugin update 后解析版本过期的问题

📦 2.1.110（2026-04-15）¶

📝 笔记定位：/tui 与 /focus · 推送通知 · Remote Control 扩展 · Windows 特性 · 插件管理 · Hook 修复 · SDK 追踪 · 会话恢复任务 · 自动滚动配置

✨ 新功能¶

• /tui 命令：新增 /tui 命令和 tui 设置，运行 /tui fullscreen 在同一会话中切换到无闪烁渲染
• /focus 命令：Ctrl+O 改为仅在普通和详细 transcript 之间切换；专注视图现在通过新的 /focus 命令单独切换
• 推送通知 tool：Claude 可在 Remote Control 和 "Push when Claude decides" 配置启用时发送移动端推送通知
• autoScrollEnabled 配置：新增配置项，可在全屏模式下禁用对话自动滚动
• Ctrl+G 编辑器显示上下文：新增选项，在 Ctrl+G 外部编辑器中以注释形式显示 Claude 的上一条回复（通过 /config 启用）
• /resume 恢复计划任务：--resume/--continue 现在恢复未过期的计划任务

🔧 改进¶

• /plugin Installed 标签页改进：需要关注的项和收藏项置顶，禁用项折叠隐藏，按 f 收藏选中项
• /doctor 当 MCP server 在多个配置作用域中以不同端点定义时发出警告
• Remote Control 命令扩展：/autocompact、/context、/exit 和 /reload-plugins 现在可在 Remote Control（移动端/Web）客户端中使用
• Write tool 现在会在 IDE diff 中编辑了建议内容后再接受时通知模型
• Bash tool 现在强制执行文档中规定的最大超时时间，不再接受任意大的值
• SDK/headless 会话现在从环境变量读取 TRACEPARENT/TRACESTATE 用于分布式追踪链接
• Session recap 现在对禁用遥测的用户（Bedrock、Vertex、Foundry、DISABLE_TELEMETRY）启用，可通过 /config 或 CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 退出

🐛 修复¶

• 修复 MCP server 连接在 SSE/HTTP 传输中途断开时 tool 调用无限挂起
• 修复 API 不可达时非流式回退重试导致数分钟挂起
• 修复 session recap、本地斜杠命令输出和其他系统状态行在专注模式下不显示
• 修复全屏模式下 tool 运行时选中文本导致高 CPU 占用
• 修复插件安装不遵守 plugin.json 中声明的依赖；/plugin 安装现在列出自动安装的依赖
• 修复 disable-model-invocation: true 的 skill 通过 /<skill> 在消息中间调用时失败
• 修复 --resume 有时显示第一个 prompt 而非 /rename 设置的名称
• 修复排队消息在多 tool 调用轮次中短暂出现两次
• 修复 session 清理未移除完整 session 目录（包括 subagent transcript）
• 修复 CLI 重启后（如 /tui、provider 设置向导）按键丢失
• 修复 macOS Terminal.app 和其他不支持同步输出的终端中启动渲染乱码
• 安全加固："在编辑器中打开"操作防止不受信任的文件名注入命令
• 修复 PermissionRequest hook 返回 updatedInput 时未重新检查 permissions.deny 规则
• 修复 PreToolUse hook 的 additionalContext 在 tool 调用失败时被丢弃
• 修复向 stdout 输出非 JSON 行的 stdio MCP server 在第一行杂散输出时被断开（v2.1.105 回归）
• 修复 headless/SDK session 自动标题在设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 时触发额外 Haiku 请求
• 修复管道（非 TTY）Ink 输出包含单行超宽行时潜在的大量内存分配
• 修复全屏模式下 /skills 菜单在列表超出模态框时不滚动
• 修复 Remote Control session 过期时显示通用错误而非提示重新登录
• 修复从 claude.ai 的 Remote Control session 重命名未持久化标题到本地 CLI session

📦 2.1.109（2026-04-15）¶

🔧 改进¶

• 改进 extended-thinking 指示器，新增旋转进度提示

📦 2.1.108（2026-04-14）¶

📝 笔记定位：缓存 TTL 控制 · Session recap · /undo 别名 · 内置命令发现 · 内存优化 · 会话恢复改进 · 模型切换警告

✨ 新功能¶

• 1 小时 Prompt 缓存 TTL：新增 ENABLE_PROMPT_CACHING_1H 环境变量，在 API key、Bedrock、Vertex 和 Foundry 上选择 1 小时缓存 TTL；新增 FORCE_PROMPT_CACHING_5M 强制 5 分钟 TTL
• Session recap：新增 recap 功能，在返回 session 时提供上下文摘要，可在 /config 中配置，手动调用 /recap
• 内置斜杠命令发现：模型现在可以通过 Skill tool 发现和调用内置斜杠命令（如 /init、/review、/security-review）
• /undo 别名：/undo 现在是 /rewind 的别名

🔧 改进¶

• /model 在对话中途切换模型前发出警告，因为下一条响应会以未缓存方式重新读取完整历史
• /resume 选择器默认显示当前目录的 session，按 Ctrl+A 显示所有项目
• 服务端限流与计划用量限制现在区分显示；5xx/529 错误显示 status.claude.com 链接
• 通过按需加载语言语法，减少文件读取、编辑和语法高亮的内存占用
• 查看详细 transcript（Ctrl+O）时新增 "verbose" 指示器
• 启动时当 DISABLE_PROMPT_CACHING* 环境变量禁用了 prompt 缓存时显示警告

🐛 修复¶

• 修复 /login 代码输入中粘贴不工作（v2.1.105 回归）
• 修复设置了 DISABLE_TELEMETRY 的订阅用户回退到 5 分钟缓存 TTL 而非 1 小时
• 修复 Agent tool 在 auto mode 下当安全分类器的 transcript 超出上下文窗口时仍提示权限
• 修复 CLAUDE_ENV_FILE 以 # 注释行结尾时 Bash tool 无输出
• 修复 --resume 丢失通过 /rename 设置的 session 自定义名称和颜色
• 修复首条消息为简短问候时 session 标题显示占位示例文本
• 修复 --teleport 后终端转义码在 prompt 输入中显示为乱码
• 修复 /feedback 重试：失败后按 Enter 重新提交现在无需先编辑描述即可工作
• 修复 --teleport 和 --resume <id> 前置条件错误静默退出而非显示错误信息
• 修复 Remote Control session 在 Web UI 中设置的标题在第三条消息后被自动生成标题覆盖
• 修复 --resume 在 transcript 包含自引用消息时截断 session
• 修复 transcript 写入失败（如磁盘满）被静默丢弃而非记录日志
• 修复变音符号在配置了 language 设置时从响应中丢失
• 修复策略管理的插件在从非首次安装的项目运行时从不自动更新

📦 2.1.107（2026-04-14）¶

🔧 改进¶

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

📦 2.1.105（2026-04-13）¶

📝 笔记定位：PreCompact 可阻断 · 插件 monitors 键 · Skill 描述上限提升 · /proactive 别名

✨ 新功能¶

• EnterWorktree 工具新增 path 参数：可在现有 worktree 之间直接切换，无需重新创建
• PreCompact Hook 支持阻断：exit code 2 可阻止自动压缩执行
• 插件后台监控：插件 manifest 新增 monitors 键，支持挂载后台监控进程
• /proactive 命令：作为 /loop 的别名使用

🔧 改进¶

• API 流式传输卡住超过 5 分钟后自动中止并切换到非流式重试
• 网络错误消息立即显示重试提示，不再等待
• 超长单行文件写入在 UI 中截断显示，而非分页翻页
• /doctor 界面重新设计，加入状态图标
• /config 菜单标签和说明更清晰
• Skill 描述上限从 250 提升至 1,536 字符
• WebFetch 工具自动过滤页面中的 <style> 和 <script> 标签
• 改进合并了 squash-merged PR 的过期 Agent worktree 清理
• MCP 大体量输出截断时提供格式化相关的具体指引

🐛 修复¶

• 修复排队消息附带的图片被丢弃
• 修复长对话中提示词换行时屏幕变空白
• 修复助手消息中前导空白被丢失
• 修复 Bash 输出在带可点击文件链接时显示乱码
• 修复 Alt+Enter 和 Ctrl+J 在多种终端中换行插入失效
• 修复 "Creating worktree" 文字重复出现
• 修复焦点模式下已排队的用户提示词消失
• 修复单次定时任务被反复触发
• 修复 Team/Enterprise 入站频道通知被静默丢弃
• 修复市场插件安装时未自动安装依赖
• 修复自动更新后官方市场状态丢失
• 修复 /resume 会话提示未正确打印
• 修复反馈调查快捷键失效
• 修复输出格式不规范的 stdio MCP 服务器导致卡住，现在快速失败
• 修复 headless 会话第一轮无法使用 MCP 工具
• 修复 /model 选择器在 AWS Bedrock 非 US 区域无法使用
• 修复多个提供商的 429 速率限制错误未显示清晰提示
• 修复 /resume 在遇到格式错误的 text block 时崩溃
• 修复终端高度较短时 /help 布局错乱
• 修复格式错误的键绑定条目不再被静默接受，改为报错
• 修复 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 在单项目持久化场景下不生效
• 修复通过 SSH/mosh 连接时 16 色调色板显示偏淡
• 修复模式降级时 Bash 工具权限提示行为不一致

📦 2.1.101（2026-04-11）¶

📝 笔记定位：企业网络配置 · Settings 与权限

✨ 新功能¶

• /team-onboarding 命令：根据本地 Claude Code 使用记录生成团队新人上手指南
• OS CA 证书存储默认信任：企业 TLS 代理无需额外配置即可工作（设置 CLAUDE_CODE_CERT_STORE=bundled 仅使用内置 CA）
• /ultraplan 自动创建云环境：/ultraplan 及其他远程会话功能现在自动创建默认云环境，无需先在网页端配置

🔧 改进¶

• brief mode 现在会在 Claude 返回纯文本而非结构化消息时自动重试一次
• focus mode 中 Claude 编写更自包含的摘要，因为用户只能看到最终消息
• 工具不可用错误现在解释原因和后续步骤，当模型调用的工具存在但当前上下文不可用时
• rate-limit 重试消息现在显示命中的限制和重置时间，而非模糊的秒数倒计时
• 拒绝错误消息现在包含 API 提供的解释（如果可用）
• claude -p --resume <name> 现在接受通过 /rename 或 --name 设置的会话标题
• settings 韧性改进：settings.json 中无法识别的 Hook 事件名称不再导致整个文件被忽略
• 通过托管设置强制启用的插件 Hook 现在在设置 allowManagedHooksOnly 时正常运行
• /plugin 和 claude plugin update 在 marketplace 无法刷新时显示警告，而非静默报告过时版本
• plan mode 在用户组织或认证设置无法访问 Claude Code 网页端时，隐藏「Refine with Ultraplan」选项
• beta tracing 现在遵循 OTEL_LOG_USER_PROMPTS、OTEL_LOG_TOOL_DETAILS 和 OTEL_LOG_TOOL_CONTENT 设置
• SDK query() 在消费者从 for await 中 break 或使用 await using 时正确清理子进程和临时文件

🐛 修复¶

• 修复 POSIX which 回退中的命令注入漏洞（LSP 二进制检测使用）
• 修复长会话中虚拟滚动器保留大量消息列表历史副本导致内存泄漏
• 修复 --resume/--continue 在大会话上丢失对话上下文（加载器锚定到死胡同分支而非活跃对话）
• 修复 --resume 链恢复桥接到无关子 Agent 对话（当子 Agent 消息位于主链写入间隙附近时）
• 修复 --resume 在持久化的 Edit/Write 工具结果缺少 file_path 时崩溃
• 修复硬编码的 5 分钟请求超时中止慢速后端（本地 LLM、扩展思考、慢网关），忽略 API_TIMEOUT_MS
• 修复 permissions.deny 规则不覆盖 PreToolUse Hook 的 permissionDecision: "ask"（之前 Hook 可将拒绝降级为提示）
• 修复 --setting-sources 未包含 user 时，后台清理忽略 cleanupPeriodDays 并删除 30 天前的对话历史
• 修复 Bedrock SigV4 认证在设置 ANTHROPIC_AUTH_TOKEN、apiKeyHelper 或 ANTHROPIC_CUSTOM_HEADERS 的 Authorization 头时返回 403
• 修复 claude -w <name> 在之前会话的 worktree 清理留下过期目录时报「already exists」
• 修复子 Agent 不继承动态注入的 MCP 服务器工具
• 修复在隔离 worktree 中运行的子 Agent 被拒绝访问其 worktree 内的文件
• 修复沙箱 Bash 命令在全新启动后因 mktemp: No such file or directory 失败
• 修复 claude mcp serve 工具调用在验证 outputSchema 的 MCP 客户端中报「Tool execution failed」
• 修复 RemoteTrigger 工具的 run 操作发送空请求体被服务器拒绝
• 修复多个 /resume 选择器问题：窄默认视图隐藏其他项目会话、Windows Terminal 无法预览、worktree 中 cwd 不正确、会话未找到错误未输出到 stderr、终端标题未设置、恢复提示与输入重叠
• 修复 Grep 工具在嵌入的 ripgrep 二进制路径过期时 ENOENT（VS Code 扩展自动更新、macOS App Translocation）；现在回退到系统 rg 并在会话中自修复
• 修复 /btw 每次使用时将整个对话写入磁盘
• 修复 /context 的 Free space 和 Messages breakdown 与头部百分比不一致
• 修复多个插件问题：斜杠命令解析到具有重复 name: frontmatter 的错误插件、/plugin update 失败报 ENAMETOOLONG、Discover 显示已安装的插件、目录源插件从过期版本缓存加载、skill 不遵循 context: fork 和 agent frontmatter 字段
• 修复 /mcp 菜单对使用 headersHelper 配置的 MCP 服务器提供 OAuth 特定操作；现在改为提供 Reconnect 以重新调用辅助脚本
• 修复 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 被移除、连接失败未持久化到记录、brief mode 中本地会话显示虚假「Disconnected」指示器、/remote-control 在仅设置 CLAUDE_CODE_ORGANIZATION_UUID 时通过 SSH 失败
• 修复 /insights 有时从响应中省略报告文件链接
• [VSCode] 修复关闭最后一个编辑器标签时聊天输入下方的文件附件未清除

📖 更早版本（2.1.98 及之前）请查看更新日志归档。

更早版本（1.x 及之前）请查看更新日志（1.x 及更早）。