MiniMax Token Plan - 开源工具配置文档

全球首个全模态 AI 订阅服务，一个 API Key 覆盖文本编程、图像生成、语音合成、视频制作和音乐创作。

核心配置信息

Base URL

接口协议	Base URL	适用工具
OpenAI 兼容	`https://api.minimaxi.com/v1`	Cursor、TRAE、OpenCode、Cline、Kilo Code、Codex CLI 等
Anthropic 兼容	`https://api.minimaxi.com/anthropic`	Claude Code、OpenClaw（推荐）、Claude Desktop 等

API Key

名称：Token Plan 订阅 Key（Subscription Key）
格式：sk-cp-xxxxx
获取路径：MiniMax 开放平台 → 账户管理 → Token Plan
重要：此 Key 为 Token Plan 专属，与按量计费 API Key 不可互换

支持模型

模型	Model ID	上下文	说明
MiniMax-M3	`MiniMax-M3`	1M	最新旗舰模型，深度思考能力强
MiniMax-M2.7	`MiniMax-M2.7`	512K	稳定主力模型
MiniMax-M2.7-highspeed	`MiniMax-M2.7-highspeed`	-	高速推理版，极速版套餐专属

全模态能力

模态	模型	说明
文本	M3 / M2.7 系列	5小时滚动请求额度
语音	Speech 2.8	每日字符配额
图像	image-01	每日张数配额
视频	Hailuo-2.3 / Hailuo-2.3-Fast	每日个数配额（768P 6s）
音乐	Music-2.5	每日首数配额（每首≤5分钟）

快速验证（Anthropic 兼容）

bash

curl https://api.minimaxi.com/anthropic/v1/messages \
  -H "Authorization: Bearer YOUR_TOKEN_PLAN_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "MiniMax-M3",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "hello"}]
  }'

快速验证（OpenAI 兼容）

bash

curl https://api.minimaxi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN_PLAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3",
    "messages": [{"role": "user", "content": "hello"}]
  }'

Claude Code

前置条件

Node.js 18+
Windows 需安装 Git for Windows 或 WSL

安装

bash

npm install -g @anthropic-ai/claude-code
claude --version

清除冲突环境变量

bash

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

若变量在 ~/.bashrc / ~/.zshrc 中永久导出，请同步删除对应行。

配置 settings.json

macOS / Linux： ~/.claude/settings.jsonWindows： C:\Users\<用户名>\.claude\settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-cp-xxxxx",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"
  }
}

跳过登录验证

macOS / Linux： ~/.claude.jsonWindows： C:\Users\<用户名>\.claude.json

json

{
  "hasCompletedOnboarding": true
}

使用 CC Switch（推荐）

安装 CC Switch
添加供应商 → 选择预设 MiniMax
填入 Token Plan API Key
模型名称全部改为 MiniMax-M3
点击「启用」

使用

bash

cd your-project
claude

验证：输入 /status，确认 Base URL 和 Model 正确。

OpenClaw

前置条件

Node.js 22.19.0+

安装

macOS / Linux：

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

OAuth 一键配置（推荐）

安装向导中选择 MiniMax 作为 Model Provider
选择 MiniMax Global — OAuth 认证方式
浏览器跳转授权页面，点击 Authorize
返回终端，确认模型选择
选择消息渠道（Telegram、Discord 等）或 Skip for now

手动配置（Anthropic 协议）

配置文件：~/.openclaw/openclaw.json

json

{
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "sk-cp-xxxxx",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M3",
            "name": "MiniMax-M3",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "MiniMax-M2.7",
            "name": "MiniMax-M2.7",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 524288,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/MiniMax-M3"
      },
      "models": {
        "minimax/MiniMax-M3": {},
        "minimax/MiniMax-M2.7": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": { "mode": "none" }
  }
}

重启生效

bash

openclaw gateway restart

高级能力

图片理解：支持多模态输入
网络搜索：通过 MCP 接入 Token Plan 搜索能力
全模态生成：配合 MiniMax CLI 实现视频、语音、图像、音乐生成

Cursor

安装

Cursor 官网下载安装。

⚠️ 注意：仅 Cursor 高级会员（Pro+）及以上支持配置自定义模型。

配置

Settings → Models
展开 API Keys 部分：
- 勾选 Override OpenAI Base URL
- 填入：https://api.minimaxi.com/v1
在 OpenAI API Key 输入 Token Plan Key
点击右侧按钮 → Enable OpenAI API Key
Models → View All Models → Add Custom Model
添加模型：MiniMax-M3、MiniMax-M2.7

已知问题

Override 是全局设置：开启后会影响所有 API Key，包括 Cursor 自带的 Claude/GPT 模型
切换使用 MiniMax 时开启 Override，使用 Cursor 自带模型时需关闭

TRAE

安装

TRAE 官网下载安装。

内置模型（推荐）

TRAE 中国版内置 MiniMax-M3 模型，登录后直接选用即可，无需额外配置。

自定义模型配置

