编辑文档 - OpenCode 接入 MiniMax M3：curl 一键安装 + 1M 上下文配置教程

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

## 为什么选 MiniMax M3？

| 对比项 | MiniMax M3 | OpenCode 默认模型 |
|--------|------------|------------------|
| 上下文 | 1M tokens | 通常 128K |
| 输入价格 | $0.30/M（缓存后 $0.06/M）| 各家不同 |
| 多模态 | ✅ 原生多模态 | 取决于模型 |
| Coding benchmark | SWE-bench 持平 Opus 4.7 | 普通模型 |

对于需要处理大项目、超长代码审查、或者同时处理多模态任务（代码+截图+文档）的开发者，MiniMax M3 的 1M 上下文优势非常明显。

---

## 一、安装 OpenCode

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

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

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

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

### 方式三：桌面端 Beta

OpenCode 也提供桌面应用，支持 macOS、Windows、Linux：

访问 [opencode.ai](https://opencode.ai) 下载桌面 Beta 版。

---

## 二、首次登录配置

### Step 1：登录 OpenCode

```bash
opencode auth login
```

这一步会引导你创建账户或登录，支持 GitHub 账号登录。

### Step 2：连接项目

进入你的代码目录：

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

首次运行时会提示选择 Provider（模型提供商）和输入 API Key。

---

## 三、接入 MiniMax M3

### 方式一：首次运行时配置（推荐新手）

当 `opencode` 提示选择 provider 时：

**Step 1**：在 provider 列表中搜索并选择 **"MiniMax（minimaxi.com）"**

**Step 2**：输入你的 MiniMax API Key

**Step 3**：完成配置，进入主界面

**Step 4**：在命令行输入 `/models` 查看可用模型，确认 `MiniMax-M3` 在列表中

### 方式二：手动配置文件（适合已安装用户）

如果 OpenCode 已安装好，想要切换到 MiniMax M3，编辑配置文件：

**配置文件路径**：
- macOS/Linux：`~/.config/opencode/opencode.json`
- Windows：`%APPDATA%/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"
      }
    }
  }
}
```

> ⚠️ **注意**：使用前需确保已安装 Anthropic 包。如果遇到问题，先确认是否已安装 Anthropic 相关的 npm 包，以及配置文件中的 baseURL 和环境变量设置正确。

### 方式三：环境变量（适合多项目复用）

不想每个项目单独配置，可以在 shell 配置文件（`~/.bashrc` 或 `~/.zshrc`）中设置环境变量：

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

保存后重载配置文件：

```bash
source ~/.bashrc   # 或 source ~/.zshrc
```

然后再运行 `opencode`。

---

## 四、验证是否成功接入

运行以下命令验证：

### 1. 查看状态

```bash
opencode --status
```

确认 Provider 显示为 MiniMax。

### 2. 查看模型列表

```bash
opencode /models
```

确认 `MiniMax-M3` 在列表中。

### 3. 快速测试

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

在对话中输入：

```
请介绍一下这个项目的结构和主要文件
```

如果 MiniMax M3 正常响应，说明接入成功。

---

## 五、切换不同模型

OpenCode 支持随时切换模型。在对话中输入：

```
/model MiniMax-M3
```

或者在配置文件中修改 `provider` 设置，下次启动时自动使用新模型。

---

## 六、MiniMax API Key 获取方式

如果还没有 MiniMax API Key，按以下步骤获取：

### 方式一：MiniMax 开放平台（推荐）

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

### 方式二：MiniMax 官网

访问 [minimax.io](https://www.minimax.io) → 注册 → 控制台 → API Key。

### 价格说明

| 计费类型 | 价格 |
|----------|------|
| 标准输入（MiniMax-M3） | $0.30/M tokens |
| 混合价格（含 Cache，强烈推荐） | **$0.06/M tokens** |
| 输出价格 | 视模型而定 |

建议开启自动 Cache，费用降低约 80%。

---

## 七、常见问题

### Q1：报错 "Cannot find provider"

**原因**：配置文件中 provider 格式不对，或 npm 包未安装。

**解决方法**：确保 `@ai-sdk/anthropic` 已安装，或使用 npm 安装：
```bash
npm i -g @ai-sdk/anthropic
```

### Q2：API Key 无效

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

**解决方法**：
1. 登录 MiniMax 控制台重新生成 Key
2. 确认 Key 没有过期
3. 检查账户余额

### Q3：连接超时

**原因**：网络问题（国内访问 `api.minimax.io` 可能不稳定）。

**解决方法**：使用国内接口 `https://api.minimaxi.com/anthropic`，而非国际接口。

### Q4：模型不匹配

**原因**：输入的模型名称与 MiniMax 不符。

**解决方法**：确认使用的是 `MiniMax-M3`（完整名称，包含大小写）。

---

## 八、OpenCode 常用命令速查

| 命令 | 说明 |
|------|------|
| `opencode` | 启动 OpenCode |
| `opencode auth login` | 登录账户 |
| `opencode /models` | 查看可用模型 |
| `opencode /model <name>` | 切换模型 |
| `opencode --status` | 查看当前状态 |
| `opencode --help` | 查看帮助 |

---

## 九、进阶用法：结合 OpenCode 特色功能

### 多会话并行

OpenCode 支持在同一项目启动多个 Agent 并行工作。用 MiniMax M3 的大上下文，可以同时处理多个大型任务：

```bash
# 终端 1：代码重构
opencode
> 帮我重构 /src/utils 目录

# 终端 2：写测试
opencode
> 为 /src/core 添加单元测试
```

### LSP 自动加载

OpenCode 自动检测项目语言并加载对应 LSP，MiniMax M3 在代码理解时会获得更精准的上下文：

```bash
opencode
> 分析这个 TypeScript 项目的类型定义
```

### 分享会话

OpenCode 可以生成分享链接，MiniMax M3 的分析结果可以直接分享给同事：

```bash
opencode
> 分析这段代码并生成分享链接
```

---

## 总结

| 步骤 | 操作 |
|------|------|
| 1 | 安装 OpenCode（curl/npm/desktop） |
| 2 | `opencode auth login` 登录 |
| 3 | 选 MiniMax provider 或编辑配置文件 |
| 4 | 输入 MiniMax API Key |
| 5 | `opencode` 启动，输入 `/model MiniMax-M3` |
| 6 | 开始 Coding |

MiniMax M3 的 1M 上下文在 OpenCode 里可以发挥最大价值——让 AI 看到整个代码库，而不只是零散的文件片段。如果你经常处理大型项目、多文件重构、或者需要跨多个模块做代码分析，这个组合非常值得一试。

摘要

标签多个标签用逗号分隔

分类