Claude Code + 小米 MiMo API 配置教程
为什么用 MiMo 驱动 Claude Code?
Claude Code 是 Anthropic 推出的终端 AI 编程工具,默认使用 Claude 模型。它的交互模式和能力已经得到了大量开发者的认可。但有一个现实问题:Claude Opus 模型的 API 价格较高,对于高频使用的开发者来说,每月数百美元的 API 费用是一笔不小的开支。
通过配置 MiMo API 作为 Claude Code 的后端推理引擎,你可以在保留 Claude Code 优秀交互体验的同时,大幅降低使用成本:
- 大幅降低成本:MiMo API 定价仅为 Claude Opus 的 1/10 左右。以每月处理 500 万输入 token + 100 万输出 token 为例,使用 Claude Opus 费用约 $150,而使用 MiMo-V2.5-Pro 仅需 $8,节省超过 90%
- 享受 MiMo 的推理能力:MiMo-V2.5-Pro 在 Agent 场景经过深度优化,编程能力突出。在 SWE-Bench Verified 上取得了 41.6% 的 pass@1 成绩,接近 Claude 3.5 Sonnet 的水平,但成本仅为后者的几分之一
- 统一 API 管理:通过 MiMo Token Plan 集中管理 AI 编程的 API 费用,所有主流编程工具(Claude Code、Cursor、Cline、Zed)均可共用同一个 API Key 和配额
- 超长上下文:MiMo-V2.5-Pro 支持 1M token 上下文,比 Claude 原生模型的 200K 上下文高出 5 倍。这意味着你可以将整个大型代码库一次性载入上下文,进行全面的分析和重构
- 不受限的地理可用性:对于部分地区开发者而言,直接使用 Claude API 可能面临服务可用性问题。通过 MiMo API 作为中转,可以获得更稳定的连接和更低的延迟
前置条件
在开始配置之前,请确保你已准备好以下两项:
- Claude Code 已安装:访问 claude.ai/code 获取安装命令并完成安装。Claude Code 支持 macOS、Linux 和 Windows(WSL)。安装后运行
claude --version确认版本号 - 小米 MiMo 平台账号:在 platform.xiaomimimo.com 注册账号。注册过程简单,支持邮箱注册和 Google/GitHub 第三方登录。新用户注册即送 $2 试用额度,足完成整套配置验证
此外,建议你对 MiMo 的模型家族有一个基本了解,以便后续选择最合适的模型。可以参考我们的 MiMo-V2.5 系列全面解读 → 了解各模型的定位和特点。
第一步:获取 MiMo API Key
将 MiMo API 配置为 Claude Code 后端的核心是获取一个有效的 MiMo API Key。操作步骤如下:
- 访问 platform.xiaomimimo.com 并登录你的账号
- 在左侧导航栏中找到「API Keys」页面
- 点击「Create New Key」按钮,系统会生成一个以
mimo_开头的 API Key - 立即复制并安全保存该 Key(关闭页面后将无法再次查看完整 Key)
💡 关于 Token Plan 订阅: 如果你计划长期使用 MiMo API 进行 AI 编程,强烈建议订阅 MiMo Token Plan。Token Plan 是小米面向 AI 编程场景推出的专属订阅方案,相比按量计费可节省 30-50% 的费用。订阅后,你可以在 Token Plan 控制台查看每日消耗、设置预算告警和查看使用趋势。
第二步:配置 Claude Code 使用 MiMo API
Claude Code 支持通过 ANTHROPIC_BASE_URL 环境变量指定自定义 API 端点。由于 MiMo API 兼容 OpenAI 格式,而 Claude Code 使用 Anthropic 格式的客户端,小米专门提供了兼容层来桥接两者。配置方式如下:
方法一:创建启动脚本(推荐)
创建一个启动脚本,将以下内容保存为 claude-mimo.sh:
#!/bin/bash
# 设置 MiMo API 作为 Claude Code 后端
export ANTHROPIC_BASE_URL="https://api.xiaomimimo.com/v1"
export ANTHROPIC_API_KEY="your-mimo-api-key-here"
# 启动 Claude Code
claude
赋予执行权限后即可使用:chmod +x claude-mimo.sh && ./claude-mimo.sh。
方法二:单行命令
如果你不想创建脚本,也可以直接通过环境变量前缀启动:
ANTHROPIC_BASE_URL=https://api.xiaomimimo.com/v1 \
ANTHROPIC_API_KEY=your-key \
claude
方法三:持久化到 shell 配置文件
如果你希望长期使用 MiMo API 作为默认后端,可以将配置写入 shell 配置文件(如 ~/.zshrc 或 ~/.bashrc):
export ANTHROPIC_BASE_URL="https://api.xiaomimimo.com/v1"
export ANTHROPIC_API_KEY="your-mimo-api-key-here"
这样每次打开终端时,配置自动生效。
第三步:配置模型选择
Claude Code 默认使用 Claude 模型名,但你可以通过 CLAUDE_MODEL 环境变量指定要用的 MiMo 模型。小米的 API 网关会自动将请求路由到对应的模型实例:
export CLAUDE_MODEL="mimo-v2.5-pro"
推荐的 MiMo 模型选择如下,你可以根据任务类型灵活切换:
| 用途 | 推荐模型 | 特点 |
|---|---|---|
| 日常编程(性价比最优) | mimo-v2-flash | 高速推理,成本最低,适合简单查询和代码补全 |
| 复杂任务(重构、架构分析) | mimo-v2.5-pro | 最强 Agent 能力,1M 上下文,支持深度推理 |
| 代码审查 | mimo-v2.5-pro | 深度推理能力使代码审查更为精准,能发现潜在的安全漏洞和性能问题 |
| 多模态任务 | mimo-v2.5-omni | 支持图像和代码截图的理解,适合 UI 开发和设计稿转代码场景 |
你也可以不设置 CLAUDE_MODEL,留空让 Claude Code 使用默认模型名,小米 API 网关会自动映射到 MiMo-V2.5-Pro。
第四步:验证配置
完成上述配置后,启动 Claude Code 并验证配置是否正确:
ANTHROPIC_BASE_URL=https://api.xiaomimimo.com/v1 \
ANTHROPIC_API_KEY=your-key \
CLAUDE_MODEL=mimo-v2.5-pro \
claude
启动后,尝试运行以下命令:
/ask "你当前使用的模型是什么?请简要描述你的能力范围"
如果 Claude Code 正常响应并显示出 MiMo 模型的能力特征(如 1M 上下文、MoE 架构、Agent 优化等),说明配置成功。你也可以通过编程任务来进一步验证:
/edit "在当前目录创建一个 Python 脚本,实现斐波那契数列的两种算法:递归和动态规划"
如果 MiMo Code 正确理解并生成了完整的代码,证明配置生效且模型运行正常。
第五步:优化建议
为了让 MiMo + Claude Code 的组合发挥最大价值,以下是一些实用的优化建议:
- 使用 Token Plan 订阅:面向 AI 编程场景的专属方案,性价比更高。Token Plan 提供多种档位选择(入门版 $9.9/月、专业版 $29.9/月、企业版 $99.9/月),用量越大优惠越明显。所有主流编程工具(Claude Code、Cursor、Cline、Zed)均可共用配额
- 按任务切换模型:简单代码补全和查询用
mimo-v2-flash(高速低延迟),复杂重构和架构分析用mimo-v2.5-pro(深度推理)。你可以通过 Shell alias 快速切换,或在 Claude Code 中通过/model命令动态切换 - 配合 MiMo Code 使用:Claude Code 和 MiMo Code 各有特色——Claude Code 在交互体验上更成熟,而 MiMo Code 在多智能体切换和持久化记忆上更具优势。两者可以互补,按需求灵活选择
- 设置预算告警:在 MiMo 平台控制台中设置月度预算上限和使用量告警,避免意外的 API 费用超支
- 利用缓存减少重复调用:MiMo API 提供了语义缓存功能,相同的请求(如重复的代码审查)会命中缓存,不计费且响应时间降至毫秒级
通过以上优化,大多数个人开发者每月仅需花费 10-40 元人民币即可获得高质量的 AI 编程辅助体验——这远低于直接使用 Claude Pro 订阅的费用。
性价比对比
| 方案 | 输入 (1M tokens) | 输出 (1M tokens) | 月均开销估算 |
|---|---|---|---|
| Claude Opus(原生) | $15 | $75 | $200-500 |
| Claude Sonnet(原生) | $3 | $15 | $50-150 |
| MiMo-V2.5-Pro | $1 | $3 | $10-40 |
| MiMo-V2-Flash | $0.50 | $1.50 | $5-20 |
也可以直接使用小米官方的 AI 编程智能体:了解 MiMo Code → 或 MiMo Code 快速上手 →
🖥️ 推荐 GPU 算力平台
以下平台可用于部署 MiMo 模型推理与微调,新用户注册均有免费额度。