企业官网建设流程全解析

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

📅 安装日期：2026-06-11
🖥️ 系统环境：Windows + Node.js v20.19.4
📦 版本：MiMo Code v0.1.0

目录

1. MiMo Code 是什么？
2. 环境准备
3. 安装步骤
4. API Key 配置
5. 启动 MiMo Code
6. 基础操作速查
7. 配置文件详解
8. 常见问题与技巧
9. 附录：完整 CLI 命令参考

1. MiMo Code 是什么？

MiMo Code 是小米开源的终端原生 AI 编程助手（基于 OpenCode fork），它可以：

两种使用方式

核心特性一览

• 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# 应 ≥ 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-scripts@mimo-ai/cli

Windows 下 postinstall 脚本会自动跳过（使用内置 .exe），无需额外操作。

安装位置

4. 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 → 完成。

本机已配置的模型

💡 查看完整模型列表：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/

🔒 生产环境建议设置密码：

setMIMOCODE_SERVER_PASSWORD=your_passwordsetMIMOCODE_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 输入框中使用）

6.2 模式切换（核心操作）

按Tab键在三种工作模式间循环切换：

Build ──Tab──▶ Plan ──Tab──▶ Compose ──Tab──▶ Build ──...

🔑最佳实践：

1. 先用Plan模式分析代码、制定方案
2. 确认方案后切换到Build模式实施
3. 复杂任务切换到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"// 其他文件编辑需确认}}}

三种权限级别：

💡 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 配置层级（优先级从高到低）

1. 项目级.mimocode/mimocode.json— 项目特定配置
2. 全局级~/.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 完整帮助

🎉 安装配置总结

现在你可以：

# 终端模式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! 🚀