资讯

Claude Code v2.1.119–2.1.132 更新解读:5 月新功能汇总(ultrareview CLI、project purge、MCP 增强)

Claude Code 5 月密集更新解读(v2.1.119–2.1.132):ultrareview 正式支持 CLI 非交互运行(CI/CD 集成);claude project purge 清除项目状态;CLAUDE_CODE_SESSION_ID 注入 Bash 子进程;--dangerously-skip-permissions 覆盖更多路径;安全修复(allowManagedDomainsOnly 绕过问题);MCP alwaysLoad 选项;PostToolUse 注入 duration_ms;/config 设置持久化;Windows 不再依赖 Git for Windows;以及多个终端渲染和内存泄漏修复。

2026/5/76分钟 阅读ClaudeEagle

Claude Code 在 4 月底到 5 月初密集发布了多个版本(v2.1.119–2.1.132),带来大量实用新功能和 Bug 修复。本文解读其中最值得关注的更新。


重大新功能

/ultrareview CLI 化(v2.1.120)

bash
claude ultrareview [target]

/ultrareview 现在有了对应的 CLI 子命令,可以在 CI/CD 脚本里非交互式运行:

  • 找到的问题直接打印到 stdout
  • --json 输出原始 JSON 格式,方便程序处理
  • 退出码:完成为 0,失败为 1

这意味着可以在 GitHub Actions 里把 ultrareview 集成到 PR 检查流程:

yaml
- name: Claude Code 代码审查
  run: claude ultrareview --json > review.json
  # 如果发现 critical 问题,退出码为 1,Pipeline 失败

claude project purge(v2.1.126)

bash
claude project purge [path]          # 删除项目的所有 Claude Code 状态
claude project purge --dry-run       # 预览要删除的内容
claude project purge --interactive   # 交互式选择
claude project purge --all           # 清除所有项目

删除内容:会话记录(transcript)、任务、文件历史、配置条目。适合:

  • 清理离职员工的项目状态
  • 处理敏感信息泄露后的清理
  • 释放磁盘空间

CLAUDE_CODE_SESSION_ID 注入 Bash 子进程(v2.1.132)

Bash 工具的子进程环境里现在自动包含 CLAUDE_CODE_SESSION_ID,与传递给 Hooks 的 session_id 一致。

用途:让 Bash 脚本知道自己是哪个 Claude Code 会话调用的,方便日志关联和审计追踪。

CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1(v2.1.132)

bash
export CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1
claude

禁用全屏交替渲染,让对话保留在终端的原生滚动历史里。

适合:

  • 需要用终端滚动缓冲区查看历史的场景
  • tmux/screen 里滚动行为异常时
  • 截图或录制终端内容时

权限和安全改进

--dangerously-skip-permissions 覆盖更多路径(v2.1.126)

--dangerously-skip-permissions 现在也绕过 .claude/.git/.vscode/、shell 配置文件等之前受保护的路径的写入提示。灾难性的删除命令仍然会提示,作为保底安全网。

这对 CI/CD 管道有用——之前某些自动化场景会被路径保护打断。

安全修复:allowManagedDomainsOnly 绕过问题(v2.1.126)

修复了当更高优先级的 managed-settings 来源缺少 sandbox 块时,allowManagedDomainsOnly / allowManagedReadPathsOnly 被忽略的安全问题。企业用户如果依赖这两个策略,强烈建议升级


MCP 相关改进

MCP 工具数量显示(v2.1.128)

/mcp 命令现在显示每个已连接服务器的工具数量,并标记连接了但工具数为 0 的服务器(之前是静默显示,难以发现配置问题)。

MCP 服务器自动重试(v2.1.121)

启动时遇到瞬时错误的 MCP 服务器现在自动重试最多 3 次,而不是一直保持断开状态。减少需要手动重启的情况。

alwaysLoad 选项(v2.1.121)

