WSL下调整窗口大小导致Claude Code CLI闪崩

背景

在 Linux 开发环境中，WSL2（Windows Subsystem for Linux 2）因其能够运行完整的 Linux 发行版（如 Ubuntu）并与 Windows 系统无缝集成，成为许多开发者的首选平台。然而，WSL2 与 Windows 主机之间的交互机制（特别是图形渲染、终端窗口大小调整等）偶尔会引发兼容性问题。

近期，在使用 Claude Code（Anthropic 推出的 CLI 代码助手）时，部分用户遇到了一个特定的稳定性问题：在 WSL2 环境下，当用户尝试调整 bash 终端窗口的大小时，Claude Code 进程会发生闪崩（Crash）。这一问题不仅影响了开发体验，也暴露了特定版本软件与底层环境交互时的潜在缺陷。

核心内容

该问题主要涉及以下技术栈和现象：

1. 环境配置：

   • 操作系统：WSL2，运行 Ubuntu 26.04 版本。
   • 系统库：glibc 2.43。
   • 交互模式：启用了 interop（允许 WSL 与 Windows 进程交互）。
   • 软件版本：Claude Code v2.1.195，采用原生单文件二进制格式（244 MB ELF），通过 npm 包装器启动。

2. 问题现象：

   • 在 Claude Code（简称 cc）运行期间，一旦用户尝试调整终端窗口的大小，程序立即崩溃。
   • 此问题在旧版本中不存在，仅在较新版本中出现。

3. 社区排查与尝试：

   • 社区用户尝试了多种解决方案，包括排查显卡渲染问题、推荐使用 tmux 终端复用器、以及调整内存分配等，但均未彻底解决该问题。

4. 当前可行解决方案：

   • 在 VS Code 中安装相关插件，通过 VS Code 的终端调用 Claude Code。
   • 此方法避开了原生 bash 窗口大小调整引发的冲突，运行稳定且体验舒适。

关键要点

• 触发条件明确：问题直接由“调整 bash 窗口大小”这一动作触发，属于典型的终端信号处理或渲染同步问题。
• 版本特异性：问题出现在 Claude Code v2.1.195 及后续版本，旧版本无此问题，暗示新版本可能在终端交互逻辑或依赖库上进行了变更。
• 环境依赖性：问题仅在 WSL2 环境下复现，与 glibc 版本（2.43）及 interop 启用状态有关，纯 Linux 环境或 Windows 原生 PowerShell/CMD 可能不受影响。
• 社区方案局限性：显卡渲染、tmux、内存分配等常见排查方向未能解决此问题，说明问题根源可能更偏向于终端窗口事件处理而非资源或图形后端。
• 有效规避策略：使用 VS Code 插件作为中间层调用 CLI 工具，是目前公认的稳定替代方案。

意义与影响

1. 对开发者的影响：

   • 对于依赖 WSL2 进行 AI 辅助开发的开发者而言，终端窗口大小调整是高频操作。闪崩问题严重干扰工作流，迫使开发者改变使用习惯（如转向 VS Code 插件模式）。
   • 凸显了 WSL2 环境下原生二进制工具与终端模拟器之间兼容性的重要性。

2. 对 Anthropic 的启示：

   • 作为 AI 代码助手，CLI 工具的稳定性至关重要。此问题表明，Anthropic 需要加强对 WSL2 等混合环境的测试覆盖，特别是在处理终端信号（如 SIGWINCH）时的健壮性。
   • 用户反馈“以前的版本就没有这个问题”，说明回归测试可能未充分覆盖终端交互场景。

3. 技术生态意义：

   • 反映了 AI 工具链正在从“云端 API 调用”向“本地原生二进制 CLI”演进，这类工具对底层系统环境的依赖性和兼容性要求更高。
   • 促进了社区对 WSL2 终端行为、glibc 版本与二进制兼容性之间关系的深入探讨。

4. 未来展望：

   • 期待 Anthropic 能在后续版本中修复此问题，恢复原生 CLI 的稳定性。
   • 对于无法等待修复的用户，VS Code 插件方案提供了一个可行的临时替代路径，但也提示了未来 AI 工具可能需要更完善的跨平台终端支持。