小米Mimo Code免费API获取及CCS接入教程

背景

小米近期推出了名为 Mimo Code 的 AI 编程工具。在该工具的 CLI 界面中，用户若选择 MiMo Auto 模式，可以限免且无限量地使用 mimo-v2.5 模型。这一举措为开发者提供了低成本甚至零成本体验先进 AI 编程能力的机会。

然而，为了将这一免费接口接入到更广泛的 AI 编程生态（如 Claude Code、CC GUI 等第三方工具），用户需要自行获取身份凭证（JWT Token）并配置 API 路由。由于该接口属于免费性质，其稳定性、限流策略及 Token 有效期存在不确定性，因此官方或社区分享了详细的配置教程，旨在帮助用户打通从获取 Token 到在第三方工具中调用的全链路。

核心内容

本教程详细拆解了将小米 Mimo Code 免费 API 接入 CC Switch (CCS) 及 Claude Code 等工具的具体操作步骤，主要分为获取凭证、验证接口、配置路由三个核心阶段。

1. 获取 JWT 令牌 (Token)

这是访问 API 的“临时身份证”，通过 Bootstrap 接口获取。

• 接口地址：https://api.xiaomimimo.com/api/free-ai/bootstrap
• 请求方式：POST
• Header：需设置 Content-Type: application/json
• Body：JSON 格式，包含 {"client": "test"}。其中 client 字段可随意填写字符串，作为设备标识符。
• 响应：返回 JSON 数据，其中的 jwt 字段值即为所需的 Token。
• 快速获取命令：

  curl -X POST 'https://api.xiaomimimo.com/api/free-ai/bootstrap' \
  -H 'Content-Type: application/json' \
  -d '{"client": "my-device-id"}'
  

2. 接口可用性测试

在配置软件前，建议先通过 curl 验证 Token 是否有效。

• 接口地址：https://api.xiaomimimo.com/api/free-ai/openai/chat
• 关键 Header：
  • Authorization: Bearer <YOUR_JWT_TOKEN>（替换为实际 Token）
  • X-Mimo-Source: mimocode-cli-free
• Body：

  {
    "model": "mimo-auto",
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下你自己"
      }
    ]
  }
  

• 成功标志：返回包含 content 字段的 JSON 数据。

3. CC Switch (CCS) 配置指南

这是接入第三方工具的关键步骤，配置错误会导致连接失败。

• 添加供应商：在 CCS 中添加新供应商，名称可自定义（如 mimo）。
• 填写 API Key：将第一步获取的 JWT Token 粘贴至 API Key 输入框。
• 关键设置（易错点）：
  1. 请求地址：必须开启“完整 URL”开关（绿色状态）。填入 https://api.xiaomimimo.com/api/free-ai/openai/chat。
     • 原因：该接口路径非标准 OpenAI 路径，必须强制 CCS 使用完整链接，禁止自动拼接 /v1/chat/completions。
  2. API 格式：选择 OpenAI Chat Completions (需开启路由)。
  3. 模型映射：填写 mimo-auto。
• 开启路由：
  1. 进入 CCS 设置，点击左上角开启路由功能。
  2. 在顶部【路由】栏中，确保路由总开关【开启】。
  3. 确保 Claude 选项【启用】。
• 保存并启用：保存配置后，在主界面找到 mimo 供应商并启用开关。

4. Claude Code 测试与安装

• MiMo Code 安装：
  • Mac/Linux：推荐 iTerm 或 VSCode Terminal，执行 curl -fsSL https://mimo.xiaomi.com/install | bash。
  • Windows：执行 npm install -g @mimo-ai/cli。
• 测试流程：
  1. 终端输入 claude 进入 Claude Code。
  2. 输入 model 确认当前模型。
  3. 选择 mimo-auto。
  4. 发送测试消息（如“你好 你是什么模型”）。
  • 注意：由于开启了路由，模型回复可能不会直接显示为 mimo，但应能正常交互。

5. 重要注意事项

• Token 有效期：免费接口获取的 JWT Token 有效期约为 1 小时。
• 故障排查：若 API 突然报错（如 401 Unauthorized），通常是因为 Token 过期。解决方法是重新执行第一步获取新 Token 并更新配置。
• 稳定性声明：该接口为免费接口，可能存在限流或不稳定情况，仅供学习和体验。

关键要点

• 非标准路径配置：在 CC Switch 中配置时，必须开启“完整 URL”开关，并手动填入 /api/free-ai/openai/chat 路径，严禁使用默认的 /v1/chat/completions 拼接逻辑。
• Token 时效性管理：JWT Token 仅有效期约 1 小时，用户需建立定期刷新 Token 的意识，否则会导致服务中断。
• 模型标识一致性：在 CCS 的模型映射及 API 请求 Body 中，模型名称必须统一使用 mimo-auto。
• 依赖工具链：教程主要面向使用 CC Switch (CCS) 作为中转层，进而调用 Claude Code 或 CC GUI 的高级用户，而非直接通过小米官方 App 使用。
• 环境推荐：对于 Mac/Linux 用户，推荐使用 iTerm 或 VSCode Terminal 以获得更佳的用户体验。

意义与影响

1. 降低 AI 编程门槛：通过提供限免且无量的 mimo-v2.5 模型访问权限，小米降低了开发者试用高端 AI 编程助手的经济门槛，有助于推广其 Mimo Code 生态。
2. 增强生态兼容性：教程详细指导如何将小米私有 API 接入通用的 CC Switch 及 Claude Code 等主流工具，打破了单一客户端的限制，提升了工具的灵活性和用户粘性。
3. 技术实践价值：对于开发者而言，此教程提供了处理非标准 OpenAI 兼容接口、JWT 认证管理以及 API 路由配置的实际案例，具有一定的技术参考意义。
4. 潜在风险与局限：由于接口免费且未明确长期支持计划，用户需承担 Token 过期、限流或服务中断的风险。这提示用户在生产环境中需谨慎依赖此类免费接口，更适合用于个人学习、原型开发或临时体验。