Codex CLI 常用配置實(shí)戰(zhàn)：模型、推理強(qiáng)度與 Web Search 配置和驗(yàn)證

本文面向已經(jīng)能正常使用 Codex CLI、希望固定日常開發(fā)行為的讀者，適用版本為 Codex CLI 0.145.0，最后核驗(yàn)日期為 2026-07-28。重點(diǎn)解決模型選擇、推理強(qiáng)度、Personality 和 Web Search 四類常用配置，不重復(fù)首次連接流程。

完成后，你會(huì)得到一份可回退、保留安全邊界的 config.toml。示例中的 medium 只面向本文核驗(yàn)的 GPT-5.5 與 GPT-5.6 Sol、Terra、Luna 目錄項(xiàng)，不是所有模型的通用值。字段事實(shí)來自官方配置文檔；具體檔位、默認(rèn)值和 Personality 模板來自 OpenAI rust-v0.145.0 標(biāo)簽中的內(nèi)置 models.json，并通過 codex debug models --bundled 交叉驗(yàn)證。本文不使用模型回答作為配置事實(shí)依據(jù)，Web Search 運(yùn)行結(jié)果仍需讀者在自己的可用環(huán)境中驗(yàn)證。

修改前先備份

配置已經(jīng)能工作時(shí)，先備份再調(diào)整。若新配置不符合預(yù)期，可以直接恢復(fù)原文件。

PowerShell

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
Copy-Item (Join-Path $codexHome "config.toml") (Join-Path $codexHome "config.toml.daily-config.bak")

恢復(fù)命令：

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
Copy-Item (Join-Path $codexHome "config.toml.daily-config.bak") (Join-Path $codexHome "config.toml") -Force

Bash 或 Zsh

codex_home="${CODEX_HOME:-$HOME/.codex}"
cp "$codex_home/config.toml" "$codex_home/config.toml.daily-config.bak"

恢復(fù)命令：

codex_home="${CODEX_HOME:-$HOME/.codex}"
cp "$codex_home/config.toml.daily-config.bak" "$codex_home/config.toml"

如果源文件還不存在，應(yīng)先完成首次配置，不要把備份命令的報(bào)錯(cuò)當(dāng)成 Codex 配置錯(cuò)誤。

合并這份日常配置

把下面的頂層字段合并到當(dāng)前實(shí)際生效的 config.toml。不要覆蓋文件中已經(jīng)工作的其他字段或配置表。

model = "YOUR_MODEL_ID"
model_reasoning_effort = "medium"
web_search = "cached"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
# 僅當(dāng)當(dāng)前模型確實(shí)支持該 Personality 選項(xiàng)時(shí)啟用：
# personality = "pragmatic"

把 YOUR_MODEL_ID 替換為當(dāng)前環(huán)境實(shí)際可選的模型 ID。本文核驗(yàn)的四個(gè)目錄項(xiàng)都列出 medium；如果 /model 沒有為你的模型列出該檔位，必須改成界面實(shí)際提供的值。主塊不默認(rèn)開啟 Personality。

這份配置保留了兩項(xiàng)日常安全基線：on-request 讓越過既有邊界的操作仍有批準(zhǔn)機(jī)會(huì)，workspace-write 將默認(rèn)文件寫入限制在工作區(qū)內(nèi)。完整權(quán)限組合不在本文展開。

為什么不能只看通用參數(shù)表

Codex 配置存在三個(gè)不同的事實(shí)層級(jí)：

0.145.0 Schema 將推理強(qiáng)度定義為模型公布的非空字符串。也就是說，字符串通過 Schema 校驗(yàn)，不代表當(dāng)前模型一定支持；當(dāng)前 CLI 應(yīng)通過 /model 同時(shí)確認(rèn)模型與推理強(qiáng)度。

0.145.0 模型目錄對(duì)照

OpenAI rust-v0.145.0 標(biāo)簽中的 codex-rs/models-manager/models.json 列出以下內(nèi)置模型能力；本機(jī) codex debug models --bundled 返回相同結(jié)果：

這張表只是 Codex CLI 0.145.0 的內(nèi)置模型快照，不是所有 OpenAI API 模型的永久枚舉。通用配置參考、API 模型指南和 CLI 內(nèi)置目錄屬于不同產(chǎn)品層，不能互相覆蓋。

截至 2026-07-28，在線通用配置參考的 model_reasoning_effort 類型仍包含 minimal，且未列出 max、ultra；0.145.0 的上述四個(gè)內(nèi)置目錄項(xiàng)則都沒有 minimal，部分 GPT-5.6 目錄項(xiàng)提供 max 或 ultra。這說明通用字段說明不能替代固定版本的模型目錄。

