MiMo Code 2026 最新部署与进阶使用终极指南摘要本文整理了 2026 年 6 月最新开源终端 AI 编程助手 MiMo Code 的完整部署与进阶使用指南。教程覆盖 Windows / Mac / Linux 全平台安装、MiMo Auto 免费通道零配置接入、Build/Plan/Compose 三大核心工作模式详解。重点解析跨会话持久记忆MEMORY.md、自定义 Agent 权限管理、服务器 24/7 持久化部署以及自我进化Dream Distill机制。全程规避环境变量失效、API 配置错误、上下文溢出等经典坑点帮助开发者 3 分钟快速搭建属于自己的终端 AI 结对编程专家。文章目录MiMo Code 2026 最新部署与进阶使用终极指南一、前置说明 · 核心认知 环境要求1.1 MiMo Code 核心定位1.2 适配版本与时间锚点1.3 最低硬件配置1.4 安装核心红线全网90%报错根源二、全平台安装部署Windows / Mac / Linux2.1 Windows 部署npm 方案2.2 Mac / Linux 部署官方脚本方案三、首次启动与模型接入3.1 启动与初始化3.2 接入 MiMo Auto 免费通道四、三大核心工作模式详解4.1 Build 模式默认·全能开发4.2 Plan 模式只读·架构分析4.3 Compose 模式编排·工业级交付五、进阶玩法持久记忆与自我进化5.1 跨会话持久记忆MEMORY.md5.2 Distill 自我进化流程固化六、服务器 24/7 持久化部署运维必看6.1 方案一Tmux 会话托管推荐最稳健6.2 方案二Systemd 服务进阶通过 tmux 间接启动步骤 1创建专用用户推荐非必需步骤 2创建启动脚本步骤 3创建 Systemd 服务单元步骤 4启用并启动服务步骤 5查看日志或恢复交互七、安全加固与权限管理八、全套避坑报错排查表九、最终总结一、前置说明 · 核心认知 环境要求1.1 MiMo Code 核心定位MiMo Code 是小米 MiMo 团队于 2026 年 6 月开源的终端原生 AI 编程助手基于 OpenCode 二次开发MIT 协议。它不是简单的代码补全工具而是能读写代码、执行 Shell 命令、管理 Git 的全能 AI 同事。其核心优势在于“越用越懂你”的持久记忆系统和多智能体协作能力。1.2 适配版本与时间锚点当前版本v0.1.32026年6月最新支持系统Windows 10/11、MacOS 12、LinuxUbuntu/CentOS/WSL2终端要求推荐使用支持真彩色的现代终端如 Windows Terminal、iTerm2、WezTerm、Alacritty 等1.3 最低硬件配置内存推荐 8G若开启 Max Mode 并行推理建议 16G磁盘预留 ≥5G 空闲空间用于缓存模型与上下文记忆网络可正常访问外网 API支持离线本地模型接入1.4 安装核心红线全网90%报错根源Windows 用户必须提前安装 Node.js ≥ 18推荐 20 LTSMac/Linux 用户若安装后提示command not found需手动刷新环境变量强烈建议首次启动在项目根目录执行否则AGENTS.md和MEMORY.md会生成在当前工作目录后续需要手动移动若已在非项目目录启动可通过mimo --init重新初始化。API Key 严禁明文写在配置文件中必须使用环境变量或独立文件读取二、全平台安装部署Windows / Mac / Linux2.1 Windows 部署npm 方案环境准备确保已安装 Node.js v20 和 npm。一键安装打开 PowerShell 或 CMD执行npminstall-gmimo-ai/cli权限放行若提示allow-scripts警告执行npm approve-scripts mimo-ai/cli。验证安装输入mimo --version若输出版本号即安装成功。2.2 Mac / Linux 部署官方脚本方案一键安装打开终端执行curl-fsSLhttps://mimo.xiaomi.com/install|bash环境变量修复高频报错点安装成功后若直接输入mimo提示command not found是因为当前终端会话未加载新 PATH。请执行source~/.zshrc# 若使用 zsh# 或source~/.bashrc# 若使用 bash验证安装输入mimo --version确认。三、首次启动与模型接入3.1 启动与初始化进入你的代码项目目录cd /path/to/your/project启动 MiMo Codemimo首次启动会自动分析项目结构并在根目录创建AGENTS.md和MEMORY.md建议将此文件提交到 Git。3.2 接入 MiMo Auto 免费通道在 TUI 界面输入/connect唤起模型连接菜单。选择MiMo Auto (free)。这是小米官方提供的限时免费匿名通道零配置、无需 API Key性能对标 Claude Sonnet。若需使用其他模型如 DeepSeek、OpenAI选择对应提供商并粘贴 API Key 即可。建议虽然 MiMo Auto 免费通道目前零配置且性能优秀但作为“限时免费”服务可能会在未来调整策略。建议同步配置一个备用 provider如 DeepSeek 或 OpenAI Compatible并将 API Key 通过环境变量或.env文件注入以便免费通道波动时无缝切换避免影响工作流。四、三大核心工作模式详解MiMo Code 通过 Tab 键可在三种主 Agent 模式间无缝切换4.1 Build 模式默认·全能开发权限拥有文件读写、代码编辑、Shell 命令执行、Git 操作等完整权限。适用场景日常代码编写、重构、Bug 修复、依赖安装。4.2 Plan 模式只读·架构分析权限禁用write、edit、bash等所有修改和执行工具仅保留只读分析能力。适用场景接手陌生项目时分析代码架构、设计方案评审、改动可行性评估。4.3 Compose 模式编排·工业级交付权限调用内置的 13 个聚焦技能库如 TDD 测试驱动、Debug 系统化调试、Git Worktree 管理等。适用场景复杂的全流程开发任务。AI 会自动拆解任务按“规划-执行-审查-验证”的闭环自主推进。五、进阶玩法持久记忆与自我进化5.1 跨会话持久记忆MEMORY.mdMiMo Code 不使用黑盒向量数据库而是将项目背景、架构决策、反复验证的技术事实保存在根目录的MEMORY.md中。手动保存长对话中可随时输入/checkpoint保存关键上下文。防上下文毒化当对话过长或MEMORY.md文件膨胀时可使用/compact命令手动触发上下文压缩释放 Token 空间。Dream 机制知识收敛每 7 天自动触发独立 Agent 会读取历史对话对MEMORY.md执行合并、去重、验证确保记忆“越用越紧凑”。5.2 Distill 自我进化流程固化触发方式使用一段时间后在终端输入/distill。作用AI 会扫描你的历史会话识别你反复出现的手动工作流将其自动固化为可复用的专属 Skill、CLI 命令或自定义 Agent实现真正的“私人定制”。六、服务器 24/7 持久化部署运维必看本地电脑关机或网络波动会中断 AI 任务。若需长期运行自动化脚本或后台 AI 代理推荐部署至 Linux 云服务器。由于 MiMo Code 默认启动的是 TUI文本用户界面直接放入后台极易因缺少 TTY 而卡死以下是两种生产级解决方案6.1 方案一Tmux 会话托管推荐最稳健使用tmux或screen创建一个虚拟终端完美解决 TUI 后台运行问题。# 1. 安装 tmuxaptinstalltmux-y# 2. 创建名为 mimo-session 的会话tmux new-smimo-session# 3. 在 tmux 中启动 MiMocd/path/to/project mimo# 4. 按下 CtrlB松开后按 D 键脱离会话此时 MiMo 在后台稳定运行# 随时恢复会话tmux attach -t mimo-session6.2 方案二Systemd 服务进阶通过 tmux 间接启动如果必须使用 systemd 进行开机自启和服务管理不要直接启动 TUI 程序而是通过 systemd 创建一个 tmux 会话让 MiMo 在该会话内运行。这样既保留了 TUI 的完整性又避免了无 TTY 导致的卡死。步骤 1创建专用用户推荐非必需sudouseradd-r-s/bin/bash mimosudomkdir-p/home/mimosudochownmimo:mimo /home/mimo步骤 2创建启动脚本创建/opt/mimo/start-mimo.sh内容如下#!/bin/bash# 确保 tmux 会话不存在则创建存在则附加if!tmux has-session-tmimo-service2/dev/null;thentmux new-session-d-smimo-service-c/path/to/project tmux send-keys-tmimo-servicecd /path/to/project mimoEnterfi赋予执行权限chmod x /opt/mimo/start-mimo.sh步骤 3创建 Systemd 服务单元创建/etc/systemd/system/mimo.service文件[Unit] DescriptionMiMo Code Service (via tmux) Afternetwork-online.target network.target Wantsnetwork-online.target [Service] Typeforking Usermimo Groupmimo # 核心修复补充环境变量防止找不到 node/npm EnvironmentPATH/usr/local/bin:/usr/bin:/bin EnvironmentHOME/home/mimo ExecStart/opt/mimo/start-mimo.sh ExecStop/usr/bin/tmux kill-session -t mimo-service RemainAfterExityes [Install] WantedBymulti-user.target关键说明Typeforking因为 tmux 会在后台 fork 子进程systemd 等待父进程退出即可。ExecStop显式杀死 tmux 会话保证服务停止时清理干净。RemainAfterExityes让 systemd 认为服务一直在运行直到手动 stop。步骤 4启用并启动服务sudosystemctl daemon-reloadsudosystemctlenable--nowmimo.service步骤 5查看日志或恢复交互查看服务状态systemctl status mimo.service随时进入 tmux 会话交互sudo -u mimo tmux attach -t mimo-service退出 tmux 后服务继续运行不会中断。七、安全加固与权限管理AI 编程工具最大的风险在于“随意执行 Shell 命令”。务必在项目根目录的.mimocode/mimocode.json中配置严格的权限规则{permission:{bash:{*:ask,git status*:allow,git diff*:allow,npm test*:ask,git commit*:deny,git push*:deny,rm -rf*:deny,npm uninstall*:deny},edit:ask,write:ask,delete:deny}}核心原则AI 可以帮你改代码但提交commit、推送push以及删除rm/uninstall等破坏性命令必须强制deny或ask由人来确认。八、全套避坑报错排查表问题现象根本原因解决方案安装后提示 command not found环境变量未生效执行source ~/.zshrc或重启终端Windows 安装报错Node.js 版本过低升级 Node.js 至 v20 LTS免费通道限额/不可用MiMo Auto 限时免费策略调整切换至其他 OpenAI 兼容 API 提供商上下文过长导致卡顿历史对话堆积使用/checkpoint保存/compact压缩中文 Prompt 乱码/不识别终端编码问题确保终端 UTF-8 编码MiMo 完美支持中文Windows 运行卡顿终端兼容性问题推荐使用 WSL2 运行 Linux 环境九、最终总结MiMo Code 是目前开源界将“终端交互”与“AI 自主编程”结合得最紧密的工具之一。它不仅提供了 MiMo Auto 这样的限时免费高质量模型通道更通过MEMORY.md和/distill机制解决了 AI 编程“没有长期记忆”的核心痛点。
MiMo Code 2026 最新部署与进阶使用终极指南
MiMo Code 2026 最新部署与进阶使用终极指南摘要本文整理了 2026 年 6 月最新开源终端 AI 编程助手 MiMo Code 的完整部署与进阶使用指南。教程覆盖 Windows / Mac / Linux 全平台安装、MiMo Auto 免费通道零配置接入、Build/Plan/Compose 三大核心工作模式详解。重点解析跨会话持久记忆MEMORY.md、自定义 Agent 权限管理、服务器 24/7 持久化部署以及自我进化Dream Distill机制。全程规避环境变量失效、API 配置错误、上下文溢出等经典坑点帮助开发者 3 分钟快速搭建属于自己的终端 AI 结对编程专家。文章目录MiMo Code 2026 最新部署与进阶使用终极指南一、前置说明 · 核心认知 环境要求1.1 MiMo Code 核心定位1.2 适配版本与时间锚点1.3 最低硬件配置1.4 安装核心红线全网90%报错根源二、全平台安装部署Windows / Mac / Linux2.1 Windows 部署npm 方案2.2 Mac / Linux 部署官方脚本方案三、首次启动与模型接入3.1 启动与初始化3.2 接入 MiMo Auto 免费通道四、三大核心工作模式详解4.1 Build 模式默认·全能开发4.2 Plan 模式只读·架构分析4.3 Compose 模式编排·工业级交付五、进阶玩法持久记忆与自我进化5.1 跨会话持久记忆MEMORY.md5.2 Distill 自我进化流程固化六、服务器 24/7 持久化部署运维必看6.1 方案一Tmux 会话托管推荐最稳健6.2 方案二Systemd 服务进阶通过 tmux 间接启动步骤 1创建专用用户推荐非必需步骤 2创建启动脚本步骤 3创建 Systemd 服务单元步骤 4启用并启动服务步骤 5查看日志或恢复交互七、安全加固与权限管理八、全套避坑报错排查表九、最终总结一、前置说明 · 核心认知 环境要求1.1 MiMo Code 核心定位MiMo Code 是小米 MiMo 团队于 2026 年 6 月开源的终端原生 AI 编程助手基于 OpenCode 二次开发MIT 协议。它不是简单的代码补全工具而是能读写代码、执行 Shell 命令、管理 Git 的全能 AI 同事。其核心优势在于“越用越懂你”的持久记忆系统和多智能体协作能力。1.2 适配版本与时间锚点当前版本v0.1.32026年6月最新支持系统Windows 10/11、MacOS 12、LinuxUbuntu/CentOS/WSL2终端要求推荐使用支持真彩色的现代终端如 Windows Terminal、iTerm2、WezTerm、Alacritty 等1.3 最低硬件配置内存推荐 8G若开启 Max Mode 并行推理建议 16G磁盘预留 ≥5G 空闲空间用于缓存模型与上下文记忆网络可正常访问外网 API支持离线本地模型接入1.4 安装核心红线全网90%报错根源Windows 用户必须提前安装 Node.js ≥ 18推荐 20 LTSMac/Linux 用户若安装后提示command not found需手动刷新环境变量强烈建议首次启动在项目根目录执行否则AGENTS.md和MEMORY.md会生成在当前工作目录后续需要手动移动若已在非项目目录启动可通过mimo --init重新初始化。API Key 严禁明文写在配置文件中必须使用环境变量或独立文件读取二、全平台安装部署Windows / Mac / Linux2.1 Windows 部署npm 方案环境准备确保已安装 Node.js v20 和 npm。一键安装打开 PowerShell 或 CMD执行npminstall-gmimo-ai/cli权限放行若提示allow-scripts警告执行npm approve-scripts mimo-ai/cli。验证安装输入mimo --version若输出版本号即安装成功。2.2 Mac / Linux 部署官方脚本方案一键安装打开终端执行curl-fsSLhttps://mimo.xiaomi.com/install|bash环境变量修复高频报错点安装成功后若直接输入mimo提示command not found是因为当前终端会话未加载新 PATH。请执行source~/.zshrc# 若使用 zsh# 或source~/.bashrc# 若使用 bash验证安装输入mimo --version确认。三、首次启动与模型接入3.1 启动与初始化进入你的代码项目目录cd /path/to/your/project启动 MiMo Codemimo首次启动会自动分析项目结构并在根目录创建AGENTS.md和MEMORY.md建议将此文件提交到 Git。3.2 接入 MiMo Auto 免费通道在 TUI 界面输入/connect唤起模型连接菜单。选择MiMo Auto (free)。这是小米官方提供的限时免费匿名通道零配置、无需 API Key性能对标 Claude Sonnet。若需使用其他模型如 DeepSeek、OpenAI选择对应提供商并粘贴 API Key 即可。建议虽然 MiMo Auto 免费通道目前零配置且性能优秀但作为“限时免费”服务可能会在未来调整策略。建议同步配置一个备用 provider如 DeepSeek 或 OpenAI Compatible并将 API Key 通过环境变量或.env文件注入以便免费通道波动时无缝切换避免影响工作流。四、三大核心工作模式详解MiMo Code 通过 Tab 键可在三种主 Agent 模式间无缝切换4.1 Build 模式默认·全能开发权限拥有文件读写、代码编辑、Shell 命令执行、Git 操作等完整权限。适用场景日常代码编写、重构、Bug 修复、依赖安装。4.2 Plan 模式只读·架构分析权限禁用write、edit、bash等所有修改和执行工具仅保留只读分析能力。适用场景接手陌生项目时分析代码架构、设计方案评审、改动可行性评估。4.3 Compose 模式编排·工业级交付权限调用内置的 13 个聚焦技能库如 TDD 测试驱动、Debug 系统化调试、Git Worktree 管理等。适用场景复杂的全流程开发任务。AI 会自动拆解任务按“规划-执行-审查-验证”的闭环自主推进。五、进阶玩法持久记忆与自我进化5.1 跨会话持久记忆MEMORY.mdMiMo Code 不使用黑盒向量数据库而是将项目背景、架构决策、反复验证的技术事实保存在根目录的MEMORY.md中。手动保存长对话中可随时输入/checkpoint保存关键上下文。防上下文毒化当对话过长或MEMORY.md文件膨胀时可使用/compact命令手动触发上下文压缩释放 Token 空间。Dream 机制知识收敛每 7 天自动触发独立 Agent 会读取历史对话对MEMORY.md执行合并、去重、验证确保记忆“越用越紧凑”。5.2 Distill 自我进化流程固化触发方式使用一段时间后在终端输入/distill。作用AI 会扫描你的历史会话识别你反复出现的手动工作流将其自动固化为可复用的专属 Skill、CLI 命令或自定义 Agent实现真正的“私人定制”。六、服务器 24/7 持久化部署运维必看本地电脑关机或网络波动会中断 AI 任务。若需长期运行自动化脚本或后台 AI 代理推荐部署至 Linux 云服务器。由于 MiMo Code 默认启动的是 TUI文本用户界面直接放入后台极易因缺少 TTY 而卡死以下是两种生产级解决方案6.1 方案一Tmux 会话托管推荐最稳健使用tmux或screen创建一个虚拟终端完美解决 TUI 后台运行问题。# 1. 安装 tmuxaptinstalltmux-y# 2. 创建名为 mimo-session 的会话tmux new-smimo-session# 3. 在 tmux 中启动 MiMocd/path/to/project mimo# 4. 按下 CtrlB松开后按 D 键脱离会话此时 MiMo 在后台稳定运行# 随时恢复会话tmux attach -t mimo-session6.2 方案二Systemd 服务进阶通过 tmux 间接启动如果必须使用 systemd 进行开机自启和服务管理不要直接启动 TUI 程序而是通过 systemd 创建一个 tmux 会话让 MiMo 在该会话内运行。这样既保留了 TUI 的完整性又避免了无 TTY 导致的卡死。步骤 1创建专用用户推荐非必需sudouseradd-r-s/bin/bash mimosudomkdir-p/home/mimosudochownmimo:mimo /home/mimo步骤 2创建启动脚本创建/opt/mimo/start-mimo.sh内容如下#!/bin/bash# 确保 tmux 会话不存在则创建存在则附加if!tmux has-session-tmimo-service2/dev/null;thentmux new-session-d-smimo-service-c/path/to/project tmux send-keys-tmimo-servicecd /path/to/project mimoEnterfi赋予执行权限chmod x /opt/mimo/start-mimo.sh步骤 3创建 Systemd 服务单元创建/etc/systemd/system/mimo.service文件[Unit] DescriptionMiMo Code Service (via tmux) Afternetwork-online.target network.target Wantsnetwork-online.target [Service] Typeforking Usermimo Groupmimo # 核心修复补充环境变量防止找不到 node/npm EnvironmentPATH/usr/local/bin:/usr/bin:/bin EnvironmentHOME/home/mimo ExecStart/opt/mimo/start-mimo.sh ExecStop/usr/bin/tmux kill-session -t mimo-service RemainAfterExityes [Install] WantedBymulti-user.target关键说明Typeforking因为 tmux 会在后台 fork 子进程systemd 等待父进程退出即可。ExecStop显式杀死 tmux 会话保证服务停止时清理干净。RemainAfterExityes让 systemd 认为服务一直在运行直到手动 stop。步骤 4启用并启动服务sudosystemctl daemon-reloadsudosystemctlenable--nowmimo.service步骤 5查看日志或恢复交互查看服务状态systemctl status mimo.service随时进入 tmux 会话交互sudo -u mimo tmux attach -t mimo-service退出 tmux 后服务继续运行不会中断。七、安全加固与权限管理AI 编程工具最大的风险在于“随意执行 Shell 命令”。务必在项目根目录的.mimocode/mimocode.json中配置严格的权限规则{permission:{bash:{*:ask,git status*:allow,git diff*:allow,npm test*:ask,git commit*:deny,git push*:deny,rm -rf*:deny,npm uninstall*:deny},edit:ask,write:ask,delete:deny}}核心原则AI 可以帮你改代码但提交commit、推送push以及删除rm/uninstall等破坏性命令必须强制deny或ask由人来确认。八、全套避坑报错排查表问题现象根本原因解决方案安装后提示 command not found环境变量未生效执行source ~/.zshrc或重启终端Windows 安装报错Node.js 版本过低升级 Node.js 至 v20 LTS免费通道限额/不可用MiMo Auto 限时免费策略调整切换至其他 OpenAI 兼容 API 提供商上下文过长导致卡顿历史对话堆积使用/checkpoint保存/compact压缩中文 Prompt 乱码/不识别终端编码问题确保终端 UTF-8 编码MiMo 完美支持中文Windows 运行卡顿终端兼容性问题推荐使用 WSL2 运行 Linux 环境九、最终总结MiMo Code 是目前开源界将“终端交互”与“AI 自主编程”结合得最紧密的工具之一。它不仅提供了 MiMo Auto 这样的限时免费高质量模型通道更通过MEMORY.md和/distill机制解决了 AI 编程“没有长期记忆”的核心痛点。
