AI工具配置 12

OpenCode 接入小米 MiMo 完整指南

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 用户可以用官方脚本:

bash
curl -fsSL https://opencode.ai/install | bash

如果你已经安装了 Node.js 18 或更新版本,也可以用 npm:

bash
npm install -g opencode-ai

安装完成后运行 opencode -v,如果输出版本号就说明安装成功了。

配置

编辑或新建配置文件 opencode.json,路径取决于你的操作系统:

  • macOS / Linux:~/.config/opencode/opencode.json
  • Windows:用户目录\.config\opencode\opencode.json

把下面的内容复制进去,记得把 BASE_URLMIMO_API_KEY 替换成你自己的:

json
{
  "$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"

启动

配置完成后,进入你的项目目录,执行:

bash
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。

感谢阅读,如果这篇文章对你有帮助,欢迎继续浏览同栏目内容。

返回 AI工具配置