解决 SSH 终端下 codex-cli 回答截断的实用指南

最近有不少朋友在折腾服务器的自动化流程，我也在尝试把 AI 编程助手搬到命令行里来用。像 codex-cli 这种工具确实能极大提升我们在终端里的效率，不用切来切去查文档。

不过，有个特别搞心态的问题是：在 SSH 连接服务器时，AI 的回答总是莫名其妙地截断。有时候正看到关键代码结尾，啪的一下就没了，剩下的内容必须重新生成，既浪费 Token 又破坏心流。

今天我们就来扒一扒这个问题，并提供几个实测有效的解决方案。

为什么好好的工具一上 SSH 就“断片”？

其实这个锅大部分时候不能全甩给 codex-cli 本身，更多是终端环境配置和交互限制的问题。主要原因通常有以下几点：

1. SSH 终端缓冲区限制： SSH 客户端（如 Putty、iTerm2、Windows Terminal）或服务端的 PTY（伪终端）可能有输出行数或字符数的硬性限制。一旦超出的内容，直接被“吞”了。
2. SHELL 的超时或流控问题： 某些 Shell 配置（特别是 Zsh 或经过深度定制的 Oh My Zsh）在处理长文本流时，可能会因为某些插件的主题渲染效率问题导致输出中断。
3. API 流式输出的缓冲策略： 很多 CLI 工具是基于流式输出的。如果在 SSH 网络环境较差的情况下，TCP 窗口大小调整可能导致数据块积压，进而触发工具内部的超时机制，强制停止输出。

实战解决方案

既然知道了病因，我们就可以对症下药。按推荐顺序，大家可以逐个尝试。

1. 检查并调整 SSH 客户端设置

SSH 终端缓冲区限制示意图

有时候问题出在本地。如果你用的是 iTerm2 或 Terminal.app，检查一下“滚动行数”是否设置得太小。建议将其设置为“无限制”或者一个比较大的数值（如 10000 行）。

对于 Windows Terminal 用户，确保你的终端配置文件中没有意外启用了旧版的兼容模式，这有时会影响长文本的回显。

2. 使用 less 或重定向输出（最稳妥的一招）

如果你的 AI 回答动不动就几百上千行，直接打印在屏幕上确实容易出事。我们可以利用 Linux 的管道特性，把输出“接”到翻页工具里。

你可以尝试修改调用方式，例如：

codex-cli "解释一下这个 Kubernetes 的部署文件" | less

利用管道将输出重定向到 less 查看器

或者直接把结果存到文件里看，这样绝对不丢内容：

codex-cli "生成一段 Python 脚本" > ai_output.py
cat ai_output.py

less 甚至支持你直接在查看时进行搜索，比在终端里滚轮回溯要舒服得多。

3. 切换 Shell 或排查加载项

这是一个很多人容易忽略的点。我之前遇到 zsh 下的 powerlevel10k 主题在处理超长输出行时会导致渲染卡顿甚至截断。

测试方法：

临时切换到最基础的 bash 环境测试一下：

bash
codex-cli "ask something long..."

如果在这一层没问题，那基本确定是你原有 Shell 的配置问题。建议检查 .zshrc 或 .bashrc，暂时禁用一些复杂的异步提示插件试试。

4. 调整 codex-cli 的配置参数

部分 CLI 工具允许通过参数控制输出的最大 Token 数量或者超时时间。查看一下 codex-cli 的帮助文档，寻找诸如 --max-tokens、--timeout 或类似的流控参数。

适当增加超时时间，或者如果仅仅是因为内容太长，尝试分批次提问（比如第一步写框架，第二步写函数实现），往往能缓解截断现象。

总结

在终端里用 AI 是效率神器，但遇到截断确实让人头秃。大部分情况下，这属于环境适配问题而非工具本身的 Bug。

建议优先尝试重定向输出到文件或使用 less 查看器，这是改动最小但效果最立竿见影的方法。如果问题依旧，再回头排查 Shell 和网络层面的因素。

你们平时在服务器上都用哪些命令行 AI 工具？有没有遇到过类似的奇葩 Bug？欢迎在评论区交流避坑经验！