Codex CLI 配置
Codex CLI 是終端裡的 Codex。它適合在本地項目裡讓 Codex 閱讀代碼、修改文件、執行測試和解釋報錯。桌面客戶端的設置放在 Codex 客戶端頁；這裡專門講終端 CLI。
官方信息 下載和文檔以官方站點為準
這個工具是什麼，用於什麼
終端 Codexconfig.toml自定義 Provider項目內使用
配置文件位置
| 系統 | 示例路徑 | 說明 |
|---|---|---|
| Windows | C:\Users\你的用戶名\.codex\config.toml | 用戶名換成你電腦自己的用戶名 |
| macOS / Linux | ~/.codex/config.toml | 沒有文件就新建 config.toml |
自定義 Provider 怎麼寫
如果你只用官方賬號，先使用官方登錄流程。只有在服務商明確提供 Codex / OpenAI 兼容配置時，再添加自定義 Provider。
Codex CLI 登錄測試
codex login codex "請只回覆：配置成功"config.toml 示例
model = "服務商後臺顯示的模型 ID 或模型名" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "某某中轉站" base_url = "https://你的服務商API地址" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"| 配置項 | 怎麼填 | 注意 |
|---|---|---|
| model | 服務商後臺模型列表裡的模型 ID / 模型名 | 不要填自己起的顯示名，也不要改大小寫、橫線或點號 |
| model_provider | 下面 Provider 的名字 | 要和 [model_providers.xxx] 裡的 xxx 一致 |
| base_url | 服務商後臺給出的 API 地址 | 按後臺示例決定是否帶 /v1 |
| env_key | 本機環境變量名 | 這裡寫變量名，不直接寫 Key |
| wire_api | 接口協議 | 按 Codex 官方文檔和服務商說明選擇 |
Key 和測試
上面的 env_key 只是變量名，真正的 Key 要放到本機環境變量裡。先臨時設置並測試，確認成功後再考慮長期保存。
PowerShell 臨時測試
$env:MZ_PROXY_API_KEY = "你的_Key" codex "請只回覆：配置成功"Terminal 臨時測試
MZ_PROXY_API_KEY="你的_Key" codex "請只回覆：配置成功"TOML 裡 model 和 model_provider 要放在文件前面，不要追加到 [model_providers.xxx] 小節下面。
Codex CLI 文檔 查看 Codex CLI 官方入口。
Codex 配置基礎 查看 config.toml 的位置和作用域。
Codex 配置參考 查看 model_providers、base_url、env_key 等字段。