MiMoCode（mimo）安装与使用

安装

三种官方方式，装完都是 mimo。

macOS / Linux：

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

二进制进 ~/.mimocode/bin/，脚本会改 shell 的 PATH。可选参数：

bash
curl -fsSL https://mimo.xiaomi.com/install | bash -s -- --version 0.1.0
./install --binary /path/to/mimo
./install --no-modify-path

Windows PowerShell：

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

装到 $env:USERPROFILE\.mimocode\bin。指定版本：

powershell
$env:VERSION = "0.1.0"; irm https://mimo.xiaomi.com/install.ps1 | iex

npm（各平台）：

bash
npm install -g @mimo-ai/cli

验证：

bash
mimo --version
mimo

Homebrew / pacman / Chocolatey / Scoop / Docker 那些是上游 OpenCode 的渠道，MiMoCode 官方安装里没有。

首次登录（Linux + TokenPlan）

要用小米 MiMo 的 TokenPlan，先在 shell 里登，再进 TUI。部分终端里 TUI 登录链接不好复制，容易卡死：

bash
mimo account login <url>

<url> 用小米 MiMo 平台地址。命令会打出链接和设备码，一般会开浏览器；凭据写到 ~/.local/share/mimocode/auth.json。

然后进项目再开：

bash
cd /path/to/your/project
mimo

进 TUI 后常用 /init 生成 AGENTS.md，/models（或 Ctrl+X M）切模型。

其它通道：首次启动也会引导 —— MiMo Auto（限时免费）、小米平台 OAuth、从 Claude Code 导入、自定义 OpenAI 兼容 Provider。TUI 里 /connect 可连 OpenRouter 一类。账号相关还有 mimo account logout / switch / orgs / open / console。

注意：mimo auth 是 MCP 鉴权，不是账号登录；账号用 mimo account login。

运行

bash
cd /path/to/your/project
mimo

参数	作用
`--continue` / `-c`	恢复上次会话
`--session <id>` / `-s`	打开指定会话
`--model <provider/model>` / `-m`	指定模型
`--agent <name>`	指定主智能体
`--trust`	信任当前项目目录
`--never-ask`	非交互不弹确认
`--dangerously-skip-permissions`	自动放行未显式拒绝的操作（很危险，TUI 会先红字确认）

无头模式：

bash
mimo run "为 src/utils 编写单元测试并运行"

WSL（Windows 上更省事）

按微软文档装好 WSL。
在 WSL 里：

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

进项目再 mimo。Windows 盘在 /mnt/c/、/mnt/d/。仓库尽量放到 WSL 本机文件系统（例如 ~/code/），少直接在 /mnt/c/ 上跑。配置和数据在 WSL 的 ~/.local/share/mimocode/。

剪贴板乱码可以装 xsel：

bash
sudo apt install xsel

Windows 本机

不想用 WSL 就用上面的 PowerShell 或 npm。中文乱码时，MiMoCode 已对子进程开过 UTF-8；仍乱的话可在「设置 → 时间和语言 → 语言和区域 → 管理语言设置 → 更改系统区域设置」勾选 Beta 的 Unicode UTF-8，然后重启。这是系统级开关，老软件可能受影响。

编辑器

在 VS Code / Cursor / Zed 的集成终端里直接跑 mimo 即可。要用 /editor、/export 调外部编辑器：

bash
export EDITOR="code --wait"   # Cursor 用 cursor --wait

仓库 sdks/vscode 里有个分屏扩展，命令 ID 还沿用上游 opencode.*。文档里的快捷键：Ctrl+Esc / Cmd+Esc 打开或聚焦；Ctrl+Shift+Esc / Cmd+Shift+Esc 新建会话；Alt+Ctrl+K / Cmd+Option+K 插入 @File#L37-42 这类引用。若终端里没有 code，用命令面板装 “Shell Command: Install 'code' command in PATH”。

CLI

