開發者設定
開發者設定
設定跨 ChatGPT 和 Codex 客戶端的開發設定
- ChatGPT 桌面應用 在桌面端處理專案、檔案和耗時較長的任務。
- ChatGPT 網頁版 在瀏覽器中使用聊天、專案和 Work。
- Codex CLI 在終端中使用 Codex。
- Codex IDE 擴充套件 在編輯器中使用 Codex。
ChatGPT 網頁版會在 ChatGPT 設定中儲存產品和工作區偏好設定。ChatGPT Work 聊天在託管環境中執行,不會讀取本機 Codex 設定檔。請使用工作區在 ChatGPT 設定中提供的控制項; 工作區管理員可能會代你管理部分設定。
通用設定頁面介紹 App 偏好,包括個人資料、鍵盤快捷鍵、通知、外觀、個人化、記憶和已歸檔聊天。
專案和終端行為
選擇檔案的開啟位置、聊天中顯示多少命令輸出,以及預設在哪裡開啟終端標籤頁。
程式碼審查
在 Settings > Git(設定 > Git) 中,通過 Review delivery(審查交付方式) 選擇 Inline(內聯) 或 Detached(分離)。Inline 會盡可能在當前聊天中執行 /review;Detached 則會啟動獨立的審查聊天。
IDE 擴充套件同步
當 ChatGPT 桌面 App 和 IDE 擴充套件在同一專案中開啟時,兩者會共享當前聊天和編輯器上下文。在 App 輸入框中開啟 IDE context(IDE 上下文),可讓 Codex 使用當前在編輯器中開啟的檔案;如果不希望 App 提示詞包含這些編輯器上下文,請將其關閉。
你可以從 IDE 擴充套件開啟 App 聊天,也可以在 App 中繼續 IDE 聊天。兩個產品形態通過同一個專案判斷要共享哪些聊天和上下文。
智能體設定
App 中的 Codex 智能體會繼承 IDE 擴充套件和 CLI 使用的同一份設定。常用設定可以通過 App 內控制項調整;進階選項則編輯 config.toml。詳情參見智能體審批與安全和基礎設定。
Git
使用 Git 設定統一分支命名,並選擇 Codex 是否可以執行 強制推送。你還可以設定 Codex 生成 提交訊息 和 PR 描述時使用的提示詞。
整合與 MCP
通過 Model Context Protocol(MCP)連線外部工具。你可以啟用推薦的 MCP server,也可以新增自己的 MCP server。如果 MCP server 需要 OAuth,App 會啟動認證流程。由於 MCP 設定儲存在 config.toml 中,這些設定也會應用於 Codex CLI 和 IDE 擴充套件。詳情參見 Model Context Protocol。
瀏覽器開發者模式
在 Developer mode(開發者模式) 中開啟 Enable full CDP access(啟用完整 CDP 存取),ChatGPT 就可以使用 Chrome DevTools Protocol 進行效能分析和更深入的瀏覽器除錯。如果組織已停用完整 CDP 存取,則無法在本機重新開啟。設定方式、風險、審批和管理員要求參見開發者模式。
Codex CLI 從 ~/.codex/config.toml 讀取你的個人預設設定。如需
為專案或子資料夾設定專用的覆蓋項,請在受信任的專案或子資料夾中新增
.codex/config.toml 檔案。CLI 和 IDE 擴充套件共享這些設定
層。
檢視設定
使用以下命令瞭解當前會話的有效設定:
- 執行
/status,檢視當前使用的模型、審批策略、可寫根目錄和 token 使用量。 - 執行
/debug-config,檢視按優先順序排列的設定層,以及 託管策略要求的來源。 - 使用
--strict-config啟動 Codex,將無法識別的config.toml鍵視為 錯誤,而不是將其忽略。
如需完整的互動式命令參考,請參閱開發者命令。
更改單次執行的設定
如果有專用標誌,請使用該標誌。常見的標誌包括 --model、
--sandbox、--ask-for-approval、--profile 和 --search。使用 -c 或
--config 可覆蓋單次執行中任何受支援的設定鍵。
以下模型覆蓋設定需要 GPT-6.1 Sol 的存取權限。如果你的帳戶或工作區
無法使用該模型,請省略 --model 或選擇 /model 列出的模型。
請參閱各套餐的 GPT-6.1 Sol 可用性。
codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'命令列標誌和 --config 值具有最高優先順序。如需
完整的標誌列表,請參閱開發者命令。
設定層級
CLI 會先應用命令列標誌和 --config 覆蓋項,再應用專案、
設定檔、使用者、系統和內建設定。可利用此優先順序,將共享的
預設設定儲存在設定檔中,將一次性更改放在命令列中。
如需瞭解完整的優先順序和常用選項,請參閱設定基礎。
在 TUI 中更改設定
互動式終端 UI 為常用的會話和顯示設定提供了選擇器:
| 目標 | 命令 | 相關設定 |
|---|---|---|
| 選擇終端模式 | /tui |
tui.fullscreen_transcript(需要重啟) |
| 選擇模型 | /model |
model、model_reasoning_effort |
| 更改權限 | /permissions |
審批和沙箱設定 |
| 設定可選工具 | /experimental、/memories |
特定功能的 config.toml 設定鍵 |
| 自定義終端 UI | /keymap、/statusline、/title、/theme |
[tui] 下的設定鍵 |
| 設定編輯預設值 | /vim、/raw |
tui.vim_mode_default、tui.raw_output_mode |
部分命令僅對當前會話生效,而部分選擇器可讓你 儲存所選項。如需將某個選項設為未來會話的預設值,請設定相關的設定鍵。 如需瞭解終端主題、編輯器、補全和快捷鍵 工作流程,請參閱 CLI 自定義。
設定參考資料
Codex IDE 擴充套件包含兩個設定層:
- Codex 設定 控制與 Codex CLI 共享的智能體行為,包括
模型、推理強度、權限、沙箱、MCP server和
個人化設定。Codex 從
config.toml讀取這些設定。 - 編輯器設定 控制擴充套件在 VS Code 和
相容編輯器中的行為。這些設定使用編輯器設定系統中的
chatgpt.*鍵。
開啟 Codex 設定
在 Codex 側邊欄中選擇齒輪圖示,然後選擇 Codex 設定。使用 設定面板調整常用的智能體控制項,或選擇 開啟 config.toml, 直接編輯當前設定層。
如需瞭解設定層的優先順序和常用鍵,請參閱設定
基礎。如需檢視所有受支援的 config.toml 鍵,請參閱
設定參考。
更改編輯器設定
要更改設定,請按以下步驟操作:
- 開啟編輯器設定。
- 搜尋
@ext:openai.chatgpt、Codex或設定名稱。 - 更新該值。
該擴充套件還會在 Codex 聊天介面中遵循 VS Code 的內建聊天字型設定。
編輯器設定參考
| 設定 | 預設值 | 說明 |
|---|---|---|
chatgpt.commentCodeLensEnabled |
true |
在 TODO 註釋上方顯示 CodeLens,以便 Codex 處理這些註釋。 |
chatgpt.openOnStartup |
false |
擴充套件啟動完成後,將焦點移至 Codex 側邊欄。 |
chatgpt.followUpQueueMode |
queue |
選擇執行期間傳送的訊息是等待下一次執行(queue),還是引導當前執行(steer)。擴充套件會將舊版 interrupt 值視為 steer。按 Cmd/Ctrl+Shift+Enter 可針對一條訊息反轉此行為。 |
chatgpt.composerEnterBehavior |
enter |
選擇是讓 Enter 始終傳送(enter),讓 Cmd/Ctrl+Enter 傳送多行提示詞(cmdIfMultiline),還是始終要求使用修飾鍵(cmdAlways)。 |
chatgpt.reviewDelivery |
inline |
儘可能在當前聊天中執行 /review(inline),或啟動單獨的審查聊天(detached)。 |
chatgpt.localeOverride |
自動 | 設定 Codex UI 的首選語言。留空可自動檢測。 |
chatgpt.runCodexInWindowsSubsystemForLinux |
false |
僅限 Windows:當 WSL 可用時,在 WSL 中執行 Codex。如果你的程式碼儲存庫和工具位於 WSL2 中,或需要 Linux 原生工具,請使用此設定。更改此設定會重新載入 VS Code。 |
chatgpt.cliExecutable |
未設定 | 僅限開發:設定 Codex CLI 執行檔的路徑。除非你正在開發 Codex CLI,否則無需使用此設定;手動覆蓋捆綁的執行檔可能導致擴充套件的部分功能無法正常工作。 |
chat.fontSize |
編輯器預設值 | 控制 Codex 側邊欄中的聊天文本,包括聊天內容和輸入框。 |
chat.editor.fontSize |
編輯器預設值 | 控制 Codex 聊天中以程式碼形式呈現的內容,包括程式碼片段和差異。 |
上述 chatgpt.* 鍵屬於 IDE 擴充套件,不應寫入
config.toml。有關共享的智能體設定,請參閱設定
基礎、高階設定
和設定參考。