MiMoCode 快速上手教程（GitHub README 中文整理）

是什么

MiMoCode 是小米开源的一款终端原生 AI 编程助手，主打"模型与智能体协同进化"的理念。它运行在命令行界面中，能够读写代码、执行命令、管理 Git 操作，并内置了持久化记忆系统——这意味着它能在多次会话之间保持对项目的深入理解，并持续自我改进。

MiMoCode 内置了 MiMo Auto 通道（限时免费），开箱即用，无需任何配置。同时它也支持连接任何主流的 LLM 提供商 API，灵活性很高。

能干什么

MiMoCode 的核心能力围绕三种智能体模式展开：

按 Tab 键可以在主智能体之间切换。系统会根据需要自动创建子智能体。注意：首条消息发送后模式会锁定，Build 和 Plan 之间仍可互切，但一旦进入 Compose 模式就会被隔离——这样能保证技能/工具集在会话中固定不变，显著提升工具调用的可靠性。

对于前沿模型（如 Fable/Sol 级别），官方推荐在 build 智能体中使用 /compose-next 技能来执行 compose 风格的工作。

怎么装

MiMoCode 支持多种安装方式，覆盖所有主流平台：

macOS / Linux 一行安装：

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

Windows PowerShell 一行安装：

powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

或通过 npm 安装（全平台通用）：

npm install -g @mimo-ai/cli

安装完成后，在终端运行 mimo 即可启动。

常见环境问题：

• WSL 剪贴板乱码：安装 xsel 即可解决：sudo apt install xsel
• macOS 自带终端渲染异常：MiMoCode 不支持 Terminal.app，建议使用 iTerm2 或 VS Code 集成终端：brew install --cask iterm2
• SSH 远程 TUI 卡顿：在远程主机上运行 mimo serve --port 4096，本地通过 SSH 端口转发 ssh -N -L 4096:127.0.0.1:4096 user@remote-host，然后本地执行 mimo attach http://127.0.0.1:4096 连接。如果只是动画卡顿，运行 /vivid 或在 ctrl+p 命令面板中切换视觉模式。
• Windows 中文乱码：MiMoCode 会强制子进程使用 UTF-8 输出，若仍有乱码，可在系统设置中开启"Beta: 使用 Unicode UTF-8 提供全球语言支持"（系统级开关，可能影响旧版非 Unicode 程序，请谨慎使用）。

怎么用第一个例子

首次启动 mimo 时，配置向导会自动引导你完成设置。支持的认证方式包括：

• MiMo Auto（限时免费）——匿名通道，零配置直接使用
• 小米 MiMo 平台——OAuth 登录
• Codex（ChatGPT Pro/Plus）——OpenAI OAuth 登录
• 从 Claude Code 导入——一键迁移已有认证
• 提供商列表——通过 API Key 连接目录中的提供商（如 xAI/Grok）
• 自定义提供商——在 TUI 中添加任何兼容 OpenAI 的 API

配置完成后，直接在项目目录下运行 mimo，输入你的需求即可。例如：

cd your-project
mimo

然后输入类似"帮我重构这个模块的代码"或"修复这个测试失败的问题"，MiMoCode 就会开始工作。

社区资源

MiMoCode 是小米 MiMo 模型生态的一部分。除了本工具，MiMo 模型还可以在 Cursor、Cline、Zed 等其他编程工具中使用。

awesome-mimo-agent 收集了在这些工具中使用 MiMo 的配置指南，如果你想在其他地方尝试 MiMo，值得一看。也欢迎通过 PR 贡献你自己的配置教程。

翻译整理自 GitHub README，原文：https://github.com/XiaomiMiMo/MiMo-Code