小米 MiMo Code 安装配置教程

小米 MiMo 团队正式发布了开源 AI 编程 Agent：MiMo Code。
整体使用方式和 Claude Code、Codex CLI、OpenCode 类似。
目前内置的 MiMo Auto 通道限时一个月免费，使用 MiMo V2.5 模型，支持 100 万 token 上下文，不需要 API Key，也不需要复杂网络环境。
免费、开源、国内直连。

图 1：文章配图

注意

MiMo Code 最值得关注的不是性能以及模型质量，而是这三点：

工具本身开源：代码已经发布到 GitHub，使用 MIT 许可证，换言之代码接受全网审查，不涉及隐私问题。
模型目前限时免费：首次启动选择 MiMo Auto，不用配置 API Key，开箱即用。
国内可以直接使用：注册、安装和调用模型不需要特殊网络环境。

你可以把它简单理解成：

一个国内可以直接使用、目前免费、拥有长期记忆能力的开源版 Claude Code。

另外有两点值得关注的地方：

第一，MiMo Code 是基于 OpenCode fork 构建，保留了 OpenCode 的多模型、终端界面、LSP、MCP、插件等能力，并在此基础上加入了持久化记忆、任务追踪、子 Agent、Goal、Compose 等功能。

第二，免费的不是“永久免费 API”，而是内置的 MiMo Auto 限时通道。小米官方在 2026 年 6 月 10 日的发布说明中写的是“限时一个月免费”。后续免费时间、额度和使用规则都可能调整，请以启动页面和官网最新说明为准。

本文核心

这篇文章主要讲：

MiMo Code 是什么
它和 Claude Code、Codex CLI、OpenCode 有什么区别
安装 Node.js
使用 npm 安装 MiMo Code
免费连接 MiMo V2.5
在项目中第一次运行
MiMo Code 的基础使用方法
常见问题和注意事项

整套流程不需要申请 API Key，也不用配置 cc-switch。

1. MiMo Code 是什么

MiMo Code 是小米 MiMo 团队基于 OpenCode 二次开发推出的终端 AI 编程 Agent。

它的基本使用方式和 Claude Code 很像。

据官方描述：“免费体验比肩 Claude Sonnet 4.6 级别多模态模型”

使用的模型是 MiMo V2.5，性能还是很不错的，基本和 DeepSeek V4 Pro 没有很大区别

前一阵好评度很高的 MiMo V2.5 Pro是不参与本次免费活动的

具体性能大家可以参考很多知名排行榜，这里不再赘述，下图可做参考，来源 Artificial Analysis

图 2：文章配图

关于什么是 AI Agent 可以参考我的这篇文章：

关于什么是 Claude Code 可以参考我的这篇文章：

关于什么是 OpenCode 可以参考我的这篇文章：

MiMo Code 相比于 OpenCode 目前值得推荐的地方是：持久化记忆 + 官方免费

很多 AI Agent 都有一个问题：当前对话一长，前面的要求就容易被压缩或遗忘；关闭会话后，下次又要重新解释项目。

MiMo Code 针对这个问题加入了多层记忆系统，包括：

项目记忆
会话检查点
临时笔记
每个任务的进度记录

当任务持续很久、对话接近上下文上限时，它会提前保存当前状态，然后重建上下文继续工作。

白话说就是：

它会把重要规则、当前进度、踩过的坑和下一步动作记录下来，尽量避免每次重新开始。

这套设计更适合重构项目、迁移代码、持续修复问题这类需要几十步甚至上百步的长任务。

2. MiMo Code 和 Claude Code、Codex CLI、OpenCode 有什么区别

这四个工具都属于可以进入本地项目、读取文件、修改代码和执行命令的 AI Agent。

但它们的定位并不完全一样。

工具	是否开源	默认模型和费用	国内使用	主要特点
MiMo Code	开源，MIT	MiMo Auto 目前限时免费	国内直连	持久化记忆、长任务、子 Agent、Compose
Claude Code	工具本体非开源	使用 Claude 订阅或 API	受网络环境影响	成熟稳定，Agent 工作流和工具调用体验好
Codex CLI	开源	使用 GPT 账号或 OpenAI API	受网络环境影响	OpenAI 生态、代码理解和执行能力强
OpenCode	开源	工具免费，模型费用取决于提供商	国内直连	多模型、可扩展、支持 75+ 提供商

它保留了 OpenCode 的终端界面、多模型支持、LSP、MCP 和插件能力，然后加入了自己的记忆、上下文重建、任务追踪、Goal、Compose 和自我整理功能。

