MiMo Code 完整使用指南

一、平台介绍

1. 基本信息

• 发布主体：小米 MiMo 团队
• 发布日期：2026-06-11
• 开源协议：MIT 开源协议
• 官方仓库：https://github.com/XiaomiMiMo/MiMo-Code
• 配套官网：https://mimo.xiaomi.com/zh/mimocode

2. 产品定位

• 核心类型：终端 TUI AI 编程智能体（Agent）
• 技术基础：基于 OpenCode 二次开发，内置自研 MiMo-V2.5 大模型。
• 主要区别：不同于 IDE 内的代码补全工具，运行在系统终端中。
• 核心优势：支持直接读写项目文件、执行 shell/git 命令、自主完成多阶段开发流程。
• 网络环境：国内网络访问低延迟，MiMo Auto 通道初期无需注册账号。

二、核心功能特性

1. 超大上下文与持久记忆系统（核心差异化）

• 上下文窗口：MiMo-V2.5 原生支持 100 万 token 上下文窗口。
• 记忆机制：配合无损压缩与 Cycle 检查点机制，实现“类无限上下文”管理。
• 四层持久化记忆：
• 项目全局记忆：MEMORY.md
• 会话快照检查点：任务过程中的状态保留。
• 临时笔记：随时记录的信息。
• 分任务进度日志：详细记录各阶段进展。
• 恢复能力：关闭终端并重启后，自动恢复项目认知，无需重新解析整个仓库。

2. 多模式 Agent 开发框架

• Plan 模式：适用于需求拆解、架构方案规划。
• Build 模式：适用于常规代码编写、Bug 修复、单模块迭代。
• Compose 模式：支持多子智能体协同，动态编排工作流，能独立完成从需求到可运行 Demo 的完整交付。
• Max Mode：支持并行采样，单次任务生成多套方案择优，并搭配 Goal 完成度校验以降低长流程出错概率。

3. 终端原生工具能力

• 文件操作：Agent 具备权限直接读写项目源码。
• 系统命令：可直接执行 shell 终端命令。
• 版本控制：支持操作 Git（提交/分支/合并）。
• 批量处理：支持批量文件修改与单元测试生成。

4. 模型灵活接入

• 内置模型：支持 MiMo Auto 免费通道（MiMo-V2.5）。
• 第三方接入：支持手动接入 DeepSeek、Kimi、GLM 等大模型。
• API 支持：可导入自定义 API Key。
• 兼容性：兼容读取 Claude Code 历史项目记忆文件，平滑迁移项目。

5. 自进化系统

• 记忆整理：周期性自动整理项目记忆（Dream）。
• 技能固化：提炼复用工作流程，固化为技能模板（Distill）。
• 习惯适配：随项目迭代自动适配开发习惯与项目规范。

三、适用人群与限制

✅ 推荐使用人群

1. 个人独立/副业开发者：预算有限，零成本体验长流程 AI 编程；适合开发 Demo、脚本工具、个人项目。
2. 后端/运维重度终端使用者：适合编写 Shell、自动化部署脚本、数据处理程序。
3. 编程学生/入门学习者：利用免注册免费通道练习代码、调试算法、理解项目架构，降低成本。
4. 长期项目维护者：利用持久跨会话记忆，避免每次重启 AI 重新讲解项目架构。

❌ 不推荐优先使用人群

1. 大型商业复杂系统专职开发：生态尚早期，稳定性与完整配套能力弱于 Cursor、GitHub Copilot；无企业级 SLA 保障。
2. 重度前端可视化 UI 开发：纯终端环境无 IDE 实时预览，前端页面调试效率偏低。
3. 高敏感涉密项目：MiMo Auto 免费通道请求经由小米云端服务，严禁上传敏感业务代码或密钥。

四、费用与政策说明

1. MiMo Auto 通道（限时免费）

• 账号要求：无需手机号/账号注册，开箱即用。
• 模型支持：内置 MiMo-V2.5 模型。
• 特殊情况：部分新用户随机分配 UltraSpeed 高速输出通道（MiMo-V2.5-Pro）。
• 政策风险：官方仅说明为限时免费，长期定价、免费额度上限尚未公示；存在调整、收费或限流可能性。

