mimo2codex：一款让 OpenAI Codex 无缝接入 MiMo / DeepSeek 的本地代理

如果你已经在用 OpenAI Codex CLI 或 Codex 桌面端，但希望换成小米 MiMo 或 DeepSeek，又不想折腾配置——mimo2codex 或许正是你要的工具。

一、它解决什么问题

OpenAI Codex 的官方文档只支持小米 MiMo 的 wire_api = "chat" 模式。但更新版本的 Codex 对此直接报错，官方解决办法是回退 Codex 版本——代价是丢失宠物功能、新桌面端支持以及工具修复。

mimo2codex 的思路很直接：不修改 Codex，也不修改 MiMo，在中间加一层协议翻译。

具体来说：Codex 使用的是 Responses API，MiMo（以及大多数国内模型）只支持 Chat Completions。mimo2codex 实时做双向翻译，Codex 以为自己在和原生后端通信，实际上请求已经被翻译发往 MiMo 或 DeepSeek。

二、mimo2codex 是什么

一句话概括：

本地 HTTP 代理，让 OpenAI Codex CLI / 桌面端接入小米 MiMo、DeepSeek，以及任意 OpenAI Chat Completions 兼容模型。

三种安装方式：

# 方式1：npm 一行安装 npm install -g mimo2codex # 方式2：Linux/macOS curl curl -fsSL https://raw.githubusercontent.com/7as0nch/mimo2codex/main/scripts/install.sh | bash # 方式3：Windows PowerShell irm https://raw.githubusercontent.com/7as0nch/mimo2codex/main/scripts/install.ps1 | iex

桌面端（macOS / Windows）也有安装包，下载后后台运行，开机自启，无需终端操作。

三、核心功能一览

支持的模型

Provider	模型
MiMo	mimo-v2.5-pro、mimo-v2-flash
DeepSeek	deepseek-v4-pro（默认）、deepseek-v4-flash、deepseek-chat、deepseek-reasoner
通用	Qwen / GLM / Kimi / Ollama / vLLM / LM Studio 等（配置 providers.json）

核心能力

多 provider 路由：一个进程同时支持 MiMo + DeepSeek，根据请求中的 model 字段自动分发，互不干扰。

协议实时翻译：Responses API ↔ Chat Completions 双向翻译，支持 streaming SSE 返回。

Tool calling：function tools、parallel calls、local_shell、MCP namespace 全部支持。

Web search：Codex 的 web_search / web_search_preview 自动翻译为 MiMo 原生 web_search builtin。如果账号未开通插件，自动 strip 后重试并记住结果，后续请求直接跳过，无需配置。

Vision（多模态）：只有 mimo-v2.5 / mimo-v2-omni 支持；非 vision 模型自动 strip 图片并加占位符。

Reasoning passthrough：MiMo 的 reasoning_content 多轮正确回传。加 --no-reasoning 参数可以隐藏 terminal 输出（推理过程不显示），但跨轮次传递仍然保留。

Admin Web UI：浏览器访问 http://127.0.0.1:8788/admin/，查看[1] dashboard、聊天记录、模型目录、设置。

SQLite 持久化：聊天记录、token 统计、模型别名、运行时设置全部存入 ~/.mimo2codex/data.db。

Codex Enable：Web UI 内一键写入 ~/.codex/auth.json + config.toml，无需手动编辑配置文件。

mimoskill：Python 脚本（stdlib only，无外部依赖），补充 MiMo 原生不支持的能力——OCR、图像生成、宠物生成。

四、如何使用

基础配置

export MIMO_API_KEY=sk-xxx...xxx # 小米 MiMo key export DS_API_KEY=sk-xxx...xxx # DeepSeek key（可选） mimo2codex

启动后访问 http://127.0.0.1:8788/admin/，点击[2] Codex Enable，一键完成认证配置，Codex 即可使用。

配置通用 provider

编辑 ~/.mimo2codex/providers.json：

{ "providers": [ { "id": "qwen", "displayName": "Qwen (DashScope)", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "envKey": "QWEN_API_KEY", "defaultModel": "qwen3-max" } ] }

然后：

QWEN_API_KEY=*** mimo2codex --model qwen

五、技术原理

请求流程

Codex CLI → mimo2codex (:8788) → selectProvider（按 model 字段匹配 provider） → reqToChat（Responses API → Chat Completions） → 上游 HTTP 调用（MiMo / DeepSeek / 通用 provider） → respToResponses / streamToSSE（Chat Completions → Responses API SSE） → Codex

关键技术细节

per-request 路由：请求中 model 字段匹配到哪个 provider 的目录，就发往哪个 provider，不匹配才 fallback 到默认 provider。

parallel_tool_calls 自动开启：MiMo 默认不开启 parallel tool calls，mimo2codex 强制开启，减少 round-trips，提升工具调用效率。

context overflow 友好处理：上游返回 400（context window exceeded）时，自动重写为双语气提示，引导用户使用 Codex 的 /compact 命令压缩上下文。

MiMo key 自动路由：tp-* 前缀的 key 路由到 token-plan 主机，sk-* 前缀路由到按量付费主机，透明分流。

Admin UI 配置优先级：CLI flag / 环境变量 → Admin DB 设置 → 默认值。Web UI 修改设置无需重启，即时生效。

六、同类产品对比

项目	支持的 Provider	协议翻译	Admin UI	特色
mimo2codex	MiMo、DeepSeek、Qwen、GLM、Kimi、Ollama 等	Responses ↔ Chat Completions	✅ Web UI + SQLite	MiMo 深度适配，Codex Enable 一键配置
OpenRouter	广泛	—	—	在线服务，无需本地部署
claude-code-router	Claude 系	Anthropic ↔ OpenAI	—	面向 Claude

mimo2codex 的差异化在于：专门针对 小米 MiMo 做了深度适配（web_search 转发、parallel_tool_calls 强制开启、reasoning_content 多轮回传、key 自动路由），同时通过 generic provider 机制支持任意 OpenAI Chat Completions 兼容模型。

七、注意事项

/hatch 宠物生成无法通过代理实现，需要 mimoskill 补充
DeepSeek deepseek-chat / deepseek-reasoner 模型已 deprecated（2026-07-24），alias 为 v4-flash
Admin UI 只读环境变量，API key 必须通过环境变量注入，不要在 UI 里填 key
代理运行在 127.0.0.1，不暴露到外网，本地安全使用

相关链接：