Codex config.toml 配置教程：团队网关模板直接复制

如果你要让 Codex 接入统一 OpenAI 兼容 API，这一页就是主入口：路径、模板、令牌、验证和常见坑都放在一起。

配置文件到底在哪里

用户级配置文件是 ~/.codex/config.toml。在 Windows 里，~ 等于用户目录，例如 C:\Users\zkl\.codex\config.toml。

如果文件不存在，先创建目录，再用记事本打开：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

团队网关推荐模板

把下面内容保存进 ~/.codex/config.toml。其中 base_url 要带 /v1，provider 名称可以按团队习惯改。

model = "your-codex-model"
model_provider = "izkl-gateway"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
model_reasoning_effort = "high"

[model_providers.izkl-gateway]
name = "izkl AI Gateway"
base_url = "https://izkl.top/v1"
requires_openai_auth = true
wire_api = "responses"

设置个人令牌

团队里建议每个人使用独立令牌，不要多人共用一个长期密钥。当前 PowerShell 会话可这样设置：

$env:OPENAI_API_KEY = "你的团队个人令牌"

需要长期保存时用 setx，执行后重新打开 PowerShell：

setx OPENAI_API_KEY "你的团队个人令牌"

为什么 provider 要写在用户级配置

model_provider 和 model_providers 属于本机 provider、认证和主机侧配置。团队模板应该放在用户级 ~/.codex/config.toml，项目级 .codex/config.toml 更适合放项目规则和工作偏好。

最短验证流程

运行 codex --version，确认安装没问题。
运行 $env:OPENAI_API_KEY，确认令牌已经读到。
进入项目目录，运行 codex，问一句“解释这个项目结构”。

cd "你的项目目录"
codex

常见问题

base_url 要不要带 /v1？

OpenAI 兼容网关通常要写成 https://域名/v1。少了 /v1 很容易出现 404、405 或请求路径不对。

wire_api 怎么写？

Codex 当前 provider 协议使用 responses；省略时默认也是 responses。

config.toml 保存成 txt 了怎么办？

把文件名改回 config.toml，并确认资源管理器里没有隐藏的 .txt 后缀。