前言
五一期间，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
