故障排除
如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加
.md来获取 URL。
侧边栏中出现了 Codex 未编辑的文件
Section titled “侧边栏中出现了 Codex 未编辑的文件”如果你的项目位于 Git 仓库中，审查面板会自动 根据你项目的 Git 状态显示更改，包括 Codex 未进行的更改。
在审查窗格中，你可以在已暂存更改和尚未 暂存的更改之间切换，并将你的分支与 main 进行比较。
如果你只想查看上一次 Codex 回合的更改，请将 diff 窗格切换到 上次回合 视图。
从侧边栏移除项目
Section titled “从侧边栏移除项目”要从侧边栏移除项目，请将鼠标悬停在项目名称上，点击 三个点并选择“移除”。要恢复它，请使用 旁边的 添加新项目 按钮重新添加 聊天 或使用
Cmd+O。
查找已归档的聊天
Section titled “查找已归档的聊天”已归档的聊天可在 设置中找到。取消归档 聊天后，它会重新出现在侧边栏的原位置。
侧边栏中只显示部分聊天
Section titled “侧边栏中只显示部分聊天”侧边栏允许你根据项目状态筛选聊天。如果你 找不到聊天，请选择 聊天旁边的筛选图标，然后选择 按时间顺序。如果仍然看不到该聊天，请打开 设置 并检查 已归档的聊天。
代码无法在工作树中运行
Section titled “代码无法在工作树中运行”Worktree 会在不同目录中创建，并默认继承已检入
Git 的文件。根据你为项目管理依赖项和工具的方式，
你可能需要使用
本地环境 在 worktree 上运行设置脚本，或复制被忽略的设置文件
并使用 .worktreeinclude。
或者，你也可以在常规的本地项目中检出这些更改。请参阅
相关 worktree 文档 了解更多信息。
应用未使用队友共享的本地环境
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要获取 Codex 随你的 ChatGPT 桌面应用捆绑的版本，请使用
保留的 Codex.app 兼容性捆绑包路径：
/Applications/Codex.app/Contents/Resources/codex --version在消息编辑器中输入 / 以向团队提供反馈。如果 你在现有聊天中触发反馈，可以选择将 现有会话连同反馈一起分享。提交反馈后， 你将收到一个会话 ID ，可分享给团队。
要报告问题：
- 查找 现有问题 在 Codex GitHub 仓库中。
- 新建 GitHub 问题
更多日志位于以下位置：
- 应用日志（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。