OpenAI Codex 遇到侧边栏文件不对、线程找不到、worktree 不能运行、终端卡住或 CLI 和 App 行为不一致时，先按这里的排查顺序处理。重点是确认 Git 状态、切换 review pane 视图、检查 Settings 里的归档线程，以及用 codex --version 和 /Applications/Codex.app/Contents/Resources/codex --version 对比版本。
OpenAI Codex 报错与排查
常见问题
Codex 侧边栏出现了我没让它改的文件
如果你的项目在 Git repository 里，review pane 会根据项目的 Git 状态自动显示变更，包括不是 Codex 这次修改的内容。
在 review pane 里，你可以在 staged changes 和还没 staged 的变更之间切换，也可以把当前分支和 main 对比。
如果你只想看上一次 Codex 轮次改了什么，把 diff pane 切到 Last turn changes 视图。
怎么把项目从侧边栏移除
把鼠标移到项目名上，点三个点，再选 Remove。要恢复显示，可以用 Threads 旁边的 Add new project 按钮重新添加，或者按 Cmd+O。
归档线程在哪找
归档线程可以在 Settings 里找到。取消归档后，它会回到侧边栏原来的位置。
为什么侧边栏只显示部分线程
侧边栏会根据项目状态过滤线程。如果少了线程，点 Threads 标签旁边的筛选图标，切换到 Chronological。还是找不到的话，打开 Settings，检查 archived chats 或 archived threads 区域。
Codex 在 worktree 里为什么跑不起来
worktree 会在另一个目录里创建，而且只继承已经提交到 Git 的文件。根据你的依赖和工具链管理方式，你可能需要在 worktree 里通过 local environment 运行一些 setup scripts。也可以把改动检出到本地常规项目里。更多内容见 worktrees 文档。
App 为什么读不到队友共享的 local environment
local environment 配置必须放在项目根目录的 .codex 文件夹里。如果你在 monorepo 中处理多个项目，要确保打开的是包含 .codex 文件夹的那个目录。
Codex 为什么会要求访问 Apple Music
根据任务不同，Codex 可能需要浏览文件系统。macOS 上的某些目录，包括 Music、Downloads 或 Desktop，都需要用户额外批准。如果 Codex 需要读取你的 home directory，macOS 会弹窗让你确认这些文件夹的访问权限。
automations 为什么会创建很多 worktree
频繁的 automations 会随着时间创建很多 worktree。把不再需要的 automation run 归档掉，也不要 pin 这些 run，除非你确实想保留它们的 worktree。
选错 Local、Worktree 或 Cloud 后怎么恢复 prompt
如果你一开始选错了 thread target（Local、Worktree 或 Cloud），可以先取消当前 run，再在 composer 里按上箭头恢复上一条 prompt。
为什么 Codex CLI 能用，但 Codex app 不行
Codex app 和 Codex CLI 使用同一个底层 Codex agent 和配置，但任何时候可能依赖不同版本的 agent，而且一些实验性功能可能会先出现在 Codex CLI。
查看系统里的 Codex CLI 版本：
codex --version查看 Codex app 内置的 Codex 版本：
/Applications/Codex.app/Contents/Resources/codex --version反馈和日志
在 message composer 里输入 /，就可以把反馈发给团队。如果你是在已有对话里触发反馈，还可以选择把当前 session 一起分享出去。提交后会拿到一个 session ID，方便转给团队排查。
报告问题时：
- 先在 Codex GitHub repo 里查找 existing issues。
- 再 创建新的 GitHub issue。
可用日志位置如下：
- App logs（macOS）：
~/Library/Logs/com.openai.codex/YYYY/MM/DD - Session transcripts：
$CODEX_HOME/sessions（默认：~/.codex/sessions） - Archived sessions：
$CODEX_HOME/archived_sessions（默认：~/.codex/archived_sessions）
分享日志前先检查一遍，确认里面没有敏感信息。
卡住状态和恢复方法
如果 thread 看起来卡住了：
- 先确认 Codex 是不是在等 approval。
- 打开 terminal，运行一个基础命令，比如
git status。 - 用更小、更聚焦的 prompt 新建一个 thread。
如果你误取消了 worktree 创建并且 prompt 丢了，按 composer 里的上箭头可以把它找回来。
终端问题
Terminal 看起来卡住了
- 关掉 terminal panel。
- 用 Cmd+J 重新打开。
- 重新运行一个基础命令，比如
pwd或git status。
如果命令表现和预期不同，先在 terminal 里确认当前目录和 branch 是否正确。
如果还是卡住，等当前活跃的 Codex threads 完成后再重启 app。
字体显示不正常
Codex 在 review pane、integrated terminal 以及 app 里所有代码显示区域，使用的是同一种字体。你可以在 Settings 面板里把 Code font 配好。
常见问题
OpenAI Codex 侧边栏为什么会显示我没改过的文件
如果项目在 Git repository 里，review pane 会按 Git 状态显示变更，不只显示 Codex 这次修改的文件。切到 Last turn changes 可以只看最近一轮修改。
OpenAI Codex CLI 和 App 版本不一致怎么查
在 Codex CLI 里运行 codex --version，在 macOS 的 Codex app 里运行 /Applications/Codex.app/Contents/Resources/codex --version。如果版本不同，某些功能表现可能也会不同。
Codex 终端卡住怎么解决
先关掉 terminal panel，再用 Cmd+J 打开，执行 pwd 或 git status 验证当前目录和分支。若仍无响应，等正在运行的 threads 完成后重启 app。