从零开始,5 分钟跑通 MiMo + Codex++

一、下载 Codex++

1. 下载安装包

GitHub 地址(需科学上网):

GitHub:https://github.com/BigPizzaV3/CodexPlusPlus

国内加速地址:

加速:https://ghfast.top/https://github.com/BigPizzaV3/CodexPlusPlus/releases

选择对应系统的版本:

系统下载文件
WindowsCodexPlusPlus-x.x.x-win-x64.exe
macOS (M芯片)CodexPlusPlus-x.x.x-macos-arm64.dmg
macOS (Intel)CodexPlusPlus-x.x.x-macos-x64.dmg

2. 安装并启动

安装后会多出 两个应用

  • Codex++ 管理工具 — 用于配置供应商、协议、Key
  • Codex++ — 增强版 Codex 客户端(需从管理工具启动)

二、配置 MiMo 供应商

3. 打开管理工具 → 供应商配置

启动 Codex++ 管理工具,点击左侧 "供应商配置"

4. 填写 API 请求地址

根据你的 Key 类型选择地址:

Key 类型API 地址
tp 开头 订阅套餐https://token-plan-cn.xiaomimimo.com/v1
sk 开头 按量付费https://api.xiaomimimo.com/v1
⚠️ 不要填 https://platform.xiaomimimo.com,那是官网不是 API 地址!

5. 填写 API Key

去 MiMo 开放平台后台获取 Key:

⚠️ 必须从 Token Plan 订阅详情页 复制 Key,不是从 API Key 管理页创建!

路径:MiMo 后台 → 订阅套餐 → 查看密钥/复制 API Key

6. 选择上游协议

选择 Chat Completions(MiMo 使用 OpenAI 兼容格式)

7. 设置模型名称

填写模型名称,常用选项:

模型说明
mimo-v2.5-pro旗舰模型,推理能力强,消耗 credits 多(约 1:14 倍率)
mimo-v2.5基础模型,速度快,消耗 credits 少(约 1:10 倍率)
? 写小说、日常对话推荐用 mimo-v2.5 省 credits;复杂编码和推理用 mimo-v2.5-pro

8. 保存并启动

点击 "保存",然后从管理工具启动 Codex++

新建对话,发送消息测试是否正常响应

三、常见问题

❓ API Key 无效 / 401 鉴权失败
  • 确认 Key 是从 Token Plan 订阅详情复制的,不是 API Key 管理页
  • 确认 API 地址与 Key 类型匹配(tp 用 token-plan-cn 地址)
  • ✅ 重新从正确位置复制 Key
❓ Claude Code 报 400 错误:messages[1].role must be 'user' or 'assistant'
  • Claude Code 新版本(2.1.151+)加了消息格式验证,不兼容第三方 API
  • ✅ 回退版本:npm install -g @anthropic-ai/claude-code@2.1.149
  • ✅ VS Code 插件:卸载后从 VSIX 安装 2.1.149 版本
❓ MiMo 模型自称是 Claude / OpenAI
  • Codex++ 使用 Claude/OpenAI 的系统提示词,模型会误认身份
  • ✅ 正常现象,不影响功能,实际跑的就是 MiMo
❓ 长文输出中断 / Reconnecting
  • MiMo v2.5-pro 在长文本生成时可能因特殊字符中断
  • ✅ 在 CLAUDE.md 中加"避免输出未闭合的尖括号标签"
  • ✅ 被中断后发"继续"即可续写

四、省 Credits 技巧

  • 简单任务用 mimo-v2.5,复杂任务用 mimo-v2.5-pro
  • 定期使用 /compact 压缩上下文
  • 一个 Session 一个任务,不要在一个对话里做太多事
  • 写小说建议:大纲用 pro,正文用 v2.5
  • 凌晨 0:00-8:00 有 0.8 倍系数(Standard 套餐以上)