🚨 Windows 下 Codex + WeCode + 第三方 API 配置踩坑全记录（含完整解决方案）

最近在 Windows 上配置 Codex CLI + WeCode + 第三方 API（intelligrow） 时，遇到了一系列“明明设置了 Key 但一直 missing”的问题。

折腾一圈之后，终于定位清楚原因。

这篇文章帮你避坑。

---

🧨 一、问题现象

我做了以下操作：

1. 在 PowerShell 里设置环境变量：

$env:INTELLIGROW_API_KEY="sk-xxxx"

2. 并写入到 $PROFILE
3. 在 C:\Users\用户名\.codex\config.toml 里配置：

model_provider = "intelligrow"

[model_providers.intelligrow]
base_url = "https://cc.intelligrow.ai/v1"
env_key = "INTELLIGROW_API_KEY"

4. 启动 Codex

结果仍然报错：

missing api key

后来改用：

npx wecode

重新配置，结果又报：

配置文件 base_url 与文档不一致
期望 https://api.wecodemaster.com/v1
实际 https://cc.intelligrow.ai/v1

非常迷惑。

---

🔍 二、问题根源分析

这个问题本质上不是 Key 错误，而是：

❗ CLI 工具和配置体系混用了

你必须理解这三者的区别：

工具	是否支持自定义 provider
@openai/codex 官方 CLI	❌ 不支持
wecode CLI	✅ 支持
手动改 config.toml	⚠ 可能被覆盖

---

✅ 核心问题 1：官方 Codex CLI 不支持第三方 Provider

我最开始用的是：

npm install -g @openai/codex

这个版本：

• 只认 OPENAI_API_KEY
• 只连接 OpenAI 官方 API
• 不支持 model_provider
• 不支持 env_key
• 不支持自定义 base_url

也就是说：

即使你写了：

model_provider = "intelligrow"

它根本不会读。

所以永远 missing。

---

✅ 核心问题 2：WeCode 是“托管式配置”

当你运行：

npx wecode

它会：

• 自动生成 config.toml
• 自动写 auth.json
• 自动做一致性检查

它要求：

config.toml 必须完全由它生成

如果你手动加过：

[model_providers.intelligrow]

它就会报错。

因为它检测到：

当前 model_provider 是 wecode
但 config 里还有 intelligrow

直接判定为“污染配置”。

---

💥 三、为什么会一直 missing？

完整原因链：

1. 使用官方 Codex CLI（不支持第三方 provider）
2. 手动添加 intelligrow provider
3. 再用 wecode CLI 重写配置
4. config.toml 里出现多 provider 混合
5. 一致性检查失败
6. 报 missing / base_url 不一致

---

✅ 四、正确解决方案（干净重置）

这是 100% 有效的步骤。

---

✅ 第一步：删除旧配置（非常重要）

Remove-Item -Recurse -Force $env:USERPROFILE\.codex

必须删干净。

---

✅ 第二步：重新用 WeCode 配置

npx wecode

选择：

• Codex
• 完整配置
• 填入 WECODE_API_KEY

不要手动修改 config.toml。

---

✅ 第三步：验证

codex "hello"

如果正常输出，说明成功。

---

✅ 五、最终正确的 config.toml 应该是这样的

model_provider = "wecode"
model = "gpt-5.4"
preferred_auth_method = "apikey"

[model_providers.wecode]
base_url = "https://api.wecodemaster.com/v1"
env_key = "WECODE_API_KEY"

不应该再出现：

[model_providers.intelligrow]

---

🧠 六、关键经验总结

✅ 1️⃣ 官方 Codex CLI 不支持第三方 API

不要再往里面加自定义 provider。

---

✅ 2️⃣ WeCode CLI 是托管配置

不要手改 .codex/config.toml

---

✅ 3️⃣ Windows 下环境变量建议用 setx

不要只写：

$env:KEY="xxx"

要用：

setx KEY "xxx"

然后重开终端。

---

✅ 4️⃣ 出问题第一步：删 .codex 目录

90% 的问题都来自历史配置冲突。

---

🎯 七、最重要的一句话

不要混用 Codex 官方 CLI 和 WeCode 自定义 provider 配置。
选一个体系，用到底。

---

✅ 最终建议

如果你想：

• 用 OpenAI 官方 API → 用官方 Codex CLI
• 用第三方兼容 API → 用 WeCode CLI
• 不要两边混着配

---

后记

2026年4月2日于上海。在gpt5.2辅助下完成。