Codex 桌面版
Codex 桌面版與 CLI 共用同一份設定,配好 CLI 即可使用。本頁說明如何確認設定已經生效。
Codex 桌面版(macOS、Windows)和 Codex CLI 讀的是同一份 ~/.codex/config.toml。也就是說,Codex 那頁配好供應商之後,桌面版這邊不需要再做任何設定。
還沒設定過的話,先完成 Codex 頁的設定步驟。
確認設定已生效
按下面四步比對一次。
查看已寫入的設定
手工改設定檔的:直接開啟 ~/.codex/config.toml,確認 model_provider 和 [model_providers.…] 區塊都在。
用 CC Switch 設定的:開啟 CC Switch,點供應商項目進入編輯頁,下滑到 config.toml(TOML) 區塊,就能看到實際寫進去的內容。
供應商叫什麼名字都行,只要 model_provider 和 [model_providers.…] 兩處對得上。
開啟桌面版讀到的設定
開啟桌面版的設定,左側選設定檔,點右上角的開啟 config.toml,檔案會在系統預設編輯器裡開啟。
比對兩份設定
重點看 model_provider 和 base_url 兩項,一致就說明桌面版讀的是同一份設定。對不上的話,通常是改完設定後桌面版沒重啟。
發訊息驗證
在桌面版裡發送任意訊息,收到正常回覆即表示接入成功。輸入框附近會顯示目前模型,點開可以在模型對應裡設好的那幾個模型之間切換。
常見問題排查
| 現象 | 解決辦法 |
|---|---|
| 桌面版仍然要求登入 OpenAI 帳號 | 設定沒讀到。按上面四步比對一次,確認兩邊的 model_provider 一致。 |
| CLI 能用,桌面版不能用 | 兩種可能:一是桌面版啟動時才讀一次設定,改完設定後要完全結束再重開,僅關視窗不夠;二是金鑰來源不同——方式 A 把金鑰放在環境變數裡,而桌面版不一定繼承終端機的環境變數,改用 CC Switch 設定可以避開這個問題。 |
兩份 config.toml 內容不一致 | CC Switch 改完設定後要重啟桌面版才會重新讀取。 |
| 報驗證錯誤 | 方式 A 檢查 env_key 指向的環境變數是否設定正確;方式 B 在 CC Switch 裡重新填一遍 API Key,儲存後重啟桌面版。 |
| 桌面版模型下拉是空的 | 走方式 B 時,在 CC Switch 的模型對應裡點「取得模型列表」拉取,然後重啟桌面版。 |
| 多輪對話第二輪開始報錯 | 設定裡漏了 disable_response_storage = true,詳見 Codex。 |