故障排查

常見問題

側邊面板中出現了 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 監聽埠和非迴環代理監聽器；套接字規則的支援情況取決於執行路徑。本機執行的合併行為另行定義。

比較實際生效的策略，並測試預期允許和阻止的操作。具體情況請參閱受管設定。不要為了繞過失敗的測試而放寬全域基線。