MiMoCode免费API反向代理mimo-proxy

发表于 分类于 Waline： 阅读次数： 本文字数： 4.7k 阅读时长 ≈ 4 分钟
mimo-proxy 是一个 MiMoCode Free API 的反向代理，支持 OpenAI 和 Anthropic 格式调用。

简介

什么是 mimo-proxy ？

mimo-proxy 是一个轻量级的 MiMoCode Free API 反向代理工具，基于 Go 语言编写。它可以帮助用户将小米 MiMo Code 的免费 AI 模型（mimo-auto）以标准的 OpenAI 和 Anthropic 格式暴露出来，供各种第三方客户端调用。

小米发布的 MiMo Code 自带了限时免费的 MiMo-V2.5 模型通道，但仅限在 MiMo Code 内部使用。mimo-proxy 的作用就是将这个免费通道代理出来，让 Claude code、Codex、Cursor 等 AI 客户端也能白嫖这个免费模型。

主要特点

  • 双协议支持：同时支持 OpenAI 格式（/v1/chat/completions）和 Anthropic 格式（/v1/messages），兼容主流 AI 客户端
  • 流式响应：完整支持流式（stream）和非流式响应，实时输出生成内容
  • API Key 认证：可选的 API Key 认证机制，保护你的代理服务不被滥用
  • 自动刷新 JWT：内置 JWT 自动刷新机制，无需手动维护认证令牌
  • 思考过程支持：支持 reasoning_content 字段，完整保留模型的思考推理过程
  • 轻量高效：基于 Go 语言编译为单一二进制文件，无外部依赖，资源占用极低
  • 跨平台：支持 Linux、Windows、macOS，可从源码编译或直接下载 Release
  • 开源免费：基于 MIT 协议开源，可免费使用和修改

应用场景

  • 白嫖免费模型：通过代理将 MiMo Code 的免费 mimo-auto 模型暴露给其他客户端使用
  • 多客户端接入：Claude code、Codex、Cursor 等工具统一接入 MiMo 免费模型
  • 团队共享：部署在服务器上，团队成员通过 API Key 认证共享免费模型额度
  • 开发测试：开发者快速搭建本地 AI 接口测试环境，无需配置复杂的上游认证
  • API 格式转换：将小米 MiMo 的专有协议转换为标准 OpenAI/Anthropic 格式，降低接入门槛

mimo-proxy 是一个轻量级的 API 反向代理工具，让你的第三方客户端也能用上 MiMoCode 的免费模型。

构建镜像

如果你不想自己构建，可以跳过，直接阅读下一章节

Dockerfile

官方没有提供 Docker 镜像，所以老苏只能自己构建，Dockerfile 如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
FROM golang:1.26-alpine AS builder

WORKDIR /src

COPY go.mod go.sum ./
RUN go mod download

COPY . .
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags="-s -w" -o /out/mimo-proxy .

FROM alpine:3.20

RUN apk add --no-cache ca-certificates tzdata

WORKDIR /app

COPY --from=builder /out/mimo-proxy /usr/local/bin/mimo-proxy
COPY config.yaml /app/config.yaml

EXPOSE 5000

USER 65532:65532

ENTRYPOINT ["/usr/local/bin/mimo-proxy"]

构建和运行

构建镜像和容器运行的基本命令如下👇

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 下载代码
git clone https://github.com/myflavor/mimo-proxy.git
  
# 进入目录  
cd mimo-proxy
  
# 构建镜像
docker build -t wbsu2003/mimo-proxy:v1 .

# 运行容器
docker run -d \
  --restart unless-stopped \
  --name mimo-proxy \
  -p 5355:5000 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  wbsu2003/mimo-proxy:v1

准备

创建目录

1
2
3
4
5
# 新建文件夹 mimo-proxy
mkdir -p /volume1/docker/mimo-proxy

# 进入 mimo-proxy 目录
cd /volume1/docker/mimo-proxy

config.yaml

