使用 config.toml 設定 Codex 專案預設模型與權限

更新

摘要

在專案建立 .codex/config.toml,能讓 Codex 於每次啟動時都自動套用模型與權限設定,省去再手動調整的步驟。

文章目錄

平常開啟 Codex 後,都要先用 /model 選擇模型,再透過 /permissions 調整執行權限。尤其 Codex 預設不會直接使用 Full Access,每次啟動後都得重新切換。

我們其實可以把預設值寫進專案的 .codex/config.toml,設定後每次啟動 Codex 時就會自動套用模型與權限設定,不用再手動調整。

建立 Codex 專案設定檔

在專案根目錄建立 .codex/config.toml,寫入以下設定:

1model = "gpt-5.6-sol"
2model_reasoning_effort = "low"
3sandbox_mode = "danger-full-access"
4approval_policy = "never"

根據 Codex config.toml 官方設定參考,這四個欄位還能依照專案需求調整:

欄位目前設定自訂方式
modelgpt-5.6-sol改成 Codex 目前可使用的其他模型名稱。
model_reasoning_effortlow可設定為 lowmediumhighxhighmax
sandbox_modedanger-full-accessread-only 僅允許讀取、workspace-write 可修改工作區,danger-full-access 則開放完整的檔案系統與網路存取權限。
approval_policynever可設定為 untrustedon-failureon-requestnever,用來控制 Codex 執行動作前是否需要詢問使用者。

danger-full-access 是讓模型拿到你電腦的完整權限,雖然可以避免遇到 Codex Windows 常常掛掉的 Sandbox 和權限審核問題,但這模式是危險的,最好要有人盯著他運作以免意外。

總結

設定完成後,每次從這個專案啟動 Codex,都會自動套用指定的模型與權限。對於長期使用固定設定的專案來說,可以省下重複操作的步驟。

下一篇 Matt Pocock Skills 讓 Agent 穩定處理開發工單 AI
Ted Liou

Ted Liou

Unity 現役工程師,Unity、AI 技術開發經驗分享與諮詢。