Claude Code Changelog 更新报告

日期: 2026-03-05
仓库: anthropics/claude-code

📋 更新概览

今天 Claude Code 发布了 2 个新版本：v2.1.69 和 v2.1.68。

v2.1.69 是一个重磅更新，包含超过 80 项改进，涵盖新功能、bug 修复和性能优化。最值得关注的包括：全新的 /claude-api skill、语音支持扩展到 20 种语言、大量内存泄漏修复、以及显著的性能提升。

v2.1.68 是一个小版本，主要调整了 Opus 4.6 的默认 effort 设置，并将旧版 Opus 4/4.1 用户自动迁移到 Opus 4.6。

✨ 重要变更详解

🎯 新功能

开发工具增强

• /claude-api skill: 新增专门用于构建 Claude API 和 Anthropic SDK 应用的技能
• /reload-plugins 命令: 无需重启即可激活插件变更
• ${CLAUDE_SKILL_DIR} 变量: Skills 可以引用自身目录
• git-subdir 插件源类型: 支持指向 git 仓库内的子目录
• pathPattern 正则匹配: 为文件/目录 marketplace 源添加更灵活的路径匹配

用户体验改进

• 语音支持扩展: 新增 10 种语言的语音转文字支持（俄语、波兰语、土耳其语、荷兰语、乌克兰语、希腊语、捷克语、丹麦语、瑞典语、挪威语），总计支持 20 种语言
• Effort 级别显示: Logo 和 spinner 现在显示当前的 effort 设置（如 "with low effort"）
• 数字键盘支持: 选择选项时支持数字键盘（之前仅支持主键盘数字键）
• Ctrl+U 退出 Bash: 在空 Bash 提示符下按 Ctrl+U 可退出 Bash 模式
• Agent 名称显示: 使用 claude --agent 时终端标题显示 agent 名称
• /remote-control 自定义名称: 可为 remote-control 会话设置自定义标题
• Claude Code Desktop 提示: 在 macOS 和 Windows 上首次启动时提示桌面版（最多显示 3 次）

配置与权限

• includeGitInstructions 设置: 可移除内置的 Git 工作流说明
• sandbox.enableWeakerNetworkIsolation: macOS 上允许 Go 程序（gh、gcloud、terraform）通过自定义 MITM 代理验证 TLS 证书
• pluginTrustMessage: 管理设置中可添加组织特定的插件信任警告
• Policy limit 获取: Team 计划 OAuth 用户也可获取策略限制（之前仅 Enterprise）
• oauth.authServerMetadataUrl: MCP 服务器可指定自定义 OAuth 元数据发现 URL

Hook 系统

