2026-06-11 · 教程 · 约 5 分钟阅读 · 编辑: MiMo AI 社区

MiMo Code 快速上手教程

第一步：安装 MiMo Code

MiMo Code 支持 macOS、Linux 和 Windows（WSL）三大平台。安装前请确保你的系统满足以下最低要求：

• macOS：macOS 12+（Monterey 及以上），推荐 Apple Silicon 芯片以获得最佳性能
• Linux：任意主流发行版（Ubuntu 20.04+、Debian 11+、CentOS 8+ 等均已测试通过），需 curl 和 bash 支持
• Windows：推荐使用 WSL2（Windows Subsystem for Linux），原生 Windows 支持正在开发中，预计 2026 年 Q3 发布

在终端中运行以下命令即可完成安装：

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

安装脚本会自动检测你的操作系统并完成安装。安装过程包括：下载二进制文件、配置 PATH 环境变量、创建配置文件目录。安装完成后，关闭并重新打开终端，或运行：

source ~/.bashrc  # 或 source ~/.zshrc

验证安装是否成功：

mimo-code --version

如果显示版本号（例如 v0.1.0），说明安装成功。

第二步：配置 API Key

首次启动 MiMo Code 需要配置 API Key。MiMo Code 支持多种 API 后端，最推荐的方式是使用小米官方的 MiMo API：

mimo-code

启动后，按照提示输入你的 API Key。如果没有 API Key，可以按照以下步骤获取：

1. 访问 platform.xiaomimimo.com 注册账号
2. 在控制台进入 API Keys 管理页面，点击「Create New Key」
3. 复制生成的 API Key（新用户注册即送 $2 免费试用额度，足够完成数千次简单查询）
4. 将 API Key 粘贴到 MiMo Code 的配置提示中

也可以使用环境变量配置，这种方式适合 CI/CD 场景或多账号管理：

export MIMO_API_KEY=your-key-here
mimo-code

如果你希望使用其他模型提供商（如 OpenAI、Anthropic），也可以在配置文件中指定——详见"第五步：多智能体切换"部分。

第三步：基本命令

MiMo Code 提供了一套直观的命令体系，让开发者可以通过自然语言与代码库进行交互。以下是三个最核心的命令：

/ask — 提问代码问题

mimo-code /ask "这个项目的架构是怎样的？"

MiMo Code 会自动分析当前代码库的结构，理解各模块之间的依赖关系，并给出架构解读。除了简单的架构问答，/ask 还能胜任以下场景：

• 代码解释："这个函数的时间复杂度是多少？"
• 依赖分析："哪些模块引用了这个 util？"
• 重构建议："这段代码有哪些可以改进的地方？"
• Bug 定位："为什么这段代码在 Edge 浏览器上会报错？"

/ask 命令的核心优势在于其跨文件分析能力——它不会孤立地看待单个文件，而是将整个代码库作为上下文来理解。

/edit — 自动编辑代码

mimo-code /edit "给所有 API 端点添加错误处理"

MiMo Code 会分析你的需求，生成具体的修改方案，并以 diff 格式展示所有变更。开发者可以逐项审查变更，确认后再应用到文件中。这种"审阅后应用"的模式大大降低了 AI 自动编辑的风险。支持的编辑类型包括：

• 批量文件修改（跨多个文件同步变更）
• 智能重构（提取函数、重命名变量、优化结构）
• Bug 修复（根据错误描述定位并修复问题）
• 代码格式化（统一代码风格）
• 测试用例生成（为现有代码自动生成单元测试）

/run — 执行命令并分析

mimo-code /run "npm test"

执行命令并捕获其输出。MiMo Code 会分析执行结果，识别错误信息，并根据情况自动调整后续操作。例如，如果测试失败，它可以分析失败原因并提出修复方案。这种"执行-分析-迭代"的闭环使得调试效率大幅提升。

第四步：连接到 Git 仓库

MiMo Code 与 Git 工作流深度集成，能够自动检测当前仓库的状态并辅助完成各种 Git 操作。无论是个人项目还是团队协作，MiMo Code 都能显著提升代码管理效率：

• 自动 commit：编辑后自动生成有意义的 commit 消息。MiMo Code 会分析所有变更文件，理解变更的上下文和目的，生成符合 Conventional Commits 规范的消息（如 feat: / fix: / refactor:）
• 代码审查：运行 /ask "Review the latest commit" 可对最近一次提交进行详细的代码审查，包括潜在的 Bug、安全漏洞、性能问题和代码风格建议
• 冲突解决：遇到 merge conflict 时帮助分析冲突原因并提供解决方案。MiMo Code 会读取冲突文件，理解双方的修改意图，推荐最优的合并策略
• PR 描述生成：基于当前分支与目标分支的 diff 自动生成 PR 描述，包括变更摘要、改动文件列表、测试建议和 Breaking Change 提示