json
{
  "mcpServers": {
    "my-server": {
      "command": "...",
      "alwaysLoad": true  // 新增
    }
  }
}

设置为 true 后,该服务器的所有工具跳过"工具搜索延迟加载",始终立即可用。适合高频使用的 MCP 服务器(如内部数据库、代码搜索工具)。

workspace 成为保留服务器名(v2.1.128)

workspace 现在是 MCP 保留名,使用该名称的现有服务器会被跳过并给出警告,请重命名。


Windows 改进

不再强依赖 Git for Windows(v2.1.120)

Git for Windows 不再是必须的。当没有安装时,Claude Code 自动使用 PowerShell 作为 Shell 工具。

PowerShell 工具权限自动批准(v2.1.119)

PowerShell 工具命令现在可以在权限模式中被自动批准,与 Bash 行为一致。之前需要单独配置。

Windows 剪贴板安全修复(v2.1.126)

剪贴板写入不再把复制内容暴露在进程命令行参数里(之前可能被 EDR/SIEM 遥测工具捕获),同时修复了超过 22KB 的内容无法到达剪贴板的问题。


Hooks 增强

PostToolUse 注入 duration_ms(v2.1.119)

PostToolUsePostToolUseFailure 的 Hook 输入现在包含 duration_ms(工具执行时间,不含权限提示和 PreToolUse hook 的时间)。

用于性能监控:

bash
#!/bin/bash
# 记录慢工具调用
DURATION=$(echo "$CLAUDE_TOOL_RESULT" | python3 -c "import json,sys; print(json.load(sys.stdin).get('duration_ms',0))")
if [ "$DURATION" -gt 5000 ]; then
  echo "[SLOW TOOL] $CLAUDE_TOOL_NAME took ${DURATION}ms" >> ~/.claude/slow-tools.log
fi

PostToolUse 可替换工具输出(v2.1.121)

PostToolUse Hook 现在可以通过 hookSpecificOutput.updatedToolOutput 替换所有工具的输出(之前只有 MCP 工具支持)。

应用场景:

  • 敏感数据脱敏:把工具返回内容里的 API Key、密码替换为 [REDACTED]
  • 内容过滤:过滤掉工具输出里的不合规内容
  • 格式标准化:把工具输出统一转为某种格式再给 Claude 看

上下文和性能

/config 设置持久化(v2.1.119)

/config 里的设置(主题、编辑器模式、verbose 等)现在持久化到 ~/.claude/settings.json,参与项目/用户/策略的覆盖优先级体系。之前会话结束后这些设置会重置。

CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE(v2.1.129)

bash
export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1

通过 Homebrew 或 WinGet 安装时,设置此环境变量后 Claude Code 会在后台自动运行升级命令,并在升级完成后提示重启。

Hooks 里支持 ${CLAUDE_EFFORT} 变量(v2.1.120)

Skills 现在可以在内容里引用 ${CLAUDE_EFFORT} 获取当前的努力等级,根据不同努力等级提供不同的指令。


Bug 修复精选

终端体验

  • 修复全屏模式下笔记本从睡眠恢复、Ctrl+Z/fg 后显示空白屏幕
  • 修复 Ctrl+L 清除输入内容(现在只强制刷新屏幕,不影响输入)
  • 修复 JetBrains IDE 2025.2 终端的滚轮处理(滚动方向错误、意外加速等)

核心稳定性

  • 修复 MCP stdio 服务器向 stdout 写入非协议数据时内存无限增长(RSS 超 10GB)
  • 修复大型目录树的 find 命令耗尽文件描述符导致系统级崩溃(macOS/Linux)
  • 修复通过管道向 claude -p 发送超大输入(>10MB)时崩溃

Opus 4.7 1M 上下文修复(v2.1.119)

  • 修复状态栏显示 context_window Token 数为累计会话总量而非当前上下文用量(之前一直显示偏高)

