claude_code_no_flicker_mode_cheetsheet.md

Claude Code NO_FLICKER 模式速查表

快速启用

# 启用全屏无闪烁模式
CLAUDE_CODE_NO_FLICKER=1 claude

# 仅启用无闪烁渲染，禁用鼠标捕获
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude

环境变量	作用	适用场景
CLAUDE_CODE_NO_FLICKER=1	启用备用屏幕缓冲区渲染，消除闪烁	长对话、VS Code 终端、tmux
CLAUDE_CODE_DISABLE_MOUSE=1	禁用鼠标捕获，保留无闪烁渲染	鼠标干扰工作流

核心特性

解决的问题

• 消除长对话时的闪屏、跳屏（ANSI 清屏重绘限制）
• CPU/内存占用不再随对话长度线性增长
• 仅渲染当前视口可见内容

新增交互

• 点击输入框 → 定位光标
• 点击折叠输出 → 展开查看
• 点击 URL → 直接打开
• 拖拽选中文本 → 自动复制到剪贴板

快捷键变更

操作	传统终端	NO_FLICKER 模式
搜索	Cmd+F (macOS) / Ctrl+F	Ctrl+O → /
复制	Cmd+C / Ctrl+C	选中文本即自动复制 或在设置中改为 Ctrl+C 手动复制
粘贴	Cmd+V / Ctrl+V	系统默认粘贴键

版本要求

• 最低版本: v2.1.88+
• 当前状态: 研究预览版（Research Preview）
• 内部使用情况: Anthropic 团队已将其作为默认选择

技术原理简述

标准终端: 清屏 → 重绘全部内容 → 闪烁
NO_FLICKER: 切换至备用屏幕缓冲区 (alternate screen) → 
            仅渲染视口内内容 → 无闪烁 + 资源稳定

类比: 类似 vim 或 htop 的全屏终端应用接管模式