针对 Claude Code 2.1.121 版本的深度调研显示：该版本通过修复四项独立的内存泄漏问题，显著提升了长会话的运行稳定性；MCP 机制引入了 alwaysLoad 属性与启动自动重试逻辑，Plugin 新增 prune 清理指令，PostToolUse hooks 功能突破了 MCP 的局限，实现全工具覆盖；此外，OpenTelemetry 新增 stop_reason 等字段，进一步完善了针对大语言模型（LLM）调用的可观测性体系。

一、核心摘要

Claude Code 2.1.121 是一次涵盖“底层内存优化、MCP/插件体验打磨、Hooks 能力拓展”的全方位质量迭代。本次更新条目密集、覆盖面广，涉及内存泄漏修复、MCP 稳定性增强、Hooks API 扩展、终端交互体验优化以及 SDK 能力提升，几乎所有子系统均有所动作。

最值得关注的三个演进方向：

1. 底层内存泄漏的集中治理： 修复四项独立的内存泄漏问题——包括多图片会话中高达数 GB 的常驻集（RSS）异常增长、大型 transcript 场景下 /usage 指令导致的约 2GB 内存泄漏、长时运行工具未发送进度事件引发的泄漏，以及大型目录树下 find 命令导致文件描述符（fd）激增的问题。这些修复使长会话的稳定性获得了实质性提升。

2. MCP 与 Plugin 生态趋于成熟： MCP 新增 alwaysLoad 选项以跳过工具搜索延迟机制，并在启动阶段引入最多 3 次的自动重试；Plugin 推出 prune 指令用于清理孤立依赖；PostToolUse hooks 现已支持替换所有工具的输出（此前期限于 MCP）。

3. 终端与 SDK 能力的边界拓展： 全屏模式下的滚动操作不再被输入打断，超长对话框支持键盘与鼠标滚动；环境变量 CLAUDE_CODE_FORK_SUBAGENT=1 现已在非交互式场景中生效；mcp_authenticate 开始支持 redirectUri；OpenTelemetry 新增 stop_reason 等核心字段。

核心定调： 这是一个将 2.1 系列各项过渡性功能打磨至生产级标准的稳定性版本。长会话重度用户、MCP 深度使用者、Plugin 开发者以及 SRE/可观测性团队均将从中直接获益。

二、本版三大核心特性详解

2.1 底层内存泄漏的集中治理：长效运行能力的确立

针对以下四项代码的修复：

• Fixed unbounded memory growth (multi-GB RSS) when processing many images in a session

• Fixed /usage leaking up to ~2GB of memory on machines with large transcript histories

• Fixed memory leak when long-running tools fail to emit a clear progress event

• Reduced peak file descriptor usage during find in the Bash tool on large directory trees

对于长时间使用 Claude Code 的用户而言，此组修复带来的感知最为强烈。

以往的技术痛点：

• 在涉及多图片的会话（如设计稿评审、UI 调试、截图交互）中，长时间运行会导致 RSS 飙升至 5–10GB，最终引发内存溢出（OOM）。

• 在具有庞大 transcript 历史记录的设备上，执行 /usage 指令会触发约 2GB 的内存泄漏，导致重度用户对该命令望而却步。

• 长时间运行的命令（如构建、测试、爬虫）若未正确发送 progress 事件，将导致内部缓冲区持续膨胀。

• 在大型代码库中执行 find 命令时，文件描述符占用会触及上限，致使 Bash tool 直接报错。

该修复的核心价值： 随着 Claude Code 逐渐具备 IDE 属性，单次开启时间往往长达数小时甚至跨越数天。此前几个版本在“会话保活”方面的努力提升了用户保持长会话的意愿，但内存问题导致“长效运行”异化为“运行崩溃”。此次四项独立修复的集中打包，彻底补齐了“长会话稳定性”这一关键短板。

实际应用价值：

• 从事多图片设计评审或维护超长 transcript 的核心工程师，可保障全天候稳定运行。

• /usage 指令不再具备触发严重内存泄漏的风险。

• 执行长周期任务（如数据集处理、端到端测试）时，无需再周期性重启实例。

• 在大型 monorepo 架构下，Bash tool 不会再因 fd 限制而陷入瘫痪。

2.2 MCP 与 Plugin 生态演进：从基础可用向工程化管理跨越

针对以下代码的更新：

• Added alwaysLoad option to MCP server config — when true, all tools from that server skip tool-search deferral and are always available

