Codex 配置指南

准备工作

开始前请准备：

• MaiToken API 密钥：前往 MaiToken 控制台 创建密钥。

• Codex CLI：按照 Codex 官方文档 安装，或使用以下命令：

  npm install -g @openai/codex

• CC Switch：只从 CC Switch 官网 或 官方 GitHub Releases 下载。

在 CC Switch 中添加 MaiToken

1. 打开 CC Switch，在顶部应用切换器中选择 Codex。

2. 点击右上角 +，选择 应用专属供应商。

3. 在预设中选择 自定义，填写以下内容：

   配置项	填写内容
   名称	MaiToken
   API Key	您的 MaiToken API 密钥
   API 端点 / Base URL	https://api.maitoken.com/v1
   模型	gpt-5.3-codex
   API 协议	Responses
   需要本地路由映射	关闭

4. 点击 添加，然后在 MaiToken 供应商卡片上点击 启用。

5. 关闭正在运行的 Codex 和终端窗口，重新打开终端使配置生效。

注意： MaiToken 原生支持 POST /v1/responses，因此不要开启“需要本地路由映射”。该开关用于只支持 Chat Completions 的供应商。

启动并验证

codex

进入 Codex 后发送一个简单任务，例如：

检查当前项目并说明它的主要目录结构。

如能正常返回结果，说明接入成功。

切换模型

如果账户开放了其他 Responses 模型，可以编辑 MaiToken 供应商并更换模型。CC Switch 的模型输入框支持通过 /v1/models 获取可用列表；也可以前往 MaiToken 模型一览 查看模型 ID。

常用选择：

提示： 模型是否可用取决于账户和渠道配置，请优先以 CC Switch 获取到的 /v1/models 列表为准。

常见问题

启用后仍使用旧供应商

Codex 不会热重载供应商配置。请完全退出 Codex，并重新打开终端后再启动 codex。

401 Unauthorized

1. 检查 CC Switch 中的 API Key 是否完整。
2. 在 MaiToken 控制台 确认密钥有效。
3. 确认账户余额充足。

404 或 Responses 路径错误

确认 Base URL 是 https://api.maitoken.com/v1，API 协议为 Responses，并且“需要本地路由映射”处于关闭状态。

模型不可用

在 CC Switch 中点击模型字段旁的“获取模型”，或调用 GET https://api.maitoken.com/v1/models 检查当前密钥可用的模型。

配置文件与密钥安全

CC Switch 会管理 ~/.codex/auth.json 和 ~/.codex/config.toml。不要把这些文件、API Key 或包含密钥的截图提交到 Git 仓库。

更多 CC Switch 操作说明参阅其官方用户手册。