# 给配置助手的任务

我是新手，正在 Windows 上配置 Codex CLI，使用米醋 API。请先阅读这份教程：https://docs.micuapi.ai/simple/codex-cli-windows

请先确认我已经安装了什么、进行到哪一步。每次只指导一个步骤，写清楚在哪里操作、填什么、成功后会看到什么，等我反馈再继续。遇到错误先根据教程排查，不要猜测不存在的模型、分组或界面选项。已有配置先备份并只合并必要字段。API Key 用 sk-xxx 占位，由我在本机填写。

如果无法读取链接，请明确告诉我，让我粘贴完整教程。你没有本机操作能力时，请指导我执行，不要声称已经替我修改成功。

---

# Codex CLI · Windows 配置教程

先完成一步，再继续下一步。已经完成的安装步骤可以跳过。

> 配置资料核对日期：2026-09-13。分组和模型可能调整，当前可用情况以 [米醋模型广场](https://www.micuapi.ai/pricing) 为准。

## 这份教程会帮你完成什么

安装并连接米醋 API，最后发送一条消息确认可以使用。所有 API Key 示例都是占位值 `sk-xxx`，实际 Key 只在你自己的软件中填写。

| 要填写的内容 | 本教程使用的值 |
|---|---|
| 工具 | Codex CLI |
| 系统 | Windows |
| 令牌分组 | `vip_2` |
| Base URL | `https://www.micuapi.ai/v1` |
| 模型 | `gpt-5.6-sol` |

## 1. 安装并打开工具

右键开始按钮，打开「终端」或「Windows PowerShell」。先从 [Git for Windows](https://git-scm.com/install/windows) 安装 Git，安装后重新打开终端。

```powershell
git --version
```



从 [Node.js 官网](https://nodejs.org/en/download) 安装当前 LTS 版本。重新打开终端并检查：

```powershell
node -v
npm -v
```

然后安装 Codex CLI：

```powershell
npm install -g @openai/codex
codex --version
```

**完成标志**：版本检查能显示版本号，没有「找不到命令」的提示。

## 2. 准备米醋 API Key

**先看模型广场，再创建密钥。** 打开 [米醋模型广场](https://www.micuapi.ai/pricing)，确认分组 `vip_2` 当前支持的模型；后面填写 `model` 时，直接复制该页面显示的完整模型名称，避免写错模型导致调用失败。

**如果模型广场或创建 API Key 页面看不到国外模型，请先开启代理（魔法），并启用 TUN（网卡模式），再刷新页面。** 仅浏览器代理可能无法加载完整列表。

1. 登录 [米醋站点](https://www.micuapi.ai)，进入令牌管理页面。
2. 新建或编辑一个令牌，分组选择 `vip_2`。
3. **关闭「模型限制」**，限制可调用模型有时会引发未知异常。
4. 保存并复制 API Key，稍后填入本机的软件。

本教程选择的主模型是 `gpt-5.6-sol`。不要把后台审查模型 `codex-auto-review` 设为主会话模型。

**完成标志**：手中有一个对应分组的 API Key，令牌的模型限制已关闭。

## 3. 用 CC Switch 填写配置

### 使用前看一眼：先查模型，再配置

> **第一步：打开 [米醋模型广场](https://www.micuapi.ai/pricing)，先查看你准备使用的分组支持哪些模型。** 设置 `model` 时请复制该分组显示的完整模型名称，避免模型名称写错或分组不支持导致调用失败。
>
> **看不到国外模型时，先开代理（魔法），并启用 TUN（网卡模式），再刷新模型广场和 API Key 创建页面。** 仅开启浏览器代理可能无法加载完整分组或模型列表。

### CC Switch 使用前，先确认这三项

> 优选域名无需开启代理（魔法）。如果主站域名无法访问，请开启代理并启用 TUN（网卡模式）；部分地区还需要开启全局模式。

1. **关闭路由模式**。CC Switch 的路由模式有时会掩盖真实错误，配置和排障时请先关闭。
2. **不要点击 CCS 的「检测」**。米醋不接受 Claude Code / Codex 的 CCS 检测请求。保存并启用配置后，直接打开 Claude Code 或 Codex，发送一条消息验证。
3. **更新 CCS，使用 Micu 预设**。将 CC Switch 更新到最新版本，在 CCS 中选择对应框架和 **Micu** 预设，再填写 API Key。不要依赖米醋站点的「直接导入 CC Switch」功能。

![CC Switch 路由模式开关示意，使用前请关闭](https://docs.micuapi.ai/img/cc-switch/cc-switch-routing-toggle.png)

如果出现 `401 Unauthorized`，且报错地址是 `api.openai.com/v1/responses`，也可能是旧会话的问题。**先新开会话测试**。新会话正常时，右键原会话 → 分叉 → 创建聊天分支。如果新会话也报错，再完全退出 ChatGPT / Codex，用最新版 CCS 的 Micu 预设重新配置模型和供应商。详见 [配置或旧会话导致 401 的排查步骤](https://docs.micuapi.ai/errors/cd-wrong-provider-import)。

![请求地址仍为 OpenAI 官方端点时的 401 错误示例](https://docs.micuapi.ai/img/errors/codex-wrong-provider-401.png)

从 [CC Switch 发布页](https://github.com/farion1231/cc-switch/releases) 下载适合 Windows 的版本并安装。

**CC Switch 简称 ccs；Claude Code 简称 cc，两者是不同的软件。**

1. 打开 CC Switch，点击「添加配置」。
2. 框架选择 **Codex**。
3. 在预设供应商中选择 **Micu**，Base URL 会自动填入。
4. 把第 2 步准备的 API Key 填入对应输入框。
5. 模型填写 `gpt-5.6-sol`。
6. 保存或点击「添加」，并确认已启用这个配置。
7. 重新打开终端。

![CC Switch 中选择 Micu 预设供应商](https://docs.micuapi.ai/img/claude-code/cc-switch-micu-preset.webp)

确认 Base URL 是 `https://www.micuapi.ai/v1`。Codex 的地址带 `/v1`。

**完成标志**：CC Switch 已启用 Micu 配置，工具已重新打开。

## 4. 检查后台审批设置

LUNA（`gpt-5.6-luna`）有全局限速，且本次查询未列入 `vip_2` / `vip_2_cc` 的可选模型。如果后台审批仍使用 LUNA，可能受限。

如果你遇到后台审批反复失败，先退出 Codex，然后用下面的命令启动一个不请求审批的新会话：

```powershell
codex --ask-for-approval never
```

正常使用且没有审批问题时，可以直接进入下一步。

「从不请求审批」表示受限操作会直接失败，不会自动扩大沙盒权限。如果需要保留自动审批，请在支持模型映射的接入服务中，把**审批请求使用的模型**映射到当前分组可用模型；只修改主会话模型不能保证后台审批也改变。

**完成标志**：已选择合适的审批方式，使用新会话继续。

## 5. 发一条消息验证

在终端执行：

```powershell
codex
```

如果出现工作目录信任提示，确认目录后按界面操作，再发送：**请只回复「配置成功」**。

**完成标志**：收到正常回复，没有 API Key 无效、模型不可用或连接失败的报错。

## 没成功时，先看这里

| 你看到的现象 | 先做什么 |
|---|---|
| 找不到命令 | 关闭并重新打开终端，再检查版本；Windows 下确认打开的是本教程指定的终端。 |
| API Key 无效 / 401 | 检查 Key 是否复制完整、是否过期，确认已启用正确的 Micu 配置。不要把完整 Key 发到聊天里。 |
| 模型不可用 | 检查令牌分组、模型名称和模型限制；以本教程的配置表和模型广场为准。 |
| 403 block | 先确认使用官方客户端和正确分组，第三方客户端另见完整手册的外接说明。 |
| 连接失败 / 一直等待 | 换一个可用网络，检查代理；记录完整错误文字，不要同时修改多个设置。 |

## CC Switch 不可用时：手动配置

这是备用方式。已有配置时先备份，只合并下面涉及的字段，不要整份覆盖原文件。保存后重新打开工具。

配置文件：`C:\Users\<USERNAME>\.codex\config.toml`。供应商之前的字段必须位于文件顶层。

```toml
model_provider = "micu"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.micu]
name = "micu"
base_url = "https://www.micuapi.ai/v1"
wire_api = "responses"
requires_openai_auth = true
```

认证文件：`C:\Users\<USERNAME>\.codex\auth.json`。

```json
{
  "OPENAI_API_KEY": "sk-xxx"
}
```

把占位值 `sk-xxx` 替换成你自己的 API Key。

## 配好了，接下来

可以开始使用，也可以进入 [Codex CLI 详细手册](https://docs.micuapi.ai/codex) 查看更多配置。后续报错请保留错误原文、系统和工具版本，按 [报错手册](https://docs.micuapi.ai/errors) 排查。