必须确保 node.js ≥ v18.18.0，否则 mimo code 无法启动；运行 node -v 验证版本，若提示命令未找到则需先安装 node.js 并勾选 add to path。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认本地环境是否满足最低要求
运行 MiMo Code 前必须确保 Node.js 版本 ≥ v18.18.0，否则 CLI 无法启动、命令直接报错退出。打开终端输入 node -v，若返回 v18.20.2 或更高版本号，说明已就绪；【若提示“command not found”或“不是内部或外部命令”，必须先安装 Node.js 并勾选 Add to PATH，否则后续所有配置都无效】。
Windows 用户去 https://nodejs.org 下载 LTS 版本安装即可；macOS 用户推荐执行 brew install node；Linux 用户可运行 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash - && sudo apt-get install -y nodejs。
安装 MiMo CLI 并进入项目根目录
在任意终端位置执行全局安装命令：npm install -g @mimo-ai/cli。安装完成后，用 cd 切换到你的代码仓库根目录——这个路径下必须存在 .git 或 package.json 等标识文件；【不在项目根目录启动，MiMo 将完全无法读取任何源码，AI 所有“理解项目”类指令均失效】。
确认路径无误后，直接运行 mimo。首次启动会自动初始化 SQLite 记忆库，并弹出 TUI 界面。
通过 /connect 连接免费模型（零配置最快路径）
在 TUI 界面中直接输入斜杠命令：/connect → 按上下键选择 “MiMo Auto(限时免费)” → 回车确认。
该通道无需 API Key、不走网络认证、不限速不限 Token，连接成功后右下角状态栏立即显示 ✅ Model: MiMo-V2.5，同时开始扫描当前目录文件树。这个过程耗时 3–15 秒，取决于项目规模——请勿中断或关闭窗口，否则上下文重建不完整，后续分析将严重失真。
手动配置小米 MiMo-V2.5-Pro 模型（需 API Key）
方法一：使用 TaoToken 兼容网关（推荐新手）
① 注册 TaoToken 账号并获取 API Key，访问 https://taotoken.net/api 获取 OpenAI 风格端点；
② 在项目根目录创建或编辑 .mimorc 文件，填入以下内容（替换 YOUR_API_KEY）：
{ "provider": { "type": "openai", "apiKey": "YOUR_API_KEY", "baseURL": "https://taotoken.net/api", "model": "mimo-v2.5-pro" } }
方法二：直连小米官方端点（需实名认证）
① 访问 https://mimo.xiaomi.com → 快速体验 → API 接入 → 申请 API Key（仅显示一次，务必复制保存）；
② 确保账户已完成实名认证（否则调用返回 401）；
③ 修改 .mimorc，将 baseURL 改为 https://api.xiaomimimo.com/anthropic，model 改为 mimo-v2.5-pro-fp4-dflash；【若仍写 auto 或 mimo-v2.5，系统将 fallback 至压缩版 32k 上下文模型，长项目分析必然失真】。
验证模型是否真正可用
在 TUI 界面中输入：/status，查看右下角状态栏是否稳定显示 ✅ DFlash active | ctx: 100000；
若显示 ⚠️ Fallback to qwen2.5，则说明主模型加载失败，需检查 ~/.cache/mimo/models/ 下是否存在完整 mimo-v2.5-pro-fp4-dflash 目录；
输入 /ask 解释当前项目的入口文件和构建流程，观察是否能准确识别 package.json、vite.config.ts 等关键文件并给出结构化回答——这是判断模型连通性与上下文加载是否成功的最终依据。
