常见问题

本页整理官方 Troubleshooting 页里与 Codex 本地使用相关的常见问题（官方该页以桌面应用为主）；与 ChatGPT Work、云端同步有关的条目以官方为准。

侧边面板里出现 Codex 没改的文件：项目在 Git 仓库里时，评审面板按项目的 Git 状态自动显示改动，包括 Codex 没做的改动。在评审面板里可以在已暂存和未暂存的改动之间切换，并与 main 比较；只想看 Codex 上一回合的改动，把 diff 面板切到 Last turn 视图。

worktree 里代码跑不起来：worktree 创建在不同的目录，默认继承已检入 Git 的文件。取决于你怎么管理依赖和工具，你可能需要用本地环境在 worktree 上运行 setup 脚本，或用 .worktreeinclude 复制被忽略的设置文件；也可以把改动检出到你正常的本地项目里。

应用没有拿到队友共享的本地环境：本地环境配置必须在项目根目录的 .codex 文件夹里；在含多个项目的 monorepo 里，要打开包含 .codex 文件夹的那个目录作为项目。

定时任务创建了很多 worktree：频繁的定时任务会随时间创建许多 worktree。归档你不再需要的定时运行，除非有意保留其 worktree，否则不要固定运行。

选错了目标后恢复提示词：如果你不小心用错误的目标（Local、Worktree 或 Cloud）开始了对话，可以取消当前运行，并在输入框里按向上箭头恢复之前的提示词。

某功能在 Codex CLI 里能用但在桌面应用里不行：ChatGPT 桌面应用和 Codex CLI 可能包含不同的 Codex 版本，功能可能先到达其中一个入口；实验性功能也可能先在 Codex CLI 里落地。用 codex --version 查看系统上 CLI 的版本。

Codex 请求访问 Apple Music：取决于任务，Codex 可能需要浏览文件系统；macOS 上某些目录（Music、Downloads、Desktop）需要用户额外批准。Codex 需要读取你的主目录时，macOS 会提示你批准对这些文件夹的访问。

移除侧边栏里的项目、找回已归档的对话：悬停项目名，点三个点选 Remove，之后用 Add new project 按钮或 Cmd+O 重新添加；已归档的对话在设置里，取消归档后会回到侧边栏原来的位置。侧边栏只显示部分对话时，选 Chats 旁的过滤图标再选 Chronological，仍找不到就到设置里查看 Archived chats。