故障排除

常见问题

侧边面板中出现了 Codex 未编辑的文件

如果你的项目位于 Git 仓库中，审查面板会根据项目的 Git 状态自动显示变更，包括非 Codex 作出的更改。

在审查面板中，你可以在已暂存的更改和尚未暂存的更改之间切换，还可以将你的分支与 main 分支进行比较。

如果你只想查看上一次 Codex 回合的更改，请将差异面板切换至“上一轮更改”视图。

了解更多关于如何使用审查面板的信息.

从侧边栏移除项目

要从侧边栏移除项目，请将鼠标悬停在你的项目名称上，点击三个点图标并选择“移除”。要恢复项目，请使用以下位置的按钮重新添加该项目： 添加新项目 旁边的按钮 线程 or using

Cmd+O.

查找已归档的对话

已归档的对话可以在以下位置找到： 设置。当你取消归档某个线程时,它会重新出现在侧边栏的原始位置。

侧边栏中只显示部分对话

侧边栏允许根据项目状态筛选线程。如果你找不到线程，请点击 线程 标签旁边的筛选图标，并切换到“按时间顺序”。如果你仍然看不到该线程，请打开 设置 并查看已归档的聊天或已归档的线程部分。

代码无法在工作树上运行

工作树创建在不同的目录中，并且只会继承已提交到 Git 的文件。根据你管理项目依赖和工具的方式，你可能需要使用 本地环境。或者，您可以在常规的本地项目中查看这些更改。查看 工作树文档 to learn more.

应用未检测到团队成员共享的本地环境

本地环境配置必须位于项目根目录的 .codex 文件夹中。如果你在包含多个项目的 monorepo 中工作，请确保在包含 .codex folder.

Codex 请求访问 Apple Music

根据你的任务，Codex 可能需要访问文件系统。macOS 上的某些目录（包括“音乐”、“下载”或“桌面”）需要用户额外批准。如果 Codex 需要读取你的主目录，macOS 会提示你批准访问这些文件夹。

自动化会创建许多工作树

频繁的自动化操作会随着时间推移创建许多工作树。请归档不再需要的自动化运行，除非你打算保留它们的工作树，否则请避免固定运行。

在选择了错误的目标后恢复提示

如果你使用了错误的目标（本地, 工作树, or 云端)时,你可以取消当前运行,并通过在编辑器中按向上箭头键来恢复你之前的提示。

功能在 Codex CLI 中可用,但在 Codex 应用中不可用

Codex 应用和 Codex CLI 使用相同的底层 Codex 代理和配置，但随时可能依赖不同版本的代理，且一些实验性功能可能会率先在 Codex CLI 中推出。

要获取您系统上 Codex CLI 的版本，请运行：

codex --version

要获取随你的 Codex 应用捆绑的 Codex 版本,请运行:

/Applications/Codex.app/Contents/Resources/codex --version

Feedback and logs

类型 / 到消息编辑器中以向团队提供反馈。如果你在现有对话中触发反馈,可以选择连同反馈一起共享现有会话。提交反馈后,你会收到一个可与团队共享的会话 ID。

To report an issue:

1. 查找 现有问题 在 Codex GitHub 仓库中。
2. 提交新的 GitHub issue

以下位置提供了更多日志：

• 应用日志 (macOS)： ~/Library/Logs/com.openai.codex/YYYY/MM/DD
• 会话记录： $CODEX_HOME/sessions (默认： ~/.codex/sessions)
• 已归档会话： $CODEX_HOME/archived_sessions (默认： ~/.codex/archived_sessions)

如果分享日志，请先检查以确认它们不包含敏感信息。

卡死状态与恢复模式

如果线程似乎卡住了：

1. 检查 Codex 是否正在等待批准。
2. 打开终端并运行一个基础命令，例如 git status.
3. 使用一个更精简、更具体的提示词开启一个新线程。

如果你误取消了工作树 (worktree) 的创建并丢失了提示词，可以在编辑器中按上方向键来恢复它。

终端问题

终端似乎卡住了

1. 关闭终端面板。
2. 使用以下方式重新打开 Cmd+J.
3. 重新运行一个基础命令，例如 pwd or git status.

如果命令的行为与预期不符，请先在终端中验证当前目录和分支。

如果仍然卡住，请等待活跃的 Codex 线程完成，然后重启应用。

字体无法正常渲染

Codex 对审查面板、集成终端以及应用内显示的所有其他代码使用相同的字体。你可以在 设置 面板中配置字体，选项为 代码字体.