前言

五一期间，Claude Code 悄然发布了 v2.1.126 版本。这次更新不仅带来了一个大家呼声已久的功能——项目状态一键清理，还解决了在远程环境（SSH、WSL2）下登录难的问题。对于 Windows 用户来说，这更是一个里程碑版本，PowerShell 终于成为了“一等公民”。

提交时间： 2026-05-01 02:05 UTC

---

一、 重磅新功能：项目全量清理 (claude project purge)

当你完成一个项目并想彻底清除所有本地 AI 生成的数据时，不再需要手动删除各个隐藏目录了。

• 新命令：claude project purge [path]。

• 作用：删除该项目所有的 Claude Code 状态，包括：

  • 会话转录（Transcripts）

  • 任务记录（Tasks）

  • 文件历史（File History）

  • 配置条目（Config entries）

• 进阶操作：支持 --dry-run（预览删除内容）、-y（静默删除）和 --all（清理所有已知项目状态）。

---

二、 登录与网络：打通“最后一公里”

1. 远程环境登录优化

在 WSL2、SSH 或容器（Container）中使用 Claude 时，由于浏览器回调无法访问本地 localhost，常导致登录失败。

• 改进：claude auth login 现在支持手动粘贴 OAuth 代码。当浏览器无法回调时，直接在终端输入代码即可完成授权。

2. 更加健壮的流传输

• 休眠唤醒修复：解决了 Mac 笔记本在请求中途休眠后唤醒报 "Stream idle timeout" 的问题。

• 背景任务保活：修复了长思考（Thinking）过程中，由于模型长时间不输出导致背景会话误判为超时的 Bug。

---

三、 Windows 体验：PowerShell 全面上位

• 主要 Shell 切换：现在当 PowerShell 工具启用时，Claude 会将其视为主 Shell，不再默认调用 Bash，这更符合 Windows 开发者的习惯。

• 安装路径自动检测：支持通过 Microsoft Store、MSI 安装或作为 .NET global tool 安装的 PowerShell 7 自动发现。

• 安全性增强：修复了剪贴板写入时，内容暴露在进程命令行参数中的风险，防止了 EDR/SIEM 监控系统的敏感信息泄露。

---

四、 核心功能修复与体验优化

1. 图片处理自动缩放

• 痛点：以前粘贴超过 2000px 的大图会导致会话直接崩溃。

• 修复：现在粘贴时会自动等比缩小。如果历史记录中存在超大图，系统会在加载时自动移除并重试请求。

2. 权限与安全

• 权限跳过增强：--dangerously-skip-permissions 现在可以绕过对 .claude/、.git/、.vscode/ 等路径的写入确认。但别担心，毁灭性的系统删除命令依然保留了安全确认。

• 沙盒策略修复：修复了在管理设置（Managed-settings）中 sandbox 模块被跳过的安全漏洞。

3. 视觉反馈优化

• 红色预警：当工具执行卡在权限检查环节时，Loading 旋转图标（Spinner）会变成红色，提示用户需要手动操作。

• 状态清除：Ctrl+L 现在只负责强制刷新屏幕，不再错误地清空已输入的 Prompt 内容。

---

五、 Bug 修复清单

类别	修复内容
国际化	修复了 Windows 下“无闪烁模式”导致中日韩文字显示乱码的问题。
工具发现	修复了子代理（Subagents）在第一轮对话中无法发现 WebSearch 等延迟加载工具的问题。
插件管理	修复了 /plugin 卸载后依然显示为 "Enabled" 的 UI Bug。
性能	限制了由于 Linter 修改大量文件导致的“文件变动提醒”信息堆叠，防止阻塞上下文。

---

结语

从 v2.1.126 开始，Claude Code 在多环境兼容性上迈出了一大步。特别是对项目数据的清理能力，让它在处理敏感项目或资源整理时更加游刃有余。

升级命令：

claude update