AI 对话框右上角 → 设置图标
选择「模型」页签
点击 + 添加模型
服务商选择 MiniMax-CN
模型选择 MiniMax-M3
填入 Token Plan API Key
点击「添加模型」完成

OpenCode

安装

bash

# curl 安装
curl -fsSL https://opencode.ai/install | bash

# npm 安装
npm i -g opencode-ai

配置（内置 Provider）

bash

opencode auth login

搜索并选择 MiniMax Token Plan（minimaxi.com）
输入 Token Plan API Key
完成认证

使用

bash

opencode

输入 /models 切换模型，选择 MiniMax-M2.7 或 MiniMax-M3。

Kilo Code

安装

VSCode 扩展市场搜索 Kilo Code 安装。

配置

打开 Kilo Code → Settings
API Provider 选 MiniMax
MiniMax Entrypoint 选 api.minimaxi.com
MiniMax API Key 填入 Token Plan Key
Model 选 MiniMax-M2.7 或 MiniMax-M3
依次点 Save + Done

⚠️ 使用前请清空 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 环境变量，否则会覆盖配置。

Cline

安装

VSCode 扩展市场搜索 Cline 安装。

配置

配置项	值
API Provider	OpenAI Compatible
Base URL	`https://api.minimaxi.com/v1`
API Key	Token Plan 订阅 Key
Model ID	`MiniMax-M3` 或 `MiniMax-M2.7`

Codex CLI

安装

bash

npm i -g @openai/codex
codex --version

配置

macOS / Linux： ~/.codex/config.tomlWindows： %USERPROFILE%\.codex\config.toml

toml

model = "MiniMax-M3"
model_provider = "minimax"

[model_providers.minimax]
name = "minimax"
base_url = "https://api.minimaxi.com/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "responses"

环境变量

bash

export MINIMAX_API_KEY="sk-cp-xxxxx"

Grok CLI

通用配置参考

Grok CLI 支持自定义 OpenAI 兼容端点：

配置项	值
API Provider	OpenAI Compatible
Base URL	`https://api.minimaxi.com/v1`
API Key	Token Plan 订阅 Key
Model	`MiniMax-M3`

Droid

通用配置参考

Droid 支持自定义 OpenAI 兼容端点：

配置项	值
Base URL	`https://api.minimaxi.com/v1`
API Key	Token Plan 订阅 Key
Model ID	`MiniMax-M3`

其他工具通用配置

协议选择指南

工具类型	推荐协议	常见环境变量
Claude Code 风格（TUI/CLI）	Anthropic 兼容	`ANTHROPIC_BASE_URL` + `ANTHROPIC_AUTH_TOKEN`
Cursor / Continue / IDE 插件	OpenAI 兼容	`OPENAI_BASE_URL` + `OPENAI_API_KEY`
两种都支持	推荐 Anthropic 兼容（Prompt Cache 优势）

Dify

设置 → 工作空间 → 模型供应商 → 找到 Minimax → 安装
添加 API 密钥：
- API Base：https://api.minimaxi.com/anthropic
- Token Plan Key
- Group ID 留空
保存后即可在工作流中调用

Cherry Studio

打开 Cherry Studio → Choose other Providers
搜索 MiniMax，选 MiniMax CN
填入 Token Plan Key（API Host 已预填）
点 Check 验证连接
模型列表选 MiniMax-M2.7 / MiniMax-M3

Claude Desktop

安装桌面客户端
Help → Troubleshooting → Enable Developer mode
Developer → Configure third-party inference → Connection
配置：
- inferenceProvider: gateway
- inferenceGatewayBaseUrl: https://api.minimaxi.com/anthropic
- inferenceGatewayApiKey: Token Plan Key
- inferenceGatewayAuthScheme: bearer
Apply locally → Relaunch now

Xcode（macOS）

Xcode 26+ → Settings → Intelligence → Add a Model Provider
选 Internet Hosted，填入：
- URL: https://api.minimaxi.com（裸 host）
- API Key Header: Authorization
- API Key: Bearer sk-cp-xxxxx
- Description: MiniMax
Add → 启用 MiniMax-M2.7

Hermes Agent

bash

hermes model
# Select Provider: Custom endpoint
# API base URL: https://api.minimaxi.com/v1
# API Key: Token Plan Key
# Model name: MiniMax-M3

Roo Code / Zed / MonkeyCode / Qwen Code / Pi

均支持 OpenAI 兼容或 Anthropic 兼容自定义端点，参照通用配置表填入即可：

配置项	OpenAI 兼容值	Anthropic 兼容值
Base URL	`https://api.minimaxi.com/v1`	`https://api.minimaxi.com/anthropic`
API Key	Token Plan Key	Token Plan Key
Model	`MiniMax-M3`	`MiniMax-M3`

套餐对比速查

标准版

	Starter	Plus	Max
M2.7 请求	600次/5小时	1,500次/5小时	4,500次/5小时
Speech 2.8	—	4,000字符/日	11,000字符/日
image-01	—	50张/日	120张/日
Hailuo 视频	—	—	2个/日（Fast+普通各2个）
Music-2.5	—	—	4首/日

