Codex 歷史會話在哪、怎麼恢復:codex resume、/resume 與本地存儲位置詳解

退出終端後想接着上次的 Codex 對話繼續寫?按官方文檔整理:本地轉寫預設存在 ~/.codex/sessions,終端用 codex resume 或會話內 /resume 恢復,跨目錄要加 --all,附分叉對話與找回歸檔會話步驟。

NNathaniel bigo··原創首發·AI 輔助撰寫
11 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. 本地歷史預設存在 $CODEX_HOME/sessions(即 ~/.codex/sessions),已歸檔會話存在 ~/.codex/archived_sessions,輸入歷史配置由 config.toml 的 [history] 表控制。
  2. 終端外恢復用 codex resume:直接敲 codex resume 打開會話選擇器;敲 codex resume --last 直接恢復當前目錄最近一條;跨目錄找最近一條必須加 --all。
  3. 會話內切換用 /resume:在輸入框敲 /resume 回車,可在當前目錄(Cwd)、關聯工作樹倉庫(Repo)或全部目錄(All)三檔範圍裏挑舊會話加載。
  4. 想保留原記錄另試新思路,用 codex fork 或 /fork,它會克隆出一份新 ID 的會話,不破壞原對話上下文。
  5. 非交互腳本也能接續:兩階段流水線用 codex exec resume --last "下一步指令" 或指定會話 ID 繼續執行。

Codex 各端找回與恢復舊會話的方法

圖:本站根據 Codex 官方文檔:Command line options 整理的示意圖

本文根據 Codex 官方文檔《Command line options》《Slash commands in Codex CLI》《Projects and chats》與《Sample Configuration》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。如果你想清理或永久刪掉舊記錄,請看 Codex 怎麼刪除對話、清理任務。

適用於誰

  • 關掉終端窗口或重啟電腦後,想接着上一輪 Codex CLI 會話繼續改代碼的人;
  • 想知道 Codex 的本地聊天記錄到底存在硬碟哪個文件夾、怎麼關掉本地落盤的人;
  • 運行 codex resume --last 卻提示沒找到剛才那條對話,不知道卡在哪一步的人。

一、歷史會話文件存在哪、怎麼管開關

按官方配置與排查文檔,Codex CLI 的本地記錄預設放在 CODEX_HOME(未手動設環境變量時就是用戶主目錄下的 ~/.codex):

  • 活動會話轉寫:~/.codex/sessions;
  • 已歸檔會話轉寫:~/.codex/archived_sessions;
  • 命令與輸入歷史:受 ~/.codex/config.toml 裏的 [history] 表控制(完整配置結構見 Codex config.toml 完整詳解)。

在 config.toml 裏可以調整是否落盤和體積上限:

toml
[history]
persistence = "save-all"   # 預設 save-all;設為 "none" 則不儲存本地歷史
max_bytes = 5242880        # 歷史文件最大字節數,超出後自動裁剪最舊記錄

注意在 Windows 上,如果你一會兒在 PowerShell 跑原生 CLI、一會兒進 WSL 跑 Linux 版 CLI,兩邊各自讀寫 Windows 用戶目錄和 WSL 家目錄下的 .codex,歷史列表互不相通。

二、在命令行 CLI 裏恢復與管理舊會話

1. 啟動時直接恢復:codex resume

還沒進交互介面時,直接在終端運行:

bash
codex resume                      # 打開交互式選擇器挑選舊會話
codex resume --last               # 直接恢復當前工作目錄下最近一次會話
codex resume --last --all         # 跨所有目錄恢復最近一次會話
codex resume <SESSION_ID>         # 按指定會話 ID 精確恢復

官方說明,codex resume 允許你在恢復時順手覆蓋模型或沙箱參數(例如加 -m gpt-6.2-sol),但不支持與 --worktree 同時使用。

如果你當前所在的文件夾和那條會話當初儲存的目錄不一致,Codex 會彈窗問你用哪個目錄。嫌每次被問麻煩,可以在 ~/.codex/config.toml 的 [tui] 表下固定預設行為:

toml
[tui]
resume_cwd = "session"   # 固定切回會話原目錄;寫 "current" 則留在當前目錄

命令行顯式傳入的 --cd(或 -C)優先級高於 tui.resume_cwd。

2. 已經在 TUI 會話裏:/resume、/agents 與 /rename

