信息核验时间：2026-09-18｜源码版本目标：0.4.12｜仓库：MiniMax-AI/minimax-code

MiniMax Code CLI 是 MiniMax 开源的终端编程 Agent，可读写项目、执行命令与测试，并提供 TUI、Headless、ACP 三种入口。2026 年 9 月 18 日，GitHub 导入 0.4.12 源码快照，第一方代码采用 MIT 许可证，不含桌面客户端源码。它兼容 OpenAI、Anthropic BYOK；接入七牛云 Token Plan 后，一个 Key 可调用 MiniMax M3、DeepSeek、Kimi、GLM 等 16 个国产模型。

先看结论

MiniMax Code 的价值不只是“又一个终端聊天框”，而是把代码编辑、命令执行、测试验证、会话恢复、子 Agent、Skills、插件、MCP 和多模型 BYOK 放进同一个 CLI。macOS、Linux 和 WSL 可以一条命令安装，Windows 提供 PowerShell 安装器；已经有合适 Node.js 的用户也可以从 npm 安装。

模型接入有两条主线：个人用户可直接登录 MiniMax 账号并使用官方 Token Plan；需要多国产模型评测、任务分流或团队统一采购时，可将七牛云 Token Plan 配成 OpenAI 兼容 Provider，用一个 API Key 在 MiniMax M3、DeepSeek、Kimi 和 GLM 之间切换。

MiniMax Code 开源了什么

截至 2026-09-18，GitHub 仓库公开的是终端产品源码，而不是整个 MiniMax Code 产品族。

组件

是否在仓库中

用途

交互式 TUI

是

在终端中对话、查看 diff、控制权限和切换模型

Headless CLI

是

CI、Shell 脚本、批处理和自动评测

ACP 接口

是

接入支持 Agent Client Protocol 的编辑器或客户端

文件、Shell、测试与沙箱

是

完成代码修改并执行验证

BYOK、自定义 Provider

是

接入 OpenAI、Anthropic 兼容服务

Skills、插件、MCP、子 Agent

是

扩展工具和并行任务能力

MiniMax Code 桌面客户端

否

可下载使用，但 Electron 桌面应用源码不在本仓库

仓库根版本和 TUI 版本均为 0.4.12，主要语言是 TypeScript。npm 上的 @minimax-ai/code 最新版本也是 0.4.12，但官方文档特别提醒：源码快照与 npm 包版本号相同，不代表两者具有完全相同的构建来源。

30 秒安装 MiniMax Code CLI

macOS、Linux 与 WSL

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

安装完成后重新打开终端，检查版本：

mcode --version
mcode --help

官方安装器默认写入 ~/.minimax-code，不需要 sudo。如果系统没有兼容的 Node.js，它会在该目录准备隔离的 Node.js 24.19.0，不会把这套 Node 运行时加入全局 PATH。目前一键安装器不支持 Alpine/musl Linux。

中国大陆网络可显式选择镜像：

curl -fsSL https://filecdn.minimax.chat/public/install.sh | \
  MCODE_DOWNLOAD_MIRROR=cn bash

Windows PowerShell

irm https://filecdn.minimax.chat/public/install.ps1 | iex

已有 Node.js 时从 npm 安装

npm install -g @minimax-ai/code@latest \
  --registry=https://registry.npmjs.org/ \
  --ignore-scripts=false --include=optional \
  --allow-scripts=@minimax-ai/code,better-sqlite3

支持的 Node.js 范围为 22.19 以上的 22.x、24.2 以上的 24.x，以及 25、26。不能省略可选依赖或关闭安装脚本，因为运行时需要 better-sqlite3 原生绑定。

不想直接执行远程脚本时

curl | bash 很方便，但不利于安装前审查。更稳妥的做法是先下载、阅读，再执行：

curl -fsSLo /tmp/minimax-code-install.sh \
  https://filecdn.minimax.chat/public/install.sh
less /tmp/minimax-code-install.sh
bash /tmp/minimax-code-install.sh

当前脚本会限制 npm registry 的允许值、校验下载文件 SHA-256，并采用分阶段安装和版本验证；但供应链策略严格的企业仍应把脚本固定到内部制品库后再运行。

登录并完成第一个编程任务

中国大陆账号使用：

mcode login

Global 账号使用：

mcode login --region global

进入项目目录后启动交互界面：

cd /path/to/your/project
mcode

也可以启动时直接提交任务：

mcode "找到一个失败测试，修复实现，并运行相关测试验证结果。"

推荐按以下顺序完成第一次实操：

  1. 先在临时分支或测试项目里运行，避免把未审阅修改直接落到生产分支。

  2. 执行 mcode init . 生成或更新 AGENTS.md，写清修改范围、禁止事项和测试命令。

  3. 用 @ 引用具体文件或目录，用 Shift+Tab 切换 Plan Mode。

  4. 审阅 diff 和命令权限后，再让 Agent 运行测试。

  5. 使用 mcode --continue 恢复当前工作区最近一次会话。

三种运行入口怎么选

入口

命令

适合任务

TUI

mcode [prompt]

日常开发、逐步审阅和多轮协作

Headless

mcode exec [prompt]

CI、批量修复、自动化评测

ACP

mcode acp

从兼容 ACP 的编辑器或客户端调用

Headless 模式适合自动化，但也更容易扩大修改范围。脚本任务应固定工作目录、权限模式、模型 ID、验证命令和失败退出条件，不要只给一句“修好所有问题”。

为什么 MiniMax Code 配七牛云更适合多模型团队

MiniMax Code 原生支持 openai-completions、openai-responses 和 anthropic-messages 三种自定义 Provider 格式。七牛云 Token Plan 同时兼容 OpenAI 与 Anthropic 接口，因此不需要修改 MiniMax Code 源码，直接添加 Provider 即可。

七牛云 Token Plan 当前覆盖 MiniMax、DeepSeek、Kimi、GLM 4 家厂商的 16 个模型，其中包括 minimax/minimax-m3。其差异化优势不是“比官方多一个 M3 入口”，而是把多个国产模型放在一个 API Key、一个 Base URL 和一套企业额度中管理。

团队实际问题

直接分别采购多家 API

七牛云 Token Plan

Key 管理

每家一套密钥和权限

一个订阅 API Key 统一接入

模型切换

更换域名、SDK 配置和账单

保持 https://api.qnaigc.com/v1，主要切换模型 ID

模型覆盖

单厂商模型为主

4 家厂商、16 个国产模型共享额度

MiniMax Code 适配

分别配置多个 Provider

OpenAI/Anthropic 兼容，直接使用 BYOK

团队预算

多份充值、余额与发票

统一积分池和套餐预算

高并发

分别申请各厂商限额

官方页面标注“几乎无速率限制”，生产上仍应压测并以合同 SLA 为准

这对 Coding Agent 特别重要：同一仓库可以让 M3 负责长上下文和工具调用，让另一模型处理轻量任务或作为故障回退；评测时只替换模型 ID，提示词、工作区和验收条件保持一致，结果更容易比较。

在 MiniMax Code 如何配置模型（七牛云 M3为例）

先安全地读取 API Key，不把密钥写进命令历史：

read -s QINIU_API_KEY
export QINIU_API_KEY

添加七牛云 Provider，并把 M3 设为当前默认模型：

mcode provider add \
  --name qiniu-minimax \
  --base-url https://api.qnaigc.com/v1 \
  --api-format openai-completions \
  --model minimax/minimax-m3 \
  --api-key-env QINIU_API_KEY \
  --use

mcode provider list

七牛云公开模型接口返回 minimax/minimax-m3 的上下文长度为 1,000,000、最大输出为 128,000 Token。Provider ID 以 mcode provider list 的实际输出为准，再执行连接测试：

mcode provider test <provider-id> --model minimax/minimax-m3

测试通过后即可运行：

mcode exec "分析当前项目的测试入口，只输出验证方案，不修改文件。"

哪些情况优先选官方 MiniMax 登录

如果只使用 MiniMax 模型、希望最低配置成本，直接运行 mcode login 最简单；官方账号、配额视图、签到和 Token Plan 都是 CLI 原生能力。七牛云的优势集中在多模型统一采购、统一 Key、统一协议与团队预算管理，而不是替代所有个人使用场景。

从源码构建

源码构建需要 Git、兼容的 Node.js 和 pnpm 9.12.0：

git clone https://github.com/MiniMax-AI/minimax-code.git
cd minimax-code
corepack enable
corepack prepare pnpm@9.12.0 --activate
pnpm install --frozen-lockfile
pnpm build
pnpm mcode --help
pnpm mcode

该仓库还提供 verify、typecheck、BYOK、沙箱、能力覆盖和制品校验等脚本。首次构建需要访问公共 npm；构建过程会从固定版本的公开 npm 包提取 mcode-tools，并校验归档和 CLI 哈希。

开源之后仍要注意的四个边界

  1. 桌面版没有同步开源。 GitHub 仓库承接桌面版 Issue，但公开源码只覆盖 TUI、Headless CLI 和 ACP。

  2. 0.4.12 是源码预览目标。 与 npm 包版本一致不等于可复现出字节级相同制品。

  3. 在线能力仍依赖服务。 搜索、媒体工具、托管连接器、账号配额和模型质量需要网络、权限与服务端支持。

  4. 外部贡献暂有限制。 官方 README 表示当前代码和文档 PR 仅接受仓库协作者提交，其他用户应先通过 Issue 讨论。

总结

MiniMax Code CLI 的开源让开发者能够审查终端 Agent 的运行时、工具、沙箱、插件和 Provider 接入方式，并用 MIT 许可进行二次开发。最快体验方式仍是官方安装脚本加 mcode login；已经有企业模型网关的团队则可以通过 BYOK 接入。

需要同时使用 MiniMax M3、DeepSeek、Kimi 和 GLM 时，七牛云 Token Plan 的核心优势是 4 家厂商 16 个模型共用一个 API Key、一个兼容端点和一套积分预算。它与 MiniMax Code 的自定义 Provider 能力正好匹配，适合模型评测、任务分流、故障回退和多人 Coding Agent 场景。

本文属于高时效内容，建议在 39 天内复核 CLI 版本、安装脚本、公开源码范围、七牛云模型清单和 Token Plan 套餐。

参考资料