Claude Code 无法复制历史消息：从选区冲突到滚动失效的完整排查
这次排查最初来自一个很明确的问题：
Claude Code 无法复制历史消息。
仅凭这句话，可能的原因很多：macOS 剪贴板异常、VS Code 快捷键冲突、终端选区失效，或者 Claude Code 自己拦截了复制操作。因此第一步不是直接改配置，而是确认版本、运行环境和具体复现路径。
随后拿到了更关键的现象描述：
复制后报错“没有在终端中选择要复制的内容”，然后再次就无法选中历史消息了。
这条补充把问题从泛泛的“复制失败”，缩小到了终端选区所有权：屏幕上看起来已经选中，但终端认为自己没有选中任何内容。
本文按照实际排查顺序记录整个过程：确认环境、定位 Claude 全屏 TUI 的选区冲突、第一次永久规避、发现滚动副作用，最后改用同时保留复制和历史滚动的方案。
第一步：确认问题环境
当时的环境如下：
- macOS
- VS Code 集成终端，同时也在 tmux 中复现
- Claude Code
2.1.220 TERM=xterm-256color或TERM=tmux-256color- Claude Code 使用全屏 TUI
先运行基础检查：
claude --version
claude doctor
安装状态正常，claude doctor 返回：
Running: npm-global (2.1.220)
Platform: darwin-arm64
No installation issues found.
这说明问题不在安装损坏，而在交互层。
第二步：解释为什么看起来选中了，终端却说没有选区
全屏 TUI 会启用终端的 mouse reporting，也就是把点击、拖动、滚轮等鼠标事件交给 Claude Code，而不是交给终端模拟器。
于是出现了两个不同的“选区”：
- Claude Code TUI 内部维护的选区。
- VS Code 终端维护的原生选区。
鼠标拖动时，屏幕上可能出现高亮，但那是 Claude 的内部选区。按下 Command+C 后，VS Code 执行的是终端原生复制命令。它检查自己的选区，发现为空，于是提示“没有在终端中选择要复制的内容”。
这解释了为什么视觉上已经选中，复制命令却认为没有任何内容。
第三步：第一次永久规避，关闭鼠标捕获
基于这个初步根因，第一次永久规避选择了 Claude Code 提供的环境变量，用于彻底关闭全屏 TUI 的鼠标跟踪：
{
"env": {
"CLAUDE_CODE_DISABLE_MOUSE": "1"
}
}
将它加入 ~/.claude/settings.json 并重启 Claude 后，反馈确认复制已经生效。鼠标拖动重新创建终端原生选区，Command+C 也能正常读取。
但这个方案只解决了一半。
第四步：复制生效后，终端却无法滚动
紧接着出现了第二个问题：
复制生效了，但是终端滚动条没有了，无法滚动查看历史消息。
原因是 CLAUDE_CODE_DISABLE_MOUSE=1 只关闭鼠标事件，并没有退出全屏 TUI。全屏 TUI 仍然运行在终端的 alternate screen buffer 中。
alternate screen 是 Vim、less 等全屏程序常用的独立屏幕缓冲区。它不会像普通 shell 那样持续积累终端 scrollback。Claude 原本通过自己的鼠标事件处理内部滚动；关闭鼠标捕获后，这条滚动路径也被切断了。
结果就是：
- 原生文本选择和复制恢复；
- 全屏缓冲区仍然没有普通终端历史；
- Claude 的内部滚轮处理又被关闭；
- 最终无法用鼠标查看历史消息。
这次副作用说明，问题不能只靠鼠标开关解决。需要切换渲染模式。
第五步：永久使用 default 渲染器
最终配置是在 ~/.claude/settings.json 顶层设置：
{
"tui": "default"
}
如果文件中已经有其他配置，只增加 tui 字段，不要覆盖整个文件。同时删除之前加入的：
"CLAUDE_CODE_DISABLE_MOUSE": "1"
当前已经运行的会话可以直接输入：
/tui default
新启动的会话会自动读取全局配置。
default 渲染器不再占用全屏 alternate screen，也不需要 Claude 接管鼠标选区。选择、复制、滚动和历史缓冲区都重新由终端负责。
最终效果：
- 鼠标可以选中历史消息；
Command+C可以正常复制；- VS Code 终端滚动条恢复；
- 鼠标滚轮可以查看历史输出；
- 配置对后续 Claude 会话永久生效。
代价是失去全屏 TUI 的部分交互和渲染体验。对经常复制错误信息、命令和代码片段的开发场景来说，这个取舍更实用。
为什么没有使用 DISABLE_MOUSE_CLICKS
Claude Code 还提供了：
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1
它的设计目标是关闭点击、拖动和悬停，同时保留滚轮处理。理论上看起来正合适，但在 VS Code、tmux、Ghostty 等终端中存在已报告的文本选择回归。使用它仍可能遇到无法创建原生选区的问题。
因此，本次没有继续叠加鼠标相关环境变量，而是直接退出全屏渲染模式。
验证配置
修改后可以先验证 JSON：
jq -e '.tui == "default"' ~/.claude/settings.json
再运行：
claude doctor
确认没有 Invalid 或配置解析错误。最后重启 Claude，分别测试：
- 拖选一段历史消息并复制。
- 粘贴到编辑器，确认内容完整。
- 使用滚轮向上查看早期消息。
- 检查终端滚动条和 scrollback 是否恢复。
结论
这次问题的关键不是“复制快捷键失效”，而是三个组件对选区的所有权发生了冲突：Claude Code TUI、终端模拟器和系统剪贴板。
CLAUDE_CODE_DISABLE_MOUSE=1 只改变鼠标事件归属，没有改变全屏缓冲区，所以会出现复制恢复、滚动失效的组合问题。
真正同时恢复复制和历史滚动的方案，是让 Claude Code 使用经典渲染器：
"tui": "default"
排查终端交互问题时，也值得把“输入事件由谁处理”和“内容绘制在哪个屏幕缓冲区”分开考虑。它们看起来像同一个终端问题，实际属于两套机制。
暂无评论。