StoryClaw Docs

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_providerbase_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

On this page