Appearance
更新日志
Claude Code 的版本更新日志,内容自动同步自 GitHub 上的 CHANGELOG.md。记录每个版本的新功能、改进和 Bug 修复。运行 claude --version 查看当前安装的版本。
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_BODYoutput_config.effort在调用不支持 effort 的模型及 Vertex AI 的子 agent 时导致 400 错误的问题 - 修复了在设置了
NO_COLOR时提示光标消失的问题 - 修复了
ToolSearch排名问题,使得粘贴的 MCP 工具名称会显现出实际工具而不是描述匹配的兄弟工具 - 修复了压缩已恢复的长上下文会话因“长上下文请求需要额外使用量”而失败的问题
- 修复了当依赖版本与已安装插件冲突时
plugin install会成功的问题——现在报告range-conflict - 修复了“使用 Ultraplan 优化”未在转录中显示远程会话 URL 的问题
- 修复了处理失败的 SDK 图像内容块导致会话崩溃的问题——现在降级为文本占位符
- 修复了远程控制会话未流式传输子 agent 转录的问题
- 修复了当 Claude Code 退出时远程控制会话未归档的问题
- 修复了通过 Bedrock 应用程序推理配置文件 ARN 使用 Opus 4.7 时的
thinking.type.enabled is not supported400 错误
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 日
- 修复了
/resume和/branch后的 UI 挂起(状态栏卡在加载动画) - 改进了
/plugin已安装选项卡——需要注意的项目和收藏夹出现在顶部,禁用的项目隐藏在折叠后,按f可以收藏所选项目 - 改进了
/doctor,当在一个设置的作用域中定义了具有不同端点的 MCP 服务器时发出警告 --resume/--continue现在复活未到期的定时任务/context、/exit和/reload-plugins现在可从远程控制(移动/网页)客户端使用- 写入工具现在在你于 IDE 的 diff 中编辑提议的内容后接受它时通知模型
- Bash 工具现在强制执行文档化最大超时而不是接受任意大的值
- SDK/headless 会话现在从环境中读取
TRACEPARENT/TRACESTATE以进行分布式跟踪链接
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动作发送空请求体被服务器拒绝的问题
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向语言服务器标识自身
常见问题
Q: 如何查看 Claude Code 的完整更新日志?
A: 本页面同步自 GitHub,记录最近版本的更新。更完整的历史记录请访问 GitHub CHANGELOG.md。运行 claude --version 可查看当前安装版本。
Q: 如何更新到最新版本?
A: 原生安装方式(推荐)会在后台自动更新。也可以手动运行 claude update。Homebrew 用户需运行 brew upgrade claude-code,WinGet 用户需运行 winget upgrade Anthropic.ClaudeCode。
Q: 某个 Bug 修复在哪个版本中?
A: 每个版本的更新条目都会详细列出 Bug 修复。使用浏览器的页面搜索(Ctrl/Cmd+F)搜索相关关键词,或查看 GitHub 上的完整 CHANGELOG。