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 等字段。