MiMo Code API密钥配置 — 小米终端编程Agent指南

MiMo Code（小米终端 AI 编程助手 / MiMoCode CLI）支持通过 /connect 连接第三方 LLM。APIMaster.ai 提供 OpenAI 兼容 API（https://apimaster.ai/v1），可在 MiMo Code 里添加 Custom provider，用自有 API Key 调用 模型广场 上的 Claude、GPT、DeepSeek 等模型，无需手改配置文件。

本篇涵盖： MiMo Code 安装 → mimo 启动 → /connect 连接向导 → Provider id / Base URL / API key 填写 → 添加 model id → 对话测试。

开始前请 获取 API Key。Key 只填在 MiMo Code 连接向导里，不要发到群聊或截图。

---

前置条件

1. 现代终端（推荐 WezTerm、Ghostty、VS Code Terminal 等，见 MiMo Code 安装文档）。
2. 已安装 MiMo Code CLI。
3. 已从 APIMaster 控制台 复制 API Key。

---

第 1 步：安装 MiMo Code

macOS / Linux（推荐）：

curl -fsSL https://mimo.xiaomi.com/install | bash

Windows：

npm install -g @mimo-ai/cli

详细说明见官方文档：安装与启动。

---

第 2 步：进入 MiMo Code

在终端执行：

mimo

进入 MiMo Code 交互界面后，输入 /connect（或输入 /con 后从命令列表选择 连接服务商），开始连接模型 Provider。

---

第 3 步：选择「其他服务商」

在 选择服务商 列表中，选择 其他服务商（不要选小米官方通道或 MiMo Auto 免费匿名通道，那些无法填入 APIMaster Key）。

随后在 Connect a provider 列表底部选择 + Custom provider（自定义 Provider）。

---

第 4 步：填写 Provider 信息（6 步向导）

向导会依次询问以下字段，请按表填写：

步骤	字段	填写内容
1/6	Provider id	apimaster（小写，可自定，用于内部标识）
2/6	Display name	apimaster 或 APIMaster.ai（显示在模型列表里的名称）
3/6	Base URL	https://apimaster.ai/v1（必须带 /v1）
4/6	API key	粘贴你的 APIMaster Key
5/6	First model id	先填一个常用模型，如 gpt-5.4 或 claude-sonnet-4-6（与 模型广场 的 model id 一致）

每步填完后按 Enter 提交；按 Esc 可取消当前步骤。

---

第 5 步：添加更多模型（可选）

向导完成后，可在 apimaster Provider 菜单里点 + Add model，继续添加其他 model id，例如：

• gpt-5.4、gpt-5.5
• claude-sonnet-4-6、claude-opus-4-8
• 等（以你账户实际开通为准）

在列表中选中要用的模型（例如 gpt-5.4）。需要切换 Provider 时可按 Connect provider ctrl+a。

---

第 6 步：发消息测试

1. 确认底部状态行显示当前模型，例如 Build · gpt-5.4。
2. 在输入框输入短句，例如：hello。
3. 若收到正常回复，说明 APIMaster Key 与 Base URL 配置成功。

---

常见问题

现象	处理
找不到 /connect	确认已在 mimo 交互界面内；输入 / 查看命令列表
MiMo Code 如何换 API Key	重新执行 /connect，或进入 apimaster Provider 设置更新
401 / Invalid API Key	检查 Key 是否完整、未过期；到控制台重新复制
Base URL 报错	必须是 https://apimaster.ai/v1，不要漏 /v1
模型 id 填什么	与 模型广场 一致，如 gpt-5.4、claude-sonnet-4-6
模型无响应	确认 model id 与广场一致；用 API 连通性测试 排查
想改用官方 MiMo 通道	重新 /connect，选「小米」或 MiMo Auto；与 APIMaster 配置互不影响

---

相关链接

• Agent 教程总览 · OpenAI 兼容接入
• MiMo Code 安装与启动 · MiMo Code 连接模型