命令	作用
`mimo`	TUI
`mimo run`	无头运行
`mimo mcp`	MCP
`mimo agent`	智能体（`list` 看已加载的）
`mimo models`	列模型
`mimo providers`	Provider
`mimo account`	账号
`mimo upgrade` / `uninstall`	升级 / 卸载
`mimo serve`	起服务端
`mimo stats`	统计
`mimo export` / `import`	导出会话
`mimo session`	会话管理
`mimo github` / `pr`	GitHub / PR
`mimo plugin`	插件
`mimo completion`	shell 补全

任意命令加 --help。

TUI 斜杠命令

命令	作用
`/goal`	设停止条件，由裁判模型核实后再停
`/dream`	从近期轨迹抽知识进项目记忆（默认定时）
`/distill`	把重复流程收成 skill / subagent / command
`/voice`	语音输入（要 `sox`，且需 MiMo 登录）
`/loop [interval] <prompt>`	周期跑提示（如 `30m`）
`/loops`	列出 / `cancel <id>`
`/rebuild`	按最新 checkpoint 重建上下文
`/connect`	登录 Provider
`/init`	生成 `AGENTS.md` 等
`/models`	切模型
`/<skill-name>`	调技能

Tab 在 build / plan / compose 间切换。默认 leader 是 Ctrl+X：<leader>n 新会话、l 列表、e 外部编辑器、t 主题、b 侧边栏；Ctrl+R 重命名。绑定可在配置里改，设成 "none" 即禁用：

jsonc
{ "keybinds": { "session_new": "<leader>c", "sidebar_toggle": "none" } }

配置

JSON / JSONC，首次加载会注入 $schema。

文件	项目级	全局
主配置	`.mimocode/mimocode.jsonc`	`~/.config/mimocode/mimocode.jsonc`
TUI	`.mimocode/tui.json`	`~/.config/mimocode/tui.json`
凭据	—	`~/.local/share/mimocode/auth.json`

Windows 上 XDG 在 %LOCALAPPDATA%\mimocode\。可用环境变量 MIMOCODE_HOME（绝对路径）整体改根目录。Schema：https://mimo.xiaomi.com/mimocode/config.json、tui.json。项目配置覆盖全局；改完用 mimo models 或 TUI 模型列表确认，下一轮对话生效。

jsonc
{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "model": "anthropic/claude-opus-4-8",
  "model_groups": { "lite": "anthropic/claude-haiku" },
  "dream": { "auto": true, "interval_days": 3 },
  "compaction": { "tail_turns": 3 },
  "permission": { "external_directory": { "/tmp/**": "allow" } },
  "mcp": {
    "my-server": { "type": "local", "command": ["node", "server.js"] }
  }
}

自定义 OpenAI 兼容端点：

jsonc
{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "model": "custom/MODEL_NAME",
  "provider": {
    "custom": {
      "name": "Custom",
      "npm": "@ai-sdk/openai-compatible",
      "only_configured_models": true,
      "models": { "MODEL_NAME": { "name": "MODEL_NAME" } },
      "options": { "baseURL": "BASE_URL", "apiKey": "API_KEY" }
    }
  }
}

字段名就是 baseURL、apiKey；Base URL 和模型 ID 按对方文档原样填，不要擅自加减 /v1。apiKey 明文落盘，权限收紧，别提交进仓库。

智能体与记忆

智能体	说明
build	默认，完整工具权限
plan	只读分析
compose	编排 / specs-driven

记忆主要在：

MEMORY.md：跨会话项目知识
checkpoint.md：自动检查点
notes.md：暂存
tasks/<id>/progress.md：任务进展

规则想马上生效，直接让它改 MEMORY.md 即可。

语音

/voice 走 TenVAD + MiMo ASR，按停顿往输入框追加。要 MiMo 登录，并装 sox（macOS：brew install sox）。ASR 模型 mimo-v2.5-asr 只在 MiMo 平台；控制模型可通过 OpenRouter 等中转。WSLg 音频示例：

bash
export PULSE_SERVER=unix:/mnt/wslg/PulseServer

主题

<leader>t 切换。主题文件放 .mimocode/themes/ 或全局配置目录；tui.json 可调外观细节。

从源码跑

仓库用 Bun：

bash
bun ci
bun run dev
bun turbo typecheck

CLI 在 packages/opencode/，入口 packages/opencode/bin/mimo。

ai协作，人工编辑