Codex CLI 不能滚动、终端显示不对怎么办:/tui 切换终端模式、--no-alt-screen、tui.alternate_screen 和 /raw 复制

Codex 命令行里滚轮翻不了历史、选中复制很别扭?官方没有单独写这条问题,但命令页和配置参考里有 /tui(滚动缓冲或全屏转录)、--no-alt-screen、tui.alternate_screen、/raw 和 Ctrl+O 复制。本文按官方写法整理,并标出哪些是推断。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-13 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 先分清两种终端模式。 官方命令页写明 /tui 可以选择「滚动缓冲(scrollback)」或「全屏(fullscreen)」模式,选完要重启 Codex 才生效。
  2. 只想临时试一次,用 --no-alt-screen。 这个启动参数会关闭终端界面的备用屏幕模式,并覆盖配置里的 tui.alternate_screen。
  3. 想长期固定,改 tui.alternate_screen。 取值是 auto、always、never,默认 auto;官方写明 auto 在 Zellij 里会跳过备用屏幕,以保留滚动缓冲。
  4. 复制不顺手,用 /raw。 它切换「原始滚动模式」,让终端里的选择和复制更直接,也可以按默认的 Alt+R。
  5. 只想拿最近一条回答,别手选。 按 Ctrl+O 复制最近一条完成的回答,或用 /copy 选整条回答、某个代码块或引用。

Codex 命令行滚不动时的判断图:/tui 切换模式、--no-alt-screen 临时关闭、/raw 方便复制、Ctrl+O 复制最近回答、Zellij 默认保留滚动缓冲

图:本站根据 Codex 官方文档《Commands》 整理的示意图

本文根据 Codex 官方文档《Commands》《Configuration Reference》和《CLI customization》整理,资料核对于 2026-11-13。官方没有单独写「命令行不能滚动」这条问题,所以本文写的是官方文档里和终端模式、滚动、复制相关的设置,不替你断定原因。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。命令行的安装见 /guides/codex-cli-install-update。

适用于谁

  • 在终端里用 Codex CLI,滚轮或翻页翻不了前面的输出的人;
  • 想选中一段输出复制,结果总是选不准、带着格式的人;
  • 在 Zellij、tmux 里用 Codex,滚动表现和普通终端不一样的人。

一、先搞清楚「备用屏幕」是什么

很多全屏的终端程序会使用终端的「备用屏幕」:程序运行时占满整个窗口,退出后恢复原来的内容。这类界面里,终端自带的滚动条往往只能滚动备用屏幕,而不是你之前敲过的命令的历史,所以会让人觉得「滚不动」。

这是对术语的一般说明,不是官方对 Codex 的描述。官方在 Codex 文档里关于它的说法只有三句:配置键 tui.alternate_screen 控制终端界面是否使用备用屏幕;默认是 auto;auto 在 Zellij 中会跳过它,以保留滚动缓冲。也就是说,官方自己也认为备用屏幕和滚动缓冲之间有取舍。

二、用 /tui 切换终端模式

官方命令页「Choose the terminal mode with /tui」一节的步骤是:

  1. 输入 /tui;
  2. 选择滚动缓冲模式或全屏模式,然后确认;
  3. 重启 Codex 使选择生效。

官方说明:下次启动会使用保存的终端模式;而像 --no-alt-screen 这样的启动参数仍然会覆盖它。所以如果你选了某个模式却没变化,先看看自己的启动命令或别名里是不是带了这个参数。

两种模式各自的外观,官方没有展开描述。按字面理解:滚动缓冲模式更贴近终端自己的滚动历史,全屏模式则像一个独立的转录界面。哪个更适合你,要自己切换试一下,这一句属于推断。

三、临时关闭备用屏幕:--no-alt-screen

启动时加上:

bash
codex --no-alt-screen

官方参数表的说明是:关闭终端界面的备用屏幕模式,只对这一次运行覆盖 tui.alternate_screen,默认值是 false。用它可以快速验证「是不是备用屏幕造成的滚动问题」:加上参数能滚了,就说明是;再决定要不要把配置固定下来。

四、长期固定:tui.alternate_screen

把偏好写进 $CODEX_HOME/config.toml(默认 ~/.codex/config.toml):

toml
[tui]
alternate_screen = "never"   # auto | always | never

官方对三个取值的写法如下,右列是本站的归纳,官方没有给选择建议:

tui.alternate_screen 三个取值对比:auto 默认并在 Zellij 中跳过备用屏幕,always 始终使用,never 不使用

