编辑文档 - 在 OpenCode 中使用 MiniMax-M3：交互式配置 + 配置文件两种方式

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

## 安装 OpenCode

### 方式一：curl 安装（推荐 macOS / Linux）

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

### 方式二：npm 安装（跨平台）

```bash
npm i -g opencode-ai
```

两种方式安装的版本完全一致，选择适合你系统的即可。更多安装方式参考 [OpenCode 官网](https://opencode.ai)。

---

## 配置 MiniMax API（交互式，推荐新手）

### Step 1：运行认证命令

```bash
opencode auth login
```

### Step 2：选择 Provider

当提示选择 provider 时，搜索并选择 **"MiniMax（minimaxi.com）"**

### Step 3：输入 API Key

当提示输入 API Key 时，输入你的 MiniMax API Key（从 [platform.minimaxi.com](https://platform.minimaxi.com) 获取）。

### Step 4：开始使用

回到命令行界面，进入项目目录，输入 `opencode` 即可开始使用 MiniMax-M3。

```bash
cd /path/to/your/project
opencode
```

---

## 配置 MiniMax API（配置文件方式）

如果你是进阶用户，或需要同时管理多个模型，编辑配置文件是更灵活的方式。

### Step 1：编辑配置文件

OpenCode 的配置文件路径为 `~/.config/opencode/opencode.json`（macOS / Linux）或对应路径（Windows）。

**重要提示**：使用配置文件方式前，请先**清除以下 Anthropic 环境变量**，以免影响 MiniMax API 的正常使用：

```
ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL
```

在 shell 中清除：

```bash
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
```

清除后，将以下配置添加到 `opencode.json`：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "minimax": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.minimaxi.com/anthropic/v1",
        "apiKey": "<MINIMAX_API_KEY>（可选，env 变量优先）"
      },
      "models": {
        "MiniMax-M3": {
          "name": "MiniMax-M3"
        }
      }
    }
  }
}
```

### Step 2：启动 OpenCode

进入项目目录，启动 opencode：

```bash
cd /path/to/your/project
opencode
```

### Step 3：选择模型

在 OpenCode 中输入 `/models`，从列表中选择 **"MiniMax-M3"**，即可开始使用。

---

## MiniMax API Key 获取

如果还没有 MiniMax API Key：

1. 访问 [platform.minimaxi.com](https://platform.minimaxi.com)
2. 注册并登录账户
3. 进入「API Key」管理页面
4. 创建新 Key 并妥善保存

---

## 两种配置方式对比

| 对比项 | 交互式（auth login） | 配置文件 |
|--------|---------------------|----------|
| 适合人群 | 新手、临时使用 | 进阶用户、多模型管理 |
| 配置难度 | ⭐ 简单 | ⭐⭐ 略复杂 |
| 可配置项 | 基础 | 完整（可指定 baseURL、models 等） |
| 需要清环境变量 | 否 | **是**（必须清除 ANTHROPIC_*） |
| 切换模型 | 登录时默认 | 可随时 `/models` 切换 |

---

## 常见问题

### Q1：配置后提示 "Cannot find provider"

**原因**：可能没有清除 `ANTHROPIC_BASE_URL` 环境变量，导致优先读取了 Anthropic 配置。

**解决方法**：
```bash
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
```
然后重新启动 OpenCode。

### Q2：API Key 无效

**原因**：Key 未填对、额度用完或 Key 被撤销。

**解决方法**：登录 MiniMax 控制台重新生成 Key。

### Q3：连接超时（国内用户）

**原因**：网络问题。

**解决方法**：确认使用的是国内接口 `api.minimaxi.com`，配置文件中的 baseURL 需为 `https://api.minimaxi.com/anthropic/v1`。

### Q4：需要安装 npm 包吗？

是的，配置文件方式依赖 `@ai-sdk/anthropic`，确保已安装：

```bash
npm i -g @ai-sdk/anthropic
```

---

## 常用命令速查

| 命令 | 说明 |
|------|------|
| `opencode` | 启动 OpenCode |
| `opencode auth login` | 登录并交互式配置 Provider |
| `opencode /models` | 查看可用模型列表 |
| `opencode /model MiniMax-M3` | 切换到 MiniMax-M3 |
| `opencode --status` | 查看当前连接状态 |

摘要

标签多个标签用逗号分隔

分类