codex debug models --bundled 只用于核對(duì)當(dāng)前二進(jìn)制自帶的快照，不能證明賬號(hào)、第三方 Provider 或當(dāng)前會(huì)話實(shí)際開放這些模型。判斷當(dāng)前實(shí)際可選項(xiàng)必須以交互界面的 /model 為準(zhǔn)。

ultra 也不是單純比 max 更高。0.145.0 目錄說明它在最大推理之外還包含自動(dòng)任務(wù)委派，當(dāng)前只有 Sol 和 Terra 列出。任務(wù)不適合拆分或需要更可預(yù)測(cè)的單線程過程時(shí)，名稱更高不代表更合適。

medium 是候選起點(diǎn)，不是統(tǒng)一默認(rèn)值

主配置采用：

model_reasoning_effort = "medium"

原因是本次核驗(yàn)的四個(gè)目錄項(xiàng)都提供 medium，而 GPT-5.6 官方 API 指南把 medium 作為平衡質(zhì)量與速度的起點(diǎn)。但它不是所有模型的默認(rèn)值：0.145.0 中 Sol 默認(rèn) low，GPT-5.5、Terra 和 Luna 默認(rèn) medium。實(shí)際使用時(shí)可以這樣調(diào)整：

• 延遲敏感或邊界清晰的小任務(wù)可以比較 low 與 medium。
• 只有代表性任務(wù)顯示質(zhì)量確有提升時(shí)，再選擇 high 或 xhigh。
• max 留給最困難的質(zhì)量?jī)?yōu)先任務(wù)；ultra 還包含自動(dòng)任務(wù)委派，不能只理解為更高一級(jí)思考量。
• minimal、max、ultra 等值僅在 /model 為當(dāng)前模型真實(shí)列出時(shí)使用。
• 比較效果時(shí)一次只改模型或推理強(qiáng)度中的一項(xiàng)。

在交互界面輸入：

/model

/model 同時(shí)用于選擇模型和推理強(qiáng)度。界面列出的才是當(dāng)前 CLI 可選值，不要讓模型通過回答文字“自報(bào)檔位”。

固定到 Codex CLI 0.145.0 時(shí)，不要使用 /reasoning：該標(biāo)簽的 CLI 斜杠命令源碼沒有這個(gè)命令，模型和推理強(qiáng)度都通過 /model 選擇。通用斜杠命令頁面列出的 /reasoning 可能對(duì)應(yīng)其他 Codex 界面或更新版本，不能反推到本文固定版本。

Personality 改為條件配置

固定 Schema 對(duì) personality 只允許三種值：

none | friendly | pragmatic

它不是可以任意填寫的風(fēng)格名稱。本機(jī) 0.145.0 模型目錄顯示：

• GPT-5.5 的指令模板包含 Personality 占位符，friendly 與 pragmatic 變量均為非空。
• GPT-5.6 Sol、Terra、Luna 的指令模板沒有該占位符，相應(yīng)變量也為空。

這個(gè)結(jié)論只適用于本次版本和目錄，不代表 GPT-5.6 永久不支持 Personality。正因?yàn)槿齻€(gè) 5.6 目錄項(xiàng)當(dāng)前沒有對(duì)應(yīng)模板，personality = "pragmatic" 不應(yīng)成為 GPT-5.6 的通用起步默認(rèn)。

當(dāng)前模型支持時(shí)，可以取消主配置中的注釋，并通過：

/personality

確認(rèn)可選風(fēng)格。需要自定義項(xiàng)目回答方式時(shí)，把明確規(guī)則寫進(jìn)項(xiàng)目 AGENTS.md；需要用戶級(jí)開發(fā)者指令時(shí)，使用官方支持的 developer_instructions。不要發(fā)明第四種 Personality 值。

Web Search 顯式使用 cached

web_search = "cached"

當(dāng)前官方配置提供四種模式：

普通本地會(huì)話默認(rèn)使用 cached；如果啟用 --yolo 或其他 full-access 沙箱設(shè)置，官方文檔說明默認(rèn)值可能轉(zhuǎn)為 live。本文顯式寫入 web_search = "cached"，因此不依賴這一默認(rèn)差異。確實(shí)需要?jiǎng)偘l(fā)布的版本說明或近期故障信息時(shí)，再臨時(shí)切換 live。無論哪種模式，網(wǎng)頁內(nèi)容都屬于不可信外部輸入，關(guān)鍵結(jié)論仍需核對(duì)官方來源。

