Windows 从 0 配置 Codex CLI 并接入外部 API：以小米 MiMo 为例

保姆级教程。默认你已经有 API Key、Base URL 和模型名。

配图说明：本文图片为原创示意图，不爬取或复制第三方博客图片。

本文目标

这是一篇给 Windows 新手看的 Codex CLI + 外部 API 配置教程。教程默认你已经有可用的小米 MiMo API Key、Base URL 和模型名，重点是用最快速度完成本机环境、环境变量、Codex 配置、API 连通性测试和首次运行。

项目	推荐值 / 说明
系统	Windows 10 / Windows 11；更推荐 Windows 11
终端	PowerShell 或 Windows Terminal 的 PowerShell 标签页
依赖	Node.js LTS、npm、Git
Codex 版本	`@openai/codex@0.80.0`
API Key 保存方式	Windows 用户级环境变量 `MIMO_API_KEY`
Base URL 示例	`https://api.xiaomimimo.com/v1`
模型名示例	`mimo-v2.5-pro`
核心配置	`model_provider = "mimo"`，`wire_api = "chat"`

1. 先理解兼容性：为什么本文固定使用 Codex 0.80.0

小米 MiMo 的 Codex 接入文档说明，MiMo 模型目前不兼容 Responses API，仅适用于使用 ChatCompletions API 的旧版 Codex。新版 Codex 的自定义 provider 配置方向则更偏向 wire_api = "responses"。因此，如果你想照着小米文档最稳地跑通，不要直接安装最新版 @openai/codex，而是固定安装 @openai/codex@0.80.0。

新手结论：本文不追求"最新"，而是追求"最快跑通"。要接小米 MiMo，优先走旧版 Codex + ChatCompletions。

2. 准备你的 3 个参数

参数	示例	说明
API Key	`sk-xxxxxxxx` 或 `tp-xxxxxxxx`	不要写进 config.toml，不要提交到 GitHub
Base URL	`https://api.xiaomimimo.com/v1`	普通按量 API 示例；Token Plan 用户使用自己的专属 URL
模型名	`mimo-v2.5-pro`	按你账户实际可用模型填写

注意：Base URL 只写到 /v1，不要写到 /chat/completions。

3. Windows 环境安装：Node.js、npm、Git

3.1 检查 winget

powershell 复制代码

winget --version

3.2 安装 Node.js LTS

powershell 复制代码

winget install -e --id OpenJS.NodeJS.LTS

安装完成后，关闭 PowerShell 并重新打开：

powershell 复制代码

node -v
npm -v

3.3 安装 Git

powershell 复制代码

winget install --id Git.Git -e --source winget

验证：

powershell 复制代码

git --version

4. 安装 Codex CLI 旧版并验证命令

powershell 复制代码

npm uninstall -g @openai/codex
npm i -g @openai/codex@0.80.0
codex --version

如果 npm 很慢，可以临时切换镜像：

powershell 复制代码

npm config set registry https://registry.npmmirror.com

切回官方源：

powershell 复制代码

npm config set registry https://registry.npmjs.org

5. 设置 MIMO_API_KEY 环境变量

把 YOUR_MIMO_API_KEY 换成你的真实 Key：

powershell 复制代码

[Environment]::SetEnvironmentVariable("MIMO_API_KEY", "YOUR_MIMO_API_KEY", "User")
$env:MIMO_API_KEY = "YOUR_MIMO_API_KEY"
echo $env:MIMO_API_KEY

环境变量里只写 Key 本身，不要加 Bearer。

6. 创建 config.toml 配置文件

创建目录并打开记事本：

powershell 复制代码

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

复制下面内容：

toml 复制代码

model = "mimo-v2.5-pro"
model_provider = "mimo"

approval_policy = "on-request"
sandbox_mode = "workspace-write"

[windows]
sandbox = "unelevated"

[model_providers.mimo]
name = "Xiaomi MiMo"
base_url = "https://api.xiaomimimo.com/v1"
env_key = "MIMO_API_KEY"
wire_api = "chat"

如果你的 Base URL 不是普通按量地址，只改这一行：

