编辑文档 - 各大 AI 编程工具接入 MiniMax M3 教程（15款工具合集）

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

各大 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：配置环境变量**

```bash
export ANTHROPIC_AUTH_TOKEN="你的MINIMAX_API_KEY"
export ANTHROPIC_BASE_URL="https://api.minimaxi.com/anthropic"
```

Windows PowerShell：

```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）：

```json
{
  "hasCompletedOnboarding": true
}
```

**Step 3：启动 Claude Code**

```bash
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` 中添加：

```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](https://www.trae.cn/)

**Step 2**：完成初始设置并登录

**Step 3**：在模型选择器中直接选择 **MiniMax-M3**，开始使用。

---

## 四、OpenCode 接入 MiniMax M3

OpenCode 是开源 AI Coding 工具，配置简单。

**Step 1**：安装 OpenCode

```bash
# macOS/Linux
curl -fsSL https://opencode.ai/install | bash

# npm
npm i -g opencode-ai
```

**Step 2**：初始化并登录

```bash
opencode auth login
```

**Step 3**：配置 MiniMax Provider

编辑 `~/.config/opencode/opencode.json`（或程序提示的路径）：

```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**：开始使用

```bash
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

```bash
# macOS/Linux
curl -fsSL https://openclaw.bot/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
```

**Step 2**：配置 MiniMax

```bash
openclaw configure
```

在模型列表中选择 `minimax-portal/MiniMax-M3`。

**Step 3**：启动 OpenClaw

```bash
openclaw tui
```

---

## 七、Hermes Agent 接入 MiniMax M3

Hermes Agent 支持 MiniMax Token Plan，无需配置 API Key。

**Step 1**：一键安装（支持 macOS、Linux、Windows WSL2）

```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

**Step 2**：运行模型选择器

```bash
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

```bash
npm install -g @vibe-kit/grok-cli
```

**Step 2**：配置环境变量

```bash
export GROK_BASE_URL="https://api.minimaxi.com/v1"
export GROK_API_KEY="你的MINIMAX_API_KEY"
```

**Step 3**：使用 MiniMax M3 运行

```bash
grok --model MiniMax-M3 "你的指令"
```

---

## 十、Codex CLI 接入 MiniMax M3

Codex CLI 是 OpenAI 官方推出的 Coding Agent，需要注意版本。

**Step 1**：安装特定版本（推荐 0.57.0）

```bash
npm i -g @openai/codex@0.57.0
```

**Step 2**：配置 MiniMax Provider

编辑 `~/.codex/config.toml`：

```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**：设置环境变量并运行

```bash
export MINIMAX_API_KEY="你的MINIMAX_API_KEY"
codex --profile m3
```

---

## 十一、Droid 接入 MiniMax M3

Droid 是一个轻量级 CLI Coding Agent。

**Step 1**：安装

```bash
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`：

```json
{
  "ANTHROPIC_AUTH_TOKEN": "你的MINIMAX_API_KEY",
  "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic"
}
```

或添加自定义模型：

```json
{
  "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**：启动使用

```bash
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 订阅制**，已支持以下工具：

- Claude Code ✅
- Cursor ✅
- OpenCode ✅
- Codex CLI ✅
- Cline ✅
- Roo Code ✅
- Grok CLI ✅
- Kilo Code ✅
- OpenClaw ✅
- Hermes Agent ✅
- Droid ✅
- Zed ✅
- MonkeyCode ✅
- TRAE（内置）✅

订阅 Token Plan 后，工具内置的 MiniMax 支持会自动生效，无需配置 API 地址和 Key，按月或按年计费。

推荐在 [MiniMax 开放平台](https://platform.minimaxi.com) 了解详情。

---

## 十五、常见问题速查

| 问题 | 解决方法 |
|------|----------|
| `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**（一订阅全工具通用） |

摘要

标签多个标签用逗号分隔

分类