Claude Code Changelog

日期： 2026-03-26
版本： 2.1.84, 2.1.83

更新概览

Claude Code 发布了两个重要版本，带来了大量新功能、Bug 修复和性能优化。

v2.1.84 主要亮点： - Windows PowerShell 工具（预览） - 深度链接改进，支持首选终端 - 多项 Hook 和环境变量增强 - Token 显示和缓存优化

v2.1.83 主要亮点： - managed-settings.d/ 目录支持，便于多团队独立部署策略 - 会话搜索功能（Ctrl+O 后按 /） - 远程会话和 MCP 连接的稳定性大幅提升 - 启动性能优化，SDK 模式快 14%

重要变更详解

🆕 新功能

核心功能

• PowerShell 工具（Windows 预览）： 为 Windows 用户提供 PowerShell 支持，需手动启用。详见 文档
• 会话搜索： 在会话模式（Ctrl+O）下按 / 可搜索历史，n/N 切换匹配项
• 图片粘贴改进： 粘贴的图片会在光标处插入 [Image #N] 标记，支持位置引用
• Agents 初始提示： Agent 可在 frontmatter 中声明 initialPrompt，自动提交首轮消息
• 深度链接改进： claude-cli:// 链接现在会在首选终端中打开

Hook 与扩展

• 新 Hook 事件： TaskCreated、CwdChanged、FileChanged
• WorktreeCreate Hook： 支持 type: "http"，可返回创建的 worktree 路径
• Rules/Skills paths： frontmatter 中的 paths: 现支持 YAML glob 列表

配置与环境变量

• managed-settings.d/ 目录： 支持多团队独立部署策略片段，按字母序合并
• 新环境变量：
• ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_SUPPORTS — 覆盖第三方（Bedrock/Vertex/Foundry）模型能力检测
• ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_NAME/DESCRIPTION — 自定义 /model 选择器标签
• CLAUDE_STREAM_IDLE_TIMEOUT_MS — 配置流式空闲超时（默认 90s）
• CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 — 从子进程环境中移除敏感凭证
• CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK — 禁用非流式回退
• disableDeepLinkRegistration — 禁止注册 claude-cli:// 协议处理器
• sandbox.failIfUnavailable — 沙箱不可用时退出而非无沙箱运行
• allowedChannelPlugins 管理设置： 团队/企业管理员可定义插件白名单

VSCode 扩展

• 速率限制警告横幅： 显示使用百分比和重置时间
• Esc 双击倒带： 打开键盘可导航的倒带选择器
• 60 秒无响应提示： 加载动画变红并显示 "Not responding"

🐛 Bug 修复

输入与交互

• 修复语音按键说话（hold-to-talk）字符泄漏到文本输入的问题
• 修复上/下方向键在 footer 聚焦时无响应
• 修复 Ctrl+U 在多行输入边界无效的问题
• 修复鼠标事件在会话搜索中插入 "mouse" 文字
• 修复 Ctrl+B 干扰 readline 向后字符移动
• 修复空格键在语音输入后被吞没 3 秒的问题

稳定性

• 修复 macOS 退出时挂起
• 修复空闲几秒后屏幕闪烁
• 修复大型文件 diff 时超时（现在 5 秒超时并优雅回退）
• 修复启动时语音模块加载导致 1-8 秒冻结
• 修复 caffeinate 进程不正确终止导致 Mac 无法休眠
• 修复远程会话内存泄漏（工具调用 ID 无限累积）
• 修复 MCP 工具调用在 SSE 连接中断时无限挂起

MCP 与远程

• 修复 --mcp-config 绕过 allowedMcpServers/deniedMcpServers 策略
• 修复 claude.ai MCP 连接器在单次 --print 模式下不可用
• 修复容器重启后远程会话丢失历史记录
• 修复远程会话在临时认证错误时要求重新登录而非自动重试

其他

• 修复 --worktree 在名称包含 / 时静默挂起
• 修复 WSL1/Docker 无音频硬件时 ALSA 错误破坏终端 UI
• 修复 Termux/Android 上 SoX 检测失败
• 修复 SDK 会话恢复时历史丢失（hook 消息分叉父 UUID 链）

⚡ 性能优化

• 启动性能： 并行运行 setup()，提升约 30ms
• MCP 启动： REPL 立即渲染，不阻塞等待服务器连接
• SDK 模式： --bare -p 快约 14%
• 插件加载： 命令、技能、Agent 从磁盘缓存加载，无需重新获取
• Bedrock 冷启动： 并行获取配置文件
• --resume： 大会话内存和启动延迟优化
• WebFetch： 大页面峰值内存降低
• 滚动重置： 从每轮一次减少到每约 50 条消息一次
• Stats 截图： 快 16 倍，所有构建版本可用
• P90 提示缓存率： 提升
• Token 显示： ≥1M 显示为 "1.5m" 而非 "1512.6k"

📝 其他改进

• MCP 工具描述和服务器指令上限 2KB，防止 OpenAPI 生成服务器膨胀上下文
• 本地和 claude.ai 连接器配置的 MCP 服务器自动去重（本地配置优先）
• 后台 bash 任务卡在交互提示约 45 秒后显示通知
• 全局系统提示缓存在启用 ToolSearch 时生效
• /status 在 Claude 响应时可用
• 中断提示时自动恢复输入以便编辑重新提交
• WebFetch 标识为 Claude-User，方便网站管理员识别和允许
• 斜杠命令不可用时隐藏而非显示（如 /voice、/mobile 等）
• 非流式回退 token 上限 21k → 64k，超时 120s → 300s
• 废弃 TaskOutput 工具，改用 Read 读取后台任务输出文件

影响分析

对普通用户

1. Windows 用户福音： PowerShell 工具让 Windows 体验更完整
2. 会话搜索： 长会话中查找历史变得简单高效
3. 深度链接更智能： 点击链接会在你常用的终端打开
4. 更稳定的体验： 大量崩溃和挂起问题已修复

对企业/团队

1. 策略管理更灵活： managed-settings.d/ 让不同团队可独立部署配置
2. 插件白名单： allowedChannelPlugins 提供更精细的控制
3. 凭证安全： CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 防止敏感信息泄漏

对开发者

1. Hook 更强大： 新事件支持更细粒度的自动化
2. SDK 更快： 启动延迟降低 14%
3. 调试更方便： x-client-request-id 头帮助追踪超时问题

对 VSCode 用户

1. 速率限制可见： 一目了然用量情况
2. 会话历史更可靠： 修复了重新打开会话历史加载问题
3. 无响应提示： 60 秒无响应时明确提示

报告生成时间：2026-03-26 12:04 Asia/Shanghai