在无图形界面的linux服务器上稳定运行codex cli远程tui，需依次执行：安装官方cli（v0.4.2+）、配置ssh保活、unset display并启用--no-gui --tui、设rate_limit_mode为strict、清理过期会话日志、封装脚本隔离代理环境变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在无图形界面的Linux服务器上运行Codex CLI并确保其远程TUI（文本用户界面）稳定响应，需绕过X11依赖、规避SSH会话超时、解决速率限制误判及环境变量污染问题。
确认Codex CLI已安装且基础命令可执行
先验证本地是否已部署OpenAI官方Codex CLI工具链：运行codex --version，输出应为v0.4.2或更高版本。若报错command not found，说明未安装——此时不要手动下载二进制或用pip install codex，那会装错包（实际是旧版废弃库）。正确做法是执行：curl -sL https://raw.githubusercontent.com/microsoft/codex-cli/main/install.sh | bash，该脚本会自动检测系统架构、校验SHA256、写入~/.local/bin并追加PATH。
这一步操作起来很简单，直接把文件拖进去就行。
禁用SSH连接空闲断连，防止TUI交互中断
Remote TUI对SSH连接稳定性极度敏感：一旦终端因ClientAliveInterval超时被服务端强制关闭，正在输入的代码补全会直接卡死，且无法恢复上下文。必须双向配置保活机制：
方法一：修改本地SSH客户端配置（Windows/macOS/Linux通用）
编辑~/.ssh/config，在对应Host段末尾追加两行：ServerAliveInterval 30ServerAliveCountMax 3
方法二：临时启用（仅当前会话有效）
连接时加参数：ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=3 user@server
【ServerAliveCountMax 3是关键阈值】设为1会导致网络抖动时立即断开；设为5以上则可能掩盖真实连接故障，让TUI长时间挂起无响应。
绕过X11转发，强制Codex以纯TUI模式启动
Codex CLI默认尝试探测DISPLAY环境变量，哪怕你没装xauth或X Server，它也会花2.3秒做X11握手——这在无桌面环境的服务器上纯属冗余等待，且易触发超时失败。必须显式关闭GUI探针：
第一步：检查当前DISPLAY值
执行echo $DISPLAY，若返回非空字符串（如localhost:10.0），立刻执行unset DISPLAY清除。
第二步：启动时禁用所有GUI回退路径
运行codex chat --no-gui --tui，其中--no-gui参数会跳过X11检测、Web浏览器唤起、图像渲染模块加载，--tui则锁定ncurses界面协议。
第三步：验证TUI是否真正接管控制权
成功后终端将显示深蓝底色+白色边框的交互窗口，光标位于左下角输入区；若仍看到“Launching browser…”或空白闪烁，则说明--no-gui未生效——此时检查是否误用了codex-gui命令（那是已弃用的旧二进制）。
修复速率限制误判导致的TUI冻结
Codex CLI在远程场景下常将SSH连接延迟误判为API限流，触发长达60秒的退避等待，表现为输入后光标静止、无任何提示。根源在于其默认使用~/.codex/sessions/下的本地日志做配额计算，而远程服务器与本地电脑时钟不同步时，时间戳错乱会放大误判概率。
执行codex config set rate_limit_mode strict，强制CLI只依据HTTP响应头X-RateLimit-Remaining判断，忽略本地日志时间戳。
再运行find ~/.codex/sessions -name "*.log" -mtime +1 -delete清理过期会话缓存——注意别删整个sessions目录，否则历史对话记录永久丢失。
设置环境变量隔离，避免代理冲突污染TUI
若服务器已配置HTTP_PROXY全局代理（常见于企业内网），Codex CLI会错误地将TUI的本地终端I/O也走代理，造成键盘输入延迟高达800ms。必须为Codex进程单独剥离代理：
创建封装脚本：mkdir -p ~/bin && nano ~/bin/codex-tui，写入以下内容：
#!/bin/bash<br>unset HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY<br>exec codex chat --no-gui --tui "$@"
赋予执行权限：chmod +x ~/bin/codex-tui
将~/bin加入PATH顶部：echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
此后只需运行codex-tui即可启动纯净TUI会话，无需每次手动unset变量。
