从小白到大神：MiMo Code 配置与使用“零基础”通关秘籍
·
从小白到大神：MiMo Code 配置与使用“零基础”通关秘籍
📅 安装日期：2026-06-11
🖥️ 系统环境：Windows + Node.js v20.19.4
📦 版本：MiMo Code v0.1.0
目录
1. MiMo Code 是什么？
MiMo Code 是 小米开源 的终端原生 AI 编程助手（基于 OpenCode fork），它可以：
| 能力 | 说明 |
|---|---|
| 📖 读写代码 | 理解项目，编写、修改、重构代码文件 |
| 💻 执行命令 | 运行 shell 命令、测试、构建脚本 |
| 🔀 Git 管理 | 提交、分支、PR 等 Git 操作 |
| 🧠 跨会话记忆 | 基于 SQLite FTS5，记住项目上下文，下次打开继续 |
| 🔄 智能上下文管理 | 自动 checkpoint + 上下文压缩，长对话不丢失信息 |
| 🤖 多智能体 | Build / Plan / Compose 三种主代理 + 可按需生成的子代理 |
两种使用方式
| 方式 | 说明 |
|---|---|
| TUI 终端界面 | 在终端中运行 mimo，全键盘操作，类 Vim 体验 |
| Web 图形界面 🌐 | 运行 mimo web，浏览器打开，完整的可视化 UI（类似 Reasonix Code 客户端！） |
核心特性一览
- 75+ LLM 提供商支持（DeepSeek、OpenAI、Anthropic、Xiaomi MiMo 等）
- 三种工作模式：Build（完整权限）/ Plan（只读分析）/ Compose（编排工作流）
- 持久化记忆：
MEMORY.md+checkpoint.md+ 任务日志 - MCP 服务器集成（Sentry、Context7、GitHub 等）
- 自定义命令（Markdown 定义斜杠命令）
- LSP 集成（30+ 语言自动诊断）
- 代码格式化自动化（20+ 格式化工具内置）
- 语音输入支持
- 会话分叉 & 导出
2. 环境准备
必须
- Node.js ≥ 18（推荐 20 LTS）
- npm（随 Node.js 安装）
- 一款现代终端（推荐 Windows Terminal）
# 检查版本
node --version # 应 ≥ v18
npm --version # 应 ≥ 9
可选但强烈推荐
- Windows Terminal（微软商店免费下载）—— 比 CMD/PowerShell 自带终端体验好很多
- 真彩色支持（Windows Terminal 默认支持）
3. 安装步骤
Windows 安装（一条命令）
npm install -g @mimo-ai/cli
安装完成后验证：
mimo --version
# 输出：0.1.0
⚠️ 如果 npm 提示
allow-scripts警告，运行以下命令：npm approve-scripts @mimo-ai/cliWindows 下 postinstall 脚本会自动跳过（使用内置 .exe），无需额外操作。
安装位置
| 内容 | 路径 |
|---|---|
| 可执行文件 | %APPDATA%\npm\mimo.cmd |
| 全局配置 | %USERPROFILE%\.config\mimocode\mimocode.json |
| 认证数据 | %USERPROFILE%\.local\share\mimocode\data\auth.json |
| 数据库 | %USERPROFILE%\.local\share\mimocode\mimocode.db |
4. API Key 配置
MiMo Code 支持多种方式添加 API Key，这里介绍两种最实用的方法。
方法一：命令行直接添加（推荐）
# 添加 DeepSeek API Key（管道输入）
echo sk-xxxxxx | mimo providers login --provider deepseek --method apikey
# 添加 Xiaomi MiMo API Key
echo sk-xxxxxx | mimo providers login --provider xiaomi --method apikey
验证是否添加成功：
mimo providers list
输出应显示：
Credentials
• DeepSeek api
• Xiaomi api
2 credentials
方法二：TUI 内交互添加
启动 MiMo Code 后，在输入框中输入：
/connect
按提示选择提供商 → 粘贴 API Key → 完成。
本机已配置的模型
| 提供商 | 模型 ID | 说明 |
|---|---|---|
| DeepSeek | deepseek/deepseek-chat |
DeepSeek V3/V4（通用对话） |
| DeepSeek | deepseek/deepseek-reasoner |
DeepSeek R1（推理增强） |
| DeepSeek | deepseek/deepseek-v4-flash |
DeepSeek V4 Flash（快速） |
| DeepSeek | deepseek/deepseek-v4-pro |
DeepSeek V4 Pro（推荐） |
| Xiaomi | mimo/mimo-v2.5 |
MiMo 2.5（基础） |
| Xiaomi | mimo/mimo-v2.5-pro |
MiMo 2.5 Pro（推荐） |
| Xiaomi | xiaomi/mimo-v2.5-pro |
MiMo 2.5 Pro（xiaomi 源） |
| Xiaomi | xiaomi/mimo-v2.5-pro-ultraspeed |
MiMo 2.5 Pro 极速版 |
| Xiaomi | xiaomi/mimo-v2-flash |
MiMo V2 Flash |
| Xiaomi | xiaomi/mimo-v2-omni |
MiMo V2 Omni |
| Xiaomi | xiaomi/mimo-v2-pro |
MiMo V2 Pro |
💡 查看完整模型列表：
mimo models
5. 启动 MiMo Code
5.1 TUI 终端模式（默认）
# 在当前目录启动
mimo
# 在指定项目目录启动
mimo D:\my-project
# 恢复上次会话
mimo --continue
# 指定模型启动
mimo --model deepseek/deepseek-v4-pro
首次启动会自动引导配置（如果还没配 API Key）。
5.2 Web 图形界面
# 启动 Web 服务
mimo web --port 4096
# 浏览器打开
# → http://127.0.0.1:4096/
🔒 生产环境建议设置密码：
set MIMOCODE_SERVER_PASSWORD=your_password set MIMOCODE_SERVER_USERNAME=admin mimo web --port 4096
5.3 命令行单次运行
# 直接问一个问题（适合脚本/CI）
mimo run --model deepseek/deepseek-v4-pro "解释这个项目的架构"
# 在指定目录下运行
mimo run --model mimo/mimo-v2.5-pro "分析代码质量问题"
6. 基础操作速查
6.1 斜杠命令（在 TUI 输入框中使用）
| 命令 | 快捷键 | 说明 |
|---|---|---|
/help |
— | 查看帮助 |
/models |
— | 选择 / 切换模型 |
/connect |
— | 添加 API 提供商 |
/init |
— | 初始化项目（生成 AGENTS.md） |
/new |
Ctrl+X N |
新建会话 |
/sessions |
Ctrl+X L |
浏览 / 恢复历史会话 |
/undo |
— | 撤销上一步修改 |
/redo |
— | 重做撤销的修改 |
/compact |
Ctrl+X C |
手动压缩上下文 |
/theme |
— | 切换主题 |
/exit |
Ctrl+C / Ctrl+D |
退出 |
6.2 模式切换（核心操作）
按 Tab 键在三种工作模式间循环切换：
Build ──Tab──▶ Plan ──Tab──▶ Compose ──Tab──▶ Build ──...
| 模式 | 右下角标识 | 权限 | 适用场景 |
|---|---|---|---|
| Build | 🔨 Build | 全部权限：读写文件、执行命令 | 日常开发、修 bug、写功能 |
| Plan | 📋 Plan | 只读：不能写文件、不能执行命令 | 代码分析、方案设计、架构评审 |
| Compose | 🎼 Compose | 编排权限：通过 13 个内置技能驱动工作流 | TDD、Code Review、结构化开发 |
🔑 最佳实践：
- 先用 Plan 模式分析代码、制定方案
- 确认方案后切换到 Build 模式实施
- 复杂任务切换到 Compose 模式，享受技能驱动的结构化工作流
6.3 模型切换
在 TUI 中输入：
/models
会弹出模型选择器，用方向键选择 → 回车确认。
或者用快捷键循环切换模型变体（如果有配置变体）。
命令行指定模型：
mimo --model deepseek/deepseek-v4-pro
mimo --model mimo/mimo-v2.5-pro
6.4 权限控制
在 mimocode.json 中配置：
{
"permission": {
"*": "ask", // 默认：所有操作都询问
"bash": {
"git *": "allow", // git 命令自动放行
"npm *": "allow", // npm 命令自动放行
"rm *": "deny", // 禁止 rm 删除命令
"*": "ask" // 其他 bash 命令询问
},
"edit": {
"*.md": "allow", // Markdown 文件直接编辑
"*": "ask" // 其他文件编辑需确认
}
}
}
三种权限级别：
| 级别 | 含义 |
|---|---|
allow |
自动执行，不询问 |
ask |
弹出确认框（once / always / reject） |
deny |
直接拒绝 |
💡 TUI 中弹出确认时：
- once — 仅本次放行
- always — 本次会话中同类型操作自动放行
- reject — 拒绝本次
6.5 快速参考卡片
┌─────────────────────────────────────────────────────┐
│ MiMo Code 速查卡 │
├─────────────────────────────────────────────────────┤
│ 模型切换 /models │
│ 模式切换 Tab 键 │
│ 新建会话 /new (Ctrl+X N) │
│ 历史会话 /sessions (Ctrl+X L) │
│ 中断回答 Esc 键 │
│ 文件引用 @文件名 (模糊搜索) │
│ 执行命令 !命令 (如 !npm test) │
│ 撤销/重做 /undo / /redo │
│ 换行输入 Shift+Enter │
│ 退出 /exit (Ctrl+C) │
│ │
│ Building — 全权限开发 │ Planning — 只读分析 │
│ Composing — 技能编排 │ Tab 键切换 │
└─────────────────────────────────────────────────────┘
7. 配置文件详解
7.1 配置层级（优先级从高到低）
- 项目级
.mimocode/mimocode.json— 项目特定配置 - 全局级
~/.config/mimocode/mimocode.json— 用户全局配置
两者会合并，项目级覆盖全局级。
7.2 当前全局配置
位置：%USERPROFILE%\.config\mimocode\mimocode.json
{
"$schema": "https://mimo.xiaomi.com/config.json",
"model": "xiaomi/mimo-v2.5-pro",
"provider": {
"deepseek": {
"baseURL": "https://api.deepseek.com/v1"
},
"mimo": {
"baseURL": "https://api.xiaomimimo.com/v1"
},
"xiaomi": {
"baseURL": "https://api.xiaomimimo.com/v1"
}
},
"permission": {
"*": "ask",
"bash": {
"git *": "allow",
"npm *": "allow",
"node *": "allow",
"grep *": "allow",
"dir *": "allow",
"type *": "allow",
"where *": "allow",
"*": "ask"
}
}
}
7.3 认证文件
位置：%USERPROFILE%\.local\share\mimocode\data\auth.json
API Key 通过 mimo providers login 命令自动管理，通常不需要手动编辑。
7.4 推荐：项目初始化时生成项目配置
cd your-project
mimo
# 在 TUI 中输入：
/init
MiMo Code 会分析项目结构，自动生成 AGENTS.md（项目规则文件），建议提交到 Git。
8. 常见问题与技巧
Q1: MiMo Code 有桌面客户端吗？
有！但不是独立的 .exe 客户端，而是 Web 界面：
mimo web --port 4096
浏览器打开 http://127.0.0.1:4096/ 就是完整的图形界面，功能和 Reasonix Code 类似。
Q2: 默认使用哪个模型？
当前配置默认模型为 mimo/mimo-v2.5-pro。启动时可以用 --model 覆盖：
mimo --model deepseek/deepseek-v4-pro
Q3: 如何仅让 AI 分析代码，不修改文件？
按 Tab 切换到 Plan 模式，此模式下无法写文件和执行命令，只能进行分析和建议。
Q4: 上下文太长怎么办？
- 自动：MiMo Code 接近上下文上限时自动压缩
- 手动：输入
/compact（快捷键Ctrl+X C） - 配置：在
mimocode.json中调整compaction.reserved（压缩缓冲区）
Q5: 如何撤销 AI 的修改？
输入 /undo 即可撤销上一步所有修改。可连续多次 /undo。用 /redo 可重做。
Q6: MiMo Code 有哪些免费模型？
- MiMo Auto（限时免费）— 首次启动时可选的匿名免费通道，零配置
- 本机已配置 DeepSeek 和 Xiaomi MiMo 用自己的 API Key 扣费
- 可用
/connect在 TUI 中添加其他提供商的免费额度
Q7: 如何在项目中使用自定义命令？
在项目目录下创建 .mimocode/commands/my-cmd.md：
---
description: 运行测试并分析覆盖率
agent: build
model: mimo/mimo-v2.5-pro
---
运行完整测试套件，显示失败项并建议修复。
然后在 TUI 中输入 /my-cmd 即可。
Q8: 可以导入 Claude Code 配置吗？
可以。MiMo Code 自动兼容 .claude/ 目录下的 skills 和 MCP 配置。也支持从 Claude Code 一键迁移认证。
9. 附录：完整 CLI 命令参考
mimo 启动 TUI（默认）
mimo --continue 恢复上次会话
mimo --session <id> 恢复指定会话
mimo --fork 分叉会话
mimo web --port 4096 启动 Web 界面
mimo serve 启动 headless 服务
mimo run "msg" 单次命令行运行
mimo models 列出所有可用模型
mimo providers list 列出已配置的 API 提供商
mimo providers login 添加 API 提供商
mimo session list 列出历史会话
mimo export [id] 导出会话 JSON
mimo import <file> 导入会话
mimo mcp list 列出 MCP 服务器
mimo mcp auth <name> 认证 MCP 服务器
mimo upgrade 升级到最新版
mimo uninstall 卸载（加 --keep-data 保留数据）
mimo --help 完整帮助
🎉 安装配置总结
| 步骤 | 内容 | 状态 |
|---|---|---|
| 1 | 环境检查（Node.js v20） | ✅ 完成 |
| 2 | npm install -g @mimo-ai/cli |
✅ 完成 |
| 3 | 配置 DeepSeek API Key | ✅ 完成 |
| 4 | 配置 Xiaomi MiMo API Key | ✅ 完成 |
| 5 | DeepSeek API 连通性验证 | ✅ 通过 |
| 6 | Web 界面启动验证 | ✅ 通过 |
现在你可以：
# 终端模式
mimo
# Web 图形界面（推荐新手）
mimo web --port 4096
# → 浏览器打开 http://127.0.0.1:4096/
# 指定模型
mimo --model deepseek/deepseek-v4-pro
mimo --model mimo/mimo-v2.5-pro
Happy Coding! 🚀
中国智能体开发者社区，聚焦智能体与大模型开发，提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动，促进经验交流与协作，助力开发者快速构建创新智能应用。
更多推荐
14
0- 0
已为社区贡献1条内容
所有评论(0)