安装 OpenCode

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

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

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

npm i -g opencode-ai

两种方式安装的版本完全一致，选择适合你系统的即可。更多安装方式参考 OpenCode 官网。

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

Step 1：运行认证命令

opencode auth login

Step 2：选择 Provider

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

Step 3：输入 API Key

当提示输入 API Key 时，输入你的 MiniMax API Key（从 platform.minimaxi.com 获取）。

Step 4：开始使用

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

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 中清除：

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

清除后，将以下配置添加到 opencode.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：

cd /path/to/your/project
opencode

Step 3：选择模型

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

MiniMax API Key 获取

如果还没有 MiniMax API Key：

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

两种配置方式对比

常见问题

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

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

解决方法：

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，确保已安装：

npm i -g @ai-sdk/anthropic

常用命令速查