Claude Code 存在严重的终端闪烁 bug,会导致 IDE 崩溃和无法控制的滚动。自 2025 年 3 月以来已累计获得 700+ 赞同,Anthropic 仍未发布修复方案。

Claude Code 的终端闪烁问题:700+ 赞同,9 个月,仍未修复

Claude Code 存在一个严重到足以导致整个 IDE 崩溃、使系统无法使用,甚至可能引发光敏感用户癫痫发作的终端渲染问题。这个 bug 自 2025 年 3 月以来就有记录。多个相关问题已累计获得超过 1000 个赞同。而截至 2025 年 12 月,它仍然没有被修复。

这场灾难的规模

记录终端滚动完全失控的 Issue #3648 获得了 282 个点赞。Issue #1913 获得了 181 个点赞。2025 年 4 月的 Issue #769 获得了 168 个点赞。仓库中至少还有十几个重复问题,全都描述着同一个根本问题。

超过 1000 名开发者对同一个 bug 的呐喊绝不是边缘问题,这是系统性的失败。

有开发者实际测量了 Claude Code 对终端做了什么。Issue #9935 的发现令人震惊:每秒 4,000 到 6,700 次滚动事件。根本原因是 Claude Code 在每次流式输出的数据块上都执行完整的终端重绘,而不是像任何理智的终端应用程序那样进行增量更新。

实际效果演示:[原始 bug 报告]包含一个视频,展示了终端在正常使用期间变成频闪灯的情况。

在 VS Code 和 Cursor 中,终端开始闪烁,逐渐恶化,然后整个编辑器在 10 到 20 分钟后冻结并崩溃,所有未保存的工作都随之丢失。

在独立终端中,你会遇到频闪效果,但不会崩溃。旧的对话历史与新输出混合闪烁。滚动条不规则跳动。在 Claude 思考时打字简直是一种折磨。

终端开始自己超快速滚动,通常除非你关闭终端标签并重启 Claude,否则无法停止。其他时候当你试图输入提示时,你必须反复向下滚动才能找到你正在输入的位置。

一些用户报告该 bug 会生成多达七个并行的 Claude Code 进程,每个进程都在消耗 CPU,而终端无休止地闪烁却没有响应。

原始 bug 报告明确将此标记为无障碍访问问题。快速的屏幕闪烁是光敏性癫痫的已知触发因素。Web 内容无障碍指南警告不要让内容每秒闪烁超过三次。Claude Code 每秒闪烁数千次。

Anthropic 宣称自己深度致力于 AI 安全,却发布了一个存在已知无障碍访问隐患的产品长达九个月。

这不是什么深层架构问题。修复在概念上很简单:停止在每次更新时重绘整个终端缓冲区。使用光标定位只更新发生变化的部分。这是自 1970 年代以来就被理解的基本终端编程知识。

如果花哨的可视化界面太复杂而无法增量渲染,那就简化它。给用户一个能正常工作的纯文本模式,而不是一个会让 IDE 崩溃的漂亮界面。

根据社区发现,以下是最佳解决方法:

对于 Mac 用户,完全放弃 IDE 终端。使用简单的独立 bash 终端,如原生的 Terminal.app 或 iTerm2。闪烁仍然会发生,但至少不会让整个开发环境崩溃。

在终端设置中将终端回滚历史减少到 500 行或更少。这不能修复 bug,但会降低严重程度。

在提示之间频繁使用 /clear 来重置缓冲区。这会延迟但不能阻止最终的崩溃。

在 Claude Code 会话中完全避免使用 VS Code 和 Cursor 集成终端。外部终端能更好地处理这种滥用。

保持会话简短。如果你正在使用子代理进行大量代理工作,预计闪烁会变得更糟。在崩溃之前重启。

如果终端有这些选项,禁用 GPU 加速和平滑滚动。

底线:九个月,700+ 赞同,每秒 6,700 次滚动事件,零修复。使用解决方法,保持耐心,也许可以把你的赞同加到这堆里。