MiniMax Code：通过 Gonka 使用自备密钥运行 MiniMax 智能体

该智能体提供三个入口，三者与 BYOK 提供商协作的方式完全一致：

官方安装脚本会把最新版本安装到 ~/.minimax-code，必要时自动拉取合适的 Node.js，且无需管理员权限：

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

如果已装好 Node.js（22 系列需 22.19 及以上，24 系列需 24.2 及以上，此外 25 和 26 也可以），用 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

这条命令之所以这么长，是有原因的：该智能体需要原生编译的 SQLite，因此可选的依赖项与安装脚本都必须保持启用。安装后请重新打开终端并验证：mcode --version。

在 TUI 内，这些快捷键会派上用场：Shift+Tab（规划模式）、Alt+M（切换权限模式——Ask、Auto 与 Full access）、@ 用于引用文件，以及 /help 查看命令列表。中断的工作可用 mcode --continue 继续，mcode init . 则会在项目中生成一个 AGENTS.md 文件，写明智能体应遵循的规则。

用户数据——config.yaml、会话、登录状态——与程序分开存放，位于 ~/.minimax 目录（使用具名配置文件时为 ~/.minimax-<profile>）；MINIMAX_DATA_DIR 变量可指定其他位置。

JoinGonka 密钥。请前往 gate.joingonka.ai/register 注册：确认邮箱地址后，账户将收到 3M 免费代币。带 jg- 前缀的密钥可在控制台的「API 密钥」页面创建；建议为智能体单独建一个，其流量会单独显示为一行。

如果 mcode 正在运行，请先关闭它，然后执行：

npx @joingonka/setup --tool minimax-code --model minimax

安装程序会询问你的密钥，备份现有的 config.yaml，只向其中追加自己的配置块，最后向网关发起一次真实请求：密钥、地址和模型会立即验证，而不是等到你跑第一个任务时才检查。在 ~/.minimax/config.yaml 中，custom_provider 分支下会出现一个 joingonka 提供商——mcode 正是在这里存放第三方 endpoint：

custom_provider:\n  joingonka:\n    name: JoinGonka\n    kind: custom\n    enabled: true\n    api: openai-completions\n    options:\n      apiKey: jg-your-key\n      baseURL: https://gate.joingonka.ai/v1\n      authMode: api-key\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        name: MiniMax M2.7 (Gonka)\n        limit:\n          context: 200000\n          output: 8192\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        name: DeepSeek V4 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 380000\n          output: 32768\n      zai-org/GLM-5.3-Flash:\n        name: GLM 5.3 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 390000\n          output: 8192\ndefaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

关于这个配置块，有几点值得了解：

• API 格式已明确写入。没有 api 字段时，mcode 会将该提供商视为 Anthropic 兼容；安装程序会选择 openai-completions——网关的标准路径。
• 每个模型的限额各不相同。对于不熟悉的模型，mcode 会默认分配 200,000 的上下文窗口和 16,384 token 的输出上限；网络中的实际值并非如此，因此三条记录都设置了 limit。
• 密钥以字面量形式存储在文件中，文件权限会被设为 600。mcode 自身也是这样存储密钥的：它的 --api-key-env 标志会读取环境变量，并将值（而非引用）写入配置。
• 默认模型。--model minimax 标志会设置 MiniMax M2.7。不加该标志时，安装程序会为编码代理选择 DeepSeek V4 Flash——它的上下文窗口和输出上限都更大——而 --model glm 则会选择 GLM-5.3 Flash。如果配置中已选定了其他提供商的模型，不带 --model 重新运行不会改动它。
• 配置文件。如需使用命名配置，请在运行安装程序时设置环境变量，例如 MINIMAX_DATA_DIR=~/.minimax-work。

请在安装期间关闭 mcode，这不是走形式：代理在自身保存时会整体重写 config.yaml，可能会覆盖掉在它背后所做的修改。

代理自带命令也能达到同样效果。密钥通过环境变量传递——它不该出现在参数或 shell 历史记录中：

# read the key without echo\nread -s JOINGONKA_API_KEY\nexport JOINGONKA_API_KEY\n\nmcode provider add --name JoinGonka \\\n  --base-url https://gate.joingonka.ai/v1 \\\n  --api-format openai-completions \\\n  --model MiniMaxAI/MiniMax-M2.7 \\\n  --api-key-env JOINGONKA_API_KEY \\\n  --context-limit 200000 --output-limit 8192 --use

--use 标志会先用一条真实请求测试列表中第一个模型，确认无误后才保存该提供商并将其设为默认模型；失败时不会保存任何内容。运行成功会以 Provider added and selected: JoinGonka 这一行结束。mcode 会从名称中自动推导出提供商标识——joingonka——因此之后运行安装程序时会更新同一条记录，而不会新建第二条。

