MiMo Code

MiMo Code 快速入门

一句话卖点：小米开源 AI 编程 Agent——“模型与 Agent 共同进化”，支持多 Agent 协同 + 持久记忆 + Workflow 编排，终端原生，完全免费

一、产品概述

MiMo Code 是小米 MiMo AI 团队于 2026 年 6 月开源的终端原生 AI 编程助手。它不仅仅是一个代码补全工具，而是一个完整的 Agent 框架——支持多 Agent 协同、跨会话持久记忆、任务追踪、子 Agent 并行执行，以及通过 Workflow 进行确定性编排。其核心理念是”模型与 Agent 共同进化”，让 Agent 越用越懂你的代码库。

MiMo Code 基于 OpenCode 构建，在保留其多 Provider、TUI、LSP、MCP 等核心能力的基础上，新增了持久记忆、智能上下文管理、子 Agent 编排、目标驱动自主循环、Compose 工作流以及 Dream/Distill 自我进化机制。

二、核心功能

1. 多 Agent 协同

MiMo Code 内置三种 Agent 模式，按 Tab 键即可切换：

此外，主 Agent 可按需创建子 Agent，子 Agent 共享当前会话上下文并支持并行执行、生命周期追踪和取消。

2. 持久记忆系统

MiMo Code 基于 SQLite FTS5 全文搜索引擎实现了跨会话持久记忆，解决 AI 编程助手”忘记上下文”的核心痛点：

• 项目记忆（MEMORY.md） — 持久化项目知识、规则和架构决策
• 会话检查点（checkpoint.md） — 由 checkpoint-writer 子 Agent 自动维护的结构化状态快照
• 临时笔记（notes.md） — Agent 的临时备忘区域
• 任务进度（tasks//progress.md） — 每个任务的进度日志

恢复会话时记忆自动注入，Agent 无需重新学习项目上下文。

3. 智能上下文管理

• 自动检查点 — 根据模型上下文窗口自动决定何时保存状态
• 上下文重建 — 当上下文接近上限时，从最新检查点、项目记忆、任务进度和保留的最近消息重建上下文
• 预算注入 — 使用 Token 预算控制检查点、记忆和笔记内容注入量，按重要性排序

4. 任务追踪

树状任务系统（T1 → T1.1 → T1.2 …），与检查点系统自动集成，会话恢复时保留任务进度。

5. Workflow 工作流

Workflow 是运行在沙箱环境中的确定性 JavaScript 脚本，编排多个 Agent 按固定阶段序列执行。MiMo Code 内置两个 Workflow：

用户可在 .mimocode/workflows/ 目录下放置自定义 .js 文件定义自己的 Workflow。

6. 内置 Skill 系统

MiMo Code 内置 12 个可复用 Skill，覆盖文档生成、学术研究、前端设计等场景：

7. 目标驱动自主循环

/goal 命令设定会话停止条件。当 Agent 试图停止时，独立的 judge 模型评估对话是否真正满足目标——防止自主工作中的”乐观提前停止”。

8. Dream & Distill 自我进化

• /dream — 扫描近期会话轨迹，提取持久知识到项目记忆，删除过时条目
• /distill — 发现重复的手动工作流，将高置信度候选打包为可复用 Skill、子 Agent 或命令

9. 语音输入

实时流式语音输入，基于 TenVAD 和 MiMo ASR。通过 /voice 激活，音频按停顿分段并增量转写。

三、安装与配置

快速安装

# macOS / Linux 一键安装
curl -fsSL https://mimo.xiaomi.com/install | bash

# 或通过 npm 全局安装（全平台）
npm install -g @mimo-ai/cli --registry https://registry.npmjs.org

# 运行
mimo

Windows 原生安装（beta）支持 PowerShell 安装器。

首次配置

首次启动自动引导配置，支持以下选项：

• MiMo Auto（限时免费）— 匿名通道，零配置即可使用
• 小米 MiMo 平台 — OAuth 登录
• 从 Claude Code 导入 — 一键迁移现有认证
• 自定义 Provider — 在 TUI 中添加任意 OpenAI 兼容 API

配置文件

MiMo Code 使用 JSON/JSONC 配置文件，提供 JSON Schema 自动补全和校验：

支持通过 MIMOCODE_HOME 环境变量覆盖所有路径。可通过 experimental.maxMode 启用 Max Mode（并行 best-of-N 推理 + judge 选择）。

MiMo 生态

