故障排查
常見 ChatGPT 桌面 App 問題的 FAQ 與修復方法
常見問題
側邊面板中出現了 Codex 沒有編輯的檔案
如果專案位於 Git 儲存庫中，審查面板會根據專案的 Git 狀態自動顯示改動，其中也包括並非由 Codex 建立的改動。
你可以在審查面板中切換已暫存與未暫存改動，也可以比較當前分支與 main 分支。
如果只想檢視 Codex 最近一個會話輪次的改動，請把 diff 面板切換到 Last turn（最近一輪） 檢視。
進一步瞭解如何使用審查面板。
從側邊欄移除專案
將滑鼠懸停在專案名稱上，選擇三點選單中的 Remove（移除）。需要恢復時，使用 Chats（聊天） 旁邊的 Add new project（新增新專案） 按鈕，或按 Command+O 重新新增專案。
查詢已歸檔聊天
已歸檔聊天位於設定中。取消歸檔後，聊天會重新出現在側邊欄原來的位置。
側邊欄只顯示部分聊天
側邊欄可以根據專案狀態篩選聊天。如果聊天缺失，請選擇 Chats 旁的篩選圖示，再選擇 Chronological（按時間順序）。如果仍然找不到，請開啟設定，檢查 Archived chats（已歸檔聊天）。
程式碼無法在工作樹中執行
工作樹位於不同目錄，預設只繼承已提交到 Git 的檔案。根據專案管理依賴和工具的方式，你可能需要使用本機環境在工作樹中執行初始化指令碼，或通過 .worktreeinclude 複製被忽略的設定檔案。也可以在常用本機專案中檢出這些改動。詳情見工作樹文件。
應用沒有讀取到隊友共享的本機環境
本機環境設定必須位於專案根目錄的 .codex 資料夾中。如果在包含多個專案的 monorepo 中工作，請確保開啟的是包含 .codex 資料夾的專案目錄。
Codex 請求存取 Apple Music
根據任務內容，Codex 可能需要瀏覽檔案系統。macOS 上的 Music、Downloads 和 Desktop 等目錄需要使用者額外核准。如果 Codex 需要讀取 home 目錄，macOS 會提示你核准對這些資料夾的存取。
定時任務建立了大量工作樹
頻繁執行的定時任務會隨時間建立許多工作樹。請歸檔不再需要的定時執行；除非確實要保留對應工作樹，否則不要固定這些執行。
選錯目標後恢復提示詞
如果啟動聊天時誤選了 Local（本機）、Worktree（工作樹） 或 Cloud（雲端），可以取消當前執行，然後在 composer（輸入框）中按向上箭頭鍵恢復上一條提示詞。
功能在 Codex CLI 中可用，但在 ChatGPT 桌面應用中不可用
ChatGPT 桌面應用和 Codex CLI 可能內建不同版本的 Codex，因此某項功能可能先到達其中一個介面；實驗性功能也可能先進入 Codex CLI。
檢視系統中的 Codex CLI 版本：
codex --version檢視 ChatGPT 桌面應用內建的 Codex 版本，請使用保留的 Codex.app 相容 bundle 路徑：
/Applications/Codex.app/Contents/Resources/codex --version回饋與日誌
在訊息輸入框中輸入 /，可以向團隊提供回饋。如果從已有聊天中觸發回饋，可以選擇一併分享當前 session。提交後會獲得一個 session ID，可將其提供給團隊。
報告問題：
- 在 Codex GitHub 儲存庫中搜索已有 issues。
- 新建 GitHub issue。
更多日誌位於：
- 應用日誌（macOS）：
~/Library/Logs/com.openai.codex/YYYY/MM/DD - 會話記錄：
$CODEX_HOME/sessions，預設~/.codex/sessions - 已歸檔會話：
$CODEX_HOME/archived_sessions，預設~/.codex/archived_sessions
分享日誌前，請先檢查其中是否包含敏感資訊。
卡住狀態與恢復方式
如果聊天看起來卡住了：
- 檢查 Codex 是否正在等待審批。
- 開啟終端並執行
git status等基礎命令。 - 使用範圍更小、更聚焦的提示詞開始新聊天。
如果誤取消了工作樹建立並丟失提示詞，請在 composer 中按向上箭頭鍵恢復。
終端問題
終端看起來卡住了
- 關閉終端面板。
- 使用 Ctrl+` 重新開啟。
- 重新執行
pwd或git status等基礎命令。
如果命令列為與預期不同，請先在終端中確認當前目錄和分支。
如果終端仍然卡住，請等待活躍聊天完成後重啟應用。
字型顯示不正確
Codex 會為審查面板、整合終端和應用內的其他程式碼區域使用同一種字型。可以在設定中通過 Code font（程式碼字型） 設定。