图:本站根据 Codex 官方文档《Configuration Reference》 整理的示意图

改完保存,重新启动 Codex 再看。也可以输入 /config 打开终端偏好设置,官方说明可以按分组浏览,或按 / 搜索,改动会自动保存。

五、复制输出:/raw、Ctrl+O 和 /copy

滚动之外,另一个常见麻烦是复制。官方给了三个工具:

  • /raw:输入 /raw、/raw on 或 /raw off 切换原始滚动模式。官方说明它会让终端里的选择和复制更直接。也可以按默认的 Alt+R,或在配置里写 tui.raw_output_mode = true 让它默认开启;
  • Ctrl+O:复制最近一条完成的回答,不用走菜单;
  • /copy:滚动缓冲模式下,输入 /copy 后可以选整条回答、一个代码块或一段引用,按 Enter 复制;全屏模式下,则在转录里选中一个块。/status 之后用 /copy,还能复制整份状态或其中某个字段。

六、清屏不等于清对话

有时候「显示不对」是屏幕上堆了太多内容。官方区分了两个操作:Ctrl+L 只清除终端的显示,对话仍然保留;/clear 则会清屏并开始一个新的对话。别在不想丢上下文时用 /clear。

查看改动时,官方还写明 /diff 会显示已暂存、未暂存和未跟踪的文件,并且可以在命令行里滚动查看。如果这个视图滚不动,同样可以先用上面的办法排查。

七、还可以关掉的显示效果

配置参考里有一个 tui.animations,说明是开关欢迎界面、闪烁效果和旋转提示等终端动画,默认是开。官方没有说它与滚动问题有关,只在你觉得终端刷新过多、画面抖动时,作为可以关掉的显示效果列在这里。

八、排查顺序小结

  1. 先用 codex --no-alt-screen 启动,看能不能滚;
  2. 能滚,就用 /tui 或 tui.alternate_screen 固定下来;
  3. 还是不行,换一个终端模拟器或不经过 tmux、Zellij 直接运行,确认是不是终端层的问题(官方没有逐一说明各终端,这一步是通用排查);
  4. 需要复制输出,用 /raw、Ctrl+O 或 /copy;
  5. 以上都不行,用 /feedback 把诊断发给官方,官方说明它会按提示收集日志或诊断并提交给维护者。

常见问题

Q:改了 config.toml 没变化?

确认改的是你实际在用的家目录。设置了 CODEX_HOME 就以它为准;Windows 和 WSL 的家目录也不同,见 /guides/codex-cli-switch-account-logout 里的说明。另外启动参数会覆盖配置。

Q:桌面 App 也会这样吗?

本文只讲命令行的终端界面。桌面 App 是图形界面,设置在应用设置里。两者怎么选,见 /guides/codex-app-vs-cli-which-better。

Q:运行很慢也算显示问题吗?

不是。慢的原因见 /guides/codex-slow-reconnecting-why。

Q:这些设置和订阅、额度有关吗?

无关。终端显示是本地界面的设置,不影响额度。Codex 随 ChatGPT 套餐提供,额度按官方规则计算;需要更多额度时,可以看看本站的 ChatGPT Plus 充值说明,价格和额度以官方页面当前显示为准。

相关教程

参考资料

  • Codex 官方文档:Commands(CLI) — https://learn.chatgpt.com/docs/developer-commands?surface=cli
  • Codex 官方文档:Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
  • Codex 官方文档:CLI customization — https://learn.chatgpt.com/docs/cli-customization

Nathaniel 的更多内容

  1. 01

    LangGraph 流式输出(Streaming)详解:逐字 Token 流、节点进度与自定义事件写法

    多步智能体如果等全部节点跑完才返回,网页前端就会白屏干等十几秒。本文按 LangGraph 官方文档讲清 updates、messages、custom 与 values 四种 stream_mode 的区别,以及组合订阅逐字打字机输出加工具内部实时进度的完整代码。

    其他 AI 工具0
  2. 02

    LangGraph 持久化与长期记忆怎么配:Checkpointer、Store 与 PostgreSQL 实战

    在生产环境跑 LangGraph,单靠 InMemorySaver 一重启就会丢失全部对话。本文按官方文档讲清线程内短期检查点(Checkpointer)与跨线程长期记忆(Store)的分工,以及用 langgraph-checkpoint-postgres 对接 PostgreSQL 的完整步骤。

    其他 AI 工具0
  3. 03

    LangGraph 多智能体怎么写:Supervisor 主管包与 Subgraph 隔离子图实战

    在 LangGraph 里把单个图扩展成多智能体协作有两条官方路线:快速原型用预置包 langgraph-supervisor,大型生产系统用原生子图(Subgraph)嵌套。本文讲清两种写法的完整代码、私有状态隔离防 Token 膨胀技巧以及检查点传播规则。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入审批怎么写:interrupt 暂停图运行与 Command 恢复实战

    企业之所以选 LangGraph,很大程度看中它能安全挂起等待人工审批(Human-in-the-Loop)。本文按官方最新规范讲清 interrupt() 动态暂停、Checkpointer 必备条件、Command(resume=...) 恢复执行,以及防止副作用重复运行的重入规则。

    其他 AI 工具0
  5. 05

    多 Agent 协作平台怎么选:Dify、扣子(Coze)、n8n 与 LangGraph 多智能体机制对比

    搜「多agent协作平台」时,Dify、扣子、n8n 和 LangGraph 都宣称支持多智能体,但底层的调度方式完全不同。本文跳过基础安装,专门从多 Agent 角色跳转、子代理工具调用、上下文隔离与私有化部署四个维度帮你一次选准。

    其他 AI 工具0
  6. 06

    企业微信有官方 MCP 和 CLI 吗:@wecom/cli 安装初始化、长连接机器人与接入教程

    搜「企业 微信 有 mcp 吗」不用再东拼西凑民间群机器人脚本了:企业微信官方已推出 @wecom/cli 命令行工具并内置 stdio 模式的 MCP Server。本文按官方开发者文档讲清安装、智能机器人长连接初始化、业务命令与接入 Claude Code 步骤。

    Claude其他 AI 工具0

同产品的其他教程

  1. 01

    AutoGen 现在怎么样了?微软官方演进路线与 Microsoft Agent Framework 入门

    搜 AutoGen 新教程常被 0.2、0.4、社区分支和 Semantic Kernel 绕晕。按微软官方文档,微软已将 AutoGen 与 Semantic Kernel 两支团队合并推出统一的开源框架 Microsoft Agent Framework。本文讲清现状与 Python 快速上手。

    ChatGPT其他 AI 工具0
  2. 02

    多 Agent 的成本为什么翻倍、怎么控制:Token 膨胀根源与五项降本措施

    刚把单智能体拆成多 Agent,用量往往暴涨好几倍。Anthropic 工程报告统计单智能体约为聊天的 4 倍 Token,多智能体可达约 15 倍。本文拆解固定前缀重复加载、历史搬运、工具链定义与缓存失效四大根源,并给出五条实操控费办法。

    ChatGPTClaude0
  3. 03

    多 Agent 协同开发怎么落地:「一个写、一个审」双代理工作流搭建指南

    多 Agent 协同开发里投入产出比最高的模式就是「一个写、一个审」。本文依据 Anthropic 与 OpenAI 官方编码最佳实践,讲清为什么同会话自审容易漏问题,以及用只读子代理、跨模型交叉审查(Claude Code + Codex)和自动化闭环落地的具体方法。

    ClaudeCodex0
  4. 04

    多 Agent 编排模式详解:编排者-工作者、交接(Handoffs)、并行与评估循环怎么选

    搜「multi-agent orchestration 中文」会被各家框架的不同术语绕晕。本文对照 Anthropic《Building effective agents》与 OpenAI 智能体指南,把编排者-工作者、去中心化交接、并行分片投票与生成-评估循环四种标准编排拓扑讲透。

    ChatGPTClaude0
  5. 05

    多智能体(Multi-Agent)是什么、什么时候该用:Anthropic 与 OpenAI 官方判断标准

    多智能体不是代理越多越聪明。本文依据 Anthropic 研究系统架构文章与 OpenAI 官方智能体指南,讲清确定性工作流、单智能体与多智能体的区别,以及哪三类瓶颈才值得上多智能体协同。

    ChatGPTClaude0
  6. 06

    codebase-memory 类 MCP 是什么、怎么用:基于语法树图谱的本地代码索引原理与配置

    codebase-memory-mcp(DeusData/codebase-memory-mcp)是一类本地代码图谱 MCP 服务器:用 Tree-sitter 把仓库解析成函数与调用关系的 SQLite 图库,帮编码助手查调用链并省下读整份文件的额度。

    ClaudeCodex0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~