OpenCode 接入小米 MiMo 完整指南
OpenCode 是一款 AI 编程助手,支持通过 OpenAI 兼容协议接入小米 MiMo 大模型。本文介绍如何配置 OpenCode,让你在命令行或 VS Code 中直接调用 MiMo 的能力。
两种付费方式
接入 MiMo 之前,你需要先确定使用哪种付费方式:
按量付费 API 按实际调用量计费,适合轻度使用或想先试试水的场景。API Key 以 sk- 开头,Base URL 为 https://api.xiaomimimo.com/v1。前往小米 MiMo 开放平台的 API Keys 页面即可创建。
Token Plan 是固定订阅费、按套餐限量调用的模式,适合稳定使用的团队或个人。API Key 以 tp- 开头,订阅成功后在订阅管理页面获取专属的 Base URL 和 API Key。Token Plan 提供三个区域可选:
- 中国:
https://token-plan-cn.xiaomimimo.com/v1 - 新加坡:
https://token-plan-sgp.xiaomimimo.com/v1 - 欧洲:
https://token-plan-ams.xiaomimimo.com/v1
需要注意的是,OpenCode 在 Anthropic 协议下使用 MiMo 时,由于包含工具调用的 assistant 消息中缺少 reasoning_content 字段,API 会返回 400 错误。这是当前的协议限制,使用时需要留意。
CLI 方式接入
安装
OpenCode CLI 有两种安装方式,选一种即可。
macOS 或 Linux 用户可以用官方脚本:
curl -fsSL https://opencode.ai/install | bash
如果你已经安装了 Node.js 18 或更新版本,也可以用 npm:
npm install -g opencode-ai
安装完成后运行 opencode -v,如果输出版本号就说明安装成功了。
配置
编辑或新建配置文件 opencode.json,路径取决于你的操作系统:
- macOS / Linux:
~/.config/opencode/opencode.json - Windows:
用户目录\.config\opencode\opencode.json
把下面的内容复制进去,记得把 BASE_URL 和 MIMO_API_KEY 替换成你自己的:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"mimo": {
"npm": "@ai-sdk/openai-compatible",
"name": "MiMo",
"options": {
"baseURL": "BASE_URL",
"apiKey": "MIMO_API_KEY"
},
"models": {
"mimo-v2.5-pro": {
"name": "mimo-v2.5-pro",
"limit": {
"context": 1048576,
"output": 131072
},
"modalities": {
"input": ["text"],
"output": ["text"]
}
},
"mimo-v2.5": {
"name": "mimo-v2.5",
"limit": {
"context": 1048576,
"output": 131072
},
"modalities": {
"input": ["text", "image"],
"output": ["text"]
}
}
}
}
}
}
配置中有两个模型可选:
- mimo-v2.5-pro:纯文本模型,只接受文本输入
- mimo-v2.5:支持图片理解,输入模态包含 text 和 image
两个模型的上下文窗口都是 1048576 tokens,输出上限 131072 tokens。如果你需要图片理解能力,确保使用的模型配置中 modalities.input 包含 "image"。
启动
配置完成后,进入你的项目目录,执行:
opencode
启动后输入 /models 可以查看和切换可用模型。
IDE 插件方式接入
安装插件
在 VS Code 扩展市场搜索 "opencode" 并安装。
配置供应商
安装完成后有两种配置方式。
预定义供应商(推荐):在输入框输入 /connect,搜索 "Xiaomi",选择对应的 Provider,填入 API Key 就行了。如果你用的是 Token Plan,需要选择与订阅管理页面展示的 Base URL 对应的 Provider:
https://token-plan-cn.xiaomimimo.com/*→ Xiaomi Token Plan (China)https://token-plan-sgp.xiaomimimo.com/*→ Xiaomi Token Plan (Singapore)https://token-plan-ams.xiaomimimo.com/*→ Xiaomi Token Plan (Europe)
自定义供应商:如果预定义供应商不满足需求,可以参考 CLI 配置的方式,在配置文件中手动添加 provider 信息。
常见问题
Windows 安装时提示找不到平台对应的包
报错信息类似:It seems that your package manager failed to install the right version of the opencode CLI for your platform...
解决方法:按照提示执行 npm install -g opencode-windows-x64 即可。
Windows VS Code 中启动报错"禁止运行脚本"
报错信息类似:opencode : 无法加载文件 ... 因为在此系统上禁止运行脚本
解决方法:把 VS Code 的默认终端类型改为 Git Bash。