toml 复制代码

base_url = "YOUR_MIMO_BASE_URL"

7. 先测试 API，再启动 Codex

powershell 复制代码

$headers = @{
  "Authorization" = "Bearer $env:MIMO_API_KEY"
  "Content-Type"  = "application/json"
}

$body = @{
  model = "mimo-v2.5-pro"
  messages = @(
    @{
      role = "user"
      content = "你好，用一句话介绍你自己。"
    }
  )
  stream = $false
} | ConvertTo-Json -Depth 10

Invoke-RestMethod `
  -Uri "https://api.xiaomimimo.com/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -Body $body

如果返回 JSON 且里面有模型回复，就说明 API Key、Base URL、网络都正常。

8. 首次运行：创建测试项目并让 Codex 写代码

powershell 复制代码

mkdir "$env:USERPROFILE\codex-mimo-demo"
cd "$env:USERPROFILE\codex-mimo-demo"
git init
codex

进入 Codex 后输入：

text 复制代码

请在当前目录创建一个 hello_mimo.py 文件，功能是打印"你好，我已经成功用小米 MiMo 接入 Codex"。创建后运行它，并告诉我运行结果。

9. 小白常见问题排查

现象	常见原因	解决方法
`codex` 不是内部或外部命令	npm 全局安装失败或 PATH 未刷新	关闭 PowerShell 重新打开；必要时重装
`wire_api = chat is no longer supported`	安装了新版 Codex	固定安装 `@openai/codex@0.80.0`
401 Unauthorized	API Key 错或环境变量没生效	`echo $env:MIMO_API_KEY`，确认不要带 Bearer
404 Not Found	base_url 写错	config 里只写到 `/v1`
API 测试超时	网络、代理或服务端不可达	先检查 Base URL 和代理
npm.ps1 被禁止运行	PowerShell 执行策略限制	`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
Windows sandbox 报错	原生沙箱权限或系统策略问题	`[windows] sandbox = "unelevated"`

10. 一整套可复制命令

powershell 复制代码

# 1. 安装依赖
winget install -e --id OpenJS.NodeJS.LTS
winget install --id Git.Git -e --source winget

# 2. 重新打开 PowerShell 后验证
node -v
npm -v
git --version

# 3. 安装适配小米 MiMo 的 Codex 旧版
npm uninstall -g @openai/codex
npm i -g @openai/codex@0.80.0
codex --version

# 4. 设置 API Key：把 YOUR_MIMO_API_KEY 换成你的真实 Key
[Environment]::SetEnvironmentVariable("MIMO_API_KEY", "YOUR_MIMO_API_KEY", "User")
$env:MIMO_API_KEY = "YOUR_MIMO_API_KEY"
echo $env:MIMO_API_KEY

# 5. 写入 config.toml
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null

@'
model = "mimo-v2.5-pro"
model_provider = "mimo"

approval_policy = "on-request"
sandbox_mode = "workspace-write"

[windows]
sandbox = "unelevated"

[model_providers.mimo]
name = "Xiaomi MiMo"
base_url = "https://api.xiaomimimo.com/v1"
env_key = "MIMO_API_KEY"
wire_api = "chat"
'@ | Set-Content -Encoding UTF8 "$env:USERPROFILE\.codex\config.toml"

# 6. 创建测试项目并启动
mkdir "$env:USERPROFILE\codex-mimo-demo"
cd "$env:USERPROFILE\codex-mimo-demo"
git init
codex

参考资料

小米 MiMo Codex 配置文档：https://platform.xiaomimimo.com/docs/zh-CN/integration/codex
小米 MiMo 工具总览：https://platform.xiaomimimo.com/docs/zh-CN/integration/tools-overview
OpenAI Codex CLI 文档：https://developers.openai.com/codex/cli
OpenAI Codex Windows 文档：https://developers.openai.com/codex/windows
OpenAI Codex Advanced Configuration：https://developers.openai.com/codex/config-advanced
Git for Windows 安装页：https://git-scm.com/install/windows
Node.js 下载页：https://nodejs.org/en/download