3. 安装前准备

本文使用 npm 安装，所以电脑需要先有：

Node.js
npm
一个终端

支持的系统包括：

1
macOS
2
Windows
3
Linux

3.1 打开终端

Mac 用户：

按 Command + 空格，搜索“终端”，然后打开。

也可以使用小米官方更推荐的 iTerm 或 VS Code Terminal。

Windows 用户：

按 Win + R，输入：

1
cmd

然后按回车。

也可以在开始菜单搜索 PowerShell 或 Windows Terminal。

3.2 检查 Node.js

在终端运行：

1
node -v

再运行：

1
npm -v

如果两条命令都能显示版本号，说明你的电脑已经安装了 Node.js 和 npm，可以直接跳到下一节。

如果提示找不到 node 或 npm，打开 Node.js 官网：

1
https://nodejs.org/zh-cn/download

下载并安装当前的 LTS 版本。

Windows 一般下载 .msi 安装包，Mac 一般下载 .pkg 安装包。安装过程按提示继续即可，不需要修改默认选项。

图 3：文章配图

安装完成后，关闭当前终端，重新打开一个新的终端窗口，再次运行：

1
node -v
2
npm -v

能看到版本号，就可以继续。

4. 使用 npm 安装 MiMo Code

打开终端，复制下面这条命令，然后按回车：

1
npm install -g @mimo-ai/cli

这里的 -g 表示全局安装。

全局安装以后，无论你当前在哪个文件夹，都可以直接使用 mimo 命令启动 MiMo Code。

等待命令运行完成。

图 4：文章配图

安装完成后，验证版本：

1
mimo --version

如果能看到类似下面的版本号：

1
0.1.0

说明安装成功。

截至 2026 年 6 月 11 日，npm 上的正式版本为 0.1.0。MiMo Code 刚刚发布，版本更新会比较快，实际版本号以你安装时 npm 返回的结果为准。

Mac 或 Linux 的另一种安装方式

小米官方对 Mac 和 Linux 用户优先推荐一键安装脚本，目前我的mac自测会获取版本号失败，大家可以先用npm安装：

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

如果你在 Mac 上执行 npm 全局安装时遇到 EACCES 或 permission denied 权限错误，不要随便给 npm 命令加 sudo，可以直接改用上面的npm官方安装脚本。

5. 免费连接 MiMo V2.5

安装完成后，在终端运行：

1
mimo

然后按 Ctrl + P 打开设置（注意mac是 Ctrl + P ，不是 cmd + P）

选择切换模型，然后切换到MiMo Auto(free)选项即可

图 5：文章配图

MiMo Auto 是匿名、零配置的限时免费通道。

它不要求你申请 API Key，也不要求先充值。根据小米在 2026 年 6 月 10 日发布的说明，目前这个通道：

1
使用 MiMo V2.5
2
支持 100 万 token 上下文
3
限时一个月免费

选择完成后，MiMo Code 会进入终端交互界面。

6. 在项目中第一次运行

MiMo Code 最适合围绕一个具体文件夹工作。

不要在用户主目录、桌面根目录或包含大量隐私文件的目录里直接启动。

建议先准备一个不重要的测试文件夹。

6.1 进入项目目录

假设项目在桌面，名字叫：

1
mimo-demo

Mac 用户可以运行：

1
cd ~/Desktop/mimo-demo

Windows 用户可以运行：

1
cd 你的用户名\Desktop\mimo-demo

然后输入回车：

1
mimo

6.2 初始化项目规则

进入 MiMo Code 后，先运行：

1
/init

MiMo Code 会分析当前项目，并在项目根目录创建一个：

1
AGENTS.md

图 6：文章配图

这个文件用来告诉 AI：

项目是做什么的
目录怎么组织
使用什么技术
修改时要遵守哪些规则
改完应该运行什么验证命令

官方建议把 AGENTS.md 一起提交到 Git。

但不要完全相信自动生成的内容。生成后应该自己检查一遍，把项目真实规则补充清楚。

6.3 先让它阅读，不要直接修改

第一次运行可以输入：

1
先阅读当前项目，不要修改任何文件。
2
告诉我这个项目的用途、主要目录、启动方式和最重要的几个文件。

如果它的理解基本正确，再让它做下一步。

例如：

1
检查当前项目是否能正常运行。
2
先给出检查计划，不要修改文件。

图 7：文章配图

7. MiMo Code 怎么用

7.1 Build 模式

Build 是默认模式。

这个模式拥有完整的工具权限，可以读取文件、修改代码和执行命令。

