从小白到大神：MiMo Code 配置与使用“零基础”通关秘籍

张

张建站

2026/6/11 23:16:01

10分钟阅读

从小白到大神MiMo Code 配置与使用“零基础”通关秘籍安装日期2026-06-11️ 系统环境Windows Node.js v20.19.4 版本MiMo Code v0.1.0目录MiMo Code 是什么环境准备安装步骤API Key 配置启动 MiMo Code基础操作速查配置文件详解常见问题与技巧附录完整 CLI 命令参考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.mdcheckpoint.md 任务日志MCP 服务器集成Sentry、Context7、GitHub 等自定义命令Markdown 定义斜杠命令LSP 集成30 语言自动诊断代码格式化自动化20 格式化工具内置语音输入支持会话分叉导出2. 环境准备必须Node.js ≥ 18推荐 20 LTSnpm随 Node.js 安装一款现代终端推荐 Windows Terminal# 检查版本node--version# 应 ≥ v18npm--version# 应 ≥ 9可选但强烈推荐Windows Terminal微软商店免费下载—— 比 CMD/PowerShell 自带终端体验好很多真彩色支持Windows Terminal 默认支持3. 安装步骤Windows 安装一条命令npm install-g mimo-ai/cli安装完成后验证mimo--version# 输出0.1.0⚠️ 如果 npm 提示allow-scripts警告运行以下命令npmapprove-scriptsmimo-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.db4. API Key 配置MiMo Code 支持多种方式添加 API Key这里介绍两种最实用的方法。方法一命令行直接添加推荐# 添加 DeepSeek API Key管道输入echosk-xxxxxx|mimo providers login--provider deepseek--method apikey# 添加 Xiaomi MiMo API Keyechosk-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说明DeepSeekdeepseek/deepseek-chatDeepSeek V3/V4通用对话DeepSeekdeepseek/deepseek-reasonerDeepSeek R1推理增强DeepSeekdeepseek/deepseek-v4-flashDeepSeek V4 Flash快速DeepSeekdeepseek/deepseek-v4-proDeepSeek V4 Pro推荐Xiaomimimo/mimo-v2.5MiMo 2.5基础Xiaomimimo/mimo-v2.5-proMiMo 2.5 Pro推荐Xiaomixiaomi/mimo-v2.5-proMiMo 2.5 Proxiaomi 源Xiaomixiaomi/mimo-v2.5-pro-ultraspeedMiMo 2.5 Pro 极速版Xiaomixiaomi/mimo-v2-flashMiMo V2 FlashXiaomixiaomi/mimo-v2-omniMiMo V2 OmniXiaomixiaomi/mimo-v2-proMiMo V2 Pro 查看完整模型列表mimo models5. 启动 MiMo Code5.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/ 生产环境建议设置密码setMIMOCODE_SERVER_PASSWORDyour_passwordsetMIMOCODE_SERVER_USERNAMEadmin mimo web--port 40965.3 命令行单次运行# 直接问一个问题适合脚本/CImimo 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/newCtrlX N新建会话/sessionsCtrlX L浏览 / 恢复历史会话/undo—撤销上一步修改/redo—重做撤销的修改/compactCtrlX C手动压缩上下文/theme—切换主题/exitCtrlC/CtrlD退出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-pro6.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 / rejectdeny直接拒绝 TUI 中弹出确认时once— 仅本次放行always— 本次会话中同类型操作自动放行reject— 拒绝本次6.5 快速参考卡片┌─────────────────────────────────────────────────────┐ │ MiMo Code 速查卡 │ ├─────────────────────────────────────────────────────┤ │ 模型切换 /models │ │ 模式切换 Tab 键 │ │ 新建会话 /new (CtrlX N) │ │ 历史会话 /sessions (CtrlX L) │ │ 中断回答 Esc 键 │ │ 文件引用文件名 (模糊搜索) │ │ 执行命令 !命令 (如 !npm test) │ │ 撤销/重做 /undo / /redo │ │ 换行输入 ShiftEnter │ │ 退出 /exit (CtrlC) │ │ │ │ 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.jsonAPI Key 通过mimo providers login命令自动管理通常不需要手动编辑。7.4 推荐项目初始化时生成项目配置cd your-project mimo# 在 TUI 中输入/initMiMo 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-proQ3: 如何仅让 AI 分析代码不修改文件按Tab切换到Plan模式此模式下无法写文件和执行命令只能进行分析和建议。Q4: 上下文太长怎么办自动MiMo Code 接近上下文上限时自动压缩手动输入/compact快捷键CtrlX 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✅ 完成2npm install -g mimo-ai/cli✅ 完成3配置 DeepSeek API Key✅ 完成4配置 Xiaomi MiMo API Key✅ 完成5DeepSeek API 连通性验证✅ 通过6Web 界面启动验证✅ 通过现在你可以# 终端模式mimo# Web 图形界面推荐新手mimo web--port 4096# → 浏览器打开 http://127.0.0.1:4096/# 指定模型mimo--model deepseek/deepseek-v4-pro mimo--model mimo/mimo-v2.5-proHappy Coding!