Codex App Troubleshooting | 日志与修复

常见问题

侧边面板里出现了 Codex 没改过的文件

如果你的项目位于 Git 仓库中，评审面板会根据项目当前的 Git 状态自动展示改动，其中也包括那些并不是 Codex 编辑过的文件。

在评审面板中，你可以在已暂存与未暂存改动之间切换，也可以把当前分支与 main 做比较。

如果你只想看 Codex 最近一轮造成的改动，把差异面板切换到 "Last turn changes（最近一轮改动）" 视图即可。

从侧边栏移除项目

如果你要把某个项目从侧边栏中移除，把鼠标悬停在项目名上，点击三点菜单，然后选择 "Remove（移除）"。如果之后要恢复，可以通过 Threads（线程）旁边的 Add new project（添加新项目）按钮重新添加，或者使用 Cmd+O。

查找已归档线程

归档线程可以在 Settings（设置）中找到。取消归档后，它会重新出现在侧边栏原来的位置。

为什么侧边栏只显示部分线程

侧边栏支持按项目状态过滤线程。如果你发现有线程不见了，点击 Threads（线程）旁边的过滤图标，切换到 Chronological（按时间排序）。如果仍然找不到，再打开 Settings（设置），检查 archived chats（已归档聊天）或 archived threads（已归档线程）区域。

为什么代码在工作树里跑不起来

工作树创建在不同目录中，默认会继承已经提交进 Git 的文件。取决于你的项目如何管理依赖和工具链，你可能需要通过本地环境为工作树运行初始化脚本，或用 .worktreeinclude 复制被忽略的设置文件。另一个办法是把改动切回常规本地项目中运行。更多细节参见工作树文档。

应用没有读取到队友共享的本地环境

本地环境配置必须位于项目根目录下的 .codex 文件夹中。如果你在单仓多项目仓库（monorepo）里工作，而仓库中包含多个项目，请确认你打开的是那个包含 .codex 文件夹的项目目录。

Codex 为什么会请求访问 Apple Music

某些任务下，Codex 需要遍历文件系统。macOS 上的一些目录，例如 Music（音乐）、Downloads（下载）或 Desktop（桌面），需要用户单独批准访问。如果 Codex 需要读取你的 home 目录，macOS 可能会弹出权限提示，要求你批准访问这些文件夹。

自动化创建了很多工作树

高频自动化会随着时间积累出大量工作树。请归档那些已经不再需要的自动化运行记录，并避免固定那些你并不打算长期保留的运行结果。

选错目标后，如何恢复提示词

如果你误把线程启动在错误目标上，例如 Local（本地）、Worktree（工作树）或 Cloud（云端），可以先取消当前运行，然后在输入框中按上箭头键，恢复上一条提示词。

某个功能在 Codex CLI 可用，但在 Codex App 里不可用

Codex App 和 Codex CLI 使用同一个底层 Codex 智能体与配置体系，但在任意时刻它们依赖的智能体版本可能并不完全一致，而且某些实验性能力往往会先落到 Codex CLI。

要查看你系统上安装的 Codex CLI 版本，运行：

codex --version

要查看随 Codex App 打包的 Codex 版本，运行：

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

反馈与日志

在消息输入框中输入 /，可以向团队提交反馈。如果你是在某个已有会话里触发反馈，还可以选择把当前会话一并分享出去。提交之后，你会拿到一个会话 ID，可用于后续沟通。

如果你要报告问题：

先查看 Codex GitHub 仓库中的现有问题
如果没有同类问题，再新建 GitHub issue（问题单）

更多日志位于以下位置：

App 日志（macOS）：~/Library/Logs/com.openai.codex/YYYY/MM/DD
会话转录：$CODEX_HOME/sessions（默认：~/.codex/sessions）
已归档会话：$CODEX_HOME/archived_sessions（默认：~/.codex/archived_sessions）

如果你准备分享日志，请先自行检查，确认其中不包含敏感信息。

卡住状态与恢复方式

如果某个线程看起来卡住了：

先检查 Codex 是否正在等待你的审批。
打开终端，运行一个基础命令，例如 git status。
新开一个线程，并用更小、更聚焦的提示词重试。

如果你是误取消了工作树创建，并因此丢掉了提示词，可以在输入框中按上箭头键恢复它。

终端问题

终端看起来卡住了

先关闭终端面板。
使用 Cmd+J 重新打开。
重新运行一个基础命令，例如 pwd 或 git status。

如果命令表现和预期不一致，优先先验证终端当前目录和分支是否正确。

如果仍然卡住，先等待当前活跃的 Codex 线程执行完成，然后重启应用。

字体显示不正常

Codex 会为评审面板、集成终端以及应用中显示的其他代码内容统一使用同一套字体。你可以在 Settings（设置）中通过 Code font（代码字体）进行配置。