故障排查

常见问题

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

如果项目位于 Git 仓库中，评审面板会根据项目的 Git 状态自动显示改动，其中也包括并非由 Codex 创建的改动。

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

如果只想查看 Codex 最近一个会话轮次的改动，请把 diff 面板切换到 Last turn（最近一轮） 视图。

进一步了解如何使用评审面板。

从侧边栏移除项目

要从侧边栏移除项目，请将鼠标悬停在项目名称上，选择 三点菜单，然后选择移除。要恢复项目，请通过 聊天 旁的添加新项目 按钮重新添加 项目，或使用

Cmd+O.

查找已归档聊天

已归档聊天位于设置中。取消归档后，聊天会重新出现在侧边栏原来的位置。

Work 对话未出现在另一台设备上

• 确认你在每台设备上都通过 ChatGPT 登录了同一账户和工作区。
• 请工作区所有者检查是否已启用 Work Cloud 和允许访问本地计算机。如果任一云策略启用了 enforce_residency，Work 和 dots 的允许访问本地计算机 都会被禁用。这项保护措施不会配置工作区的数据驻留，也不会单独禁用 Work Cloud 或 dots。
• 检查任务的创建时间。同步仅适用于启用同步后创建的新任务。现有任务（包括项目中的任务）不会迁移，仍保留原有的仅限本地运行或在云端运行但无法访问本地文件的行为。

对于企业，应用内的本地/云端切换开关及其默认设置在功能上线时保持不变。仅凭某个切换开关或默认模式，无法确认对话是否可以同步。查找 Work 对话时，请将 Codex 历史记录单独查看。有关设置方法，请参阅 Work Cloud 和 dots 的本地计算机访问；有关常见问题，请参阅 Work 管理员常见问题。

已同步的任务无法使用计算机的文件或工具

保持计算机在线并处于连接状态。如果新一轮开始时计算机不可用，符合条件的已同步任务可以在云容器中继续运行，但无法访问计算机的文件或工具。正在运行的轮次不会自动从计算机迁移到云端。

关闭 Work Cloud 的本地计算机访问后，轮次停止了

关闭 Work Cloud 的本地计算机访问会中断正在运行的轮次。如果你仍有 Work 访问权限，请发送一条新消息来开始新一轮。在现有的云端对话中，该轮次会自动使用 Work Cloud，且无法访问本地文件。

缺少自动化策略更新

使用策略 API 管理全局设置。要管理本地或 Codex Cloud 设置，请使用 Agent Security 界面。迁移后，现有的全局 API 工作流仍然可用。请测试脚本和 Terraform 集成，并确认策略分配和排序保持不变。

侧边栏只显示部分聊天

侧边栏可以根据项目状态筛选聊天。如果聊天缺失，请选择 Chats 旁的筛选图标，再选择 Chronological（按时间顺序）。如果仍然找不到，请打开设置，检查 Archived chats（已归档聊天）。

代码无法在工作树中运行

工作树创建在不同的目录中，默认继承已签入 Git 的文件。根据项目管理依赖项和工具的方式， 你可能需要使用 本地环境在工作树中运行设置脚本，或通过 .worktreeinclude复制被忽略的设置文件。 你也可以在常用的本地项目中检出这些更改。有关详情，请参阅 工作树文档。

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

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

Codex 请求访问 Apple Music

根据任务内容，Codex 可能需要浏览文件系统。macOS 上的 Music、Downloads 和 Desktop 等目录需要用户额外批准。如果 Codex 需要读取 主目录，macOS 会提示你批准对这些文件夹的访问。

定时任务创建了大量工作树

频繁运行的定时任务会随时间创建许多工作树。请归档不再需要的定时运行；除非确实要保留对应工作树，否则不要置顶这些运行。

选错目标后恢复提示词

如果启动聊天时误选了 Local（本地）、Worktree（工作树） 或 Cloud（云端），可以取消当前运行，然后在 输入框中按向上箭头键恢复上一条提示词。

“代我批准”选项缺失或已禁用

要使用自动评审，请在输入框下方的权限控件中 选择代我批准。如果该模式缺失或已禁用：

1. 更新桌面应用，并在你想使用自动评审的聊天中 检查权限菜单。可用选项可能因 本地环境和云端环境而异。
2. 对于本地 Codex 执行，请检查实际生效的配置中是否 显式设置了 features.guardian_approval = false，并检查 配置的权限配置档案、审批策略和审批评审者。 有关配置优先级，请参阅配置基础 。本地配置无法控制托管的云端运行时。
3. 如果某个模式在托管工作区中被禁用或缺失，请让 管理员检查允许使用的权限配置档案、沙箱模式、 审批策略和审批评审者。组织或设备策略 可能限制这些选项；本地设置无法覆盖这些策略。

如果该模式仍然意外地不可用，请在反馈中提供应用版本、 操作系统、执行环境，并说明该选项是缺失还是 已禁用。

功能在 Codex CLI 中可用，但在 ChatGPT 桌面应用中不可用

ChatGPT 桌面应用和 Codex CLI 可能包含不同的 Codex 版本，因此 某些功能可能会先在其中一个界面上提供。

查看系统中的 Codex CLI 版本：

codex --version

查看 ChatGPT 桌面应用内置的 Codex 版本，请使用保留的 Codex.app 兼容应用包路径：

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

反馈与日志

在消息输入框中输入 /，可以向团队提供反馈。如果从已有聊天中触发反馈，可以选择一并分享当前会话。提交后会获得一个会话 ID，可将其提供给团队。

报告问题：

1. 在 Codex GitHub 仓库中搜索已有 issues。
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. 使用范围更小、更聚焦的提示词开始新聊天。

如果误取消了工作树创建并丢失提示词，请在输入框中按向上箭头键恢复。

终端问题

终端看起来卡住了

1. 关闭终端面板。
2. 使用 Ctrl+` 重新打开。
3. 重新运行 pwd 或 git status 等基础命令。

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

如果终端仍然卡住，请等待活跃聊天完成后重启应用。

字体显示不正确

Codex 会为评审面板、集成终端和应用内的其他代码区域使用同一种字体。可以在设置中通过 Code font（代码字体） 配置。

环境允许网络访问，但操作仍被阻止

比较各项设置之前，请先检查策略优先级。高优先级策略优先于低优先级策略，即使低优先级策略更具体也是如此。在同一策略中，特定操作系统的环境覆盖设置优先于适用于所有操作系统的环境覆盖设置，最后才是全局设置。

某些网络要求具有针对特定字段的合并规则和运行时限制。云运行时不支持受管 HTTP/SOCKS 监听端口和非回环代理监听器；套接字规则的支持情况取决于执行路径。本地执行的合并行为另行定义。

比较实际生效的策略，并测试预期允许和阻止的操作。具体情况请参阅受管配置。不要为了绕过失败的测试而放宽全局基线。