本文为非官方中文翻译，内容以 OpenAI 官方英文文档为准。
官方来源：https://developers.openai.com/codex/app/troubleshooting
故障排查
常见 Codex 应用问题的 FAQ 和修复方法
常见问题
侧边栏中出现了 Codex 没有编辑的文件
如果你的项目位于 Git 仓库中，审查面板会根据你项目的 Git 状态自动显示变更，其中包括不是由 Codex 做出的变更。
在审查面板中，你可以在已暂存变更和尚未暂存的变更之间切换，并将你的分支与 main 进行比较。
如果你只想查看你最近一次 Codex 轮次中的变更，请将 diff 面板切换到 “Last turn changes” 视图。
从侧边栏移除一个项目
要从侧边栏中移除一个项目，将鼠标悬停在项目名称上，点击三个点，然后选择 “Remove”。要恢复它，请使用 Threads 旁边的 Add new project 按钮重新添加该项目，或使用
Cmd+O。
查找已归档的线程
已归档的线程可以在 Settings 中找到。当你取消归档某个线程后，它会重新出现在侧边栏中的原始位置。
只有部分线程出现在侧边栏中
侧边栏允许根据项目状态筛选线程。如果你发现缺少某些线程，请点击 Threads 标签旁边的筛选图标，并切换到 Chronological。如果你仍然看不到该线程，请打开 Settings，并检查 archived chats 或 archived threads 部分。
代码无法在 worktree 上运行
worktree 是在不同目录中创建的，并且只会继承已提交到 Git 的文件。根据你管理项目依赖和工具的方式，你可能需要使用本地环境在 worktree 中运行一些设置脚本。或者，你也可以在你常规的本地项目中检出这些变更。请查看 worktrees 文档 以了解更多信息。
应用没有识别出队友共享的本地环境
本地环境配置必须位于项目根目录下的 .codex 文件夹中。如果你正在一个包含多个项目的 monorepo 中工作，请确保你打开的是包含 .codex 文件夹的目录中的项目。
Codex 请求访问 Apple Music
根据你的任务，Codex 可能需要浏览文件系统。macOS 中的某些目录（包括 Music、Downloads 或 Desktop）需要用户额外批准。如果 Codex 需要读取你的主目录，macOS 会提示你批准访问这些文件夹。
自动化创建了很多 worktree
频繁运行自动化会随着时间推移创建很多 worktree。请归档你不再需要的自动化运行，并避免固定运行，除非你打算保留它们的 worktree。
选择了错误目标后恢复提示词
如果你不小心使用了错误的目标（Local、Worktree 或 Cloud）启动线程，你可以取消当前运行，然后在输入框中按上方向键来恢复之前的提示词。
某个功能在 Codex CLI 中可用，但在 Codex 应用中不可用
Codex 应用和 Codex CLI 使用相同的底层 Codex agent 和配置，但它们在任意时刻可能依赖于不同版本的 agent，并且某些实验性功能可能会先在 Codex CLI 中上线。
要获取你系统上的 Codex CLI 版本，请运行：
codex --version
要获取随你的 Codex 应用打包的 Codex 版本，请运行：
/Applications/Codex.app/Contents/Resources/codex --version
反馈与日志
在消息输入框中输入 /，即可向团队提供反馈。如果你在现有对话中触发反馈，你可以选择连同现有会话一起分享。提交反馈后，你会收到一个会话 ID，可将其分享给团队。
要报告问题：
- 在 Codex GitHub 仓库中查找现有问题。
- 新建一个 GitHub issue
更多日志可在以下位置找到：
- 应用日志（macOS）：
~/Library/Logs/com.openai.codex/YYYY/MM/DD - 会话记录：
$CODEX_HOME/sessions（默认值：~/.codex/sessions） - 已归档会话：
$CODEX_HOME/archived_sessions（默认值：~/.codex/archived_sessions）
如果你要共享日志，请先检查它们，确认其中不包含敏感信息。
卡住状态与恢复模式
如果某个线程看起来卡住了：
- 检查 Codex 是否正在等待批准。
- 打开终端并运行一个基础命令，例如
git status。 - 使用一个更小、更聚焦的提示词启动新线程。
如果你误取消了 worktree 创建并丢失了提示词，请在输入框中按上方向键来恢复它。
终端问题
终端似乎卡住了
- 关闭终端面板。
- 使用 Cmd+J 重新打开它。
- 重新运行一个基础命令，例如
pwd或git status。
如果命令的行为与预期不同，请先在终端中确认当前目录和分支。
如果它仍然卡住，请等待你当前活动的 Codex 线程完成，然后重启应用。
字体渲染不正确
Codex 对审查面板、集成终端以及应用内显示的其他任何代码都使用同一种字体。你可以在 Settings 面板中的 Code font 里配置该字体。