← 返回攻略列表

MiniMax Code CLI 开源白嫖攻略：MIT 协议 0 元跑终端 AI 编程 Agent，BYOK 接免费 API

MiniMax Code CLI v0.4.12 MIT 开源，工具 0 元。BYOK 接 Cerebras 100万token/天、Groq 1000次/天、GMI Cloud M2.5 100万TPM 免费，白嫖完整终端编程 Agent。评测 76.7% 通过率、中位 4分33秒。

MiniMax Code CLI 开源白嫖攻略：MIT 协议 0 元跑终端 AI 编程 Agent，BYOK 接免费 API

MiniMax（稀宇科技）把它的终端 AI 编程工具 MiniMax Code CLI v0.4.12 以 MIT 协议正式开源了。这意味着两件事：工具本身 0 元、代码可审计、可自己改；更重要的是它原生支持 BYOK（Bring Your Own Key）——你可以把 CLI 接到任意 OpenAI / Anthropic 兼容的 API 上，包括那些免费额度的 LLM 平台。

先说结论：MiniMax Code CLI 免费拿（MIT 开源），但"跑代码"要烧 token。想 0 元跑，走 BYOK 接免费 API：Cerebras 每天 100 万 token、Groq 每天 1000 次、GMI Cloud M2.5 每分钟 100 万 TPM 免费不绑卡——三条路任选，就能白嫖一个能读仓库、改代码、跑测试的完整终端编程 Agent。

白嫖要点速览（2026-09 官方数据）

项目内容是否免费
CLI 工具本身v0.4.12，MIT 协议开源（npm 包 @minimax-ai/code）✅ 免费
官方额度MiniMax Token Plan / API Key，5 小时 + 每周两个额度窗口需订阅或付费 key
BYOK 免费 API接 Cerebras（1M token/天）/ Groq（1000次/天）/ GMI Cloud M2.5（1M TPM 免费）✅ 0 元
评测成绩FrontierHarness Eval 任务通过率 76.7%，成功任务中位耗时 4 分 33 秒—
运行环境Node.js 22.19+ / 24.2+ / 25 / 26（一键脚本会自动装兼容运行时，免 sudo）—

关键提醒：MiniMax 官方额度不是"注册即白嫖"，走的是 Token Plan 或 API Key 计费；真正 0 元的玩法是 BYOK 接免费 API。下面拆开讲。

三种装法（都 0 元）

1. 官方一键脚本（推荐，自动补 Node 运行时）

macOS / Linux / WSL：

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

Windows（PowerShell）：

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

脚本装到 ~/.minimax-code（Windows 为 %USERPROFILE%\.minimax-code），不需要 sudo / 管理员权限，还会按需装一个兼容的 Node.js 运行时。装完重新打开终端，跑 mcode --version 验证。

2. npm 安装（已有 Node 的情况）

要求 Node.js 22.19+、24.2+、25 或 26：

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/

3. 注意 Alpine / musl Linux 不支持

一键脚本目前不支持 Alpine 等 musl 架构的 Linux 发行版，这类系统建议手动装 Node 后走 npm。

登录与额度（官方路）

进项目目录后 mcode login（中国大陆账号）或 mcode login --region global（海外账号），浏览器里完成授权，回到终端用 /status 看账号、模型、运行时状态。

官方额度走两个窗口：5 小时滚动窗口 + 每周窗口，/status 会显示两个窗口各自剩余百分比和重置倒计时，/usage 看详细用量。注意这是 MiniMax 账号 / Token Plan 的额度，免费 Go/Adagio 档本身不含 coding 额度——想白嫖走下面 BYOK。

白嫖核心：BYOK 接免费 API

这是整篇的重点。CLI 原生支持 openai-completions、openai-responses、anthropic-messages 三种 API 格式，随便接一个免费 LLM API，就能让整套编程 Agent 白跑：

export MCODE_PROVIDER_API_KEY="***"
mcode provider add --name 免费源 --base-url https://api.示例/v1   --api-format openai-completions --model 模型名   --context-limit 32768 --output-limit 4096 --use
mcode

三个 0 元免费源（本站已实测，见对应攻略）：

免费 API免费额度刷新接入方式适合
Cerebras100 万 token/天每日重置openai-completions，无需信用卡日常写代码、跑测试量最大
Groq1000 次/天，RPM 30、TPM 30000每日 UTC 0 点openai-completions，首 token <50ms低延迟、实时交互
GMI Cloud M2.5/M2.7100 万 TPM（Tier 1 永久，不绑卡）按分钟计量OpenAI 兼容，国内直连中文场景、MiniMax 模型

把 CLI 指到上面任一源，配合 /provider 切模型、/model 过滤，就能 0 元跑完整编程 Agent。想跨多家错峰，可以加多个 provider（比如白天 Cerebras 冲量、夜间 Groq 补延迟敏感的活）。

三种入口，对应三种用法