不想退出重進時,直接用斜槓命令(全部命令見 Codex 命令行常用命令一頁看):

  • /resume:打開選擇器,先切搜尋範圍——Cwd(當前目錄)、Repo(含關聯 Git 工作樹的同倉庫目錄)、All(所有目錄),再回車加載對應記錄;
  • /agents(或終端跑 codex agents):打開代理命令中心,按 F3 或 / 輸入會話名、提示詞片段或工作目錄關鍵字(不區分大小寫)快速檢索老對話;
  • /rename <新名字>:給當前會話起個好認的名字(如 /rename auth-bugfix),省得以後在一堆預設標題裏翻找;
  • /app:在 macOS 和 Windows 上把當前 CLI 會話直接轉到 ChatGPT 桌面端接着聊;
  • /export session.md:把整段對話導出成 Markdown 文件留檔。

3. 想分叉試別的改法:codex fork 與 /fork

有時上次改到一半想換條技術路線,又怕把原記錄沖掉。在會話內輸 /fork,或在終端運行 codex fork --last(支持 codex fork <SESSION_ID> --worktree 直接分叉進新工作樹),Codex 會把原對話完整複製到一個新會話 ID 下繼續。

三、桌面端、網頁版與 IDE 擴展去哪找歷史

  • ChatGPT 桌面端:左側邊欄和 項目(Projects) 視圖集中展示雲端與本地項目對話。點側邊欄的 搜尋對話(Search chats) 可以按正文詞句或分支名檢索(可在 設定(Settings)> 鍵盤快捷鍵(Keyboard Shortcuts) 給搜尋綁快捷鍵);常用的對話或項目支持置頂(Pin)。
  • 網頁版 ChatGPT Work:進對應項目的 對話(Chats) 欄查看,或按 Ctrl+K(macOS 按 Cmd+K)全局搜尋;被歸檔的去 設定(Settings)> 數據控制(Data Controls)> 已歸檔對話(Archived chats) 恢復。
  • IDE 擴展(VS Code 等):打開對應工作區文件夾後,在面板的 近期對話(Recent chats) 列表點選繼續。若遇到同會話在桌面端佔用的提示,處理方法見 Codex VS Code 提示「This is open in another app」怎麼辦。

Codex 找不到舊會話時的排查順序

圖:本站根據 Codex 官方文檔:Slash commands 與排查指南整理的示意圖

四、找不到舊會話時的五個排查點

  1. 換了啟動目錄:codex resume --last 預設只認當前目錄,加上 --all 再試一次。
  2. 會話被歸檔了:桌面端去 設定(Settings)> 已歸檔對話(Archived chats) 點取消歸檔(Unarchive);CLI 運行 codex unarchive <SESSION> 恢復。
  3. 之前跑腳本加了 --ephemeral:非交互模式傳入 --ephemeral 時不會把會話文件寫盤,跑完即焚。
  4. history.persistence 被設成了 "none":檢查用戶級與託管級配置是否關閉了持久化。
  5. 登錯了帳號或工作區:個人 Plus/Pro 工作區與公司 Business 工作區的雲端記錄彼此獨立。如果團隊多人開發需要獨立工作區和集中管理,可了解本站 ChatGPT Business 團隊版定製;個人續費或升級可看 ChatGPT Plus 充值說明。

常見問題

問:恢復舊會話後,之前消耗的上下文 token 還在嗎?

答:在。恢復會把之前的對話記錄重新帶入上下文,如果原會話已經很長,接着聊之前可以先跑一次 /compact 壓縮歷史,省額度也更快。

問:桌面端的「鎖定對話(Locked chats)」支持本地 Codex 會話嗎?

答:官方《Projects and chats》明確說明,PIN 碼鎖定對話僅支持符合條件的雲端 Chat 和 Work 對話,不支持本地 Work 與本地 Codex 會話。

問:已經執行 /delete 或在已歸檔列表點垃圾桶刪掉的對話還能恢復嗎?

答:不能。官方寫明永久刪除後的會話無法通過介面、API 或聯絡客服找回。

相關教學

參考資料

  • Codex 官方文檔:Command line options — https://learn.chatgpt.com/docs/developer-commands
  • Codex 官方文檔:Slash commands in Codex CLI — https://learn.chatgpt.com/docs/reference/slash-commands
  • Codex 官方文檔:Projects and chats — https://learn.chatgpt.com/docs/projects
  • Codex 官方文檔:Sample Configuration — https://learn.chatgpt.com/docs/config-file/config-sample

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

登入 後參與評論

還沒有評論,來搶沙發~