• Added claude plugin prune to remove orphaned auto-installed plugin dependencies; plugin uninstall --prune cascades

• PostToolUse hooks can now replace tool output for all tools via hookSpecificOutput.updatedToolOutput (previously MCP-only)

• MCP servers that hit a transient error during startup now auto-retry up to 3 times instead of staying disconnected

• Claude.ai connectors with the same upstream URL are now deduplicated instead of appearing as duplicates

• Fixed claude.ai MCP connectors silently disappearing when the connector-list fetch hits a transient auth error at startup

对于 MCP 深度用户和 Plugin 开发者而言，此组更新具有极高的工程价值。

alwaysLoad 机制：消除“工具不可见”现象 近期版本引入了 tool-search deferral 机制——为节省上下文开销，非常用工具不予预加载。此举虽有利于生态发展，但对业务关键的 MCP（如数据库连接、内部 API、CI 触发器）构成了挑战。配置 alwaysLoad: true 可将该类 server 的 tools 标记为常驻内存，直接跳过 deferral 机制。这标志着 MCP server 配置首次引入了“重要性优先级”维度。

plugin prune 指令：生态成熟度的重要标志

claude plugin prune                    # 清理孤立依赖
claude plugin uninstall  --prune # 卸载时级联清理

任何包管理器发展至特定阶段，都必然需要 prune 能力（如 npm、apt、brew）。该指令的问世，印证了 Claude Code Plugin 生态已切实面临“自动安装的依赖随时间堆积”的真实痛点——这同时也意味着 Plugin 的使用规模已达到不可忽视的量级。

PostToolUse hooks 实现全工具支持：

{
  "hookSpecificOutput": {
    "updatedToolOutput": "..."
  }
}

该能力此前仅对 MCP tool 开放。如今，所有工具（包括 Bash、Edit、Read、Grep 等）均可在 PostToolUse 阶段被 hook 拦截并改写输出。其潜在应用场景包括：在数据送入模型前自动脱敏敏感信息；将 Bash 工具的报错信息翻译为更具可执行性的提示；为 Read 工具的输出附加项目级别的上下文信息等。这是 hooks 机制真正迈向“通用化”的关键一步，其定位已升级为“可构建完整的工具输出中间件层”。

MCP 启动自动重试：规避手动重连成本 在启动阶段遭遇瞬时错误时，以往会导致 server 直接进入断开状态。现已支持自动重试 3 次，配合连接列表在瞬时鉴权失败时不再静默消失的修复，MCP 在不稳定网络环境下的行为表现具备了高度可预测性。

2.3 终端交互与 SDK 能力拓展：于细微处彰显产品功力

针对以下特性的更新：

• Fullscreen mode: typing into the prompt no longer jumps scroll back to the bottom after you've scrolled up to read earlier output

• Dialogs that overflow the terminal are now scrollable with arrow keys, PgUp/PgDn, home/end, and mouse wheel in both fullscreen and non-fullscreen modes

• Clicking any line of a long URL that wraps across rows in fullscreen mode now opens the full URL

• SDK and claude -p: CLAUDE_CODE_FORK_SUBAGENT=1 now works in non-interactive sessions

• SDK: mcp_authenticate now supports redirectUri for custom scheme completion and claude.ai connectors

• OpenTelemetry: added stop_reason, gen_ai.response.finish_reasons, and user_system_prompt (gated behind OTEL_LOG_USER_PROMPTS) to LLM request spans

• 全屏模式阅读连贯性保障：修复了用户查阅历史输出时，键盘输入导致视图被强行拉回底部的历史遗留问题。

• 长对话框滚动支持：全面支持方向键、PgUp/PgDn、Home/End 键以及鼠标滚轮操作，覆盖全屏与非全屏模式。

• CLAUDE_CODE_FORK_SUBAGENT=1 适配非交互场景：打通了 CI/批处理脚本中的分支限制，意味着可以在自动化流水线中构建“主 agent 并行调度多个 subagent”的复杂工作流。

• mcp_authenticate 支持 redirectUri：OAuth 授权流程现可指定自定义 scheme 回调，使第三方 MCP 集成的 OAuth 实现更加符合行业标准。

• OpenTelemetry 新增三项核心字段：stop_reason（记录模型停止原因）、gen_ai.response.finish_reasons（标准 GenAI 语义约定）、user_system_prompt（受开关控制的用户级系统提示词）。此更新对 SRE 团队具有重大意义，为告警策略与 SLO 制定提供了准确的数据支撑。