2. 开源本地自定义模型模式（永久自主）

• 开源协议：MIT 完全开源。
• 部署方式：可自行部署，对接自有第三方模型 API。
• 费用说明：仅消耗你自身第三方模型配额，MiMo 工具本体无额外收费。

3. 商业方案状态

• 订阅方案：目前暂无公开商业团队订阅方案。
• 企业版：团队版、企业付费套餐、SLA、私有部署政策暂未发布。
• 支付渠道：当前无任何小米侧付费渠道。

五、快速上手流程

步骤 1：一键安装

• 系统要求：Linux、macOS、WSL（Windows 原生 CMD/PowerShell 支持不完善，推荐 WSL）。
• 安装命令：在终端执行以下脚本：
• bash

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

• 说明：脚本会自动匹配系统架构并配置环境变量。建议安全敏感设备先下载脚本本地查看后再执行。

步骤 2：进入项目目录

• 操作：终端 cd 到你的代码项目根目录。
• 启动：直接输入命令启动 TUI 交互界面：
• bash

mimocode
mimocode

• 默认连接：默认接入 MiMo Auto 免费通道，无需登录。

步骤 3：选择工作模式

• 自然语言描述：用自然语言（支持中英文）描述开发需求。
• 模式选择：
• Compose 模式：适合完整项目从零开发。
• Build 模式：适合局部改 Bug、新增功能。

步骤 4：权限确认与交互

• 操作提示：Agent 如需修改文件、执行系统命令会给出提示。
• 人工确认：需人工确认后方可执行。
• 过程控制：可随时查看任务进度、记忆文件，或中止当前 Agent 流程。

步骤 5：自定义第三方模型

• 适用场景：若不想使用 Auto 云端通道，或涉及敏感数据。
• 操作：在配置文件填入第三方大模型 API 地址与密钥，切换本地模型接入模式。

六、避坑重点与注意事项（早期版本高频问题）

⚠️ 1. 免费通道不确定性

• 现状：仅为早期限时福利，无明确时长、Token 限额公告。
• 建议：随时可能限流、关闭免费通道或转为付费。重要项目建议同时准备自定义第三方模型接入方案兜底。

⚠️ 2. 自动操作高风险

• 权限说明：Agent 拥有读写文件、执行系统命令、Git 操作权限。
• 已知风险：已有反馈出现异常操作风险（如误操作全局 npm 包）。
• 避坑指南：
• 正式代码变更前手动查看所有修改。
• 禁止直接在生产环境目录运行。
• 重要代码变更先做 Git 备份。

⚠️ 3. 操作系统兼容性问题

• macOS：二进制包可能触发 Gatekeeper“已损坏”提示，需手动执行安全放行命令。
• Windows：原生终端支持差，优先使用 WSL2。
• Termux：移动端环境存在日志膨胀、运行卡顿问题，不推荐主力使用。

⚠️ 4. 产品早期生态限制

• 发布状态：发布仅数日，处于极早期迭代。
• 资源匮乏：社区教程、插件 Skill 库、问题解决方案较少。
• 已知 Bug：GitHub 存在大量未修复 Issues；小众编程语言/框架适配容易出异常。
• 偶发问题：复杂长流程任务偶发 Token 统计异常、会话记忆损坏。

⚠️ 5. 云端通道数据隐私

• 数据流向：MiMo Auto 通道代码上下文上传小米服务器处理。
• 严禁行为：严禁上传公司商业源码、密钥、涉密代码。
• 隐私方案：隐私敏感场景必须切换为自行对接第三方私有模型 API。

⚠️ 6. 工具场景局限性

• 环境特点：纯 TUI 终端环境。
• 效率短板：无代码实时预览、图形调试工具；前端、GUI、可视化开发效率远不及 IDE 类 AI 工具（Cursor、Copilot）。

⚠️ 7. 资源管理

• 记忆文件膨胀：长期大型项目持续使用会生成大量记忆/检查点文件，占用磁盘。
• 维护建议：定期可手动清理旧任务进度快照，释放空间。