- 适用对象
- 想快速了解工具定位、核心功能和上手路径的中文用户
- 核对日期
- 2026-11-08
本页目录
本指南综合了 10 篇公众号实测与技术教程(2026-06-10 ~ 10-29)。文中的 [1]~[10] 对应文末「参考原文」,序号与 00_清单.md 一致。每张图下方注明出处与对应文章。素材之间说法不一致、早期版本踩坑或容易报错的地方,均用 ⚠️ 明确标出。
公众号素材集中在 2026 年 6 月小米发布 MiMo Code 前后的集中实测,以及 10 月稳定版的使用经验。指南补充了小米开放平台开发者文档、MiMo CLI 规范与开源模型接入标准,以 [官1]~[官6] 标注,查阅日期 2026-11-08。
一、定位:它是什么,适合谁
MiMo Code 是小米(Xiaomi)在 2026 年 6 月推出的自主 AI 编程 Agent 命令行工具,终端命令为 mimo [1][2][6]。
它在交互架构和终端体验上借鉴了国际主流的 Coding Agent 范式,但针对国内开发者的网络环境、国内主流模型服务商以及小米自身大模型生态做了深度优化 [1][2]。它直接运行在本地终端内,能够用自然语言理解开发者的意图,自动浏览本地代码库、增删改查文件、执行编译测试命令,并完成从需求到代码落地的全流程自动化 [1][6]。
图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》
1. 核心定位与特色
极速轻量:纯 Node.js 驱动的终端工具,启动时间通常仅需 1~2 秒,占用系统内存极低 [8]。
出厂自带免费额度:通过小米账号登录小米开放平台,官方直接赠送高额免费调用 Token(如每月 100 万 Token),零门槛起步 [4][6]。
极致开放的模型路由:内置国内主流提供商(DeepSeek、硅基流动、智谱等)一键切换,并支持完全开放的
Custom Provider自定义接口配置 [1][3][6]。开箱即用的自动化文件处理:除了常规编程,它还非常擅长通过自然语言批量处理日常文本、日志与文件重命名任务 [5]。
2. 和同类 AI 编码工具怎么比
| 维度 | 小米 MiMo Code | Claude Code | OpenCode | GitHub Copilot |
|---|---|---|---|---|
| 网络环境依赖 | 原生国内直连,无需任何网络加速 [1][2] | 依赖海外网络环境,海外账号易风控 | 支持配置国内中转 | 需稳定访问 GitHub 云端服务 |
| 免费起步成本 | 绑定小米账号送百万 Token,起步零花费 [6] | 需订阅 Pro 席位或绑定海外信用卡 | 本地开源,但需自备模型 Key | 需按月订阅付费席位 |
| 自定义模型接入 | 极简,交互式向导直接填 Base URL 与 Key [3] | 需通过特殊中转或环境变量 | 需编辑复杂的 json 配置文件 | 仅支持其内部集成的模型体系 |
| 系统侵入性 | 极低,单个 npm 全局包,随时一键卸载 [5] | 较深,写入较多全局凭据与规则 | 较轻量,终端全开源 | 深度集成于 IDE 宿主环境 |
适合谁:
初学 AI 编程的开发者与小白:不想折腾复杂的海外信用卡支付与代理网络,只想在终端里免费蹭高品质模型做日常编程的人 [2][4]。
日常全栈程序员与运维:需要一个反应迅捷、开箱即用,能随时帮自己写脚本、查日志、批量改文件的终端副驾驶 [5][8]。
国内多模型中转用户:手头有大量的 DeepSeek、硅基流动或本地 Ollama Key,希望有一个漂亮的国产终端 Agent 统一调度它们的人 [1][3]。
不适合谁:
极度抗拒命令行终端、一定要在纯图形界面(GUI)窗口或特定商业 IDE 内使用的人 [4]。
需要多智能体复杂画布编排、音画多模态合成的重度生产级工作流(此时可参考 Antigravity 或专属工作流系统)[1]。
二、准备与安装
0. 先选路线:你属于哪种情况
| 你的情况 | 推荐安装方式 | 核心步骤 |
|---|---|---|
| Windows 10/11 开发者(日常开发) | npm 全局安装 | 看第 1、2 步(注意配置环境变量) |
| macOS / Linux 开发者 | curl 一键脚本或 npm 安装 | 看第 1、3 步 |
| 手头有 DeepSeek / 硅基流动等第三方 Key | 安装后直接添加 Custom Provider | 看第 2 步 → 第四节「2. 接入第三方模型」 |
1. 账号与免费额度
小米开放平台账号:启动后选择小米官方服务时,系统会引导唤起浏览器进入小米开放平台进行授权登录 [3][8]:
图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
免费额度政策:绑定小米账号后,官方会向开发者账户发放免费调用额度(测试期间多为每月 100 万 Token,主要覆盖 MiMo-Coder 与开源轻量模型)[4][6]。
第三方与本地模型:如果你切走官方服务、使用自己的 DeepSeek 或本地 Ollama,则完全不消耗小米额度,只扣对应平台的自有额度 [1][3]。
2. Windows 环境安装(npm 方式)
在 Windows 系统下,推荐使用 Node.js 的包管理器全局安装 [3]:
前置要求
已安装 Node.js(推荐 Node 18 或 20 LTS 版本)。可在终端输入
node -v验证 [4]。
安装命令
以管理员身份打开 PowerShell 或 Windows Terminal:
npm install -g @xiaomi/mimo-code图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
⚠️ 高频避坑:安装完提示
'mimo' 不是内部或外部命令图 4 mimo不是内部命令 图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
这是因为 npm 的全局二进制路径未加入系统的 PATH 环境变量。 解决方法:在终端运行
npm config get prefix获取全局安装路径(通常为C:\Users\用户名\AppData\Roaming\npm),将其复制并添加到系统「环境变量 → 用户变量 → Path」中,重启终端即可 [3][8]。
3. macOS / Linux 环境安装(一键脚本方式)
在 macOS 或 Linux 服务器上,可以使用官方提供的轻量安装脚本 [5]:
# 运行官方快速安装脚本
curl -fsSL https://mimo.mi.com/install.sh | bash图源:[5] 好用斋《小米AI编程助手MiMo Code:安装、使用与卸载》
脚本会自动检测系统架构、配置可执行权限并软链接到 /usr/local/bin/mimo。
4. 首次启动与目录信任
在任意空文件夹或项目根目录中输入:
mimo首次运行进入某个目录时,MiMo Code 会出于系统安全性考虑弹出工作目录信任提示 [3]:
图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
选择「Yes, I trust this directory(信任此目录)」后,即可正式进入主界面:
图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
5. 官方账号登录授权
在终端中输入斜杠命令:
/auth login图源:[8] 四两同学的小院《MiMo Code 上手实录:17秒安装,30分钟跑通,第一个坑居然在官方文档里》
终端会输出一个授权网址并自动在默认浏览器中打开。点击「同意授权」后,终端会即时显示 Login successfully [3][8]。
6. 更新与彻底卸载
检查与更新:
bashnpm update -g @xiaomi/mimo-code彻底卸载: 若想清理工具与本地缓存,执行以下两条命令 [3][5]:
bash# 卸载全局二进制包 npm uninstall -g @xiaomi/mimo-code # 删除本地配置缓存(Windows) rmdir /s /q "$env:USERPROFILE\.mimo" # 删除本地配置缓存(macOS/Linux) rm -rf ~/.mimo
图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
三、上手流程:从零到第一个完整项目
下面演示如何使用 MiMo Code,通过纯自然语言从零生成并部署一个可交互的贪吃蛇网页小游戏。
第一步:初始化项目指令
在终端工作目录中,键入:
/init图源:[8] 四两同学的小院《MiMo Code 上手实录:17秒安装,30分钟跑通,第一个坑居然在官方文档里》
MiMo Code 会在当前目录自动生成 AGENTS.md(或 MIMO.md)项目规则描述文件,记录该项目的技术栈与规范要求 [8]。
第二步:下达开发指令
在输入提示符后直接输入自然语言指令:
"帮我在当前目录开发一个经典的复古风贪吃蛇网页游戏。要求:
单个
index.html包含 HTML、CSS 和原生 JavaScript,无需外部 npm 依赖;支持键盘上下左右键及 WASD 控制;
右侧显示实时计分板、历史最高分纪录(使用 LocalStorage 持久化);
界面采用深色暗黑风格,带有吃食物粒子动效。"
第三步:审查 Agent 代码生成与落盘
MiMo Code 会在终端中展示思维链拆解,并调用内置写文件工具:
终端会高亮展示即将创建的
index.html内容;如果你开启了确认机制,输入
y即可确认写入硬盘 [1][6]。
第四步:测试与快速微调
在本地浏览器中双击打开 index.html 进行体验。如果想改动细节,无需自己动手写代码,直接在 MiMo 终端中继续说话:
"蛇移动的速度太慢了,请将初始步长速度提升 30%,并在撞墙死亡时让屏幕边缘闪烁红色警示动效。"
MiMo 会自动读取现有的 index.html,定位相关逻辑并生成精确补丁,完成增量更新 [1]。
四、核心功能与进阶
1. 斜杠命令系统速查
在 MiMo 交互界面中,随时输入 / 即可展开命令菜单 [1]:
图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》
| 斜杠命令 | 核心功能 | 典型场景 |
|---|---|---|
/provider | 打开提供商切换菜单 [1][3] | 在官方小米服务与 DeepSeek、自建模型之间快速切换 |
/model | 切换当前激活的具体模型 ID [1] | 从轻量 7B 模型切换为高智商 70B 模型 |
/auth | 管理登录授权(login / logout / status)[8] | 首次绑定账号或切换开发者身份 |
/init | 扫描工作区并生成规则文档 [8] | 新项目启动时建立上下文基准 |
/clear | 清理当前轮次的终端对话历史 | 上下文占用过大时重置记忆窗口 |
/help | 打开内置命令速查手册与快捷键 | 快速查看操作帮助 |
2. 重点:接入第三方模型与 API Key 配置
MiMo Code 拥有极度友好的第三方模型配置体验,既支持交互式向导,也支持直接编辑 JSON 配置文件 [1][3][6]。
(1)交互式切换与搜索内置服务商
在终端输入 /provider,界面会列出当前支持的服务商列表 [1]:
图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》
输入关键字即可模糊搜索对应平台(如搜索 DeepSeek)[1]:
图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》
选中服务商后,终端会提示你输入该平台的 API Key,并自动列出该平台下的模型列表供你选择:
图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》
(2)配置 Custom Provider(自定义接口)
如果你的模型中转平台不在预置列表里(例如自建 OneAPI、NewAPI、硅基流动或本地 Ollama),直接选择 Custom Provider 入口 [3]:
图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》
终端会引导你依次输入:
Provider Name:自定义服务商标识(如
My-DeepSeek)。API Base URL:接口地址(注意必须包含完整协议,通常以
/v1结尾,如https://api.siliconflow.cn/v1)。API Key:你的访问密钥。
Default Model:默认模型名(如
deepseek-ai/DeepSeek-V3)。
(3)接入海外模型(如 Claude / GPT)
你甚至可以通过兼容中转将 Claude 模型挂接进 MiMo Code 运行 [6]:
图源:[6] 一灯架构《免费百万 Token + 全流程自动化,MiMo Code 真香实测》
(4)底层配置文件直接编辑
所有通过界面配置的信息都会保存在用户主目录下的 ~/.mimo/config.json 中。高级用户可以直接用编辑器打开修改 [3][6]:
{
"active_provider": "siliconflow",
"providers": {
"mimo_official": {
"type": "official",
"token": "oauth_token_here"
},
"siliconflow": {
"type": "openai_compatible",
"base_url": "https://api.siliconflow.cn/v1",
"api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"models": [
"deepseek-ai/DeepSeek-V3",
"deepseek-ai/DeepSeek-R1"
]
},
"ollama_local": {
"type": "openai_compatible",
"base_url": "http://localhost:11434/v1",
"api_key": "ollama",
"models": [
"qwen2.5-coder:7b"
]
}
}
}3. 自然语言非代码任务:批量处理文件与自动化运维
MiMo Code 不仅可以写代码,对于日常办公与系统运维场景同样极具杀伤力 [5]:
例如处理混乱命名的图片或日志文件,直接在终端中下达指令:
"将当前目录下所有的截图文件按其创建时间顺序重命名,格式为
2026-11-08-序号.png,并生成一份改名前后对照表的 Markdown 文档。"
图源:[5] 好用斋《小米AI编程助手MiMo Code:安装、使用与卸载》
MiMo 会自动调用系统 Shell 扫描文件元数据,生成重命名脚本并批量完成执行,极其省心 [5]。
五、避坑与注意(⚠️ 关键避坑)
1. ⚠️ 自定义模型名称拼写错误导致死锁
报错现象:添加完 Custom Provider 后,提问时终端抛出
Model 'xxx' does not exist on provider错误 [10]:
图源:[10] 星球ai创作《我把Claude Code换成了MiMo Code》
原因与排查:很多第三方平台(如硅基流动)的模型 ID 是带有厂商前缀的(如
deepseek-ai/DeepSeek-V3),如果配置时只写了DeepSeek-V3,接口就会返回 404 模型未找到。解决办法:核对服务商后台的模型完整技术名称,重新运行
/provider更新或直接在~/.mimo/config.json中修正 [10]。
2. ⚠️ Windows 环境下的 PATH 环境变量丢失
现象:刚装完能用,第二天开新终端却提示
'mimo' 不是内部或外部命令[3]。原因:部分安全软件或终端环境在重启后重置了用户级 PATH 路径。
避坑建议:务必确认
npm config get prefix对应的路径被永久写进了系统的「系统环境变量」而非临时会话中 [3][8]。
3. ⚠️ 官方文档早期的脚本下载链接变更
问题:部分 6 月初的早期教程(如素材 [8][9])引用的测试版 GitHub Raw 安装脚本地址后来经过了重构迁移。
核实结论:一律以小米官方最新域名
mimo.mi.com或官方 npm 镜像包@xiaomi/mimo-code为准,切勿下载第三方网盘转发的旧版脚本 [8]。
六、参考原文与出处
1. 本文参考微信公众号素材清单
| # | 文章标题与链接 | 来源公众号 | 发布日期 | 配图数 | 为什么入选与核心引用点 |
|---|---|---|---|---|---|
| 1 | [小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清] | 日常造物室 | 2026-06-12 | 6 | 入门经典教程,全面覆盖界面对比、服务商选择、斜杠命令与模型菜单(引用图 01、06、09、10、12) |
| 2 | [免费平替 Claude Code?小米 MiMo Code 保姆级安装 + 使用教程] | 雪松AI出海 | 2026-06-19 | 4 | 平替定位与安装指南,讲解零网络门槛使用与本地模型搭建 |
| 3 | [小米MiMoCode安装与使用教程] | FutureAI实验室 | 2026-06-20 | 17 | 17 张详尽截图,手把手演示 npm 安装、主界面、Custom Provider、环境变量报错与卸载(引用图 02、04、05、08、11、17、18) |
| 4 | [为了蹭MiMo Code免费额度,我现学了终端命令行] | 我用AI上班 | 2026-06-17 | 5 | 小白视角实测,介绍 Node.js 环境准备与蹭免费额度技巧 |
| 5 | [小米AI编程助手MiMo Code:安装、使用与卸载] | 好用斋 | 2026-10-29 | 2 | 10 月稳定版总结,Linux 脚本安装与自然语言批量重命名实战(引用图 03、14) |
| 6 | [免费百万 Token + 全流程自动化,MiMo Code 真香实测] | 一灯架构 | 2026-06-16 | 1 | 系统级评测,深度演示接入第三方 Claude 模型中转与全自动化流程(引用图 15) |
| 7 | [小米MiMo Code 使用大全] | IT雷震子 | 2026-09-19 | 0 | 纯命令手册,全面梳理参数速查表与配置字段定义 |
| 8 | [MiMo Code 上手实录:17秒安装,30分钟跑通,第一个坑居然在官方文档里] | 四两同学的小院 | 2026-06-19 | 7 | 实操踩坑纪实,演示 /auth login 流程与 /init 规范文件生成(引用图 07、13) |
| 9 | [小米 MIMOCode 快速上手指南(官方文档没写)] | 魔轮智能说 | 2026-06-10 | 4 | 经验补充,解读官方文档未注明的授权回跳机制与常见网络限制 |
| 10 | [我把Claude Code换成了MiMo Code] | 星球ai创作 | 2026-06-12 | 7 | 两大 Agent 深度横评,复现模型导入不存在时的排查流程(引用图 16) |
2. 官方技术文档与生态规范列表
| 编号 | 来源与页面名称 | 查阅日期 | 补充与核实用到的核心内容 |
|---|---|---|---|
| [官1] | 小米开放平台开发者中心 (open.mi.com) | 2026-11-08 | 官方 OAuth 授权协议、开发者认证流程与 Token 发放规则 |
| [官2] | MiMo Code 官方发布页与 CLI 说明 (mimo.mi.com) | 2026-11-08 | npm 包发布版本变更记录、全平台安装命令及最低依赖参数 |
| [官3] | MiMo Provider Configuration RFC | 2026-11-08 | 自定义服务商 JSON 字段标准、支持的请求头映射与流式传输协议 |
3. 本文使用图片清单核对表
| 图片文件名 | 图片内容说明 | 引用章节 | 对应素材来源 |
|---|---|---|---|
01-与OpenCode界面对比.png | MiMo Code 与 OpenCode 终端交互界面对比 | 第一节 定位 | [1] 日常造物室 |
02-Windows用npm安装.png | Windows 终端下使用 npm 全局安装过程 | 第二节 2. Windows 安装 | [3] FutureAI实验室 |
03-Linux脚本安装.png | Linux/macOS 下使用一键 shell 脚本安装 | 第二节 3. Linux 安装 | [5] 好用斋 |
04-信任工作目录.png | 首次运行时的工作目录安全信任提示 | 第二节 4. 首次启动 | [3] FutureAI实验室 |
05-主界面.png | 终端启动就绪后的标准欢迎主界面 | 第二节 4. 首次启动 | [3] FutureAI实验室 |
06-选择服务商.png | /provider 命令展开的服务商多选菜单 | 第四节 2. 接入第三方模型 | [1] 日常造物室 |
07-命令行auth-login.png | 终端输入 /auth login 唤起网页授权 | 第二节 5. 账号登录授权 | [8] 四两同学的小院 |
08-开放平台授权页.png | 小米开放平台浏览器网页登录授权页面 | 第二节 1. 账号与免费额度 | [3] FutureAI实验室 |
09-斜杠命令菜单.png | 输入 / 弹出的终端快捷操作指令清单 | 第四节 1. 斜杠命令速查 | [1] 日常造物室 |
10-搜索DeepSeek服务商.png | 在提供商列表中模糊搜索 DeepSeek 服务商 | 第四节 2. 接入第三方模型 | [1] 日常造物室 |
11-Custom-provider入口.png | 添加自定义提供商(Custom Provider)配置菜单 | 第四节 2. 接入第三方模型 | [3] FutureAI实验室 |
12-选择模型.png | 选中提供商后浏览并切换具体模型 ID | 第四节 2. 接入第三方模型 | [1] 日常造物室 |
13-init命令.png | 运行 /init 初始化生成项目规则文档 | 第三节 上手流程 | [8] 四两同学的小院 |
14-自然语言批量改名.png | 自然语言驱动 Agent 批量重命名本地文件 | 第四节 3. 非代码自动化运维 | [5] 好用斋 |
15-接入Claude模型.png | 配置中转以接入第三方 Claude 模型的终端日志 | 第四节 2. 接入第三方模型 | [6] 一灯架构 |
16-导入后模型不存在报错.png | 模型 ID 填错导致平台返回不存在的典型报错 | 第五节 避坑与注意 | [10] 星球ai创作 |
17-mimo不是内部命令.png | Windows 下环境变量未配导致命令找不到的报错 | 第二节 2. Windows 安装 | [3] FutureAI实验室 |
18-卸载确认.png | 运行卸载清理本地配置与包的终端输出 | 第二节 6. 更新与卸载 | [3] FutureAI实验室 |