--context-limit 和 --output-limit 标志会作用于命令中列出的所有模型，而网络中各模型的限额并不相同。因此，用命令先配置好一个模型、再将其余模型手动写入文件会更方便。关闭 mcode，将以下片段合并到 ~/.minimax/config.yaml 中已有的提供商配置块里：

custom_provider:\n  joingonka:\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        limit: { context: 200000, output: 8192 }\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        limit: { context: 380000, output: 32768 }\n      zai-org/GLM-5.3-Flash:\n        limit: { context: 390000, output: 8192 }

第三种方式是交互式操作：在 TUI 中，/model 命令会打开模型选择界面，其中有一个 + Add 3rd-party provider… 选项，而 /provider 用于管理已保存的连接。模型页面上的地址可通过 Ctrl+E 编辑；验证失败时不会保存任何内容，草稿会保留以便修改。

该选哪种 API 格式。网关三种格式都接受，区别仅在于基础地址：

在我们的测试中，三种格式均通过了连接检查。

三条命令即可验证这套组合是否正常运作。第一条列出提供商——当前活跃的用星号标记，密钥已打码：

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

第二条发起一次实时请求，成功时返回 Provider available: custom_provider:joingonka；--model 标志可用于检测指定模型：

mcode provider test custom_provider:joingonka

第三条检验最关键的能力——文件操作。在目录中放一个带有明显错误的小文件，然后让它找出来：

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

智能体应当自行调用读取工具并给出实质性的回答。在我们的测试中，网络上三个模型均顺利通过；如需在单次运行中指定其他模型，可使用形如 --model custom_provider:joingonka/<model-id> 的标志。加上 --output-format json 标志后，响应中会出现 usage 字段，包含输入和输出 token 数量——方便与网关控制台核对：在「使用情况」板块可以按小时和按天查看请求，并按模型和密钥分类。

如果检测未通过，mcode 会在消息中直接说明原因：

网络上所有模型价格一致，所以选择的关键在于表现。下面是各模型的限制，以及它们在同一个任务上跑 mcode exec 时的实测表现（核对日期：2026 年 9 月 21 日）：

实用法则很简单。短任务和快速修改用 MiniMax M2.7：目前它承担了网络里最多的容量。如果可见的推理过程碍事——比如用脚本解析 exec 的输出——或者需要读一个大仓库再给出一大段修改，就切到 DeepSeek V4 Flash。遇到绕来绕去的逻辑，GLM-5.3 Flash 思考得更好。

切换不需要改文件：在 TUI 里用 /model 命令，单个会话用 mcode -m custom_provider:joingonka/<model-id>，单次运行用带同样值的 mcode exec --model。长期选择保存在 defaultModel 这一行里。网络的模型阵容会随时间变化；带限制的最新列表随时可以通过 GET https://gate.joingonka.ai/v1/models 获取。

代理工具消耗 token 的方式与聊天不同：mcode 会在你的每一句话中添加系统提示词和所有工具的描述，然后与模型进行多轮对话。在我们的测试中，“阅读文件并查找错误”的任务大约消耗了 4 万个 token，且几乎全部是输入。因此，单 token 价格在这里至关重要。

通过 JoinGonka Gateway，输入端每百万 token 价格为 $0.0069，输出端为 $0.021——所有模型价格统一，并从此页面的实时来源中获取。2026 年 9 月的价格量级：单次任务仅需几分钱的百分之一，每天处理 300 万到 700 万 token 的活跃工作仅需几美分。

BYOK 涵盖的内容。 你的提供商负责处理模型请求：代码阅读与编辑、命令、子代理和会话。内置搜索、mcode-tools 媒体工具和托管连接器属于供应商的服务，需要账户登录和额度。自定义工具独立于此，通过项目中 .mcp.json 文件里的 MCP 服务器连接。

权限。 在 TUI 中，Ask、Auto 和 Full access 模式通过 Alt+M 或 /permission 命令切换；对于 mcode exec，则由 --permission 标志控制。

遥测。 mcode 中的统计、指标和诊断通道默认关闭，可单独开启；变量 MCODE_DISABLE_TELEMETRY 和 DO_NOT_TRACK 可同时将其全部禁用。网关本身不存储提示词和回复的内容——统计数据中仅保留消耗总量。

如果需要图像处理（如界面截图、原型图），请配置第二个具备视觉能力的模型提供商，并在添加时指定 --support-image 标志：Gonka 网络模型仅支持文本，而 mcode 中可以有多个提供商。

网络中所有三个模型家族都有来自实验室自身的代理：在 MiniMax Code 旁边还有来自 GLM 作者 Z.ai 的 DeepSeek Harness 和 ZCode。这三者都使用同一个密钥连接到同一个网关。