跳至主要內容

MiMo Code 新手入门指南：小米开源 AI 编程 CLI

约 1668 字大约 6 分钟...

MiMo Code 是小米开源的终端 AI 编程智能体，命令名为 mimo。它基于 opencode fork 构建，保留了多 Provider、TUI、LSP、MCP、插件等核心能力，并在此基础上新增了持久化记忆与智能上下文管理。它最大的吸引力是内置了一个免配置、限时免费的 MiMo Auto 模型（基于小米自研的 MiMo-V2.5，支持百万 token 上下文），安装后无需注册或绑卡就能直接开聊。本指南将带你从安装、首次启动，到连接更多模型与项目上下文配置，逐步上手这款工具。

定位说明：MiMo Code 是 opencode 的 fork，使用习惯与 opencode 高度一致。如果你用过 opencode，可直接迁移；没用过也不影响，本文从零讲起。

第一步：快速安装 MiMo Code

macOS / Linux

一键安装脚本：

curl -fsSL https://mimo.xiaomi.com/install | bash

Windows

通过 npm 全局安装（包名为 @mimo-ai/cli，需先有 Node.js 环境）：

npm install -g @mimo-ai/cli

npm 方式同样适用于 macOS / Linux，已有 Node.js 时可直接用它跨平台安装。

验证安装

安装完成后运行以下命令确认：

mimo --help

看到完整的帮助信息即说明安装成功。

第二步：首次启动与免费额度

在项目目录下直接运行：

mimo

首次启动会弹出模型选择引导，常见选项包括：

  • MiMo Auto（限时免费）——内置模型，免配置、免绑卡，新手直接选它即可零成本上手
  • 登录小米 MiMo 平台——获取官方账号额度
  • 导入 Claude Code 配置——复用你已有的认证与模型设置
  • 自定义模型——填入第三方 provider 的 API Key

选择 MiMo Auto 后无需任何配置即可开始对话。该模型基于 MiMo-V2.5、支持百万 token 上下文，目前处于限免阶段——免费政策可能随时调整，最终以官方说明为准。

第三步：开始你的第一次会话

进入 TUI 交互界面后，就可以用自然语言对话了：

请解释这个项目的整体结构
帮我写一个 Go 函数，从 CSV 文件读取数据并去重

引用文件使用 @ 符号，输入 @ 后会弹出文件补全：

分析 @src/main.ts 的代码质量并指出潜在问题

作为 opencode fork，MiMo Code 沿用了 opencode 的一次性命令（mimo run "..."）、模型切换（TUI 内 /models）等用法，细节以官方文档为准。

第四步：连接更多模型

MiMo Auto 之外，MiMo Code 兼容主流 provider，可接入 Claude、OpenAI、Google，以及 DeepSeek、Kimi、GLM 等模型。配置写在项目或全局的 mimocode.json 中，模型 ID 采用 provider/model 格式：

{
  "model": "anthropic/claude-sonnet-4-5"
}

如果你已经在用 Claude Code，首次启动时直接选择「导入 Claude Code 配置」即可复用现成的认证与模型设置，无需重新填 Key。

各 provider 的变体（如思考预算、推理等级）与具体字段以连接模型文档为准。

第五步：配置项目上下文（AGENTS.md）

与 opencode、Claude Code 一致，MiMo Code 使用项目根目录下的 AGENTS.md 作为「项目记忆」，其内容会被加入每次对话的上下文，用来约束模型行为。AGENTS.md 正逐渐成为各家工具通用的约定。

在项目根目录创建 AGENTS.md：

# MyWebApp 项目指南

## 技术栈

- 前端：React + TypeScript + Vite
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 编码规范

- 所有函数必须有 TypeScript 类型注解
- 组件名使用 PascalCase，文件名使用 kebab-case
- 每次改动后运行 `pnpm test` 确保测试通过

## 项目结构

- `/src/components/` - React 组件
- `/src/api/` - API 调用

配合 MiMo Code 新增的持久化记忆，跨会话的项目约定与决策能被更稳定地保留下来。

了解使用成本

  • 工具本体：开源、免费下载使用。
  • MiMo Auto：内置模型，当前限时免费、免绑卡，适合日常上手与试用。
  • 第三方模型：接入 Claude / OpenAI / DeepSeek / Kimi / GLM 等付费 API 时，按所选模型的 token 用量计费，需自备 API Key。

限免政策与额度可能随时调整，最终以 MiMo Code 官方说明为准。

常见问题解答

Q: MiMo Auto 限免要不要绑卡或注册？ A: 不需要。安装后内置即可用，选择 MiMo Auto 直接对话，无需注册或绑定支付方式。具体限免时长与额度以官方为准。

Q: 我的代码会被发送到云端吗？ A: 会。使用 MiMo Auto 或其他云端 provider 时，相关代码会发送到对应 API 进行处理。处理敏感代码前请先确认你的公司政策与数据使用条款。

Q: 用过 opencode，迁移成本高吗？ A: 很低。MiMo Code 是 opencode fork，TUI、AGENTS.md、provider/model 多模型切换等机制基本一致，主要差异是内置了 MiMo Auto 模型与持久化记忆。

Q: 已经在用 Claude Code，能复用配置吗？ A: 可以。首次启动时选择「导入 Claude Code 配置」即可复用现有认证与模型设置。

参考资料

最近更新: