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 條評論

登入 後參與評論

還沒有評論,來搶沙發~