如何解决 Claude Code 在终端中闪烁的问题
用 /tui fullscreen、CLAUDE_CODE_NO_FLICKER 或同步输出解决 Claude Code 闪烁和滚动跳动。附 tmux、VS Code 和 Windows 的解决方法。
- CLI
- 0.2.17
- 预览 ref
- a2c45c8
简要回答
在 Claude Code 中运行：
/tui fullscreen这会切换到 Claude Code 的全屏渲染器，Anthropic 称其为无闪烁渲染。对话会完整地重新启动，设置也会保存到以后的会话中。要切回去，运行 /tui default。
根据原因的不同，其他解决方法：
- 只是闪烁，且终端支持同步输出： 用
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claude启动。这会保留经典渲染器。 - 更想用环境变量：
CLAUDE_CODE_NO_FLICKER=1 claude会在启动时开启全屏渲染。 - 在 tmux 中： 升级 tmux，或在单独的终端标签中运行 Claude Code。
- Windows Terminal 上残留碎片：
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1。
在 Anthropic 的文档中（2026 年 10 月 26 日查阅），全屏渲染仍是研究预览，细节可能会变化。
问题
症状很常见：工具输出流入时屏幕闪烁。Claude 工作时滚动位置跳到顶部。会话越长终端越慢，闪烁也越严重。在绘制速度成为瓶颈的终端中最明显。Anthropic 点名了 VS Code 集成终端、tmux 和 iTerm2。
原因是经典渲染器每次更新都会重绘屏幕的大部分区域。解决方法要么改变 Claude Code 的绘制方式，要么让终端一次性应用每次更新。
方法 1：把 Claude Code 切换到全屏渲染
/tui fullscreen全屏渲染像 vim 或 htop 一样绘制在终端的备用屏幕缓冲区上，并且只渲染可见的消息。这样每次更新发送的数据更少，长对话中内存保持平稳，还支持鼠标。“全屏”指的是接管绘制区域，任何窗口大小都可以使用。
重新启动时保留的内容：屏幕上显示的对话、权限模式和 effort 级别、用 /model 选择的模型，以及 --allowed-tools、--agent 等参数。
查看当前使用的渲染器：
/tui如果 Claude 工作时输入框固定在底部，说明全屏已开启。
全屏模式下的变化
因为对话位于备用屏幕缓冲区中，终端自身的回滚和搜索看不到它：
| 之前 | 全屏模式下 |
|---|---|
Cmd+f 或 tmux 搜索 | Ctrl+o 进入转录模式，再按 / 搜索 |
| 原生拖动选择复制 | 应用内选择，松开鼠标即复制 |
| 终端回滚 | 在 Claude Code 内用鼠标滚轮、PgUp 和 PgDn |
在转录模式中，[ 会把整个对话写入终端的原生回滚，v 会在编辑器中打开它。
如果鼠标捕获造成干扰，可以保留渲染器并关闭鼠标：
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude方法 2：开启同步输出并保留经典渲染器
有些终端支持同步输出（把每次重绘作为一次更新应用），但报告方式无法被 Claude Code 检测到。Anthropic 举的例子是 Emacs 的 eat。对于这类终端，可以强制开启：
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claude这样不换渲染器也能消除闪烁，原生回滚和选择照常可用。
方法 3：设置 CLAUDE_CODE_NO_FLICKER
用环境变量开启全屏渲染：
CLAUDE_CODE_NO_FLICKER=1 claudePowerShell：
$env:CLAUDE_CODE_NO_FLICKER = "1"; claude或者在 settings.json 中：
{
"env": {
"CLAUDE_CODE_NO_FLICKER": "1"
}
}解决 tmux 中 Claude Code 闪烁
Anthropic 的全屏页面说明，3.6 系列及以前的 tmux 版本没有实现同步输出，因此在 tmux 中重绘可能比直接在终端中更容易闪烁。v2.1.201 的更新日志也列出了通过启用同步输出修复 tmux 3.4 及以后版本闪烁的问题。如果仍然闪烁：
-
用
claude update更新 Claude Code。 -
把 tmux 升级到当前版本。
-
试试全屏渲染。要在其中用鼠标滚轮滚动，开启 tmux 鼠标模式：
# ~/.tmux.conf set -g mouse on -
如果问题依旧，在 tmux 之外的单独终端标签中运行 Claude Code。
不要在 iTerm2 的 tmux 集成模式（tmux -CC）中使用全屏渲染。Anthropic 的文档说明，那里鼠标滚轮无效，双击还可能破坏终端状态。在 iTerm2 中使用普通 tmux 没有问题。
解决 VS Code 终端中的闪烁
VS Code 集成终端是 Anthropic 点名的吞吐受限终端之一。主要的解决方法是全屏渲染。鼠标被捕获时，要使用原生选择，按住 Shift，在 macOS 上开启 terminal.integrated.macOptionClickForcesSelection 后按住 Option。
解决 Windows Terminal 上残留的文字
如果旧的碎片一直留在屏幕上，直到调整窗口大小才消失，说明终端合并 Claude Code 增量更新的方式不对。Anthropic 点名了 Windows Terminal 和其他基于 ConPTY 的宿主。改为重绘每个单元格：
$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"
claude如果只想重绘一次，按 Ctrl+L。对话和输入内容都会保留。
在终端以外的地方跟进会话
有些闪烁问题来自在小终端里盯着长时间运行的任务，而且常常是从另一台设备通过 SSH 查看。如果目的是关注会话而不是在 TUI 中输入，换一种查看方式比调渲染器更有用。
如果你想在手机或浏览器上而不是终端窗口中跟进和引导 Claude Code，Happier 是一款开源应用，可以从手机、桌面或网页跨设备运行和编排 Claude Code、Codex 等代理。它在自己的界面中把会话显示为消息和工具调用的转录，因此在那台设备上不涉及终端渲染器。当你确实需要真正的 Claude TUI 时，Happier 的 Claude 统一终端选项可以在 tmux 或 zellij 中运行它。这是可选功能，适用于新会话。
设置方法见如何在手机上使用 Happier。Happier 在 GitHub 上开源，可以在这里下载，还有一个 Discord。
故障排除
Cannot switch renderers in this session
Claude Code 会显示原因且不切换。在屏幕阅读器模式下，除已附加的后台会话外，它始终使用经典渲染器。如果原因允许，用 CLAUDE_CODE_NO_FLICKER=1 启动新会话。
提示全屏渲染器未能完成启动
Claude Code 会统计全屏启动失败的次数，并回退到经典渲染器。启动失败后，它仍会遵循 CLAUDE_CODE_NO_FLICKER，但不再遵循已保存的设置。更新 Claude Code 和终端，然后再试一次 /tui fullscreen。
复制粘贴不能用了
全屏会捕获鼠标。按住终端的选择键（iTerm2 中是 Option，Terminal.app 中是 Fn，其他大多数终端是 Shift），或者设置 CLAUDE_CODE_DISABLE_MOUSE=1。
常见问题
Claude Code 为什么会闪烁？
经典渲染器在输出流入时会重绘屏幕的大部分区域。绘制较慢或应用部分更新的终端会把它表现为闪烁或跳动。
全屏模式会改变 Claude 的工作方式吗？
不会。它只改变 CLI 的绘制方式。模型、权限和工具都不变。
全屏渲染更省内存吗？
Anthropic 的文档说明，它只在渲染树中保留可见的消息，因此无论对话多长，内存都保持不变。