README

MiMoCode


  


MiMo Code: Where Models and Agents Co-Evolve


  中文 | English



  官网 | 博客


MiMoCode 是一个终端原生的 AI 编程助手。它能读写代码、执行命令、管理 Git，通过持久化记忆系统，在多次会话间保持对你项目的深度理解，并自我进化。

支持接入各家主流 LLM 厂商 API。

 Xiaomi MiMo Desktop

国内版下载 | Global Download



Xiaomi MiMo Desktop 面向真实工作场景打造，一个会话即可完成办公、设计、编程和全模态创作；多个会话可自动分工、协作与通信。桌面端以 MiMo Code 作为核心引擎，将终端原生的智能能力延伸到桌面工作流。

- 「Smart」调度：自动评估任务类型与成本，动态选择模型、框架与工具，复杂任务由多个 Agent 并行推进。
- 从生成结果到持续迭代：支持拖入多格式文件，成果覆盖 PPT、网页、3D、App 等；会话内实时预览和操作，选中局部即可精准修改，并支持版本回退。
- 让长任务成本可控：标准与旗舰模型自动路由，局部编辑只修改需要的部分；同会话缓存命中率最高 99%，跨会话最高 95%。
- 浏览器操控：自主打开网页、检索和提取信息、填写表单，生成网页后自动检查关键交互。
- 电脑操控（仅限海外版）：读屏并操作键鼠，跨应用执行；Record & Replay 录制一次后，可用自然语言复用。

搭载新一代小米模型 MiMo-V2.6-Pro 和 MiMo-V2.6-Flash。

---

 快速开始

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

 一键安装（Windows PowerShell）
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

 运行
mimo


首次启动自动引导配置。支持：
- 小米 MiMo 平台 — OAuth 登录
- Codex（ChatGPT Pro/Plus） — OpenAI OAuth 登录
- 从 Claude Code 导入 — 一键迁移已有认证
- Provider 列表 — 通过 API Key 接入目录内厂商，部分支持 OAuth（如 xAI/Grok）
- 自定义 Provider — TUI 内添加任意 OpenAI 兼容 API


WSL：剪贴板问题

如果在 WSL 上复制出现乱码，安装 xsel：
bash
sudo apt install xsel




macOS：默认终端渲染异常

MiMoCode 不支持 macOS 自带的“终端”（Terminal.app）。如果界面出现错位、闪烁或其他渲染异常，请改用 iTerm2 或 VS Code 集成终端：

bash
brew install --cask iterm2




TUI 卡顿与视觉动画问题

如果通过 SSH 直接运行 TUI 时卡顿，可以让 TUI 在本地渲染，远端只运行 MiMoCode 服务。先在远端项目目录中启动服务：

bash
 远端主机
mimo serve --port 4096

 本地主机：建立 SSH 端口转发
ssh -N -L 4096:127.0.0.1:4096 user@remote-host

 本地主机：在另一个终端连接远端 MiMoCode
mimo attach http://127.0.0.1:4096


如果卡顿来自装饰性动画，可以运行 /vivid，或在 ctrl+p 命令面板中设置“丰富显示”，根据实际情况在丰富视觉模式和简洁模式间切换。




Windows：shell 输出中文（CJK）乱码

在系统区域为非 UTF-8 的 Windows 上（如简体中文，活动代码页为 936/GBK），命令输出里的
中日韩字符可能显示为乱码。MiMoCode 已为 PowerShell/cmd 子进程强制开启 UTF-8 输出。
如果在尚未覆盖的场景下仍遇到乱码，可以开启 Windows 的系统级 UTF-8 支持：

设置 → 时间和语言 → 语言和区域 → 管理语言设置 → 更改系统区域设置 →
勾选「Beta 版: 使用 Unicode UTF-8 提供全球语言支持」→ 重启。

这会把活动代码页（ACP）切换为 UTF-8（65001），所有程序都生效，子进程不再继承旧代码页。
注意这是系统级 Beta 开关，可能导致部分老的非 Unicode 程序显示异常，建议作为临时方案。



如何配置联网搜索

如需让 Agent 联网搜索，可以设置 MIMOCODE_ENABLE_EXA=1 启用内置的 websearch 和 codesearch 工具（基于 Exa；如需更高频率上限，在 https://dashboard.exa.ai/api-keys 创建 Key 并设置 EXA_API_KEY），或在配置的 mcp 下添加一个搜索 MCP 服务。密钥可通过 {env:VAR} 从环境变量读取：

jsonc
{
  "mcp": {
    // Exa（Key 可选：在 https://dashboard.exa.ai/api-keys 创建后，在 URL 末尾加 ?exaApiKey=）
    "exa": { "type": "remote", "url": "https://mcp.exa.ai/mcp" },
    // Tavily（在 https://app.tavily.com 获取 API Key）
    "tavily": {
      "type": "remote",
      "url": "https://mcp.tavily.com/mcp/",
      "headers": { "Authorization": "Bearer {env:TAVILY_API_KEY}" }
    },
    // 火山引擎豆包搜索（需要 uv 与 Python 3.12/3.13；
    // 在 https://console.volcengine.com/search-infinity/api-key 获取 Key）
    "doubao-search": {
      "type": "local",
      "command": ["uvx", "--from", "mcp-server-askecho-search-infinity=0.2.0", "mcp-server-askecho-search-infinity"],
      "environment": { "ASK_ECHO_SEARCH_INFINITY_API_KEY": "{env:ASK_ECHO_SEARCH_INFINITY_API_KEY}" }
    }
  }
}