小米Mimo Code使用指南

一、什么是 MiMo Code?

MiMo Code 是小米 MiMo 团队于 2026 年 6 月 11 日正式发布并开源的一款终端原生 AI 编程助手。它基于开源项目 OpenCode 二次开发,采用 MIT 协议 开源,个人与企业均可免费使用与二次分发。

与传统 IDE 插件或代码补全工具不同,MiMo Code 是一个运行在终端里的 AI 编程 Agent——它能读取和理解整个项目代码、修改文件、执行命令、管理 Git,并通过持久记忆系统在多次会话间保持对项目的深度理解。简单说,它不是“写几行代码的补全工具”,而是“能在终端里替你完成完整开发任务的 AI 伙伴”。

核心特性

  • 终端原生架构:纯命令行运行,无需集成 IDE 或图形界面
  • 轻量化部署:安装仅需一条命令,5 秒内完成
  • 全中文本地化界面:所有设置项全面汉化,右侧配有实时状态看板
  • 内置限时免费模型:MiMo-V2.5 多模态大模型,零配置即可使用
  • 兼容主流第三方模型:支持接入 DeepSeek、Kimi、GLM 等 75 余款主流 LLM

核心竞争力:持久记忆系统

MiMo Code 最突出的创新是它的 持久记忆系统,通过三重机制解决长会话“越用越忘”的难题:

  • 项目记忆(MEMORY.md):记录代码库的关键决策与架构逻辑
  • 会话检查点(checkpoint.md):自动保存任务关键节点状态
  • 任务进度追踪:确保中断后可精准续写,避免重复解释需求

当上下文窗口接近上限时,独立的子 Agent 会自动将历史对话压缩为“干净简报”,主 Agent 基于简报继续工作而非从零开始。此外,内置的 /dream 命令每 7 天自动触发一次记忆整合,合并历史会话、去重冗余信息,实现“越用越懂项目”。

三种核心工作模式

MiMo Code 提供三种可通过 Tab 键 切换的工作模式:

模式用途
Build(构建)默认模式,完整工具权限——读写文件、执行命令、Git 版本管理
Plan(计划)只读分析模式,适合先理解陌生仓库,只能看代码不能改
Compose(编排)全流程开发模式,从需求到交付一条龙——自动完成设计→规划→编码→测试→审查

在 Compose 模式下,只需给它一个简单的想法(如“用 React 写一个拖拽待办事项面板”),它就能自动完成全流程,最终交付工业级可运行代码。

性能表现

在权威基准测试中,相同模型条件下,MiMo Code 在 SWE-Bench Pro V2 和 Terminal Bench 2 两项测试中的得分均高于 Claude Code。在超过 200 步的复杂长任务中,胜率提升至 65% 以上(Claude Code 仅 35%)。

二、安装教程

2.1 前置要求

MiMo Code 依托终端模拟器运行,推荐使用以下终端环境:

  • 跨平台:WezTerm、Alacritty、VSCode 内置终端
  • macOS:iTerm(官方强烈推荐)
  • Linux/macOS:Ghostty、Kitty

Windows 用户还需要提前安装 Node.js 环境(版本需 ≥ v18.18.0)。可通过 node -v 检查是否已安装。

2.2 分系统安装

MiMo Code 提供两种安装方式,不同操作系统对应不同命令:

macOS / Linux(推荐)

打开终端,执行官方一键安装脚本:

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

该方式为主推方案,会自动配置环境变量,安装完成后可直接全局调用。

Windows

通过 npm 全局安装 CLI 工具:

npm install -g @mimo-ai/cli

提示:Windows 用户也可使用 WSL2 运行 Linux 安装命令。

通用方式(跨平台)

无论哪种系统,都可以通过 npm 安装:

npm install -g @mimo-ai/cli

2.3 验证安装

安装完成后,在终端输入以下命令验证是否安装成功:

mimo

如果能进入 MiMo Code 的交互式终端(TUI)界面,则代表部署完成。

小贴士:如果安装后提示 mimo 命令未找到,可能需要重启终端或执行 source ~/.zshrc(macOS/Linux)使路径生效。

三、连接教程

安装只是第一步,要让 MiMo Code 真正工作,还需要连接大模型。MiMo Code 内置了限时免费的 MiMo-V2.5 模型,无需注册、无需 API Key 即可直接使用。

3.1 进入项目目录(关键一步)

这是最容易出错的地方——单独运行 mimo 只是打开一个空壳,它不会自动识别你的代码。

正确做法是:先用 cd 命令切换到你的项目根目录,再运行 mimo:

cd ~/projects/my-web-app
mimo

首次启动会自动初始化 SQLite 记忆库,并弹出 TUI 界面。

3.2 连接免费模型

进入 TUI 界面后,输入斜杠命令连接模型:

/connect

在弹出的列表中选择 “MiMo Auto(限时免费)” 或 “free(MiMo-V2.5)”,回车确认。

连接成功后,右下角状态栏会显示 “✅ Model: MiMo-V2.5”。此时记忆系统开始扫描当前目录的文件树,根据项目规模可能需要 3-15 秒。

3.3 连接第三方模型

除了免费的 MiMo-V2.5,MiMo Code 还支持接入 DeepSeek、Kimi、GLM 等主流模型,以及任意 OpenAI 兼容的 API。

连接第三方模型同样通过 /connect 命令,在列表中选择对应的 Provider,然后按提示输入 API Key 即可。如果接入 DeepSeek、Kimi 等第三方模型,需要显式开启工具调用开关,否则模型会忽略 tool_calls 字段直接返回自然语言。

3.4 切换工作模式

连接好模型后,按 Tab 键 可在三种模式间切换:

  • Build:直接干活,适合日常开发
  • Plan:只读分析,适合探索陌生代码
  • Compose:全流程交付,适合从零搭建功能

3.5 开始使用

一切就绪后,直接输入自然语言指令即可。例如:

“帮我写一个 Python 脚本,读取当前目录下所有 CSV 文件,合并成一张表,按销售额降序排列,保存为 result.xlsx”

按下回车,MiMo Code 会自动规划任务、创建文件、编写代码、安装依赖、运行测试。

3.6 常用命令速查

命令功能
/connect连接/切换大模型
/dream手动触发记忆优化(每 7 天自动执行一次)
/reset清空当前会话上下文
/goal设置会话停止条件
/voice激活语音输入(需登录)
Tab切换 Build / Plan / Compose 三种模式
Ctrl+C中断正在执行的长任务

四、总结

MiMo Code 是一款定位清晰、特色鲜明的终端 AI 编程助手。它的优势可以概括为三点:

  • 上手极快:一条命令安装、零配置连接免费模型,5 分钟就能开始使用
  • 记忆持久:独创的三重记忆机制,让 AI 在多轮会话中“越用越懂你的项目”
  • 能力全面:从代码读写到 Git 管理,从单文件修改到全流程项目交付,Compose 模式尤其强大

目前 MiMo Code V0.1.0 为探索性发布版本,但已在 SWE-Bench 等权威测试中展现出超越 Claude Code 的性能。随着后续版本的迭代,这款小米开源的工具值得每一位开发者关注和尝试。

返回首页