• InstructionsLoaded 事件: 当 CLAUDE.md 或 .claude/rules/*.md 加载时触发
• agent_id 和 agent_type: Hook 事件中新增 agent 标识字段
• worktree 字段: Status line hook 命令中包含 worktree 信息

🐛 Bug 修复

安全性

• 嵌套 skill 发现漏洞: 修复可能从 gitignored 目录（如 node_modules）加载技能的安全问题
• Symlink 逃逸: 修复在 acceptEdits 模式下通过符号链接父目录写新文件可能逃逸工作目录的问题
• 权限绕过: 修复 interactive tools 在 skill 的 allowed-tools 中时自动允许并使用空答案运行的漏洞

身份验证与凭据

• macOS keychain 损坏: 修复使用多个 OAuth MCP 服务器时大型 OAuth 元数据可能溢出 stdin 缓冲区的问题
• .credentials.json 丢失订阅类型: 修复配置端点临时失败时订阅类型丢失的问题
• Trust dialog: 修复首次运行时静默启用所有 .mcp.json 服务器的问题

会话与交互

• 内存泄漏: 修复多个内存泄漏问题：
• 长时间运行的 SDK/CCR 会话中对话消息不必要保留
• React Compiler memoCache 中旧消息数组版本累积
• REPL render scopes 累积（1000 turns 约 35MB）
• Hook 事件无限累积
• Teammate 内存保留问题
• Ctrl+O 卡顿: 修复长会话中 transcript 切换冻结数秒的问题
• Shift+Enter: 修复在 Ghostty SSH 中打印 [27;2;13~ 而非插入换行
• Stash 清空: 修复在 Claude 工作时提交消息导致 stash 被清空
• Plan mode 多行输入: 修复反馈输入不支持多行文本
• 输入框光标: 修复光标无法移动到输入框顶部空行

工具与功能

• /stats 崩溃: 修复 transcript 文件包含缺失或畸形时间戳时崩溃
• --model 解析: 修复 claude-opus-4-0 和 claude-opus-4-1 解析到过时版本
• remote-control 崩溃: 修复 npm 安装时立即崩溃（"bad option: --sdk-url"）
• --setting-sources user: 修复无法阻止动态发现的项目技能
• Plugin hooks: 修复任何 /plugin 操作后 hook 不触发的问题
• 重复 CLAUDE.md: 修复在 worktree 嵌套主仓库时重复加载

平台特定

• Windows: 修复 worktree 文件复制、全局 .claude 文件夹检测、CMD 风格 2>nul 重定向创建 nul 文件
• Android: 修复 Remote Control 会话中运行本地 slash commands 崩溃
• macOS: 修复使用 OAuth 的 MCP 服务器导致 UI 帧率下降

⚡ 性能优化

启动性能

• --worktree 启动: 消除启动路径上的 git 子进程
• macOS 启动: 消除管理设置解析时的冗余设置文件重载，企业/团队用户跳过不必要的 keychain 查询
• MCP -p 启动: 通过流水线 claude.ai 配置获取和本地连接，使用并发池替代顺序批处理
• Voice 启动: 移除导致重新渲染卡顿的预热脉冲动画
• 多 skills/plugins: 修复安装大量技能/插件时启动缓慢

运行时性能

• Spinner 性能: 将 50ms 动画循环与周围 shell 隔离，减少渲染和 CPU 开销
• UI 渲染: 在原生二进制文件中使用 React Compiler 改进渲染性能
• LSP 工具: 不再读取整个文件来渲染和构建内存上下文
• 文件操作: 避免读取文件内容进行存在性检查（6 个位置）
• 会话上传/内存同步: 在大小/二进制检查前避免将大文件读入内存

内存优化

• 基线内存: 延迟 Yoga WASM 预加载，减少约 16MB
• SDK/CCR 会话: 使用 stream-json 输出减少内存占用
• 恢复大会话: 减少内存使用（包括压缩历史）
• 长会话: 稳定 onSubmit 减少内存使用

Token 优化

• Multi-agent 任务: 更简洁的 subagent 最终报告，减少 token 使用

🔧 其他变更

模型配置

• Opus 4.6 默认 medium effort: Max 和 Team 订阅者现在默认使用 medium effort（速度与彻底性的平衡点）
• "ultrathink" 关键字: 重新引入以启用下一个 turn 的 high effort
• Opus 4/4.1 迁移: 从 Claude Code 中移除，固定这些模型的用户自动迁移到 Opus 4.6
• Sonnet 4.5 迁移: Pro/Max/Team Premium 用户自动迁移到 Sonnet 4.6

用户体验

• /resume 选择器: 显示最近的提示而非第一个，解决标题显示为 (session) 的问题
• MCP connector 失败: 显示通知而非静默从工具列表消失
• 示例命令: 确定性生成而非调用 Haiku
• 压缩后恢复: 不再产生前言回顾

文档与配置

• 文档澄清: --append-system-prompt-file 和 --system-prompt-file 在交互模式也有效（文档之前说仅 print 模式）

SDK & VSCode

• SDK task creation: 不再需要 activeForm 字段，spinner 回退到任务主题
• VSCode compaction 显示: 作为可折叠的 "Compacted chat" 卡片，摘要显示在内部
• VSCode 权限模式选择器: 尊重 permissions.disableBypassPermissionsMode 设置
• VSCode RTL 文本: 修复阿拉伯语、希伯来语、波斯语渲染反转问题

Bug 修复（其他）

• API 400 errors: 修复 forked agents 在中断 tool-batch 时恢复的错误
• Orphaned tool result: 修复"unexpected tool_use_id found in tool_result blocks"错误
• Nested teammates: 修复通过 Agent tool 的 name 参数意外生成嵌套 teammates
• CLAUDE_CODE_MAX_OUTPUT_TOKENS: 修复在对话压缩时被忽略
• /compact summary: 修复在 SDK consumers 中渲染为用户气泡
• Voice space bar: 修复语音激活失败后卡住
• Memory spike: 修复提交大型未跟踪二进制文件时多 GB 内存峰值
• Escape 中断: 修复输入框有草稿文本时 Escape 无法中断正在运行的 turn
• TeammateIdle/TaskCompleted hooks: 支持 {"continue": false, "stopReason": "..."} 停止 teammate
• WorktreeCreate/WorktreeRemove hooks: 修复被静默忽略
• Skill descriptions: 修复包含冒号的描述无法从 SKILL.md frontmatter 加载
• /context token counts: 修复显示服务器所有 MCP 工具的相同 token 计数
• Settings tabs: 修复 /config 搜索框聚焦但为空时 Tab/arrow 键不循环设置标签
• Service key OAuth: 修复 CCR 容器从 profile-scoped 端点获取 403 时产生 [ERROR] 日志
• Remote Control indicator: 修复"Remote Control active"状态指示器颜色不一致
• Voice waveform cursor: 修复在输入中间听写时光标覆盖第一个后缀字母
• Voice input: 修复预热期间显示所有 5 个空格而非限制在约 2 个
• MCP binary content: PDF、Office 文档或音频工具现在将解码字节保存到磁盘并使用正确文件扩展名，而非将原始 base64 转储到对话上下文
• Terminal flicker: 修复滚动边界处动画元素导致的闪烁
• Frame stalls: 修复同步调试日志刷新导致的偶发帧停顿
• Hang on corrupted file: 修复 --mcp-config 指向损坏文件时挂起
• Extra blank lines: 修复展开的 subagent transcript 视图中工具调用下方出现额外空行

💡 影响分析

对普通用户

1. 多语言用户福音: 语音支持扩展到 20 种语言，更多非英语用户可以用母语进行语音交互
2. 性能感知提升: 启动更快、长会话不卡顿、内存占用减少，整体体验更流畅
3. Effort 设置可视化: 能清楚看到当前使用的 effort 级别，避免混淆
4. Opus 4.6 默认优化: Max/Team 用户自动享受更平衡的 effort 设置

对开发者

1. /claude-api skill: 快速构建 Claude API 集成应用的利器
2. Plugin 开发增强: git-subdir 源类型、${CLAUDE_SKILL_DIR} 变量、/reload-plugins 命令让插件开发更灵活
3. Hook 系统扩展: 新事件和字段提供更多集成点
4. SDK 改进: Task creation 简化、VSCode 扩展功能增强

对企业/团队

1. 权限管理增强: Policy limit 支持 Team 计划、pluginTrustMessage 自定义、权限绕过漏洞修复
2. OAuth 稳定性: 修复多个 OAuth 相关问题，减少重复登录
3. 性能与成本: Token 使用优化、内存泄漏修复，长时间运行更稳定

需要注意

1. Opus 4/4.1 已移除: 如果有脚本固定这些模型，需要更新到 Opus 4.6
2. Sonnet 4.5 自动迁移: Pro/Max/Team Premium 用户会自动迁移到 Sonnet 4.6
3. Windows 用户: 多个平台特定修复，建议尽快升级
4. 长会话用户: 大量内存泄漏修复，升级后体验显著改善

总结: v2.1.69 是一个质量极高的版本，在功能丰富的同时重点解决了性能和稳定性问题。强烈建议所有用户升级，尤其是经常使用长会话、多语言语音或企业部署的用户。