Web Search 模式不等于 Shell 命令的網(wǎng)絡(luò)權(quán)限。兩者屬于不同配置邊界，不能用搜索成功與否推斷子進(jìn)程是否能聯(lián)網(wǎng)。

檢查實(shí)際生效值

保存配置并重啟 Codex。以下斜杠命令在 Codex 交互界面中輸入，不屬于 PowerShell、CMD、Bash 或 Zsh 命令：

/model
/personality

通過 /model 檢查當(dāng)前模型與推理強(qiáng)度，再檢查可用 Personality。若界面與文件不同，優(yōu)先排查啟動(dòng)參數(shù)、Profile 或會(huì)話內(nèi)臨時(shí)覆蓋。

需要驗(yàn)證 Web Search 時(shí)，可以在自己的可用環(huán)境中提出一個(gè)必須查詢近期官方資料的任務(wù)，觀察客戶端是否出現(xiàn)搜索工具活動(dòng)以及可訪問的來源鏈接。模型只說“已經(jīng)聯(lián)網(wǎng)”不能作為證據(jù)。

如果希望在非交互運(yùn)行中觀察結(jié)構(gòu)化事件，下面這條 Codex CLI 命令可在 PowerShell、CMD、Bash 和 Zsh 中使用：

codex exec --ephemeral --json "使用 Web Search 查詢當(dāng)前 Codex CLI 的官方變更記錄，給出來源鏈接"

本文只核對(duì)了 0.145.0 幫助中 --ephemeral 和 --json 選項(xiàng)存在，沒有實(shí)際執(zhí)行模型或 Web Search 請(qǐng)求。

完成后的檢查清單

• 修改前已備份 config.toml，并知道恢復(fù)命令。
• model 已替換為當(dāng)前環(huán)境真實(shí)可選的 ID。
• /model 中當(dāng)前模型存在配置的 medium，或已改成實(shí)際列出的值。
• Personality 只在當(dāng)前模型提供模板時(shí)啟用。
• 已顯式設(shè)置 cached；需要實(shí)時(shí)內(nèi)容時(shí)才臨時(shí)切換 live。
• 保留 on-request + workspace-write 安全基線。

總結(jié)

日常配置的關(guān)鍵不是參數(shù)多，而是證據(jù)層級(jí)正確：字段能被 Schema 解析、模型目錄公布能力、當(dāng)前會(huì)話實(shí)際選擇，三者需要分別確認(rèn)。本文主塊以本次四個(gè)目錄項(xiàng)共同提供的 medium 作為候選起點(diǎn)，顯式固定 cached，保留安全基線，并把 Personality 降為條件配置；最終仍以當(dāng)前模型的 /model 選項(xiàng)和代表性任務(wù)結(jié)果為準(zhǔn)。

FAQ

為什么配置了 medium，界面卻沒有按預(yù)期顯示？

先用 /model 查看當(dāng)前模型實(shí)際提供的推理檔位，再檢查啟動(dòng)參數(shù)、Profile 或會(huì)話內(nèi)臨時(shí)覆蓋。Schema 能解析字符串，不代表具體模型一定接受該值。

GPT-5.6 可以直接設(shè)置 personality = “pragmatic” 嗎？

0.145.0 的三個(gè) GPT-5.6 目錄項(xiàng)對(duì)應(yīng)模板為空，因此本文不把它作為通用默認(rèn)。未來版本可能變化，應(yīng)以當(dāng)時(shí)的 /personality 和模型目錄為準(zhǔn)。

ultra 是否就是比 max 更強(qiáng)？

不是簡(jiǎn)單的強(qiáng)度加一。當(dāng)前目錄說明 ultra 包含自動(dòng)任務(wù)委派，且只有 Sol 和 Terra 列出；是否適合取決于任務(wù)能否安全、有效地拆分。

cached 和 live 應(yīng)該怎樣選擇？

普通本地會(huì)話可顯式使用 cached；只有任務(wù)明確依賴近期網(wǎng)頁信息時(shí)再使用 live。full-access 模式可能默認(rèn) live，但顯式配置不受該差異影響。兩種模式的結(jié)果都要視為不可信外部輸入，并回到官方來源復(fù)核。

以上就是Codex CLI常用配置實(shí)戰(zhàn)：模型、推理強(qiáng)度與Web Search配置和驗(yàn)證的詳細(xì)內(nèi)容，更多關(guān)于Codex CLI常用配置實(shí)戰(zhàn)的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論