常见问题
侧边面板里出现了 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 的文件。取决于你的项目如何管理依赖和工具链，你可能需要通过本地环境为工作树运行一些初始化脚本。另一个办法是把改动切回常规本地项目中运行。更多细节参见工作树文档。
应用没有读取到队友共享的本地环境
本地环境配置必须位于项目根目录下的 .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（代码字体） 进行配置。