此外，MiMo Code 还支持交互式 rebase 辅助、Git bisect 分析和分支命名建议等高级功能。所有 Git 操作均通过标准 Git 命令执行，不会绕开你的 Git 配置和 hooks。

第五步：多智能体切换

MiMo Code 的一个核心特性是其多智能体架构——它支持同时配置多个 AI 模型作为后端，并根据任务类型自动路由到最合适的模型。这不仅能在保证质量的同时优化成本，还提供了极大的灵活性：

# 在 ~/.mimo/config.yaml 中配置
agents:
  default:
    model: mimo-v2.5-pro
    api_base: https://api.xiaomimimo.com/v1
  fallback:
    model: gpt-4o
    api_base: https://api.openai.com/v1
  coding:
    model: mimo-v2-flash
    api_base: https://api.xiaomimimo.com/v1

配置说明：

• default：默认使用的模型，推荐 MiMo-V2.5-Pro，兼顾推理能力与性价比
• fallback：当默认模型不可用时的备用模型，可以是其他厂商的 API
• coding：可以指定针对代码生成/编辑场景的专用模型，如 MiMo-V2-Flash 以追求高速

你也可以在交互模式下通过 /agent 命令手动切换当前会话使用的模型。这种"智能体路由"机制在实际使用中非常实用——简单查询走高速廉价模型，复杂推理走旗舰模型，实现了成本与质量的动态平衡。

第六步：高级技巧

当你熟悉了基本操作后，以下高级技巧可以帮助你更充分地发挥 MiMo Code 的潜力：

• 持久化记忆：MiMo Code 会记住项目约定和架构决策，跨会话保持上下文。这意味着你不需要在每次新会话中重复配置偏好——它知道你的代码风格、测试框架选择、包管理工具偏好等。这种记忆基于本地存储，不会上传到云端，保障了代码隐私。
• 自定义 prompt：在项目根目录创建 .mimo_prompt 文件，定义项目级别的系统提示。例如，你可以告诉 MiMo Code 你的项目使用的编码规范、依赖管理方式、测试策略等。每次启动会话时，MiMo Code 会自动加载这些指令。
• VS Code 集成：虽然 MiMo Code 是终端原生工具，但你可以通过 Claude Code + MiMo 配置 在 VS Code 的终端中使用，或者将 MiMo API 配置到 Cursor 等 AI 编辑器中
• CI/CD 集成：在 GitHub Actions 或 GitLab CI 中调用 MiMo Code 进行自动化 code review。只需在 CI 流程中配置 API Key，即可实现每次 PR 提交自动触发的代码审查
• 批量重构：配合 /edit 命令，可以在整个代码库范围内执行大规模重构操作，如"将所有的 var 替换为 const/let"或"将所有 API 路由从 Express 迁移到 Fastify"
• 多项目并行：MiMo Code 的持久化记忆按项目隔离，你可以在不同项目目录下同时维护多个会话，互不干扰

常见问题

Windows 支持？

推荐使用 WSL2（Windows Subsystem for Linux）运行。在 WSL2 终端中执行安装命令即可原生运行。原生 Windows 命令行版本正在开发中，预计 2026 年 Q3 发布，届时将支持 PowerShell 和 CMD。

如何卸载？

直接删除二进制文件和配置目录即可：

rm -rf ~/.mimo ~/.local/bin/mimo-code

如果已将 mimo-code 添加到系统 PATH 的其他位置，也请一并删除。运行 which mimo-code 可以定位二进制文件的具体位置。

支持哪些语言？

MiMo Code 支持所有主流编程语言，包括但不限于：Python、JavaScript/TypeScript、Go、Rust、Java/Kotlin、C/C++、Ruby、PHP、Swift、Scala、Shell 脚本等。模型的后端推理能力决定了支持语言的广度——由于 MiMo-V2.5-Pro 在代码理解上表现出色，即使是小众语言（如 Elixir、Haskell、OCaml）也能获得不错的支持。

隐私与安全性如何？

MiMo Code 将代码索引和持久化记忆存储在本地，不会上传到云端。实际代码编辑和查询通过 API 调用发送给后端模型，因此建议不要将敏感信息（如密码、密钥）直接作为 prompt 发送。对于企业用户，可以考虑使用 MiMo 的私有部署方案。

费用如何？

MiMo Code 本身是 MIT 开源项目，完全免费。你需要自行承担 API 调用费用。MiMo API 的价格极具竞争力（V2.5-Pro 输入 $1/M tokens，输出 $3/M tokens），个人开发者每月几十元人民币即可满足日常使用。企业用户可通过 MiMo Token Plan 订阅获得更优惠的批量价格。

如何更新？

重新运行安装命令即可覆盖更新到最新版本：

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