三、关键修复项梳理

本版修复密度极高，以下列举几项影响深远的技术修复：

• Bash tool 启动目录异常：修复了 Worktree 切换、临时目录场景下因目录被删除/移动导致工具永久不可用的缺陷。

• --resume 损坏自愈：补齐了长会话保活能力的最后一块拼图——遇到 transcript 损坏行现可自动跳过，而非引发整体崩溃。

• Bedrock ARN 阻断性缺陷：解决了采用 Bedrock + ARN profile 的企业用户面临的 thinking.type.enabled 不受支持的严重问题。

• M365 OAuth 参数失败：直接改善了 Microsoft 365 集成生态的稳定性。

• 跨终端滚动重复问题：修复了 tmux/GNOME/Windows Terminal/Konsole 环境下的 Ctrl+L 复制缺陷。

• 权限持久化失效：解决了 Worker 重启后 "Always allow" 规则丢失的历史遗留问题。

• 企业代理合规性：修复了 NO_PROXY 在原生构建的 managed-settings 下不生效的问题。

• 企业部署流程中断：修复了 Managed settings 同意后仍退出 session 的异常逻辑，现已调整为应用配置并继续会话。

四、交互体验与边界优化

• 安全底线设定：--dangerously-skip-permissions 不再绕过 .claude/skills/、agents/、commands/ 的写入权限，保护项目结构核心。

• 剪贴板权限打通：/terminal-setup 启用 iTerm2 的相关设置，确保了 /copy 指令在复杂终端环境下的可用性。

• 检索效率提升：/skills 引入搜索框，解决了技能数量增多后列表检索困难的问题。

• 启动速度优化：release-notes splash 移除 Recent Activity 面板，消除了每次升级时的性能瓶颈。

• GCP 合规拼图：Vertex AI 支持 X.509 证书的 Workload Identity Federation (mTLS ADC)。

• UI 原生化：VSCode 内 /context 升级为原生 token usage dialog，提高了信息密度；LSP 诊断摘要支持交互式展开。

五、版本演进横向对比

演进趋势研判： 2.1 系列的发展重心已从“功能堆叠”明确转向“稳定性打磨与生态成熟度建设”。2.1.121 版本正是这一战略转移的典型代表——几乎未引入全新功能，但各个子系统均实现了更为扎实的基础架构。

六、面向不同用户群体的升级建议

• 长会话重度用户（日均 6 小时以上）： 强烈建议立即升级。四项内存修复叠加损坏自愈机制，长会话稳定性获得实质性改善，建议体验优化后的全屏模式交互。

• MCP 深度用户（配置 5 个以上 servers）： 强烈建议立即升级。为核心 server 配置 alwaysLoad: true 可彻底消除工具不可见现象，启动自动重试机制提升了弱网环境下的可预测性。

• Plugin 开发者： 建议升级并深入研究 plugin prune，将其纳入开发文档体系；PostToolUse hooks 的全工具支持提供了构建数据脱敏、上下文注入等中间件的新锚点。

• SRE / 可观测性团队： 强烈建议立即升级。OTel 新增字段是完善告警策略与 SLO 体系的关键缺失拼图（需注意基于隐私保护的 OTEL_LOG_USER_PROMPTS 默认处于关闭状态，请按需开启）。

• Windows / 企业级部署用户： 建议升级。结合上一版本的 Git Bash 解禁，整体体验持续改善；此前导致批量部署流程受阻的 managed settings 缺陷已修复。

• Bedrock / Vertex AI 用户： 采用 Bedrock ARN profile 且启用 thinking 的用户属于必升范畴（已修复阻断性缺陷）；GCP 企业用户新增了 mTLS ADC 合规选项。

• 普通用户： 可在观察 24–48 小时稳定性后升级。虽非强制更新，但 UX 交互改进叠加内存优化所带来的体验提升是切实可感的。

七、结语

Claude Code 2.1.121 并非一个提供新奇功能的版本，而是一个致力于将现有功能体系打造得更为坚固的版本——内存运行趋于稳健、MCP 机制变得可控、Plugin 生态具备了清理能力、Hooks 实现了通用化、Telemetry 遥测体系趋于完整。这标志着 2.1 系列正式从“功能拓展阶段”迈入“成熟稳定阶段”。