入口命令用途
交互式 TUImcode [prompt]读仓库、对话、改代码、审 diff、权限确认
Headlessmcode exec [prompt]脚本 / CI / 批量 / 评测，支持 text / json / stream-json 输出
ACPmcode acp给支持 Agent Client Protocol 的编辑器当 Agent 服务

三者共享会话、模型、provider、插件和权限控制。CI 场景用 mcode exec 跑批最方便——把"修这个 failing test"写进流水线，headless 一次出结果。

实用技巧（省 token / 提效率）

  • Plan Mode 先规划再动手：Shift+Tab 切换，/plan on|off|status|view 管理。复杂任务先让它出计划，避免跑偏浪费 token。
  • 权限模式：/permission 有 Ask（每次确认）/ Auto（自动判风险）/ Full access（跳过确认）三档。日常用 Auto；只在完全信任的工作区开 Full。
  • 给任务设预算：/goal "完成迁移并跑测试" budget=50K——K/M 后缀，防止 agent 无节制烧额度，白嫖党必开。
  • 主任务运行时开侧问：/btw 为什么选这个实现？ 不打断主任务，临时查个细节。
  • @ 引用文件/目录、Ctrl+V 贴图贴视频，把上下文喂给 agent。
  • 插件市场：mcode plugin marketplace list / mcode plugin add 名称@official，加搜索、MCP 等能力。

评测数据说明

官方在 FrontierHarness Eval 上报告：本轮 76.7% 任务通过率（30 道任务里 23 道通过、4 道失败、3 道超时无评分），成功任务中位耗时 4 分 33 秒，两项指标均优于报告所列公开基线。注意这是第三方评测，口径和任务时限跟公开榜单有差异，只作数值参考，不代表官方排名——宣传时别拿这个数当绝对结论。

限制与坑

  • "免费"分两层：工具（MIT）永远 0 元；但官方跑模型要钱。想 0 元只能 BYOK 接免费 API，别指望注册 MiniMax 送 coding 额度。
  • 免费 Go/Adagio 档不含 coding 额度：和 Kimi Code Desktop 的 Go 档一样，免费档没有编程额度，0 元写代码走 Gemini CLI / DeepSeek-TUI / 通义灵码，或本文的 BYOK 路线。
  • 额度会滚动消耗：5 小时 + 每周两个窗口，跑满就限流；BYOK 接免费 API 时受的是那个 API 自己的日限额（Cerebras 1M/天、Groq 1000/天、GMI 按分钟 TPM）。
  • Alpine / musl Linux 不支持一键安装，得手动装 Node 走 npm。
  • 数据目录默认 ~/.minimax，BYOK 的自定义 provider 存在这里，多套 CLI 共用同一目录会串配置。

FAQ

MiniMax Code CLI 真的完全免费吗？
工具本身是：v0.4.12 以 MIT 协议开源，安装、运行、二次开发都 0 元。但"跑模型"要 token——官方走 Token Plan / API Key 计费。想 0 元跑，用 BYOK 接免费 API（Cerebras 100 万 token/天、Groq 1000 次/天、GMI Cloud M2.5 100 万 TPM 免费）。
怎么白嫖一个完整的编程 Agent？
三步：① 一键脚本装 CLI（自动补 Node 运行时）；② mcode provider add 接一个免费 API；③ /goal ... budget=50K 设预算开跑。全程 0 元，能读仓库、改代码、跑测试。
BYOK 支持哪些 API 格式？
支持 openai-completions、openai-responses、anthropic-messages 三种。OpenAI 兼容的免费 API（Cerebras、Groq、GMI）直接用第一种；Anthropic 兼容的走第三种。本地/自托管模型要加 --context-limit 32768 --output-limit 4096。
和 Gemini CLI、Kimi Code Desktop 比，选哪个？
纯 0 元、不挑模型，Gemini CLI 自带免费额度最省事；要国内直连 + MiniMax 模型，走 GMI Cloud M2.5；Kimi Code Desktop 是桌面 GUI 四档订阅（¥49 起），终端党更灵活的是 MiniMax Code CLI（开源 + BYOK）。
76.7% 通过率是什么水平？
第三方 FrontierHarness Eval 单轮成绩，30 道里 23 过 4 挂 3 超时无评分，成功任务中位耗时 4 分 33 秒。能跑主流 coding 任务，但别当官方榜单排名看——口径和时限跟公开榜单不一致。

总结

MiniMax Code CLI 开源后，"终端 AI 编程 Agent"这件过去要么付费、要么折腾的事，现在0 元可落地：MIT 工具 + BYOK 接免费 API。想白嫖最划算，就 Cerebras 冲量 + Groq 补延迟 错峰，开 /goal budget 控额度。工具永久免费，免费 API 额度每天/每周/每分钟重置——一个小项目基本零成本跑完。

相关白嫖源攻略：Cerebras 免费 API、Groq 免费 LPU、GMI Cloud 跑 MiniMax、免费 AI 编程工具横评、Kimi Code Desktop。

本文数据更新于 2026-09-23，版本与免费额度可能调整，以官网 / 仓库最新说明为准。