MiMoCode CLI 安装与配置 koalaapi

MiMoCode官网

https://mimo.xiaomi.com/coder

准备工作

开始前，请先确认你已经准备好以下内容：

Windows 电脑，可以打开 PowerShell 或 CMD。

已安装 Node.js 和 npm。

已在 https://koalaapi.com 创建 API Key。

已确认 API Key 所属分组中可用的模型 ID。

如果还没有创建 API Key，可以先参考 koalaapi 官方文档：[快速上手调用大模型API] https://koalaapi.apifox.cn/9063757m0

如果不确定电脑是否已经安装 Node.js 和 npm，可以在 PowerShell 或 CMD 中执行：

如果两条命令都能正常显示版本号，说明 Node.js 和 npm 已安装完成。

模型 ID 可以在 koalaapi 的模型市场 中查看。请确认你要填写的模型 ID，已经包含在当前 API Key 所属分组的可用模型中。

1. 安装 MiMoCode CLI

打开 PowerShell 或 CMD，执行下面的命令：

如果已经安装过 MiMoCode CLI，可以跳过这一步。

2. 启动 MiMoCode

打开 PowerShell 或 CMD，进入你的项目目录。

输入下面的命令 并回车：

首次启动时，MiMoCode 会提示是否信任当前工作区。

确认这是你自己的项目目录后，选择 “是的，我信任此目录” 并回车。

进入 MiMoCode 主界面后，说明启动成功。

3. 登录并添加自定义服务商

注意：MiMoCode 目前不支持通过 CC Switch 或 ccswitch 自动导入、切换 4sapi 配置。请按照下面的步骤，在 MiMoCode 的 /login 流程中手动添加 + Custom provider。

在 MiMoCode 输入框中 输入 /login，然后回车。

进入服务商列表后，使用键盘上下键或者鼠标滚轮找到 + Custom provider。

选中 + Custom provider 后按回车，开始添加 4sapi 的连接信息。

4. 填写 4sapi 连接信息

接下来会依次出现 6 个配置项。每填写完一项，都 按回车提交。

步骤	界面字段	示例填写	说明
1	`Provider id`	`koalaapi`	服务商 ID，用来在本地识别这组配置。
2	`Display name`	`koalaapi`	显示名称，建议和 `Provider id` 保持一致。
3	`Base URL`	`https://koalaapi.com/v1`	koalaapi 的接口地址。
4	`API key`	你的 API Key	填写在 koalaapi 后台创建的 API Key。
5	`First model id`	`claude-opus-4-8`	模型 ID，必须是当前 API Key 分组中可用的模型。
6	`First model name`	`claude-opus-4-8`	模型显示名称，通常和模型 ID 保持一致即可。

4.1 填写 Provider id

输入你喜欢的名字，然后回车。

4.2 填写 Display name

输入你喜欢的名字，然后回车。

4.3 填写 Base URL

输入下面的地址，然后回车：

https://koalaapi.com/v1

4.4 填写 API key

粘贴你在 koalaapi 后台创建的 API Key（密钥），然后回车。

API Key 属于敏感信息，请不要截图或发给他人。

4.5 填写 First model id

输入你要使用的模型 ID，例如：

claude-opus-4-8

这里的 模型 ID 必须来自创建 API Key 时所选分组中的可用模型。

如果不确定应该填哪个模型 ID，请回到 4sapi 模型市场 确认。不要把 服务商名称、模型显示名称或分组名称 填到这里。

4.6 填写 First model name

一般和上一步的 模型 ID 保持一致 即可，例如：

claude-opus-4-8

5. 选择模型并验证

6 个配置项全部填写完成后，会回到模型选择列表。

选择刚刚添加的模型，例如 claude-opus-4-8，然后回车。

回到 MiMoCode 主界面后，输入一个简单问题进行测试。

如果模型可以正常回复，说明 koalaapi 已配置完成。

常见问题

输入 `mimo` 后提示命令不存在

通常是 MiMoCode CLI 没有安装成功，或者 npm 全局命令目录没有加入环境变量。

可以 重新执行安装命令，安装完成后 关闭终端，再重新打开 PowerShell 或 CMD。

API Key 填写后无法使用

请检查 API Key 是否复制完整，并确认该 API Key 所属分组中包含你填写的 模型 ID。

可以使用 CC Switch 或 ccswitch 配置 MiMoCode 吗

目前不支持。MiMoCode 需要在 /login 中 手动添加 + Custom provider，不能直接复用 CC Switch 或 ccswitch 的配置。

模型没有响应或提示模型不存在

请重点检查以下 3 项：

Base URL 是否为 https://koalaapi.com/v1。

First model id 是否和 koalaapi 后台可用模型 ID 完全一致。

当前 API Key 是否有权限调用该模型。

MiMoCode CLI 安装与配置 koalaapi

MiMoCode官网#

准备工作#

1. 安装 MiMoCode CLI#

2. 启动 MiMoCode#

3. 登录并添加自定义服务商#

4. 填写 4sapi 连接信息#

4.1 填写 Provider id#

4.2 填写 Display name#

4.3 填写 Base URL#

4.4 填写 API key#

4.5 填写 First model id#

4.6 填写 First model name#

5. 选择模型并验证#

常见问题#

输入 mimo 后提示命令不存在#

API Key 填写后无法使用#

可以使用 CC Switch 或 ccswitch 配置 MiMoCode 吗#

模型没有响应或提示模型不存在#