Communitygithub.com

Codex CLI 权限与会话恢复

当用户询问如何检查 Codex 访问模式、立即继续之前的对话、使用 `codex resume` 或从本地 Codex 会话文件中恢复最新会话 ID 时使用。

Codex CLI 权限与会话恢复 是什么?

这个技能旨在帮助 Codex 用户快速检查当前访问权限模式(例如 `FullAccess`),并高效地恢复或分叉之前的会话,而无需重新阅读旧聊天记录。它详细介绍了如何在交互式 UI 中使用 `/permissions` 命令,以及如何通过 CLI 标志(如 `--dangerously-bypass-approvals-and-sandbox`)来获得完全访问权限,同时澄清了 `--full-auto` 的不同行为。技能提供了清晰的命令示例,包括 `codex resume --last` 和 `codex fork --last`,用于立即继续或分支最新会话,并解释了如何从文件路径中提取会话 UUID。此外,它还指导用户了解 Codex 会话文件的存储布局(位于 `${CODEX_HOME:-$HOME/.codex}/sessions/YYYY/MM/DD/*.jsonl`),并提供了快速查找最新会话文件、提取 UUID 以及决定是恢复、分叉还是直接读取 `.jsonl` 文件以获取上下文的实用方法。该技能可作为全局工作流在任何仓库中使用。

兼容平台~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-]+$'

相关技能