升级建议

  1. 有安全策略依赖(allowManagedDomainsOnly等) → 立即升级到 v2.1.126+
  2. 在 CI/CD 里使用 ultrareview → 升级到 v2.1.120+,改用 claude ultrareview CLI
  3. Windows 用户(无 Git for Windows) → v2.1.120 开始不再需要
  4. JetBrains 用户有滚轮问题 → v2.1.132 已修复
bash
# 检查当前版本
claude --version

# 升级(Homebrew)
brew upgrade --cask claude-code

# 升级(npm)
npm update -g @anthropic-ai/claude-code

来源:Claude Code 官方 Changelog | GitHub CHANGELOG.md | 整理:ClaudeEagle

相关文章推荐

资讯Claude Code Week 17 新功能详解:网页端重设计、Vim 可视化模式、Hooks 调用 MCP 工具Claude Code Week 17(4 月 20-24 日)功能详解:网页端 claude.ai/code 大改版(会话侧边栏+拖拽布局);Vim 可视化模式(v/V 字符/行选择);Hooks 直接调用 MCP 工具(type:mcp_tool 无需启动进程);Forked Subagents 继承父 Session 完整上下文;/resume 速度提升 67%;/usage 统一 /cost 和 /stats;Opus 4.7 真正 1M 上下文修复。2026/5/1资讯Claude Code Week 16 新功能详解:Opus 4.7 上线、Routines 定时 Agent、/ultrareview 云端代码审查Claude Code Week 16(4 月 13-17 日)五大功能:Opus 4.7 正式上线(Max/Team Premium 默认)含新的 xhigh 努力等级和 /effort 交互滑块;Routines 定时云端 Agent(时间表/GitHub 事件/API 三种触发);/usage 用量细分(并行 Session/Subagent/缓存未命中/长上下文各自占比);/ultrareview 云端并行代码审查;CLI 原生二进制替换 JavaScript。2026/5/1资讯Claude Code Week 13-14 功能详解:Auto Mode、Computer Use CLI、/powerup 交互课程全解析2026 年 3 月下旬到 4 月初两周的重磅功能解析:Auto Mode 自动权限管理、Computer Use 桌面版和 CLI 版、PR Auto-fix 自动让 CI 变绿、/powerup 终端内交互教程、无闪烁渲染、MCP 工具结果大小覆盖到 50 万字符、Plugin 可执行文件加入 PATH,以及条件 Hooks 配置。每个功能含完整使用命令。2026/4/26资讯Claude Code Week 15 更新详解:Ultraplan 云端规划、Monitor /loop、/team-onboarding 和 /autofix-prClaude Code 第 15 周(4 月 6-10 日)四大功能详解:① Ultraplan——云端长时间深度规划(vs 普通 Plan Mode 对比);② Monitor + /loop——自主任务的智能节奏控制;③ /team-onboarding——一键生成团队上手文档;④ /autofix-pr——终端直接读取 PR 问题并自动修复(需要 GitHub MCP)。2026/4/22资讯Claude Code 重磅更新:原生 VS Code 扩展 Beta + Checkpoints 回滚 + Agent SDK 完整解析Claude Code 三大重磅更新详解:① 原生 VS Code 扩展(Beta)——专属侧边栏 + 实时内联 Diff;② Checkpoints——每次改动前自动快照,Esc×2 或 /rewind 即时回滚;③ Claude Agent SDK(原 Claude Code SDK)——新增 Subagents 和 Hooks 支持。含完整安装步骤和使用场景对比。2026/4/22资讯Claude Code 2026 年 3-4 月更新合集:/powerup 教学、MCP 500K、会话稳定性全解析Claude Code v2.1.69 到 v2.1.101 五周迭代全解析:/powerup 交互式学习系统、/team-onboarding 文档生成、MCP 工具结果上限提升到 500K token、/cost 费用详情、headless 权限延迟、NO_FLICKER 渲染引擎、Opus 4.6 百万上下文支持。2026/4/16