核心思路-config.toml负责告诉 Codex请求发到哪里、用哪个 provider、用什么协议。- Windows 环境变量负责保存真实 API Key。- Codex Windows 沙箱负责限制它能安全地读写和执行什么。一、准备信息你需要先从中转站后台拿到三项信息API KeyBase URL可用模型名示例API Key: sk-你的中转站key Base URL: https://你的中转站域名/v1 Model: gpt-5.5注意Base URL 通常需要以/v1结尾。如果中转站支持 OpenAI Responses API配置里可以使用wire_api responses。真实 Key 不要直接写进config.toml建议用环境变量引用。二、推荐的 Codex 配置结构配置文件路径$HOME\.codex\config.toml示例内容model gpt-5.5 model_provider proxy [model_providers.proxy] name proxy base_url https://你的中转站域名/v1 env_key OPENAI_API_KEY wire_api responses [windows] sandbox unelevated这段配置的含义model你要使用的模型名。model_provider选择下面定义的 provider。[model_providers.proxy]自定义一个叫proxy的中转站 provider。base_url中转站接口地址。env_key从环境变量OPENAI_API_KEY读取真实 Key。wire_api使用 Responses API 协议。[windows].sandbox unelevatedWindows 下使用非管理员沙箱。三、全流程 PowerShell 代码把下面示例里的中转站域名、Key 和模型名替换成你自己的。# 1. 打开 PowerShell先准备变量 $ProxyBaseUrl https://你的中转站域名/v1 $ProxyKey sk-你的中转站key $ModelName gpt-5.5 2. 当前终端会话临时生效适合先测试 $env:OPENAI_API_KEY $ProxyKey 3. 长期保存到当前 Windows 用户环境变量 [Environment]::SetEnvironmentVariable(OPENAI_API_KEY, $ProxyKey, User) 4. 创建 Codex 配置目录 $CodexDir Join-Path $HOME .codex New-Item -ItemType Directory -Force -Path $CodexDir | Out-Null 5. 写入 Codex 配置文件 model $ModelName model_provider proxy [model_providers.proxy] name proxy base_url $ProxyBaseUrl env_key OPENAI_API_KEY wire_api responses [windows] sandbox unelevated | Set-Content -Path (Join-Path $CodexDir config.toml) -Encoding UTF8 6. 检查配置文件是否写入成功 Get-Content (Join-Path $CodexDir config.toml) 7. 重新打开一个 PowerShell确认长期环境变量能读到 [Environment]::GetEnvironmentVariable(OPENAI_API_KEY, User) 8. 诊断 Codex 环境 codex doctor 9. 进入你的项目目录必须在项目目录里启动 Codex cd E:\Codex 10. 启动 Codex codex 11. 或者直接用一句话测试文件写入能力 codex 创建 test.txt 文件并写入 hello 12. 如果首次出现沙箱选择选择非管理员沙箱 1. Set up default sandbox 2. Use non-admin sandbox 3. Quit 输入2四、如何判断是否配置成功如果你看到类似提示Sandbox ready Codex can now safely edit files and execute commands in your computer并且 Codex 能完成下面这些动作就说明 CLI 基本可用创建文件修改文件执行命令读取当前项目目录内容推荐测试codex 创建 test.txt 文件并写入 hello如果当前目录出现test.txt并且内容是hello说明基础链路已经跑通。五、常见问题排查1. Codex 提示 Windows 设置未完成怎么办不一定代表 CLI 不能用。Windows 上有时会出现高权限沙箱初始化失败但unelevated非管理员沙箱仍然可以正常工作。先用小任务验证 Codex 是否能创建和修改文件。2. 中转站请求失败怎么办优先检查base_url是否写对。base_url是否以/v1结尾。中转站是否支持你配置的模型名。中转站是否支持responses协议。当前 PowerShell 是否能读到OPENAI_API_KEY。检查环境变量$env:OPENAI_API_KEY [Environment]::GetEnvironmentVariable(OPENAI_API_KEY, User)3. Codex 不能读取项目文件怎么办确认你是在项目目录里启动 Codex。例如cd E:\Codex codex不要在无关目录里启动否则 Codex 的工作区就不是你的项目目录。4. 需要看官方诊断信息怎么办执行codex doctor重点看这些关键词附近的报错sandbox windows sandbox setup helper elevated provider base_url六、安全提醒配置中转站 Key 时建议遵守这几条不要把真实 Key 写进帖子、截图或仓库。不要把 Key 明文写入config.toml。用env_key OPENAI_API_KEY引用环境变量。如果 Key 泄露立刻到中转站后台吊销并重新生成。发帖时用sk-你的中转站key这类占位符替代真实内容。一句话总结config.toml管“去哪儿请求”环境变量管“拿什么钥匙”Windows 沙箱管“能安全做什么”。这三层分开配置更清晰排错也更容易。