在 Windows 上跑 Codex CLI最烦的从来不是它写错代码而是它一边思考一边往终端里喷 token。你以为自己在滚动查看上下文它哗啦啦又刷出一屏新输出鼠标滚轮瞬间失灵你想选中一段报错信息复制刚按下左键拖到一半新的日志覆盖过来整段选择直接被冲散。那种感觉就像你在抄笔记旁边有个人不停把你的本子抽走翻页。后来我花了几个晚上把终端、PowerShell 和 Codex 的交互链路从头到尾捋了一遍把该装的装了该配的配了终于不再跟它抢鼠标了。这篇文章记录的就是这套完整方案Windows 上天天用 Codex 干活的朋友可以直接抄作业。先说结论这个必装并不是某个神秘软件而是一整套组合拳——Windows Terminal 的定制配置、一个专门给 Codex 用的终端 profile、以及一套让 Codex 输出尽量滚出终端焦点区的用法。三样都安排上你在 Windows 里跑 Codex 的体验会从一个抢鼠标的熊孩子变成一台安安静静干活的机器。1. 先搞明白Codex 在 Windows 上是靠什么抢你鼠标的1.1 流式输出的抢占逻辑Codex CLI 在终端里的工作方式和普通命令行工具不一样。普通命令是执行完了才输出顶多有个进度条。Codex 是边推理边输出每个 token 生成后立刻推到屏幕上而且它是持续不断地推短则几秒长则几分钟。终端为了渲染这种高频刷新会不断调整视图状态包括滚动位置、光标位置、缓冲区内容。问题就出在这。Windows Terminal 的默认行为里当有新输出到达时如果输出位置在可视区域之外它会触发自动滚动如果你正在用鼠标选中文本终端会在输出刷新时尝试合并选区与新内容。合并失败时选区直接失效。更精准地说你在跟 Codex 交互的绝大多数时刻屏幕并不是静止的而是一个被高频改写的画布。在高速重绘的画布上用鼠标做精确操作本身就是一个体验灾难。1.2 三个独属于 Windows 的放大器这个问题在 macOS 上没那么严重在 Windows 上却会被三个因素放大。第一个是终端渲染管线。Windows Terminal 虽然已经是现代架构但它的文本选择逻辑和滚轮事件处理面对高频输出时仍然会出现肉眼可见的延迟——你滚一下它先愣住然后跳一大截。第二个是 PowerShell 的 PSReadLine 模块。它接管了终端里的输入行编辑Codex 在输出过程中如果穿插了交互提示比如问你要不要采纳改动PSReadLine 会抢焦点导致你滚轮滚动时你以为在滚历史输出实际上在滚提示行上下文。第三个是剪贴板交互的割裂。Windows 下终端里复制默认走选择即复制或CtrlC/CtrlShiftC两套逻辑Codex 的输出流一旦打断选择复制就变成复制了半行残句。1.3 竞品与历史包袱为什么 mac 上没这事macOS 的 Terminal.app 和 iTerm2 对高频输出场景做了很多隐性优化比如平滑滚动、异步渲染、选区隔离。Windows Terminal 虽然有 GPU 加速但在鼠标交互优先这个层面上它考虑的更多是常规命令行体验而不是AI 持续输出两分钟这种新场景。所以这不是 Codex 做错了什么而是 Windows 终端生态还没有专门为流式 AI 输出 鼠标操作做好适配。理解了这一点你就知道解决方案的方向了不是让 Codex 闭嘴而是把终端环境调到哪怕 Codex 疯狂输出鼠标操作也不被打断的状态同时把那些不需要盯着看的输出挪出焦点区。2. 必装清单Windows Terminal 与 PowerShell 的配套改造2.1 先把 Windows Terminal 的鼠标行为调到防抢档我的第一刀砍在 Windows Terminal 的settings.json上。按下CtrlShift,打开配置文件下面这几项是我实测下来最有感知的调整。{ copyOnSelect: false, scrollToInputOnEnter: true, scrollback: 15000, largePasteWarning: false, multiLinePasteWarning: false, mouseWheelScrollSpeed: 3, padding: 0, 4, 0, 4 }逐个说。copyOnSelect默认是 true意思是鼠标选中文本就自动复制。听着方便但在 Codex 输出流里你拖动鼠标的本意往往只是看一眼选区内容结果终端咔一下把半截文本塞进剪贴板把本来就脆弱的选区状态又搅和了一遍。关掉它把复制动作完全交给右键菜单和快捷键。scrollToInputOnEnter保持 true这样你按回车发送新命令时视图自动滚回输入行。如果没有它你几轮对话下来视觉上会搞不清当前焦点在哪。scrollback我拉到 15000。Codex 一次会话的输出量非常大默认 9000 行经常不够翻。调大之后你可以放心往回滚动查看上下文而不用担心历史内容被缓冲区挤掉——这才是鼠标不会被抢的心理基础。largePasteWarning和multiLinePasteWarning关掉原因后面在问题排查部分细说跟 Codex 自动粘贴多行 patch 有关。mouseWheelScrollSpeed设成 3是因为滚动调太快的时候遇到 Codex 输出跳动会更容易误触调成适中档滚轮轨迹更好控制。这个因人而异你可以自己试。2.2 给 Codex 单独建一个 profileWindows Terminal 支持多个 profile 并存。我专门建了一个叫 Codex 的配置让 Codex 永远不会用错终端环境也避免跟日常 PowerShell 配置互相污染。{ name: Codex, commandline: powershell.exe -NoLogo -NoExit -Command \Import-Module PSReadLine; Set-PSReadLineOption -ExtraVerticesForSelection:$false -PredictionSource History\, icon: codex.png, colorScheme: Campbell, font: { face: Cascadia Mono, size: 11 }, opacity: 95, useAcrylic: true, antialiasingMode: cleartype, snapOnInput: true, scrollToInputOnEnter: true }这里有个容易被忽略的坑snapOnInput如果不设Codex 在高频输出时回车发送指令后视图不会自动回到输入行你会发现自己一边打字一边看屏幕在跳。设成 true 以后输入行为优先鼠标不追着输出跑。字体用 Cascadia Mono11 号是我试过在中文 Windows 上渲染 Codex 输出最稳的组合。Cascadia Mono 的等宽对齐在代码 patch 场景里很重要阿拉伯数字和缩进对不齐会导致看 patch 时非常费眼。透明度开到 95保留模糊这样即使用分屏视线也不会在两层内容之间反复跳。2.3 常用配置项速查表配置项推荐值为什么这么设copyOnSelectfalse防止选中即复制打断 Codex 输出流scrollback15000保证长时间会话的历史可以被滚回查看scrollToInputOnEntertrue回车后视图自动定位到输入行snapOnInputtrue输入行优先不被输出跳动抢走焦点largePasteWarningfalse避免粘贴多行 patch 时弹确认框multiLinePasteWarningfalse同上mouseWheelScrollSpeed3平衡滚动速度与高频输出下的控制感这一套配完Codex 输出时滚轮和选区的基本盘就稳了。接下来才是真正的重点——怎么让 Codex 的输出尽量别出现在你鼠标要操作的地方。3. 真正舒坦的用法让 Codex 的输出滚出终端焦点区3.1 四窗格布局一个窗格写一个窗格看输出一个窗格跑命令Windows Terminal 从 1.x 开始就支持多窗格布局快捷键AltShift加号垂直分屏AltShift减号水平分屏。我现在的固定布局是三个窗格左边跑 Codex右上方开 PowerShell 看日志和跑构建命令右下方开一个纯编辑器窗格比如code打开临时文件用来快速查看生成的 patch。这个布局的核心逻辑是Codex 的输出窗口不是你的操作窗口。你在左窗格给 Codex 下指令然后用鼠标去右窗格滚动日志、选中报错、跑测试。因为 Codex 的输出只在自己那一个窗格里滚动其他窗格完全不受影响鼠标在右窗格的任何操作都是干净的不会被 Codex 的 token 流冲掉。我强烈建议你给这个布局保存成一个 preset在 Windows Terminal 的设置里绑定一个快捷键比如CtrlAltC。我实测下来固定布局比每次重新分屏舒服得多肌肉记忆一旦形成整个工作流就顺了。3.2 让 Codex 别边想边刷屏批量任务用 exec 模式如果你只是想让 Codex 重新生成某个函数的实现不需要盯着它一步步思考那就别用交互模式用codex exec。这个模式会用一整段任务作为输入跑完后一次性把结果输出到 stdout而不是边推理边流式打印。codex exec 把 src/utils.py 里的 fetch_data 函数改成支持超时重试并补上单元测试 --json result.json输出重定向到文件之后你完全不需要在终端里看它的过程。终端处于等待完成的静止状态鼠标想滚就滚想选就选没有任何东西来抢。任务跑完你直接在编辑器里打开result.json看结构化结果需要 patch 的时候就只看 patch信息密度比在终端里盯着高多了。我现在的习惯是探索性问题用交互模式机械性改写任务用 exec 模式。前者要的是看着它一步步来后者要的是结果别吵我。这一条直接改变了我和 Codex 的相处方式鼠标冲突事件大概减少了六成以上。3.3 我常用的 PowerShell 包装脚本为了让上面这些操作一键完成我写了几个 PowerShell 函数放进$PROFILE里用顺手之后基本告别了手动开终端、切目录、敲命令的流程。function Start-CodexPane { param([string]$Task) $guid [guid]::NewGuid().ToString() $json $env:TEMP\codex_$guid.json codex exec $Task --json 2$null | Out-File -FilePath $json -Encoding utf8 if (Test-Path $json) { code $json } }这个函数把codex exec的输出写到临时 JSON 文件然后用 VS Code 打开。整个过程终端只在最开头闪一下之后就是安静的。你在终端里的鼠标操作和 Codex 的输出完全隔离。再配合一个快速打开 Codex 专用终端窗格的函数function CodexPane { wt -w Codex sp -p Codex powershell.exe }wt命令是 Windows Terminal 的命令行入口-w Codex指定窗口sp是 split-pane-p Codex指定用刚才那个 profile。快捷键一绑整个工作流就完全脱离手忙脚乱的状态了。3.4 分屏和无头模式之外的备选方案还有一个更极端的方案如果你完全不需要在 Codex 所在的终端里看输出可以把 Codex 作为一个后台任务输出写到日志文件终端只用来查看日志片段。Start-Process -WindowStyle Hidden -FilePath codex -ArgumentList exec 任务描述 -RedirectStandardOutput .\codex.log -RedirectStandardError .\codex_err.log这样 Codex 连一个可见窗口都没有鼠标想抢都抢不到。日志文件用Get-Content -Wait按需查看或者干脆等任务结束再打开文件。代价是你不能实时打断它但对耗时较长的重构任务来说这个模式很省心——它跑的这段时间你完全可以切到别的项目干活。4. 常见问题与排查实录4.1 终端突然开始疯狂自动滚动症状Codex 正在输出你滚到上面想回看某段内容结果滚轮刚停画面又自己跳回底部怎么都停不住。原因很直接Codex 的输出源并没有停只是速度慢了。终端收到新输出且输出位置在当前视图之外就会自动滚动。你看到的是终端自己往下滚本质是代码还在生成。解决思路分两层。第一层给输出一个缓冲区隔离。用codex exec的输出重定向方案彻底避免输出源直连终端视图。第二层如果非要留在交互模式里把窗格宽度拉大、高度拉高可视区域越大输出到达视图之外的延迟越长自动滚动出现的概率越低。但这个方法治标不治本。4.2 选中代码一瞬间被新输出冲掉这是最经典的抢鼠标场景。你费劲拖蓝了一段代码正准备复制Codex 又吐了一行选区直接碎裂。这里的关键操作是在复制前先把 Codex 的输出暂停下来。交互模式下按Esc可以中断 Codex 继续生成具体行为视版本而定但普遍支持发送中断信号。中断之后终端变成静止状态你再选中、复制、粘贴不会再被打断。复制完从历史里重新唤回对话上下文继续损失的只是几秒钟的等待换来的是干净利落的复制体验。另外关掉copyOnSelect之后选中行为变成纯视觉标记不会因为误触就把半截内容塞进剪贴板。配合CtrlShiftC手动复制你至少能保证复制的一定是自己想要的。4.3 右键粘贴失效 / 中文输入法乱入Windows Terminal 的右键默认行为是粘贴剪贴板内容。Codex 输出过程中如果你正在输入中文指令输入法状态可能会因为终端焦点切换而失效。具体表现是你在输入框里敲拼音Codex 输出刷了一下屏幕你的中文候选框消失了打出来的是一串英文字母。这个问题的根源其实是输入法和终端渲染线程的交互。Windows Terminal 有experimental.input.forceVT之类的兼容开关但更稳定的做法是在给 Codex 下中文指令时把输入法先切到英文状态指令内容用英文写需要中文说明的直接粘贴文本不依赖输入法实时合成。中文用户如果一定要在终端里打中文建议把 Windows 的使用以前版本的微软拼音这类兼容选项关掉Windows Terminal 对新版输入法 API 的支持更完整。4.4 粘贴多行补丁时弹警告Codex 经常会把一大段 diff 直接复制到剪贴板你往终端里一粘Windows Terminal 弹出是否粘贴多行内容的确认框。这个框在鼠标场景里很烦人——你得从键盘上挪手去点确定而且这个弹窗本身也是焦点抢夺。提前在settings.json里把largePasteWarning和multiLinePasteWarning都设成 false 就能根治。别担心误粘贴我实测下来Codex 产生的 patch 都是可控的确认框的价值远没有它造成的打断感大。4.5 排查思路小结症状直接原因对症方案自动滚动跳到底部输出未停 视图外触发滚动用 exec 模式重定向输出选区被冲掉高频输出重绘视图先 Esc 暂停再选中复制右键粘贴失效焦点切换关 copyOnSelect固定鼠标操作窗格中文输入法失效渲染线程与输入法 API 冲突切换英文输入粘贴中文多行粘贴弹窗默认安全警告关闭两个 pasteWarning 开关5. 踩坑之后留下的几条操作准则这套方案我用了小半年陆陆续续踩了无数坑最后沉淀下来的其实是几条特别朴素的行为准则。第一条Codex 输出的地方不要是你操作鼠标的地方。哪怕你配置了花里胡哨的终端主题只要输出和操作在同一个窗格里冲突就永远存在。分屏和重定向是治本方案其他都是缓解。第二条交互模式是给看过程用的不是给看结果用的。想看结果请用 exec 模式或输出重定向。我自己现在跑 Codex 的默认姿势就是codex exec只有需要实时干预任务走向时才切到交互模式。第三条别让终端替你记住太多东西。scrollback调大固然能防止历史被冲掉但你真的会回翻几千行去看一个函数长什么样吗大部分时候不会。更多时候你是想在编辑器里打开生成的文件直接看代码。所以我现在更倾向于让 Codex 直接改文件然后我在编辑器里看 diff终端里只看错误信息和最终结果历史滚动基本不看了。第四条Windows Terminal 不是终点它只是一个壳。真正决定鼠标体验的是你让输出往哪走、让焦点停在哪。配置可以帮我挡掉八成冲突剩下两成要靠使用习惯解决。如果你也是 Windows 上天天被 Codex 输出搞到鼠标失灵的受害者强烈建议把这套配置先照抄一遍用两周再根据自己的习惯调整。配置本身十分钟就能搞定换来的是以后每一次和 Codex 交互都不再被抢鼠标这笔账怎么算都划算。