跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://platform.minimaxi.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

上面已经覆盖了主流 AI 编程工具的接入步骤。如果你使用的工具不在列表里,但支持自定义 Base URL + API Key,照下面的值填即可。

配置参考

MiniMax 同时提供两种兼容协议,你的工具支持哪种就选哪种——大多数现代工具至少支持其中一种。

OpenAI 兼容协议

字段
ProviderOpenAI Compatible(有的工具叫 CustomOpenAI-format
Base URLhttps://api.minimaxi.com/v1
API Key获取 Token Plan Key
Model IDMiniMax-M2.7MiniMax-M2.7-highspeed

Anthropic 兼容协议

字段
ProviderAnthropic Compatible(有的工具叫 ClaudeCustom Anthropic
Base URLhttps://api.minimaxi.com/anthropic
API Key获取 Token Plan Key
Model IDMiniMax-M2.7MiniMax-M2.7-highspeed

该选哪种协议

工具类型推荐协议常见环境变量
Claude Code 风格(为 Anthropic 设计的 TUI/CLI)Anthropic 兼容ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN
Cursor / Continue / Aider / 各类 OpenAI 格式 IDE 插件OpenAI 兼容OPENAI_BASE_URL + OPENAI_API_KEY
两种都支持的工具任选——推荐 Anthropic 兼容(享受 prompt cache 优势)

Dify

Dify 是一个开源 LLM 应用开发平台,集成工作流、RAG、Agent 与可观测性。
1

安装插件

打开 Dify Cloud,登录后进入 设置 → 工作空间 → 模型供应商,在列表中找到 Minimax 并点 安装
2

配置 API Key

安装完成后点 添加 API 密钥,填入 Token Plan KeyAPI Base https://api.minimaxi.com/anthropicGroup ID 留空。
3

开始使用

保存后即可在工作流中调用 MiniMax-M2.7 系列模型。

Cherry Studio

Cherry Studio 是一个开源桌面客户端,支持 50+ LLM 服务商,内置 MCP 服务器和 300+ 智能助手。
1

安装客户端

Cherry Studio 官方文档 完成安装。
2

添加 MiniMax provider

打开 Cherry Studio → 点 Choose other Providers → 搜索框输入 MiniMax,选 MiniMax CN
3

填入 API Key

填入 Token Plan Key(API Host 已预填),点 Check 验证连接。
4

选模型

模型列表中选 MiniMax-M2.7 即可使用。

Claude Desktop

Claude Desktop 是 Anthropic 出品的 Claude 官方桌面应用,集成对话、编程和系统操作工具。
1

下载客户端

Claude Desktop 下载页 安装桌面客户端。
2

启用 Developer mode

登录 Claude,顶部菜单选 Help → Troubleshooting → Enable Developer mode,出现 Developer 菜单。
3

配置 third-party inference

打开 Developer → Configure third-party inference → Connection,填四个字段:
  • inferenceProvidergateway
  • inferenceGatewayBaseUrlhttps://api.minimaxi.com/anthropic
  • inferenceGatewayApiKey:你的 Token Plan Key(前缀 sk-cp-…去获取
  • inferenceGatewayAuthSchemebearer
Configure third-party inference 配置对话框
4

重启并选模型

Apply locally → Relaunch now。重启后在右下角模型选择器中选 MiniMax-M2.7,即可开始对话。

Xcode

Xcode 是 Apple 官方 IDE,支持 macOS / iOS / iPadOS / watchOS / visionOS 开发,内置 Coding Intelligence。
1

安装 Xcode

Mac App Store 安装 Xcode 26 或更新版本。
2

添加 Model Provider

打开 Xcode → 顶部菜单 Xcode → Settings → Intelligence → Add a Model Provider,选 Internet Hosted 标签页,填:
  • URLhttps://api.minimaxi.com(裸 host,不带任何 path)
  • API Key HeaderAuthorization(手动键入,覆盖默认的 x-api-key
  • API KeyBearer <你的 Token Plan Key>Bearer只有一个空格再接 sk-cp-… key,去获取
  • DescriptionMiniMax(任意)
Xcode 添加模型 Provider 对话框
3

启用模型

Add,回 Intelligence 面板进入新加的 MiniMax provider,启用 MiniMax-M2.7
4

开始对话

打开任意项目,按 ⌘+0 唤出 Coding Assistant,左上角编辑图标里选 MiniMax-M2.7

Pi

Pi 是 earendil-works 出品的开源终端编程 Agent,通过统一 LLM API 接入任意服务商。
1

安装 Pi

npm install -g @earendil-works/pi-coding-agent
2

设环境变量并启动

Token Plan Key(前缀 sk-cp-…)设到环境变量后启动 Pi:
export MINIMAX_CN_API_KEY=sk-cp-...
pi --provider minimax-cn --model MiniMax-M2.7

Kilo Code

Kilo Code 是开源的 VS Code AI 编程 Agent 插件,支持多家 LLM 服务商和 MCP 服务器。
使用前先清空 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL 环境变量,否则会覆盖配置。
1

安装扩展

在 VS Code 扩展面板搜索 Kilo Code 安装。
2

配置 MiniMax provider

打开 Kilo Code → Settings
  • API ProviderMiniMax
  • MiniMax Entrypointapi.minimaxi.com
  • MiniMax API Key 填入 Token Plan Key
  • ModelMiniMax-M2.7
依次点 Save + Done 保存。

Roo Code

Roo Code 是开源 VS Code 插件,提供按角色分工的 AI 编程 Agent(架构师、编码者、审阅者)。
1

安装扩展

在 VS Code 扩展面板搜索 Roo Code 安装。
2

配置 MiniMax provider

打开 Roo Code → Settings,配置同 Kilo Code:
  • API ProviderMiniMax
  • MiniMax Entrypointapi.minimaxi.com
  • MiniMax API KeyToken Plan 获取
  • ModelMiniMax-M2.7
Save + Done 保存。

Codex CLI

Codex CLI 是 OpenAI 官方的终端编程 Agent,由 Rust 编写。
新版 Codex CLI 存在兼容性问题,推荐 0.57.0 版本。
使用前先清空 OPENAI_API_KEYOPENAI_BASE_URL 环境变量。
1

安装 Codex CLI

npm i -g @openai/codex@0.57.0
2

编辑配置文件

~/.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"
requires_openai_auth = false

[profiles.m27]
model = "codex-MiniMax-M2.7"
model_provider = "minimax"
3

设环境变量并启动

export MINIMAX_API_KEY=sk-cp-...   # 从 Token Plan 获取
codex --profile m27

Zed

Zed 是 Atom 创始团队打造的开源高性能多人协同代码编辑器,由 Rust 编写。
1

安装 Zed

Zed 官方文档 完成安装。
2

添加 LLM Provider

设置 → LLM Provider+Add Provider → 选 OpenAI,填:
  • API URLhttps://api.minimaxi.com/v1
  • API KeyToken Plan 获取
  • Model NameMiniMax-M2.7
3

二次确认 API Key

Save Provider 保存,回 LLM Provider 列表点击新加的 MiniMax 条目,再次输入 API Key 并按回车确认。
4

选模型

回智能体面板右下角 Select a ModelMiniMax-M2.7 即可使用。

OpenCode

OpenCode 是 SST 出品的开源终端 AI 编程 Agent,支持多服务商接入和 LSP 集成。
OpenCode 已内置 MiniMax-M2.7,无需额外配置文件。
1

安装 OpenCode

curl -fsSL https://opencode.ai/install | bash
# 或 npm i -g opencode-ai
2

登录认证

运行 opencode auth login,提示选 provider 时搜并选 MiniMax Token Plan(minimaxi.com),填入 Token Plan API Key。
3

启动

回到命令行 opencode 启动即可。

Grok CLI

Grok CLI 是开源终端编程 Agent,可接入 xAI Grok 与任意 OpenAI 兼容服务商。
不推荐做 Agent 工作流,推荐使用 Claude CodeCursor
使用前先清空 OPENAI_API_KEYOPENAI_BASE_URL 环境变量。
1

安装 Grok CLI

npm install -g @vibe-kit/grok-cli
2

设环境变量并启动

export GROK_BASE_URL=https://api.minimaxi.com/v1
export GROK_API_KEY=sk-cp-...   # 从 Token Plan 获取
grok --model MiniMax-M2.7

Droid

Droid 是 Factory 官方终端编程 Agent,可与 IDE 和团队协作工具集成。
必须先清空 ANTHROPIC_AUTH_TOKEN 环境变量(会覆盖 config.json 里的 key)。注意配置文件路径是 ~/.factory/config.json不是 settings.json)。
1

安装 Droid

curl -fsSL https://app.factory.ai/cli | sh        # macOS / Linux
# Windows:  irm https://app.factory.ai/cli/windows | iex
2

编辑配置文件

~/.factory/config.json 加入:
{
  "custom_models": [{
    "model_display_name": "MiniMax-M2.7",
    "model": "MiniMax-M2.7",
    "base_url": "https://api.minimaxi.com/anthropic",
    "api_key": "<MINIMAX_API_KEY>",
    "provider": "anthropic",
    "max_tokens": 64000
  }]
}
3

启动并选模型

启动 droid/modelMiniMax-M2.7 即可使用。

MonkeyCode

MonkeyCode 是长亭科技 (Chaitin) 出品的企业级 AI 开发平台,Code Agent 兼容 Codex / Claude Code / OpenCode。
MonkeyCode 内置免费的 MiniMax-M2.7,但资源池在高峰期可能排队,建议长期使用自己配 key。
1

登录平台

访问 MonkeyCode 官网 登录。
2

进入 AI 大模型配置

右下角 配置AI 大模型绑定
3

填入 MiniMax 配置

  • API 地址https://api.minimaxi.com/anthropic
  • API KeyToken Plan 获取
  • 接口格式anthropic
  • 模型名称MiniMax-M2.7
4

保存使用

保存 后回主界面即可使用 MiniMax-M2.7。

Qwen Code

Qwen Code 是阿里巴巴开源的终端编程 Agent,针对 Qwen 模型族优化。
1

安装 Qwen Code

Linux / macOS:
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"
Windows(Command Prompt 与 PowerShell 通用):
powershell -Command "Invoke-WebRequest 'https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat' -OutFile (Join-Path $env:TEMP 'install-qwen.bat'); & (Join-Path $env:TEMP 'install-qwen.bat')"
2

启动并选 provider

终端运行 qwen 启动客户端,依次选 Third-party ProvidersMiniMax API Key → 区域选 China
3

填入 API Key

填入从 Token Plan 获取的 API Key(前缀 sk-cp-…)后回车。
4

确认模型 ID

模型 ID 默认已含 MiniMax-M2.7MiniMax-M2.7-highspeed,按回车提交即可开始对话。

Open WebUI

Open WebUI 是自托管的开源 AI 聊天平台,支持离线运行、RAG 和多模型 runner。
1

安装 Open WebUI

通过 Python pip 安装(要求 Python 3.11,避免兼容性问题):
pip install open-webui
open-webui serve
2

创建管理员账号

浏览器打开 http://localhost:8080,按提示创建本地管理员账号。
3

添加 OpenAI Connection

右上角头像 → Admin Panel → 顶部 Settings → 左侧 Connections,在 OpenAI 一栏点 ➕ Add Connection,填:
  • URLhttps://api.minimaxi.com/v1
  • Auth(Bearer 模式):从 Token Plan 获取的 API Key(前缀 sk-cp-…
4

选模型

Save 后回到聊天界面,顶部模型选择器选 MiniMax-M2.7 即可对话。

nanobot

nanobot 是 HKUDS 出品的轻量级开源个人 AI Agent CLI,内置对话频道、记忆和 MCP 支持。
1

安装 nanobot

uv tool install nanobot-ai
# 或:pipx install nanobot-ai
# 或:pip install nanobot-ai            # macOS 上可能需要 --user 或 --break-system-packages
2

初始化

nanobot onboard
3

一行配好 MiniMax

sk-cp-... 换成你的 Token Plan API Key
python3 -c '
import json, os, sys
p = os.path.expanduser("~/.nanobot/config.json")
c = json.load(open(p))
c["providers"]["minimax"]["apiKey"] = sys.argv[1]
c["providers"]["minimax"]["apiBase"] = "https://api.minimaxi.com/v1"
c["agents"]["defaults"]["provider"] = "minimax"
c["agents"]["defaults"]["model"] = "MiniMax-M2.7"
json.dump(c, open(p, "w"), indent=2)
' sk-cp-...
4

启动

nanobot agent

OpenHands

OpenHands(前身 OpenDevin)是 All-Hands-AI 出品的开源 AI 编程 Agent,提供 TUI、网页 GUI 和 IDE 集成。
1

安装 OpenHands

pipx install openhands
2

一行配好 MiniMax

sk-cp-... 换成你的 Token Plan API Key
pipx run --spec openhands python -c '
import sys
from openhands_cli.stores.agent_store import AgentStore
AgentStore().create_and_save_from_settings(
    llm_api_key=sys.argv[1],
    settings={"llm_model": "openai/MiniMax-M2.7",
              "llm_base_url": "https://api.minimaxi.com/v1"},
)
' sk-cp-...
3

启动

openhands

LangChain

LangChain 是 LangChain Inc. 出品的开源 LLM 应用开发框架,提供模型适配器、检索、Agent 与可观测性能力。
1

安装

pip install langchain-openai
2

通过 OpenAI 兼容适配器接入 MiniMax

sk-cp-... 换成你的 Token Plan API Key
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="MiniMax-M2.7",
    api_key="sk-cp-...",
    base_url="https://api.minimaxi.com/v1",
)
print(llm.invoke("Hello").content)