Frequently Asked Questions
Side panel 中出现 Codex 没有编辑的 files
如果你的 project 位于 Git repository 内，review panel 会根据 project 的 Git state 自动显示 changes，包括不是 Codex 做出的 changes。
在 review pane 中，你可以在 staged changes 和尚未 staged 的 changes 之间切换，也可以将你的 branch 与 main 进行比较。
如果你只想查看上一次 Codex turn 的 changes，请把 diff pane 切换到 "Last turn changes" view。
从 sidebar 移除 project
要从 sidebar 移除 project，请 hover 到 project name 上，点击 three dots，然后选择 "Remove"。要恢复它，请使用 Threads 旁边的 Add new project button 重新添加 project，或使用
Cmd+O。
查找 archived threads
Archived threads 可以在 Settings 中找到。当你 unarchive 一个 thread 时，它会重新出现在 sidebar 的原位置。
sidebar 中只显示部分 threads
Sidebar 允许根据 project state 过滤 threads。如果缺少 threads，请点击 Threads label 旁的 filter icon，并切换到 Chronological。如果仍然看不到 thread，请打开 Settings ，检查 archived chats 或 archived threads section。
Code 无法在 worktree 上运行
Worktrees 会创建在不同 directory 中，并默认继承 Git 中 checked-in 的 files。根据你管理 project dependencies 和 tooling 的方式，你可能需要在 worktree 上使用 local environment 运行 setup scripts，或用 .worktreeinclude 复制 ignored setup files。也可以在常规 local project 中 check out 这些 changes。参见 worktrees documentation 了解更多。
App 没有识别 teammate 共享的 local environment
Local environment configuration 必须位于 project root 的 .codex folder 中。如果你在包含多个 projects 的 monorepo 中工作，请确保打开的是包含 .codex folder 的 directory。
Codex 要求访问 Apple Music
根据你的 task，Codex 可能需要 navigate file system。macOS 上的某些 directories，包括 Music、Downloads 或 Desktop，需要用户额外 approval。如果 Codex 需要读取你的 home directory，macOS 会提示你 approve 对这些 folders 的 access。
Automations 创建了许多 worktrees
Frequent automations 可能随着时间创建许多 worktrees。Archive 不再需要的 automation runs，并避免 pinning runs，除非你确实想保留它们的 worktrees。
选择错误 target 后恢复 prompt
如果你意外使用错误 target（Local、Worktree 或 Cloud）启动 thread，可以 cancel 当前 run，并在 composer 中按 up arrow key 恢复之前的 prompt。
Feature 可在 Codex CLI 中工作，但不能在 Codex app 中工作
Codex app 和 Codex CLI 使用相同的 underlying Codex agent 和 configuration，但它们在任意时刻可能依赖不同版本的 agent，某些 experimental features 也可能先进入 Codex CLI。
要获取你系统上的 Codex CLI version，请运行：
codex --version要获取 Codex app bundled 的 Codex version，请运行：
/Applications/Codex.app/Contents/Resources/codex --versionFeedback 和 logs
在 message composer 中输入 /，为 team 提供 feedback。如果你在 existing conversation 中触发 feedback，可以选择连同 feedback 一起分享 existing session。提交 feedback 后，你会收到一个 session ID，可以分享给 team。
要 report an issue：
在 Codex GitHub repo 中查找 existing issues 。
更多 logs 位于以下位置：
App logs (macOS): ~/Library/Logs/com.openai.codex/YYYY/MM/DD
Session transcripts: $CODEX_HOME/sessions (default: ~/.codex/sessions)
Archived sessions: $CODEX_HOME/archived_sessions (default: ~/.codex/archived_sessions)
如果你分享 logs，请先 review 它们，确认其中不包含 sensitive information。
Stuck states 和 recovery patterns
如果 thread 看起来 stuck：
检查 Codex 是否正在等待 approval。
打开 terminal，并运行 git status 这样的 basic command。
用更小、更 focused prompt 启动 new thread。
如果你误 cancel worktree creation 并丢失 prompt，请在 composer 中按 up arrow key 恢复它。
Terminal issues
Terminal 看起来 stuck
关闭 terminal panel。
用 Cmd+J 重新打开。
重新运行 pwd 或 git status 这样的 basic command。
如果 commands 的行为不符合预期，请先在 terminal 中 validate 当前 directory 和 branch。
如果它仍然 stuck，请等待 active Codex threads 完成，然后 restart app。
Fonts 没有正确 rendering
Codex 会为 review pane、integrated terminal，以及 app 内显示的任何其他 code 使用同一种 font。你可以在 Settings pane 中以 Code font 配置该 font。