【问题记录】Claude Code 在 Windows 下 Alt+M 快捷键不好使的解决方案
大家好，我是一个刚接触 Claude Code 的小白。
这几天在 Windows 上用 Claude Code 时，遇到了一个很奇怪的 bug：终端里 Alt+M 无法切换模式。
本来官方文档说：
Windows 下的快捷键是 Alt+M。
但是我按下去毫无反应，在 VS Code 内置终端里不行，换到外部 PowerShell / cmd 里也不行，郁闷了很久。
1. 问题定位
一开始我还以为是 VS Code 把 Alt 键拦截 了，改了半天配置也没用。
后来我发现，即使在外部 cmd / PowerShell 里也不好使，那就说明 问题不在 IDE ，而是在 Node.js 环境。
我当时的 Node 版本是 22.17.1（最新的 Current 版）。
2. 解决办法
后来我在社区里查到有人说：
- Claude Code 在 Windows 上的快捷键依赖 终端 VT 模式 (Virtual Terminal Mode) 。
- 这个功能在 Node.js 20.x LTS 版本 支持得最好，但在 22.x 上很多 TUI 工具都有 bug（比如
fetch failed、快捷键失效等）。
于是我试着装了一个 LTS 版本：
perl
nvm install 20.19.4
nvm use 20.19.4再运行 Claude Code，Alt+M 瞬间恢复正常！
3. 科普一下：什么是终端 VT 模式？
小白版解释：
- 终端本质上就是一个输入输出窗口。
- 早期终端只能显示纯文本，没法控制颜色、光标位置。
- VT 模式（Virtual Terminal mode） 是 Windows 在命令行里模拟的一种功能，让程序可以通过 ANSI 控制序列来移动光标、改变颜色、检测快捷键等。
- Claude Code 这种交互式 TUI 工具就是依赖 VT 模式来捕捉按键事件的。
4. 为什么 Node.js 22.x 有问题？
- Node 22.x 是 Current 版本 ，很多底层改动还在迭代，社区里不少 TUI 工具（像
neo-tree、lazygit、Claude Code）都反馈过 bug。 - Node 20.x 是 LTS（长期支持版） ，对 Windows 终端 VT 的兼容性更稳定，所以官方和大部分工具测试时都会以 20.x 为基准。
所以，像我这种小白，如果只是想稳定使用，建议直接用 Node 20.x LTS，不要追最新版本。
5. 总结
- 问题：Claude Code 在 Windows 上 Alt+M 无效。
- 原因：Node 22.x 下的 VT 模式兼容性有 bug。
- 解决：切换到 Node 20.19.4 LTS，立刻恢复正常。
一句话：新不一定好，LTS 才是王道。
6. 给同样踩坑的小伙伴
如果你也是小白：
- 不要怕，问题很多时候不是你操作错，而是版本兼容性。
- Claude Code 这种工具更新很快，建议关注它的 Release Notes。
- 如果快捷键、终端渲染异常，第一步先看看自己是不是用的 Node 22，换到 20.x 基本能解决大部分问题。
👉 这就是我这次的踩坑记录，希望能帮到正在挣扎的朋友们。
如果你也遇到过类似问题，欢迎留言交流。