Research Notes

MiMo Code Windows CLI

3 min read

这是一个面向 Windows 11 终端的中国友好设置，用来安装和使用 MiMoCode。MiMoCode 是小米开源的 AI 编程智能体，重点是终端原生、跨会话记忆和项目上下文保持。

推荐默认选择：先用 MiMo Auto。这是内置的限时免费通道，可以先不用配置 API key 就开始试用。

1. 安装 Node.js 和 Git

打开 PowerShell：

winget install OpenJS.NodeJS.LTS
winget install Git.Git

关闭并重新打开 PowerShell，然后检查：

node -v
npm -v
git --version

2. 安装 MiMoCode

Windows PowerShell 推荐用 npm：

npm install -g @mimo-ai/cli
mimo --version

如果你已经在用 Git Bash 或 WSL，也可以用一键安装脚本：

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

GitHub release 里包含 Windows 构建，包括 mimocode-windows-x64.zip、 mimocode-windows-x64-baseline.zip 和 mimocode-windows-arm64.zip。

3. 第一次启动：选择 MiMo Auto

在项目目录里运行：

cd C:\dev\your-project
git status
mimo

第一次启动时选择：

MiMo Auto

先用它，因为这是最低摩擦的免费/低成本路径：

  • 不需要把 API key 写进配置
  • 不需要 DeepSeek token
  • 试工具之前不需要先配置付费 provider
  • 足够做基础仓库理解和小型代码修改

如果之后 MiMo Auto 要求登录，可以用小米 MiMo Platform 登录。只有在你明确需要某个 模型或公司付费 API 时，再添加 Custom Provider。

4. 好的第一条 prompt

先从只读探索开始：

Use plan mode. Inspect this repository and explain the architecture.
Do not edit files yet.
Tell me the smallest safe first change for <task>.

然后再做小修改：

Goal: make the smallest safe change that implements <task>.
Before editing, inspect the relevant files and explain the plan.
Do not touch unrelated files.
After editing, run the smallest relevant test or check.
Summarize changed files, commands run, and remaining risks.

5. 可选：之后再配置 Custom Provider

先确认 MiMo Auto 能正常工作，再做这一步。

MiMoCode 支持在 TUI 里添加 OpenAI-compatible provider。项目级配置在 .mimocode/mimocode.json，全局配置在 ~/.config/mimocode/mimocode.json。

实用规则：

  • onboarding 和日常低成本检查先用 MiMo Auto。
  • 只有需要特定付费模型时，才配置 custom provider。
  • 不要把可复用 API key、SSH key 或公司 secret 写进文档。

为什么用 MiMoCode

上游 README 介绍的能力包括：

  • build、plan、compose 多智能体
  • 通过 MEMORY.md 保存项目记忆
  • session checkpoint
  • subagent
  • task tracking
  • /goal、/dream、/distill
  • 登录 MiMo 用户可用 voice input

MiMoCode 基于 OpenCode fork 构建，保留 provider、TUI、LSP、MCP、plugin 等能力， 同时加入 MiMo 的记忆和自主工作流功能。

Sources