1. codex 在 kitty 里退格删两个字符到底卡在哪一层如果你正在用 kitty 终端跑 codex CLI然后发现按一次 Backspace 会连着删掉两个字符这篇就是写给你的。这个问题的典型现象是在 kitty 里直接运行 codex退格键像被触发了两次但一旦套上 tmux 再跑 codex退格就恢复正常了。听起来很玄学其实根因不在 codex 本身而在 kitty 的键盘协议和 tmux 的终端类型传递这两层之间。我先把结论摆出来codex 是一个交互式 TUI 程序它依赖终端上报的按键事件。kitty 默认启用了扩展键盘协议kitty keyboard protocol会把按键以更丰富的事件形式发给前台程序而 codex 在某些版本里对这套协议的解析不够严谨导致一个退格事件被当成两次处理。tmux 作为中间层会把 kitty 的现代键盘事件转换成传统 PTY 行为codex 收到的就是标准的单次退格问题自然消失。适合谁看在 Linux 桌面比如 Ubuntu 24上用 kitty tmux codex CLI 的开发者被退格、回车、方向键这类“按键触发两次”问题困扰的人以及想搞清楚终端键盘协议到底怎么影响 TUI 程序的人。下面我会从 kitty 配置、tmux 配置、验证步骤到排错逐项拆开配置片段可以直接复制。2. 先理解 kitty 键盘协议与 tmux 终端类型传递要修问题先得知道问题出在哪一层。你可以把整条链路想成三层kitty 负责把物理按键翻译成字节流tmux 负责在中间转发并可能改写这些字节流codex 负责解析字节流并渲染界面。退格删两个字符说明 codex 收到了两次退格语义。kitty 的扩展键盘协议本意是好的传统终端只能区分有限的按键组合而 kitty 协议可以上报修饰键、按键按下/释放等更细的信息。但代价是前台程序必须正确理解这套协议。codex 的 TUI 在解析时可能把 kitty 上报的一个事件拆成了两个退格动作。tmux 在这里扮演的是“兼容缓冲”的角色。它默认使用screen或tmux-256color这类终端类型并且会把 kitty 的扩展键盘事件降级成传统序列。所以套上 tmux 后codex 看到的是它熟悉的传统按键流退格就正常了。但 tmux 也带来副作用鼠标滚轮默认会被当成 Up/Down 键发给前台程序于是滚轮变成了“翻上一条命令”。所以正确的思路不是二选一而是用 tmux 隔离键盘协议问题同时修好 tmux 的滚轮行为。这样既保住退格又保住滚轮滚屏。3. 可复制的 kitty.conf 与 tmux.conf 配置先处理 tmux 这一层因为它是解决退格问题的关键。打开或创建~/.tmux.conf加入下面这段配置。核心是开启鼠标支持并让滚轮进入 copy-mode 实现滚屏而不是发送 Up/Down。# ~/.tmux.conf # 开启鼠标支持滚轮才能被 tmux 捕获 set -g mouse on # 滚轮向上进入 copy-mode 并向上滚而不是发 Up 键 bind -n WheelUpPane if-shell -F #{mouse_any_flag} \ send-keys -M \ copy-mode -e; send-keys -M # 滚轮向下正常转发退出 copy-mode 后回到程序 bind -n WheelDownPane send-keys -M这段配置里mouse_any_flag用来判断当前面板里的程序是否自己处理鼠标。如果程序自己处理比如某些编辑器就直接转发否则进入 copy-mode 滚历史输出。copy-mode -e里的-e表示滚到底部时自动退出 copy-mode体验更顺。然后是 kitty 侧。这里我不建议直接关掉扩展键盘协议因为那会影响 kitty 的其他高级按键能力属于全局副作用。更稳的做法是让 kitty 在 tmux 场景下保持默认把兼容问题交给 tmux 处理。如果你确实想显式声明可以在~/.config/kitty/kitty.conf里保留默认不做激进改动# ~/.config/kitty/kitty.conf # 保持 kitty 默认键盘协议不全局禁用扩展协议 # 兼容问题交给 tmux 中间层处理避免影响 kitty 其他特性改完 tmux 配置后重载一次tmux source-file ~/.tmux.conf如果你已经在 tmux 会话里重载后新开的窗口和面板会生效保险起见可以退出重进。接下来用 tmux 包一层跑 codex# 直接进 tmux 再运行 codex tmux codex # 或者建一个可复用的命名会话 tmux new -As codex codexnew -As codex codex的意思是如果名为 codex 的会话已存在就 attach否则新建并运行 codex。这样你下次直接tmux new -As codex codex就能回到同一个工作现场。4. 逐项验证退格与滚轮是否恢复正常配置改完不能只看“感觉好了”要逐项验证。下面这套步骤你可以照着做每一步都有明确的预期结果。第一步确认当前终端类型。在 tmux 里执行echo $TERM预期输出是screen-256color或tmux-256color。如果还是xterm-kitty说明你可能没在 tmux 里或者 tmux 配置没生效。第二步验证退格行为。在 tmux 里启动 codextmux new -As codex codex进入 codex 的输入框输入一段中英文混合文本比如hello 世界 test然后把光标移到中间按一次 Backspace。预期是只删掉一个字符。如果还是删两个先确认你确实是在 tmux 会话里而不是在 kitty 直接跑 codex。第三步验证滚轮。在 codex 里产生一些输出让屏幕有可滚动的历史内容然后向上滚动鼠标滚轮。预期是进入 copy-mode 并向上滚屏而不是把上一条命令填进输入框。按q可以退出 copy-mode。第四步验证 copy-mode 退出。滚到底部后继续向下滚预期自动退出 copy-mode回到 codex 的正常交互。如果卡在 copy-mode 里按q手动退出即可。第五步回归测试。在 tmux 里跑一个普通 shell 命令比如ls -la确认滚轮依然能滚屏退格在 shell 里也正常。这一步是确认你的 tmux 配置没有误伤其他场景。5. 本篇常见错排查退格、滚轮、TERM 的坑排错环节我按“现象 → 原因 → 处理”来写你可以对号入座。现象一改了 tmux.conf 但退格还是删两个字符。原因通常是配置没重载或者你根本没在 tmux 里跑 codex。处理执行tmux source-file ~/.tmux.conf然后tmux new -As codex codex重新进会话。如果还不行检查~/.tmux.conf路径是否正确tmux 默认读的是这个文件。现象二滚轮向上还是变成上一条命令。原因是mouse on没生效或者 WheelUpPane 的绑定被其他配置覆盖。处理在 tmux 里执行tmux show -g mouse确认输出是mouse on。如果绑定的顺序有问题把滚轮绑定放到配置文件靠后位置。现象三只改TERM想绕过问题。比如TERMxterm-256color codex。这个做法有时能缓解但对某些版本不根治因为根因在键盘协议和事件处理不在终端类型字符串本身。我不推荐把它当主方案tmux 中间层更稳。现象四用stty erase调整。stty erase解决的是“退格发^?还是^H”的问题而这里的现象是退格事件被处理了两次属于更上层的输入事件兼容问题。所以stty通常治不了这个“一次触发两次”。现象五直接禁用 kitty 扩展键盘协议。思路是让 kitty 不启用扩展协议降低触发概率。代价是可能影响 kitty 的其他高级按键和交互能力属于全局副作用。我更推荐用 tmux 作为隔离层而不是牺牲 kitty 的全局特性。现象六在 tmux 里 codex 的鼠标选择文本行为异常。这是mouse on的常见副作用tmux 会接管鼠标。处理按住 Shift 再拖拽鼠标可以绕过 tmux 直接用终端选择或者临时set -g mouse off关闭。6. 把配置固化下来顺手把接入环境也理清这套方案的价值在于稳定、可复用、副作用小。即使以后 codex 官方修了输入兼容问题你继续用 tmux 工作流也不受影响。建议你把~/.tmux.conf里的滚轮绑定和mouse on固化下来作为默认配置kitty 侧保持默认不激进禁用扩展协议。如果你在配置 codex 的接入环境需要先拿到 API Key 并确认接入文档可以从这里走API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。想先验证模型对话是否正常可以用模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 快速试一条请求。如果你长期在终端里做编码和 Agent 工作流Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 控制台入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。官网首页是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API 基址是 https://taotoken.net/api 。最后给你一个我实测下来最省事的检查顺序先确认在 tmux 里再确认mouse on然后确认滚轮绑定最后才去动 kitty 配置。大部分“退格删两个字符”的问题到第二步就解决了。