調整 IDE 擴充套件設定

Codex IDE extension settings 是編輯器裡的 Codex 體驗層：字型、側邊欄啟動、語言偏好、待辦 CodeLens、Windows WSL 執行方式。它不是 Codex 的全部配置中心。

真正影響 agent 執行邊界的預設模型、approval policy、sandbox mode、network access 等，仍然屬於共享的 ~/.codex/config.toml。IDE settings 負責編輯器體驗，config.toml 負責 Codex CLI 和 IDE extension 共用的執行策略。

flowchart TB
    User["👤 想調整 Codex 行為"]
    Q{"調整什麼？"}
    A["📺 UI / 字號 / 啟動行為<br/>語言 / WSL 開關"]
    B["🔐 模型 / approval<br/>sandbox / 網路訪問"]
    C["⚡ 臨時切模式<br/>臨時聚焦本任務"]
    IDE["IDE extension settings<br/>VS Code / Cursor / Windsurf"]
    TOML["~/.codex/config.toml<br/>CLI 與 IDE 共享"]
    Session["Codex 面板 / slash<br/>啟動引數"]

    User --> Q
    Q -->|UI 體驗| A --> IDE
    Q -->|執行邊界| B --> TOML
    Q -->|本次會話| C --> Session

Change a setting

修改設定按下面步驟：

1. 開啟 editor settings（編輯器設定）。
2. 搜尋 Codex 或具體 setting name（設定名）。
3. 更新 value（值）。

Codex IDE extension 底層使用 Codex CLI。有些行為不在 editor settings 裡配置，而是在共享的 ~/.codex/config.toml 檔案中配置，例如：

• default model（預設模型）
• approval policy（審批策略）
• sandbox settings（沙箱設定）
• network access（網路訪問）

配置基礎見：

https://developers.openai.com/codex/config-basic

Extension 也會遵循 VS Code 內建 chat font settings（聊天字型設定），用於 Codex conversation surfaces（對話介面）。

設定分層

實際配置時先分清三層：

這種分層的好處是：團隊可以把安全和執行邊界寫進 config.toml 或 managed config，本地使用者仍然可以微調 IDE 使用體驗，不會把 UI 習慣誤當成安全策略。

Settings reference

關鍵設定怎麼選

聊天和程式碼字號

如果你覺得 Codex 面板裡的正文太小，先改 chat.fontSize。如果只是程式碼塊、diff、inline code 的字號不合適，改 chat.editor.fontSize。

這兩個設定來自 VS Code 內建 chat font settings，Codex extension 會遵循它們。它們隻影響閱讀體驗，不影響模型輸出、不影響上下文大小，也不改變 diff 的實際內容。

CLI executable

chatgpt.cliExecutable 是 development-only 設定。普通使用者不要配置它。

只有在你正在開發 Codex CLI 本身，或者需要讓 extension 指向本地構建的 CLI binary 時，才需要設定這個路徑。手動指向錯誤的 executable，可能導致 IDE extension 的部分能力表現異常，例如版本不匹配、命令不可用、面板狀態不同步。

待辦 CodeLens

chatgpt.commentCodeLensEnabled 會在待辦註釋上方顯示入口，讓你可以直接讓 Codex 處理選中的待辦項。

適合開啟的場景：

• 團隊習慣把小修複寫成待辦註釋。
• 你希望從程式碼附近直接發起任務，不想先複製上下文到 chat。
• 你在整理技術債，希望逐條把待辦變成可執行任務。

不適合開啟的場景：

• 儲存庫裡歷史待辦註釋很多，編輯器介面已經很擁擠。
• 團隊把待辦註釋當作長期註釋，而不是行動項。
• 你正在錄屏或演示，不希望頁面出現額外 CodeLens。

Language override

chatgpt.localeOverride 控制 Codex UI 的首選語言。留空時自動檢測。

教程站、雙語團隊或中文開發者常見做法是：UI 可以保持中文，但 prompt、命令、檔案路徑、錯誤文本保留英文原文。這樣既方便閱讀，也不丟失技術細節。

Open on startup

chatgpt.openOnStartup 會在 extension 啟動完成後聚焦 Codex sidebar。

如果你的 IDE 主要用來和 Codex 協同開發，可以開啟；如果你經常只想快速看程式碼，建議關閉，避免每次啟動都打斷當前檔案檢視。

Windows WSL 模式

chatgpt.runCodexInWindowsSubsystemForLinux 是 Windows-only 設定。開啟後，只要 WSL 可用，Codex 就在 WSL 中執行。

適合開啟：

• 儲存庫實際位於 WSL2 檔案系統。
• 構建、測試、包管理都依賴 Linux 工具鏈。
• 你希望 IDE extension 的命令、審批、檔案訪問語義和 Linux sandbox 更一致。

適合保持關閉：

• 儲存庫和工具鏈都在 Windows 原生環境。
• 你正在使用 Windows sandbox。
• 團隊成員不統一使用 WSL2，配置後反而增加環境差異。

修改這個設定會 reload VS Code 才生效。

推薦配置流程

1. 先安裝 Codex IDE extension，並確認能登入。
2. 開啟一個真實專案，用預設設定完成一次小任務，例如解釋專案結構。
3. 只調整 UI 類設定：字號、語言、是否啟動自動開啟。
4. 如果是在 Windows 上，再決定是否強制 WSL2。
5. 把模型、sandbox、approval、network access 放回 ~/.codex/config.toml 管理。
6. 調整後重開 IDE，跑一次只讀任務和一次小 diff 任務確認行為符合預期。

常見誤區

自檢清單

• 你是否知道哪些設定屬於 IDE，哪些屬於 ~/.codex/config.toml？
• Windows 使用者是否確認儲存庫位置和工具鏈是在 Windows 還是 WSL2？
• 是否避免給 chatgpt.cliExecutable 配一個不確定的路徑？
• 調整後是否至少跑過一次只讀任務和一次小修改任務？
• 團隊共享配置是否沒有被個人 UI 偏好汙染？

官方資料

• Codex IDE extension
• Codex IDE extension settings
• Config basics

接下來去哪