Communitygithub.com

Codex CLI 權限與工作階段恢復

用於檢查 Codex 存取模式、使用 `codex resume` 立即繼續先前對話,或從本機 Codex 工作階段檔案中恢復最新的工作階段 ID,無需重新閱讀舊對話。

Codex CLI 權限與工作階段恢復 是什麼?

這個技能專為使用 Codex CLI 的開發者設計,提供快速檢查當前存取模式(如 `FullAccess`)的方法,以及使用 `codex resume` 或 `codex fork` 命令立即恢復先前工作階段的捷徑。它詳細說明如何從本機 `~/.codex/sessions/` 目錄中找出最新的 `.jsonl` 工作階段檔案,並從檔案名稱中提取 UUID,以便直接以一行指令恢復對話。技能也比較 `resume`(繼續同一對話線)與 `fork`(分支到新思路)的差異,並強調使用 `--dangerously-bypass-approvals-and-sandbox` 標誌來啟動完整存取模式。此外,它提供實用的 shell 命令組合,讓開發者能在一秒內找到、檢查或恢復最新的工作階段,無需手動瀏覽目錄結構或重新閱讀完整的對話記錄。此技能適用於任何使用 Codex CLI 的專案,因為其指令和工作階段佈局是跨儲存庫可重複使用的。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Ryzoner/agent_skills/tree/HEAD/.agents/skills/codex-cli-permissions-and-session-resume

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

codex-cli 權限與工作階段恢復

在以下情況使用此技能:

  • 使用者詢問 Codex 目前是否擁有完整存取權限
  • 使用者提及 /permissions、FullAccess 或類似的存取模式用語
  • 使用者想要立即繼續先前的 Codex 對話
  • 使用者詢問如何使用 codex resume
  • 使用者詢問 codex fork 與 codex resume 的差異
  • 使用者想要從本機 Codex 工作階段檔案中取得最新的工作階段 ID

範圍

這是全域的 Codex 工作流程,而非專案本機的工作流程。 它應放置在 ${CODEX_HOME:-$HOME/.codex}/skills/,因為這些命令和工作階段佈局是可跨儲存庫重複使用的。

存取模式提醒

  • 在互動式 Codex UI 中,/permissions 是快速檢查目前存取模式的方式。
  • 在 CLI 說明中,明確的完全開放旗標是 --dangerously-bypass-approvals-and-sandbox。
  • --full-auto 並不相同,它仍然使用 workspace-write。
  • resume 和 fork 接受與一般互動啟動相同的全域執行旗標。
  • 建議使用 codex --help 中記錄的旗標,而非未記錄的別名。

快速恢復命令

建議使用以下命令:

codex resume <SESSION_UUID>
codex resume --last
codex fork <SESSION_UUID>
codex fork --last
codex resume --dangerously-bypass-approvals-and-sandbox <SESSION_UUID>
codex resume --dangerously-bypass-approvals-and-sandbox --last

重要事項:

  • codex resume 正式接受工作階段 UUID 或執行緒名稱
  • codex fork 正式接受工作階段 UUID 並建立該先前工作階段的新分支
  • codex resume 也接受相同的全域執行旗標,例如 --dangerously-bypass-approvals-and-sandbox
  • 建議使用 UUID,而不是 .jsonl 檔案名稱
  • 如果檔案名稱是 rollout-2026-03-21T22-54-32-019d122d-9c09-7572-addf-ee59fab48e1b.jsonl,則建議的恢復命令是:
codex resume 019d122d-9c09-7572-addf-ee59fab48e1b

如果您希望恢復的工作階段保持完全開放風格,請使用:

codex resume --dangerously-bypass-approvals-and-sandbox 019d122d-9c09-7572-addf-ee59fab48e1b

如果您想要一個新的思路分支,而不是繼續同一條故事線,請使用:

codex fork 019d122d-9c09-7572-addf-ee59fab48e1b
codex fork --last

工作階段檔案佈局

Codex 工作階段記錄存放於:

${CODEX_HOME:-$HOME/.codex}/sessions/YYYY/MM/DD/*.jsonl

範例:

${CODEX_HOME:-$HOME/.codex}/sessions/2026/03/21/rollout-2026-03-21T22-54-32-019d122d-9c09-7572-addf-ee59fab48e1b.jsonl

最快找到最新工作階段的方法

除非必要,否則不要手動依序瀏覽年 -> 月 -> 日。 建議使用時間戳排序:

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
ls -1t "$CODEX_HOME_DIR"/sessions/*/*/*/*.jsonl 2>/dev/null | head -1

若要列出幾個最近的工作階段:

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
ls -1t "$CODEX_HOME_DIR"/sessions/*/*/*/*.jsonl 2>/dev/null | head -10

如何快速提取 UUID

從最新路徑中,取出 .jsonl 前面的尾部 UUID。

範例:

rollout-2026-03-21T22-54-32-019d122d-9c09-7572-addf-ee59fab48e1b.jsonl

UUID:

019d122d-9c09-7572-addf-ee59fab48e1b

然後使用以下命令恢復:

codex resume 019d122d-9c09-7572-addf-ee59fab48e1b

實用規則

當使用者想要在一秒內恢復上下文時:

  1. 如果存取模式很重要,請檢查 /permissions
  2. 對於最新的先前工作階段,建議使用 codex resume --last
  3. 如果知道特定的工作階段檔案,請將其縮減為 UUID 並執行 codex resume <UUID>
  4. 僅使用 ${CODEX_HOME:-$HOME/.codex}/sessions/*/*/*/*.jsonl 來發現或確認 UUID,除非恢復不可行,否則不要重新閱讀整個記錄

何時直接讀取工作階段檔案

直接讀取 .jsonl 本身是有效且有用的,當:

  • 您想要先取得先前的上下文,而不切換即時互動工作階段
  • 您想要在恢復前總結、搜尋或驗證之前發生的事情
  • 您只知道檔案系統路徑,並想要恢復工作階段 UUID
  • 您需要立即從磁碟取得最後的使用者或助理對話輪次

建議規則:

  • 最快繼續同一對話 -> codex resume <UUID> 或 codex resume --last
  • 為替代探索建立同一先前對話的乾淨分支 -> codex fork <UUID> 或 codex fork --last
  • 相同繼續但明確使用完全開放模式 -> codex resume --dangerously-bypass-approvals-and-sandbox <UUID> 或 codex resume --dangerously-bypass-approvals-and-sandbox --last
  • 從磁碟最快檢查先前上下文 -> 開啟最新的 sessions/.../*.jsonl

恢復 vs 分支 vs 平行處理

使用:

  • resume 來繼續同一工作階段和故事線
  • fork 將該工作階段分支到新的工作線

不要將同一個工作階段的兩個同時 resume 執行視為乾淨的多擁有者工作流程。 如果您需要真正的平行探索,建議使用:

  • fork 用於替代方法
  • Codex 子代理用於有限範圍的平行分析
  • 在不同的分支或工作樹中執行獨立的 Codex 程序,用於平行的大量寫入實作

實用的組合工作流程

對於最新的先前對話:

CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
latest=$(ls -1t "$CODEX_HOME_DIR"/sessions/*/*/*/*.jsonl 2>/dev/null | head -1)
printf '%s\n' "$latest"

如果您想先檢查檔案:

tail -n 80 "$latest"

如果您想直接繼續:

codex resume --last

如果您想以完全開放模式直接繼續:

codex resume --dangerously-bypass-approvals-and-sandbox --last

如果您需要從檔案名稱中提取 UUID:

basename "$latest" .jsonl | grep -oE '[0-9a-f]{8,}-[0-9a-f-]+$'

相關技能