MiMo Code 上手:小米开源编程助手接本地模型、规则与权限、计划模式、自定义命令与技能
按 MiMo Code 官方中文文档(0.1.16 实测):装好 mimo 命令,用 mimocode.json 把本机 llama.cpp 跑的开源小模型接进来、不要 API Key 跑通第一次问答;再写 AGENTS.md 规则、用对象语法配 allow / ask / deny 权限,让 build 模式写文件跑命令、plan 模式只读规划,并用 mimo debug 看清最终权限表;最后把常用提示做成带参数的自定义命令、把团队约定写成 SKILL.md 技能,学会列出、导出、继续会话和 JSON 输出。
入门·3 课时·68 分钟·图文实操
免费学习无需登录

你将学会
- 装好 MiMo Code 命令行
- 用 mimocode.json 接本地模型
- 写 AGENTS.md 项目规则
- 用 allow / ask / deny 配权限
- 区分 build 与 plan 模式
- 写自定义命令和 SKILL.md 技能
适合谁
- 想试小米开源编程助手的开发者
- 想用本地模型免费跑编程智能体的用户
- 想统一团队规则与常用命令的工程师
课前准备
- 会用终端和 Git 基本命令
- 内存 8 GB 以上,磁盘留 4 GB
- 本机有 llama.cpp 或其他 OpenAI 兼容服务
课程目录
3 课时 · 68 分钟- 01装好 MiMo Code,接上本地模型跑第一个任务了解 MiMo Code 是什么、能接哪些模型,用官方脚本或 GitHub Releases 安装,用 mimo debug paths、providers list、models 看清环境和未登录时的报错,用 llama serve 起 64K 上下文的本地服务,在 mimocode.json 里写自定义 OpenAI 兼容提供商并用 limit 修正上下文,再用 mimo run 跑通第一次问答。图文22 分钟开始本课
- 02AGENTS.md 规则、权限配置与 build / plan 模式写 AGENTS.md 项目规则并了解全局规则与 CLAUDE.md 兼容,用对象语法配 allow / ask / deny 权限并用 mimo debug config 确认,让 build 模式写 hello.py 并运行、观察规则遵守情况,用 --agent plan 只读规划,再用 mimo debug agent 看懂合并后的权限表与 hardPermission。图文24 分钟开始本课
- 03自定义命令、技能与会话管理写一个用 $1、!`命令`、@文件 的自定义命令并用 mimo run --command 运行,写 SKILL.md 技能并用 mimo debug skill 确认被发现,用 mimo session list、mimo export 查看会话和 token 用量,用 -c、-s、--fork 继续会话,最后用 --format json 让脚本读取结果。图文22 分钟开始本课
课程说明
MiMo Code 是小米 Xiaomi MiMo 团队开源的终端 AI 编程助手(MIT 许可),基于开源项目 OpenCode 分叉。它在命令行里读写代码、执行命令、管理 Git,并带有持久记忆、子智能体和二十多个内置技能。它不绑定模型:可以用小米官方的 mimo-v2.6 系列,也可以接任何 OpenAI 兼容的服务,包括跑在你自己电脑上的开源模型。
本课按 MiMo Code 官方中文文档(https://mimo.xiaomi.com/zh/mimocode/install )整理。2026-10-29 在一台没有显卡的 Linux 云主机上,用 MiMo Code 0.1.16 加本地 llama.cpp 跑的 Gemma 4 E2B 小模型(Q4_K_M 量化)逐条实跑,「对照结果」都是真实输出,小模型没做好的地方也照实写出。没有实测的部分(官方 mimo-v2.6 模型、TUI 交互、compose 模式、会话续接与分叉)取自官方文档,课内会单独注明。共 3 课时:
| 课时 | 你会做完的事 | 需要什么 |
|---|---|---|
| 1 | 装好 mimo 命令,看清配置和数据目录,用 mimocode.json 接上本地模型,跑通第一次问答 | 终端,8 GB 以上内存 |
| 2 | 写 AGENTS.md 规则,用对象语法配权限,build 模式写文件跑命令,plan 模式只读规划,用 mimo debug 看最终权限表 | 同上 |
| 3 | 写带参数的自定义命令,写 SKILL.md 技能并确认被发现,列出、导出、继续会话,用 JSON 输出给脚本读 | 同上 |
适合
- 想试小米开源编程助手的开发者
- 想用本地模型、不花 API 费用跑编程智能体的用户
- 想给团队统一规则、权限和常用命令的工程师
先修
- 会用终端和 Git 基本命令
- 内存 8 GB 以上,磁盘留 4 GB 放程序和模型
- 本机装好 llama.cpp(可先学站内「Llama App 上手」课),或已有其他 OpenAI 兼容服务
你会学到
- 用官方脚本或 GitHub Releases 安装 MiMo Code
- 用
mimo debug paths、mimo providers list、mimo models看清环境 - 在
mimocode.json里接自定义 OpenAI 兼容提供商,并用limit写对上下文 - 写
AGENTS.md项目规则,用 allow / ask / deny 对象语法配权限 - 区分 build 和 plan 模式,用
mimo debug agent看合并后的权限 - 写自定义命令(
$1、!`命令`、@文件)和SKILL.md技能 - 用
mimo session list、mimo export、-c、--fork管理会话,用--format json做自动化
官方资料
- 安装与启动:https://mimo.xiaomi.com/zh/mimocode/install
- 连接模型:https://mimo.xiaomi.com/zh/mimocode/models-provider
- 模型:https://mimo.xiaomi.com/zh/mimocode/models
- 配置文件:https://mimo.xiaomi.com/zh/mimocode/config-files
- 规则:https://mimo.xiaomi.com/zh/mimocode/rules
- 权限:https://mimo.xiaomi.com/zh/mimocode/permissions
- 模式:https://mimo.xiaomi.com/zh/mimocode/modes
- 命令:https://mimo.xiaomi.com/zh/mimocode/commands
- 代理技能:https://mimo.xiaomi.com/zh/mimocode/skills
- 会话与上下文:https://mimo.xiaomi.com/zh/mimocode/sessions
- CLI 子命令:https://mimo.xiaomi.com/zh/mimocode/cli-subcommands
- 命令行运行:https://mimo.xiaomi.com/zh/mimocode/cli-options
- 配置 Schema:https://mimo.xiaomi.com/mimocode/config.json
- 源码仓库:https://github.com/XiaomiMiMo/MiMo-Code
- 版本发布:https://github.com/XiaomiMiMo/MiMo-Code/releases
绑定工具: MiMo Code(/tools/mimo-code/)