MiMo 模型不仅可在 MiMo Code 中使用，还支持 Cursor、Cline、Zed 等主流编程工具。awesome-mimo-agent 仓库收集了在这些工具中使用 MiMo 的配置指南。

四、竞品速览

五、使用技巧

Agent 模式选择建议

• 日常编码 → 使用 build Agent，拥有完整工具权限
• 方案探索 → 切换到 plan Agent（按 Tab），只读分析避免意外修改
• 复杂项目 → 使用 compose Agent 进行规格驱动开发，自动分解任务并并行执行

记忆系统最佳实践

• 在 MEMORY.md 中记录项目架构决策、代码规范和关键约定，Agent 每次恢复会话都会读取
• 使用 /goal 命令为长任务设定明确的停止条件，避免 Agent 无限循环
• 定期运行 /dream 让 Agent 自动整理会话记忆，清理过时信息

Workflow 与 Agent 的配合

• 任务明确、可拆解 → 优先使用 compose Workflow（确定性、并行、无需人工干预）
• 需要中途调整方向 → 使用 compose Agent（对话式、交互式、灵活调整）
• 多源研究 → 使用 deep-research Workflow，自动交叉验证事实

成本优化

• MiMo Auto 通道限时免费，适合快速体验和轻量使用
• 长期重度使用建议接入自己的 LLM Provider API（如 DeepSeek、Qwen 等低成本模型），完全免费
• 通过 .mimocode/mimocode.jsonc 配置不同 Agent 使用不同模型，build Agent 用强模型，plan Agent 用轻量模型

注意事项与限制

• 版本阶段：当前为 v0.1.0，功能和 API 可能频繁变动，生产环境使用需谨慎评估
• 平台兼容性：macOS / Linux 体验最佳，Windows 处于 beta 阶段，CJK 字符可能显示异常
• 模型依赖：MiMo Auto 通道的具体模型版本和性能未公开，建议实际测试代码生成质量
• 网络要求：使用 MiMo 托管服务需要稳定网络连接，完全本地部署则无此限制
• 资源占用：作为终端 Agent 需要完整的 Node.js/bun 运行时环境，大型项目可能消耗较多内存
• 社区生态：相比 Cursor 和 Claude Code，插件生态和第三方集成尚在早期阶段
• 隐私权衡：匿名 Auto 通道最方便但数据经小米服务器；本地 API 模式最安全但需自备 API Key
• 长期可持续性：作为小米免费开源项目，未来商业模式尚不明确。限时免费的 MiMo Auto 通道可能转为付费
• 文档完善度：英文文档较完整，中文文档正在完善中。部分高级功能（如自定义 Workflow）文档覆盖不足
• 竞品压力：AI 编程工具市场竞争激烈，Claude Code、Cursor、GitHub Copilot 等持续更新，需关注 MiMo Code 的长期竞争力
• 上游依赖：基于 OpenCode 构建，OpenCode 的版本更新和方向变化可能影响 MiMo Code 的开发节奏
• 学习曲线：终端原生 + 多 Agent 切换 + Workflow 配置的组合，对非专业开发者可能存在一定的上手门槛。建议从 MiMo Auto 通道和 build Agent 开始，逐步探索 plan/compose 模式
• 小米生态绑定风险：MiMo Auto 和 MiMo 平台服务由小米运营，若未来服务策略调整（如停服、收费模式变更），依赖这些通道的用户需迁移配置
• 本地化挑战：MiMo Code 的默认语言为英文，中文用户可能遇到 TUI 界面混合中英文的情况。社区正在完善中文文档和界面汉化
• 调试体验：相比 IDE 集成的编程工具（如 Cursor 的行内错误提示），终端 Agent 的调试反馈链路较长。建议配合 VS Code SDK 使用以获得更好的错误定位体验
• 更新频率：MiMo Code 以周为单位发布更新，部分功能可能在迭代中发生 breaking changes。建议关注 GitHub Releases 了解变更
• 适用场景边界：MiMo Code 擅长自主长任务执行和跨会话项目开发，但对于快速代码补全、单行修复等轻量场景，IDE 内嵌工具（如 Copilot）可能更高效

💡 上手建议：如果你是 AI 编程工具的新用户，建议先使用 MiMo Auto 通道体验 10-20 分钟的基础功能，再用自己的 API Key 做深度测试。有 Claude Code 使用经验的用户迁移成本最低——导入认证后几乎零切换成本。