极速版

	Plus-极速版	Max-极速版	Ultra-极速版
M2.7-highspeed	1,500次/5小时	4,500次/5小时	30,000次/5小时
Speech 2.8	9,000字符/日	19,000字符/日	50,000字符/日
image-01	100张/日	200张/日	800张/日
Hailuo 视频	—	3个/日（Fast+普通各3个）	5个/日（Fast+普通各5个）
Music-2.5	—	7首/日	15首/日

核心优势

全模态覆盖：文本 + 语音 + 图像 + 视频 + 音乐，一个订阅搞定
滚动额度：M2.7 按 5 小时滚动窗口重置，非自然日限制更灵活
高速推理：极速版套餐提供 M2.7-highspeed 专属算力
MiniMax CLI：一键为 Agent 注入全模态能力（视频、语音、图像、音乐生成）

注意事项

Key 不互通：Token Plan 订阅 Key 与按量计费 API Key 不可互换，使用错误的 Key 会报错
有效期限制：订阅 Key 仅在 Token Plan 有效期内可用，过期后立即失效
5小时滚动窗口：文本模型额度按 5 小时滚动计算，不是自然日重置，用满后等待自动恢复
每日配额：非文本模型（语音/图像/视频/音乐）按自然日重置，次日自动恢复
协议选择：
- Claude Code 类工具必须用 Anthropic 兼容端点 /anthropic
- IDE 插件类工具通常用 OpenAI 兼容端点 /v1
- 两种都支持时，推荐 Anthropic 兼容（可享受 Prompt Cache 优化）
环境变量冲突：配置前务必清除已有的 ANTHROPIC_* 或 OPENAI_* 环境变量，避免优先级覆盖
Cursor 全局 Override：Cursor 的 Override Base URL 是全局设置，会影响所有模型，切换时注意开闭
额度用尽后：可切换至按量计费 API Key 继续使用，费用从账户余额扣除
MCP 能力：Token Plan 支持官方 MCP 服务（网络搜索、图片理解），可在支持 MCP 的工具中启用
MiniMax CLI：通过 mmx-cli 可一键为 OpenClaw 等 Agent 注入全模态生成能力（视频/语音/图像/音乐）

官方文档：MiniMax Token Plan 开发文档更新时间：2026.07

MiniMax Token Plan - 开源工具配置文档 ​

核心配置信息 ​

Base URL ​

API Key ​

支持模型 ​

全模态能力 ​

快速验证（Anthropic 兼容） ​

快速验证（OpenAI 兼容） ​

Claude Code ​

前置条件 ​

安装 ​

清除冲突环境变量 ​

配置 settings.json ​

跳过登录验证 ​

使用 CC Switch（推荐） ​

使用 ​

OpenClaw ​

前置条件 ​

安装 ​

OAuth 一键配置（推荐） ​

手动配置（Anthropic 协议） ​

重启生效 ​

高级能力 ​

Cursor ​

安装 ​

配置 ​

已知问题 ​

TRAE ​

安装 ​

内置模型（推荐） ​

自定义模型配置 ​

OpenCode ​

安装 ​

配置（内置 Provider） ​

使用 ​

Kilo Code ​

安装 ​

配置 ​

Cline ​

安装 ​

配置 ​

Codex CLI ​

安装 ​

配置 ​

环境变量 ​

Grok CLI ​

通用配置参考 ​

Droid ​

通用配置参考 ​

其他工具通用配置 ​

协议选择指南 ​

Dify ​

Cherry Studio ​

Claude Desktop ​

Xcode（macOS） ​

Hermes Agent ​

Roo Code / Zed / MonkeyCode / Qwen Code / Pi ​

套餐对比速查 ​

标准版 ​

极速版 ​

核心优势 ​

注意事项 ​

关于本站

MiniMax Token Plan - 开源工具配置文档

核心配置信息

Base URL

API Key

支持模型

全模态能力

快速验证（Anthropic 兼容）

快速验证（OpenAI 兼容）

Claude Code

前置条件

安装

清除冲突环境变量

配置 settings.json

跳过登录验证

使用 CC Switch（推荐）

使用

OpenClaw

前置条件

安装

OAuth 一键配置（推荐）

手动配置（Anthropic 协议）

重启生效

高级能力

Cursor

安装

配置

已知问题

TRAE

安装

内置模型（推荐）

自定义模型配置

OpenCode

安装

配置（内置 Provider）

使用

Kilo Code

安装

配置

Cline

安装

配置

Codex CLI

安装

配置

环境变量

Grok CLI

通用配置参考

Droid

通用配置参考

其他工具通用配置

协议选择指南

Dify

Cherry Studio

Claude Desktop

Xcode（macOS）

Hermes Agent

Roo Code / Zed / MonkeyCode / Qwen Code / Pi

套餐对比速查

标准版

极速版

核心优势

注意事项