各大 AI 编程工具接入 MiniMax M3 教程:免费额度、配置步骤、合集
MiniMax M3 正式发布后,接入门槛很低——$0.30/M(缓存后 $0.06/M),1M 上下文,支持 OpenAI 和 Anthropic 双协议,大量 AI 编程工具已适配。
本文整理了 15 个主流 AI 编程工具的接入方式,按工具分类,每个工具都有具体配置步骤和命令。覆盖:Cursor、TRAE、OpenCode、Claude Code、Cline、Kilo Code、OpenClaw、Hermes Agent、Roo Code、Grok CLI、Codex CLI、Droid、Zed、MonkeyCode、Claude Code for VS Code。
MiniMax 对国内和国际用户提供不同的 API 入口:
| 地区 | OpenAI 兼容接口 | Anthropic 兼容接口 |
|---|---|---|
| 中国大陆用户 | https://api.minimaxi.com/v1 |
https://api.minimaxi.com/anthropic |
| 国际用户 | https://api.minimax.io/v1 |
https://api.minimax.io/anthropic |
大多数国内开发工具走的是 OpenAI 兼容协议(api.minimaxi.com/v1),少数走 Anthropic 兼容协议(api.minimaxi.com/anthropic)。
适用于已安装 Claude Code 的用户。
Step 1:配置环境变量
export ANTHROPIC_AUTH_TOKEN="你的MINIMAX_API_KEY"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"
Windows PowerShell:
$env:ANTHROPIC_AUTH_TOKEN="你的MINIMAX_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"
Step 2:写入配置文件
编辑或新建 ~/.claude.json(macOS/Linux)或 用户目录/.claude.json(Windows):
{
"hasCompletedOnboarding": true
}
Step 3:启动 Claude Code
claude
Step 4:信任文件夹
启动后选择「信任此文件夹」,让 Claude Code 访问项目文件。
验证方法:/status 应显示 ANTHROPIC_BASE_URL 指向 api.minimaxi.com/anthropic,/model 应显示 MiniMax-M3。
如果你习惯在 VS Code 里用 Claude Code:
Step 1:安装 Claude Code for VS Code 插件
Step 2:打开设置(Settings),找到模型配置
Step 3:将模型改为 MiniMax-M3
方式三(环境变量覆盖):在 settings.json 中添加:
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://api.minimaxi.com/anthropic"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "你的MINIMAX_API_KEY"
}
]
Cursor 的配置非常直观,界面操作即可。
Step 1:打开 Cursor 设置 → Models
Step 2:在 Base URL 输入 https://api.minimaxi.com/v1
Step 3:输入你的 MiniMax API Key
Step 4:在模型名称处输入 MiniMax-M3
Step 5:点击「添加」→「启用」,完成配置。
TRAE 中国版内置了 MiniMax-M3 支持,无需配置任何 API,直接选择使用。
Step 1:下载安装 TRAE
Step 2:完成初始设置并登录
Step 3:在模型选择器中直接选择 MiniMax-M3,开始使用。
OpenCode 是开源 AI Coding 工具,配置简单。
Step 1:安装 OpenCode
# macOS/Linux
curl -fsSL https://opencode.ai/install | bash
# npm
npm i -g opencode-ai
Step 2:初始化并登录
opencode auth login
Step 3:配置 MiniMax Provider
编辑 ~/.config/opencode/opencode.json(或程序提示的路径):
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"minimax": {
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://api.minimaxi.com/anthropic",
"apiKey": "你的MINIMAX_API_KEY"
}
}
}
}
Step 4:开始使用
cd /path/to/your/project
opencode
Step 1:安装 Kilo Code(VS Code 插件商店搜索安装)
Step 2:打开设置,配置环境变量:
| 变量名 | 值 |
|---|---|
ANTHROPIC_AUTH_TOKEN |
你的 MINIMAX_API_KEY |
ANTHROPIC_BASE_URL |
https://api.minimaxi.com/anthropic |
OpenClaw 是一个功能丰富的 AI Coding Agent,支持 MiniMax 原生模型。
Step 1:安装 OpenClaw
# macOS/Linux
curl -fsSL https://openclaw.bot/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
Step 2:配置 MiniMax
openclaw configure
在模型列表中选择 minimax-portal/MiniMax-M3。
Step 3:启动 OpenClaw
openclaw tui
Hermes Agent 支持 MiniMax Token Plan,无需配置 API Key。
Step 1:一键安装(支持 macOS、Linux、Windows WSL2)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Step 2:运行模型选择器
hermes model
从列表中选择 minimax-portal/MiniMax-M3。
Cline 和 Roo Code 都是 VS Code 插件,配置方式相同。
Step 1:在 VS Code 插件市场安装 Cline 或 Roo Code
Step 2:打开设置,配置环境变量:
| 变量名 | 值 |
|---|---|
ANTHROPIC_AUTH_TOKEN |
你的 MINIMAX_API_KEY |
ANTHROPIC_BASE_URL |
https://api.minimaxi.com/anthropic |
Step 3:在模型选择中输入 MiniMax-M3,保存设置。
Step 1:安装 Grok CLI
npm install -g @vibe-kit/grok-cli
Step 2:配置环境变量
export GROK_BASE_URL="https://api.minimaxi.com/v1"
export GROK_API_KEY="你的MINIMAX_API_KEY"
Step 3:使用 MiniMax M3 运行
grok --model MiniMax-M3 "你的指令"
Codex CLI 是 OpenAI 官方推出的 Coding Agent,需要注意版本。
Step 1:安装特定版本(推荐 0.57.0)
npm i -g @openai/codex@0.57.0
Step 2:配置 MiniMax Provider
编辑 ~/.codex/config.toml:
[model_providers.minimax]
name = "MiniMax Chat Completions API"
base_url = "https://api.minimaxi.com/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "chat"
Step 3:设置环境变量并运行
export MINIMAX_API_KEY="你的MINIMAX_API_KEY"
codex --profile m3
Droid 是一个轻量级 CLI Coding Agent。
Step 1:安装
curl -fsSL https://app.factory.ai/cli | sh
# Windows
irm https://app.factory.ai/cli/windows | iex
Step 2:配置文件
编辑 ~/.factory/config.json 或 ~/.factory/settings.json:
{
"ANTHROPIC_AUTH_TOKEN": "你的MINIMAX_API_KEY",
"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic"
}
或添加自定义模型:
{
"custom_models": [
{
"model_display_name": "MiniMax-M3",
"model": "MiniMax-M3",
"base_url": "https://api.minimaxi.com/anthropic",
"api_key_env_var": "MINIMAX_API_KEY"
}
]
}
Step 3:启动使用
cd /path/to/your/project
droid
/model MiniMax-M3
Zed 是高速 AI 代码编辑器。
在 Zed 设置中添加环境变量配置:
| 变量名 | 值 |
|---|---|
ANTHROPIC_AUTH_TOKEN |
你的 MINIMAX_API_KEY |
ANTHROPIC_BASE_URL |
https://api.minimaxi.com/anthropic |
保存后,Zed 会通过 Anthropic 兼容接口调用 MiniMax M3。
MonkeyCode 支持 OpenAI 兼容协议。
Step 1:在 MonkeyCode 设置中配置 API 地址为 https://api.minimaxi.com
Step 2:输入 API Key
Step 3:保存后回到主界面,输入 Prompt 并点击「执行」,即可调用 MiniMax-M3。
常见问题:API Error: Cannot read properties of undefined (reading 'map') —— 检查 API Host 是否设置为 https://api.minimaxi.com,确认已填入真实 API Key。
如果不想管理 API Key,MiniMax 提供了 Token Plan 订阅制,已支持以下工具:
订阅 Token Plan 后,工具内置的 MiniMax 支持会自动生效,无需配置 API 地址和 Key,按月或按年计费。
推荐在 MiniMax 开放平台 了解详情。
| 问题 | 解决方法 |
|---|---|
The model MiniMax-M3 does not work with your current plan or api key |
API Key 无效或额度用完,重新获取 Key |
API Error: Cannot read properties of undefined |
确认 API Host 为 https://api.minimaxi.com,Key 已正确填入 |
| 国内工具连不上 | 确认用的是 api.minimaxi.com 而非 api.minimax.io |
| Claude Code 显示 Wrong Model | 确认 /model 切换到了 MiniMax-M3 |
| Token Plan 工具不生效 | 确认该工具已加入 Token Plan 支持列表 |
| 使用场景 | 推荐工具 |
|---|---|
| 不想配置任何东西 | TRAE(直接选 MiniMax-M3) |
| 深度 Coding + 终端操作 | Claude Code(功能最全) |
| VS Code 插件党 | Cline / Roo Code(轻量插件) |
| 国产 IDE | Cursor(界面配置最简单) |
| 开源工具爱好者 | OpenCode / OpenClaw |
| 订阅制不想管 Key | Token Plan(一订阅全工具通用) |
💬 评论区