📄 文档管理系统

← 返回列表

各大 AI 编程工具接入 MiniMax M3 教程(15款工具合集)

article #MiniMax #M3 #AI编程 #Cursor #TRAE #Claude Code #Cline #OpenCode #工具配置教程 📅 创建:2026-06-01 23:50:03 🔄 更新:2026-06-01 15:50:16
👁️ 预览 & 复制到公众号 ✏️ 编辑

各大 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 的两个接口地址

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 接入 MiniMax M3

方式一:环境变量配置(推荐)

适用于已安装 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

方式二:Claude Code for VS Code 插件

如果你习惯在 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 接入 MiniMax M3

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(最简单)

TRAE 中国版内置了 MiniMax-M3 支持,无需配置任何 API,直接选择使用。

Step 1:下载安装 TRAE

Step 2:完成初始设置并登录

Step 3:在模型选择器中直接选择 MiniMax-M3,开始使用。


四、OpenCode 接入 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

五、Kilo Code 接入 MiniMax M3

Step 1:安装 Kilo Code(VS Code 插件商店搜索安装)

Step 2:打开设置,配置环境变量:

变量名
ANTHROPIC_AUTH_TOKEN 你的 MINIMAX_API_KEY
ANTHROPIC_BASE_URL https://api.minimaxi.com/anthropic

六、OpenClaw 接入 MiniMax M3

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 M3

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 接入 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,保存设置。


九、Grok CLI 接入 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 接入 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 接入 MiniMax 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 接入 MiniMax M3

Zed 是高速 AI 代码编辑器。

在 Zed 设置中添加环境变量配置:

变量名
ANTHROPIC_AUTH_TOKEN 你的 MINIMAX_API_KEY
ANTHROPIC_BASE_URL https://api.minimaxi.com/anthropic

保存后,Zed 会通过 Anthropic 兼容接口调用 MiniMax M3。


十三、MonkeyCode 接入 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。


十四、MiniMax Token Plan:免 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(一订阅全工具通用)

💬 评论区

加载中...