准备一个 config.yaml 文件，内容如下

1
2
3
4
5
6
7
8
# 监听端口 (默认: 5000)
port: 5000

# API Key 认证 (可选，留空则不需要认证)
api_key: ""

# 上游 API 地址 (默认: https://api.xiaomimimo.com)
# base_url: https://api.xiaomimimo.com
配置项 说明 默认值
port 监听端口 5000
api_key API Key 认证，留空则不需要认证 ""
base_url 上游 API 地址 https://api.xiaomimimo.com

配置说明：api_key 用于客户端认证，设置后客户端需要在请求头中携带 Authorization: Bearer <你的api_key>。如果留空，则不需要认证即可访问。

也可以直接用命令来创建

1
2
3
4
5
6
7
8
9
10
11
# 新建配置文件 config.yaml
cat > config.yaml << 'EOF'
# 监听端口 (默认: 5000)
port: 5000

# API Key 认证 (可选，留空则不需要认证)
api_key: ""

# 上游 API 地址 (默认: https://api.xiaomimimo.com)
# base_url: https://api.xiaomimimo.com
EOF

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 wbsu2003 ，翻页、下拉找到 wbsu2003/mimo-proxy，版本选择 latest。

卷

在 docker 文件夹中，创建一个新文件夹 mimo-proxy，将 config.yaml 放入当前目录

文件夹 装载路径 说明
docker/mimo-proxy/config.yaml /app/config.yaml 存放数据库和上传文件等

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
5355 5000

环境

可变 值
PORT 监听端口
MIMO_BASE_URL 上游 API 地址

如果保持默认，可以不做修改

命令行安装

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
# 一键启动
docker run -d \
  --name=mimo-proxy \
  --restart unless-stopped \
  -p 5355:5000 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  wbsu2003/mimo-proxy:latest

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
version: '3.8'

services:
  mimo-proxy:
    image: wbsu2003/mimo-proxy:latest
    container_name: mimo-proxy
    restart: unless-stopped
    ports:
      - "5355:5000"
    volumes:
      - ./config.yaml:/app/config.yaml:ro  # 配置文件只读挂载
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:5000/health"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 10s

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
# 将 docker-compose.yml 和 config.yaml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:5355/health 即可验证服务是否正常运行

可用端点

端点 方法 说明
/health GET 健康检查（不需要认证）
/v1/models GET 模型列表
/v1/chat/completions POST OpenAI 格式聊天
/v1/messages POST Anthropic 格式聊天

OpenAI 格式

1
2
3
4
5
6
7
8
9
curl -X POST http://localhost:5355/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-auto",
    "stream": true,
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Anthropic 格式

1
2
3
4
5
6
7
8
9
10
curl -X POST http://localhost:5355/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-auto",
    "max_tokens": 100,
    "stream": true,
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Claude Code

可以在 CC Switch中配置以下参数：

参数 值
API 地址 http://<群晖IP>:5355
模型名称 mimo-auto
API Key config.yaml 中设置的 api_key）

启动 Claude Code 可以看到模型是 mimo-auto

试着问个问题

注意事项

  1. 模型限制：目前仅支持 mimo-auto 模型，这是上游 MiMo API 的限制，无法使用其他模型名称
  2. 免费额度：MiMo Auto 的免费通道为限时免费，具体截止时间以小米官方公告为准
  3. 配置文件权限：建议将 config.yaml 以只读方式挂载（:ro），防止容器内意外修改
  4. 安全建议：如果代理服务暴露在公网，建议设置 api_key 进行认证保护

参考文档

myflavor/mimo-proxy: MiMoCode Free API 的反向代理，支持 OpenAI 和 Anthropic 格式
地址：https://github.com/myflavor/mimo-proxy

MiMo Code - 小米官方 AI 编程助手
地址：https://mimo.xiaomi.com/zh/mimocode

MiMo Code GitHub 仓库
地址：https://github.com/XiaomiMiMo/MiMo-Code