故障排除
侧边栏中出现了 Codex 未编辑的文件
Section titled “侧边栏中出现了 Codex 未编辑的文件”如果你的项目位于 Git 仓库中，审查面板会根据项目的 Git 状态自动显示更改，其中包括 Codex 未进行的更改。
在审查窗格中，你可以在已暂存的更改和尚未暂存的更改之间切换，也可以将当前分支与 main 进行比较。
如果你只想查看上一次 Codex 交互中的更改，请将差异窗格切换到 Last turn 视图。
从侧边栏移除项目
Section titled “从侧边栏移除项目”要从侧边栏移除项目，请将鼠标悬停在项目名称上，点击三个点，然后选择“Remove”。要恢复项目，请使用 Chats 旁边的 Add new project 按钮，或使用
Cmd+O。
查找已归档的聊天
Section titled “查找已归档的聊天”已归档的聊天可以在 Settings 中找到。取消归档聊天后，它会重新出现在侧边栏中的原位置。
侧边栏中只显示部分聊天
Section titled “侧边栏中只显示部分聊天”侧边栏允许你根据项目的状态筛选聊天。如果缺少聊天，请选择 Chats 旁边的筛选图标，然后选择 Chronological。如果仍然看不到该聊天，请打开 Settings，检查 Archived chats。
代码无法在工作树中运行
Section titled “代码无法在工作树中运行”工作树会创建在不同的目录中，默认会继承 Git 中已提交的文件。根据你管理项目依赖项和工具的方式，你可能需要使用本地环境在工作树中运行设置脚本，或使用 .worktreeinclude 复制被忽略的设置文件。
或者，你也可以在常规本地项目中检出这些更改。详情请参阅工作树文档。
应用未使用队友共享的本地环境
Section titled “应用未使用队友共享的本地环境”本地环境配置必须位于项目根目录下的 .codex 文件夹中。如果你在一个包含多个项目的 monorepo 中工作，请确保你是在包含 .codex 文件夹的目录中打开项目。
Codex 请求访问 Apple Music
Section titled “Codex 请求访问 Apple Music”根据任务的不同，Codex 可能需要浏览文件系统。在 macOS 上，包括 Music、Downloads 或 Desktop 在内的某些目录需要获得用户的额外批准。如果 Codex 需要读取你的主目录，macOS 会提示你批准对这些文件夹的访问。
计划任务创建了许多工作树
Section titled “计划任务创建了许多工作树”频繁的计划任务可能会随着时间推移创建许多工作树。请归档不再需要的计划任务运行记录，除非你打算保留其工作树，否则不要固定运行记录。
选择错误目标后恢复提示词
Section titled “选择错误目标后恢复提示词”如果你意外地使用了错误的目标（Local、Worktree 或 Cloud）开始聊天，可以取消当前运行，然后在编辑器中按向上箭头键恢复之前的提示词。
功能在 Codex CLI 中正常运行，但在 ChatGPT 桌面应用中无法运行
Section titled “功能在 Codex CLI 中正常运行，但在 ChatGPT 桌面应用中无法运行”ChatGPT 桌面应用和 Codex CLI 可能包含不同版本的 Codex，因此某些功能可能会先在其中一个界面中提供。实验性功能也可能首先进入 Codex CLI。
要获取系统中 Codex CLI 的版本，请运行：
codex --version要获取 ChatGPT 桌面应用中捆绑的 Codex 版本，请使用保留的 Codex.app 兼容性包路径：
/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）
如果你分享日志，请先检查其中是否包含敏感信息。
卡住状态和恢复模式
Section titled “卡住状态和恢复模式”如果聊天似乎卡住了：
- 检查 Codex 是否正在等待批准。
- 打开终端并运行
git status等基本命令。 - 使用更小、更聚焦的提示词开始新的聊天。
如果你不小心取消了工作树创建并丢失提示词，请在编辑器中按向上箭头键恢复。
终端似乎卡住了
- 关闭终端面板。
- 使用 Ctrl+` 重新打开终端。
- 重新运行
pwd或git status等基本命令。
如果命令的行为与预期不符，请先在终端中确认当前目录和分支。
如果仍然卡住，请等待当前活动聊天完成，然后重启应用。
字体渲染不正确
Codex 在审查窗格、集成终端以及应用内显示的其他代码中使用相同的字体。你可以在 Settings 窗格中将其配置为 Code font。