编辑文档 - Codex 登录不了？我用 CC Switch 让它接上了 MiniMax M3

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

## 为什么 Codex 登录是个麻烦事

Codex 有两套登录体系：

- **官方账号**：走 OpenAI OAuth，登录后能用 GPT 系列模型，但需要 ChatGPT Plus 订阅
- **第三方 API**：填 API Key 走 OpenAI Responses API，但 Codex 原生只认 OpenAI 官方格式

问题在于，很多国产模型（MiniMax、DeepSeek、Kimi、GLM 等）对外暴露的是 **OpenAI Chat Completions 格式**，而不是 Codex 原生需要的 Responses 格式。

直接填 API 地址，Codex 报 404；绕过登录改配置，官方功能又全废了。

之前没有好办法，**直到 CC Switch v3.16.0 出了这个功能**。

---

## CC Switch 是什么

[CC Switch](https://github.com/farion1231/cc-switch)（ccswitch.io）是一个免费开源的桌面应用，功能是把 Claude / Codex / Gemini 的流量路由到任意大模型供应商，同时保留各平台的原生功能。

**v3.16.0 的核心更新**（2026-05-29）：
> Codex 增加 Chat Completions → Responses 格式转换。你可以在 Codex 里直接用 DeepSeek、Kimi、GLM、MiniMax 这类 Chat 格式 API 了。

**v3.16.1 的补丁**（2026-06-01）：
> 新增「Codex 应用增强」开关，保留官方登录态的同时把模型流量切到第三方 API。解决了用户反馈的「登录后就登不回去」问题。

---

## 核心原理：协议转换怎么工作的

Codex 原生用的是 OpenAI Responses API，你给它发 Responses 格式的请求，它回 Responses 格式的响应。

国产模型大多数只支持 Chat Completions 格式，**协议不一样**，直接填进去 Codex 解析不了。

CC Switch 的做法：

```
Codex（发 Responses 请求）
  → CC Switch 本地路由（127.0.0.1:15721）
  → 识别出上游是 Chat Completions 格式
  → 转换成 Chat Completions 请求发给 MiniMax/DeepSeek/Kimi
  → 上游返回 Chat 响应
  → CC Switch 转换回 Responses 格式
  → Codex 收到响应，正常工作
```

整个过程不需要你手动改 Codex 的 `config.toml`，CC Switch 会自动接管配置。

---

## 完整配置教程（以 MiniMax M3 为例）

### 方案一：用 CC Switch 内置预设（推荐）

**Step 1：安装 CC Switch**

从 [ccswitch.io](https://ccswitch.io) 或 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载安装。

**Step 2：添加 MiniMax 供应商**

打开 CC Switch，切到顶部 `Codex` 标签，点击右上角加号添加供应商。

从内置预设里选 `MiniMax`，填入从 [MiniMax 开放平台](https://platform.minimaxi.com) 获取的 API Key，保存即可。

预设已经配好了：
- API 地址
- 默认模型（MiniMax-M3）
- thinking/reasoning 参数
- **自动打开「需要本地路由映射」**（关键）

**Step 3：开启本地路由接管**

进入 CC Switch 设置 → 路由 → 本地路由：

1. 打开「路由总开关」，默认地址 `127.0.0.1:15721`
2. 在「路由启用」中打开 `Codex`

这一步会让 CC Switch 接管 Codex 的配置，Codex 的 `config.toml` 会自动指向本地路由地址。

**Step 4：切换供应商并验证**

回到 Codex 标签页，点击 MiniMax 供应商的「启用」，然后重启 Codex 终端。

输入 `/model` 看看模型是否切换到了 MiniMax-M3。也可以发个小请求，看看 CC Switch 的请求日志有没有流量进来。

### 方案二：保留官方登录 + 用第三方 API（v3.16.1 新增）

如果你想同时保留 Codex 官方 App 的手机远程操作和官方插件，又想用 MiniMax M3，v3.16.1 新增的「Codex 应用增强」功能就是为你准备的。

**Step 1**：先在 CC Switch Codex 标签页切换到 `OpenAI Official` 供应商

**Step 2**：打开 Codex（CLI 或 App），用官方 ChatGPT 账号登录一次（Free 账号也可以）

**Step 3**：回到 CC Switch，开启「Codex 应用增强」，并打开「切换供应商时保留官方登录」

**Step 4**：切换到 MiniMax 等第三方供应商

这时的效果：
- `auth.json` 保留官方登录态，远程操作和插件功能正常
- `config.toml` 写进第三方供应商的模型配置，实际流量走 MiniMax M3

---

## DeepSeek / Kimi / GLM 能用吗

能。CC Switch 内置了这些供应商的预设，配置方式完全一样：

| 供应商 | 预设支持 | 协议类型 |
|--------|---------|---------|
| MiniMax | ✅ | Chat Completions（需路由） |
| DeepSeek | ✅ | Chat Completions（需路由） |
| Kimi / Moonshot | ✅ | Chat Completions（需路由） |
| 智谱 GLM | ✅ | Chat Completions（需路由） |
| SiliconFlow | ✅ | Chat Completions（需路由） |
| OpenAI 官方 | ✅ | Responses（直连） |
| Gemini | ✅ | 直连 |

预设里没有的供应商，选择「自定义配置」，填入 base URL 和 API Key，把 `API 格式` 选为 `OpenAI Chat Completions（需开启路由）` 即可。

---

## 常见问题

### Q1：开了路由后 `/model` 看不到 MiniMax 模型

保存供应商后需要**重启 Codex**。CC Switch 会生成 `cc-switch-model-catalog.json`，正在运行的 Codex 进程不会热加载模型目录。

### Q2：Codex 报 404 或找不到 `/responses`

检查 `~/.codex/config.toml` 是否指向 `http://127.0.0.1:15721/v1`。没有开启路由接管时，Codex 会直接访问填进去的 API 地址，但国产模型没有 Responses 端点，自然 404。

### Q3：路由开启了但请求还是走错供应商

确认三处状态一致：
1. Codex 标签下当前供应商是 MiniMax
2. 本地路由服务正在运行（路由总开关打开）
3. 「路由启用」里 Codex 开关已打开

### Q4：Mac / Windows 配置文件在哪

- macOS & Linux：`~/.codex/config.toml`
- Windows：`C:\Users\你的用户名\.codex\config.toml`

---

## 写在最后

CC Switch v3.16.0-v3.16.1 这两次更新，把 Codex 接入国产大模型的体验从「折腾」变成了「开箱即用」——协议转换、登录态保留、供应商预设，这些之前需要手动配置的东西现在 CC Switch 全包了。

如果你之前试过在 Codex 里填 MiniMax/DeepSeek/Kimi 不成功，现在可以再试一次。

---

摘要

标签多个标签用逗号分隔

分类