天工开物KAIWU AI
工具指南 › MiMo Code › MiMo Code 使用指南(完整全套)
核实于 2026-11-08
工具指南·其十二核实于 2026-11-08

MiMo Code 使用指南(完整全套)

适用对象
想快速了解工具定位、核心功能和上手路径的中文用户
核对日期
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 与OpenCode界面对比

图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》

1. 核心定位与特色

  • 极速轻量:纯 Node.js 驱动的终端工具,启动时间通常仅需 1~2 秒,占用系统内存极低 [8]。

  • 出厂自带免费额度:通过小米账号登录小米开放平台,官方直接赠送高额免费调用 Token(如每月 100 万 Token),零门槛起步 [4][6]。

  • 极致开放的模型路由:内置国内主流提供商(DeepSeek、硅基流动、智谱等)一键切换,并支持完全开放的 Custom Provider 自定义接口配置 [1][3][6]。

  • 开箱即用的自动化文件处理:除了常规编程,它还非常擅长通过自然语言批量处理日常文本、日志与文件重命名任务 [5]。

2. 和同类 AI 编码工具怎么比

维度小米 MiMo CodeClaude CodeOpenCodeGitHub 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]:

图 2 开放平台授权页

图源:[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:

powershell
npm install -g @xiaomi/mimo-code
图 3 Windows用npm安装

图源:[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]:

bash
# 运行官方快速安装脚本
curl -fsSL https://mimo.mi.com/install.sh | bash
图 5 Linux脚本安装

图源:[5] 好用斋《小米AI编程助手MiMo Code:安装、使用与卸载》

脚本会自动检测系统架构、配置可执行权限并软链接到 /usr/local/bin/mimo。


4. 首次启动与目录信任

在任意空文件夹或项目根目录中输入:

bash
mimo

首次运行进入某个目录时,MiMo Code 会出于系统安全性考虑弹出工作目录信任提示 [3]:

图 6 信任工作目录

图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》

选择「Yes, I trust this directory(信任此目录)」后,即可正式进入主界面:

图 7 主界面

图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》


5. 官方账号登录授权

在终端中输入斜杠命令:

bash
/auth login
图 8 命令行auth-login

图源:[8] 四两同学的小院《MiMo Code 上手实录:17秒安装,30分钟跑通,第一个坑居然在官方文档里》

终端会输出一个授权网址并自动在默认浏览器中打开。点击「同意授权」后,终端会即时显示 Login successfully [3][8]。


6. 更新与彻底卸载

  • 检查与更新:

    bash
    npm 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
图 9 卸载确认

图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》


三、上手流程:从零到第一个完整项目

下面演示如何使用 MiMo Code,通过纯自然语言从零生成并部署一个可交互的贪吃蛇网页小游戏。

第一步:初始化项目指令

在终端工作目录中,键入:

bash
/init
图 10 init命令

图源:[8] 四两同学的小院《MiMo Code 上手实录:17秒安装,30分钟跑通,第一个坑居然在官方文档里》

MiMo Code 会在当前目录自动生成 AGENTS.md(或 MIMO.md)项目规则描述文件,记录该项目的技术栈与规范要求 [8]。

第二步:下达开发指令

在输入提示符后直接输入自然语言指令:

"帮我在当前目录开发一个经典的复古风贪吃蛇网页游戏。要求:

  1. 单个 index.html 包含 HTML、CSS 和原生 JavaScript,无需外部 npm 依赖;

  2. 支持键盘上下左右键及 WASD 控制;

  3. 右侧显示实时计分板、历史最高分纪录(使用 LocalStorage 持久化);

  4. 界面采用深色暗黑风格,带有吃食物粒子动效。"

第三步:审查 Agent 代码生成与落盘

MiMo Code 会在终端中展示思维链拆解,并调用内置写文件工具:

  • 终端会高亮展示即将创建的 index.html 内容;

  • 如果你开启了确认机制,输入 y 即可确认写入硬盘 [1][6]。

第四步:测试与快速微调

在本地浏览器中双击打开 index.html 进行体验。如果想改动细节,无需自己动手写代码,直接在 MiMo 终端中继续说话:

"蛇移动的速度太慢了,请将初始步长速度提升 30%,并在撞墙死亡时让屏幕边缘闪烁红色警示动效。"

MiMo 会自动读取现有的 index.html,定位相关逻辑并生成精确补丁,完成增量更新 [1]。


四、核心功能与进阶

1. 斜杠命令系统速查

在 MiMo 交互界面中,随时输入 / 即可展开命令菜单 [1]:

图 11 斜杠命令菜单

图源:[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]:

图 12 选择服务商

图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》

输入关键字即可模糊搜索对应平台(如搜索 DeepSeek)[1]:

图 13 搜索DeepSeek服务商

图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》

选中服务商后,终端会提示你输入该平台的 API Key,并自动列出该平台下的模型列表供你选择:

图 14 选择模型

图源:[1] 日常造物室《小米 MiMo Code 上手教程:免费模型、国内模型接入、工作模式一次讲清》

(2)配置 Custom Provider(自定义接口)

如果你的模型中转平台不在预置列表里(例如自建 OneAPI、NewAPI、硅基流动或本地 Ollama),直接选择 Custom Provider 入口 [3]:

图 15 Custom-provider入口

图源:[3] FutureAI实验室《小米MiMoCode安装与使用教程》

终端会引导你依次输入:

  1. Provider Name:自定义服务商标识(如 My-DeepSeek)。

  2. API Base URL:接口地址(注意必须包含完整协议,通常以 /v1 结尾,如 https://api.siliconflow.cn/v1)。

  3. API Key:你的访问密钥。

  4. Default Model:默认模型名(如 deepseek-ai/DeepSeek-V3)。

(3)接入海外模型(如 Claude / GPT)

你甚至可以通过兼容中转将 Claude 模型挂接进 MiMo Code 运行 [6]:

图 16 接入Claude模型

图源:[6] 一灯架构《免费百万 Token + 全流程自动化,MiMo Code 真香实测》

(4)底层配置文件直接编辑

所有通过界面配置的信息都会保存在用户主目录下的 ~/.mimo/config.json 中。高级用户可以直接用编辑器打开修改 [3][6]:

json
{
  "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 文档。"

图 17 自然语言批量改名

图源:[5] 好用斋《小米AI编程助手MiMo Code:安装、使用与卸载》

MiMo 会自动调用系统 Shell 扫描文件元数据,生成重命名脚本并批量完成执行,极其省心 [5]。


五、避坑与注意(⚠️ 关键避坑)

1. ⚠️ 自定义模型名称拼写错误导致死锁

  • 报错现象:添加完 Custom Provider 后,提问时终端抛出 Model 'xxx' does not exist on provider 错误 [10]:

图 18 导入后模型不存在报错

图源:[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-126入门经典教程,全面覆盖界面对比、服务商选择、斜杠命令与模型菜单(引用图 01、06、09、10、12)
2[免费平替 Claude Code?小米 MiMo Code 保姆级安装 + 使用教程]雪松AI出海2026-06-194平替定位与安装指南,讲解零网络门槛使用与本地模型搭建
3[小米MiMoCode安装与使用教程]FutureAI实验室2026-06-201717 张详尽截图,手把手演示 npm 安装、主界面、Custom Provider、环境变量报错与卸载(引用图 02、04、05、08、11、17、18)
4[为了蹭MiMo Code免费额度,我现学了终端命令行]我用AI上班2026-06-175小白视角实测,介绍 Node.js 环境准备与蹭免费额度技巧
5[小米AI编程助手MiMo Code:安装、使用与卸载]好用斋2026-10-29210 月稳定版总结,Linux 脚本安装与自然语言批量重命名实战(引用图 03、14)
6[免费百万 Token + 全流程自动化,MiMo Code 真香实测]一灯架构2026-06-161系统级评测,深度演示接入第三方 Claude 模型中转与全自动化流程(引用图 15)
7[小米MiMo Code 使用大全]IT雷震子2026-09-190纯命令手册,全面梳理参数速查表与配置字段定义
8[MiMo Code 上手实录:17秒安装,30分钟跑通,第一个坑居然在官方文档里]四两同学的小院2026-06-197实操踩坑纪实,演示 /auth login 流程与 /init 规范文件生成(引用图 07、13)
9[小米 MIMOCode 快速上手指南(官方文档没写)]魔轮智能说2026-06-104经验补充,解读官方文档未注明的授权回跳机制与常见网络限制
10[我把Claude Code换成了MiMo Code]星球ai创作2026-06-127两大 Agent 深度横评,复现模型导入不存在时的排查流程(引用图 16)

2. 官方技术文档与生态规范列表

编号来源与页面名称查阅日期补充与核实用到的核心内容
[官1]小米开放平台开发者中心 (open.mi.com)2026-11-08官方 OAuth 授权协议、开发者认证流程与 Token 发放规则
[官2]MiMo Code 官方发布页与 CLI 说明 (mimo.mi.com)2026-11-08npm 包发布版本变更记录、全平台安装命令及最低依赖参数
[官3]MiMo Provider Configuration RFC2026-11-08自定义服务商 JSON 字段标准、支持的请求头映射与流式传输协议

3. 本文使用图片清单核对表

图片文件名图片内容说明引用章节对应素材来源
01-与OpenCode界面对比.pngMiMo Code 与 OpenCode 终端交互界面对比第一节 定位[1] 日常造物室
02-Windows用npm安装.pngWindows 终端下使用 npm 全局安装过程第二节 2. Windows 安装[3] FutureAI实验室
03-Linux脚本安装.pngLinux/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不是内部命令.pngWindows 下环境变量未配导致命令找不到的报错第二节 2. Windows 安装[3] FutureAI实验室
18-卸载确认.png运行卸载清理本地配置与包的终端输出第二节 6. 更新与卸载[3] FutureAI实验室
更新于 2026-11-08来源:用户提供《工具指南_完整全套_含所有MD与图片.zip》;正文保留原文参考来源