适合已经明确的小任务，例如：

1
给这个项目补充一个 README.md，写清楚安装、启动和测试方法。
2
完成后检查 Markdown 格式。

或者：

1
修复当前测试失败的问题。
2
先定位根本原因，只修改相关文件，修复后重新运行测试。

7.2 Plan 模式

按 Tab 可以切换到 Plan 模式。

Plan 模式主要用于阅读、分析和制定方案，不直接修改文件。

涉及多个文件或重要项目时，建议先用 Plan：

1
我要给这个项目增加登录功能。先阅读当前结构，分析需要修改哪些模块，给出实施计划和风险，不要动手。

确认方案后，再按 Tab 切回 Build，让它实施。

这种用法与 Claude Code 的 Plan Mode 很接近。

7.3 Compose 模式

继续按 Tab，还可以切换到 Compose。

Compose 适合流程更复杂的开发任务。它内置了规划、TDD、调试、代码审查、验证和合并等工作流技能。

新手不用一开始就研究 Compose。

先把 Build 和 Plan 用熟，再处理复杂项目。

7.4 引用指定文件

输入 @ 可以搜索并引用项目中的文件。

例如：

1
请解释 @src/main.ts 的主要逻辑，并告诉我它调用了哪些模块。

这样比只说“解释一下代码”更准确。

7.5 撤销和恢复修改

如果 MiMo Code 的修改不是你想要的，可以运行：

1
/undo

需要恢复刚才撤销的修改，可以运行：

1
/redo

但涉及重要项目时，不要只依赖 Agent 自带的撤销功能。

更稳妥的做法是使用 Git，在修改前确认工作区状态，修改后认真检查 diff。

7.6 切换其他模型

MiMo Code 支持 75 个以上的 LLM 提供商，也支持本地模型。

需要选择其他模型时，可以输入：

1
/models

需要添加模型提供商时，可以输入：

1
/connect

后续你可以接入小米 MiMo 平台，也可以配置其他 OpenAI 兼容 API。

如果你现在只是想免费体验，先用 MiMo Auto 即可，不用一开始就折腾多个模型。

8. 实际使用建议

目前测试下来确实是免费的，但是官方限制了token速率（毕竟免费），可以拿来做一些简单的任务，复杂的建议自己接入api，参考我前面几个教程

9. 常见问题

Q1：真的是免费的吗？

MiMo Code 工具本身使用 MIT 许可证开源，可以免费安装和使用。

目前内置的 MiMo Auto 模型通道限时一个月免费。

这两个“免费”不是一回事：

1
MiMo Code 工具：开源
2
MiMo Auto 模型：限时免费

免费活动结束后，模型调用是否收费、有没有新额度，以官网最新规则为准。

Q2：免费通道需要 API Key 吗？

目前不需要。

首次启动选择 MiMo Auto，可以匿名、零配置开始使用。

如果后续改用小米 MiMo 平台或其他模型提供商，可能需要登录账号、添加账单信息或填写 API Key。

Q3：怎么升级 MiMo Code？

使用 npm 安装的用户可以运行：

1
npm install -g @mimo-ai/cli@latest

也可以尝试 MiMo Code 自带的升级命令：

1
mimo upgrade

升级后检查版本：

1
mimo --version

Q4：怎么卸载？

通过 npm 安装的用户运行：

1
npm uninstall -g @mimo-ai/cli

MiMo Code 也提供：

1
mimo uninstall

如果只是想卸载 npm 包，优先使用 npm 对应的卸载命令。

Q5：MiMo Code 会不会泄露项目文件？

MiMo Code 工具本身开源，但只要你使用云端模型，任务相关内容就可能被发送到对应模型服务商。

使用 MiMo Auto 时，需要按小米 MiMo 的服务条款理解数据处理范围。

涉及下面这些内容时不要直接使用免费云端模型：

公司机密代码
客户数据
未公开产品资料
API Key、token、密码
身份证、银行卡和合同等敏感文件

开源不等于所有数据都只在本地运行。

10. 总结

MiMo Code 是目前非常值得国内用户尝试的一款 AI Agent。

对于已经使用 Claude Code、Codex CLI 或 OpenCode 的人，它提供了一个不需要 API Key 就能直接体验的新选择。对于第一次接触 AI Agent 的人，安装流程也很简单

MiMo Code 目前还是 0.1.0 的首个正式版本，后续功能、界面和免费规则都可能快速变化。本文涉及版本、免费活动和模型规则的内容，以小米 MiMo 官网最新说明为准。

晴天录