Claude Code 更新追踪

日期： 2026-03-18
版本： 2.1.78

更新概览

Claude Code 发布 2.1.78 版本，这是一次重要的维护更新，带来了多项新功能和大量 bug 修复。本次更新增强了插件系统、改进了终端通知支持、优化了响应流式输出体验，并修复了近 20 个已知问题，涵盖沙盒权限、VSCode 集成、语音模式等多个方面。

重要变更详解

🚀 新功能

功能	说明
`StopFailure` Hook 事件	新增 hook 事件，当 turn 因 API 错误（如 rate limit、认证失败等）结束时触发
`${CLAUDE_PLUGIN_DATA}` 变量	插件持久化状态变量，可在插件更新后保留数据；`/plugin uninstall` 会提示是否删除
Plugin Agent Frontmatter 扩展	插件打包的 agents 现支持 `effort`、`maxTurns`、`disallowedTools` 配置
Tmux 终端通知穿透	当在 tmux 中运行且启用了 `set -g allow-passthrough on` 时，iTerm2/Kitty/Ghostty 弹窗通知可传递到外层终端
响应逐行流式输出	响应文本现在会逐行流式呈现，提升交互体验
自定义模型选项	新增 `ANTHROPIC_CUSTOM_MODEL_OPTION` 环境变量，可在 `/model` 选择器中添加自定义条目，支持 `_NAME` 和 `_DESCRIPTION` 后缀变量配置显示名称和描述

🔒 安全修复

问题	修复
沙盒静默禁用	当 `sandbox.enabled: true` 但依赖缺失时，现在会显示启动警告而非静默禁用沙盒

🐛 Bug 修复

沙盒与权限

修复 Linux 沙盒 Bash 中 git log HEAD 报 "ambiguous argument" 错误，以及 stub 文件污染 git status 的问题
修复 deny: ["mcp__servername"] 权限规则未能移除 MCP server 工具，导致模型仍可看到并尝试调用被阻止工具的问题
修复 sandbox.filesystem.allowWrite 无法使用绝对路径（之前需要 // 前缀）的问题
修复 bypassPermissions 模式下 .git、.claude 等受保护目录可被无提示写入的问题

会话与日志

修复大型会话（>5 MB）使用 subagents 时，cc log 和 --resume 静默截断对话历史的问题
修复 API 错误触发 stop hooks 后重新将阻塞错误喂给模型导致无限循环的问题
修复恢复大型会话时的内存占用和启动时间问题
修复排队 prompts 在连接时缺少换行符分隔符的问题

终端与 UI

修复普通模式下 ctrl+u 滚动而非 readline kill-line 行为（ctrl+u/ctrl+d 半页滚动移至 transcript 模式）
修复在不支持 truecolor 的 VSCode/Cursor/code-server 终端中 Claude 橙色显示过淡的问题

语音模式

语音模式修饰键组合 push-to-talk 绑定（如 ctrl+k）需要长按而非立即激活的问题
修复 WSL2 + WSLg (Windows 11) 上语音模式不工作的问题；WSL1/Win10 用户现在会收到明确错误提示

Git 与工作目录

修复 --worktree 标志不从 worktree 目录加载 skills 和 hooks 的问题
修复 CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 和 includeGitInstructions 设置未能抑制系统提示中 git status 部分的问题

环境与兼容

修复 VSCode 从 Dock/Spotlight 启动时 Bash 工具找不到 Homebrew 等 PATH 依赖二进制文件的问题
修复使用 Haiku 模型时 ANTHROPIC_BETAS 环境变量被静默忽略的问题
修复 /sandbox Dependencies 标签在 macOS 上显示 Linux 前置条件而非 macOS 特定信息的问题

VSCode 扩展

修复已认证状态下打开侧边栏时登录界面短暂闪烁的问题
修复订阅者计划层级未知时选择 Opus 出现 "Rate limit reached" 错误（模型下拉菜单不再向此类用户显示 1M context 变体）

影响分析

对普通用户

体验提升：响应逐行流式输出让交互更流畅，大型会话恢复更快更省内存
更可靠的通知：tmux 用户配置 allow-passthrough on 后可收到终端弹窗通知
语音模式改进：Windows 11 WSL2 用户现可使用语音模式，push-to-talk 体验更自然

对插件开发者

更强的插件能力：CLAUDE_PLUGIN_DATA 变量支持持久化状态，agents 支持 frontmatter 配置
更精细的错误处理：StopFailure hook 可用于处理 API 错误场景

对企业/安全敏感用户

沙盒安全增强：依赖缺失时会明确警告而非静默降级
权限控制修复：deny 规则现在正确生效，受保护目录在 bypass 模式下也有防护

对 VSCode 用户

更稳定的扩展：登录界面闪烁已修复，Opus 选择不再触发 rate limit 错误
更好的终端兼容：从 Dock/Spotlight 启动时 PATH 问题已解决

升级建议

建议所有用户尽快升级，特别是： - 使用 tmux 的用户（启用 set -g allow-passthrough on 获取通知） - WSL2 + Windows 11 用户（语音模式现已支持） - 关注 沙盒安全 的用户（安全警告增强） - 插件开发者（新 API 和持久化支持）

📦 Claude Code 更新