LowHow 文档

中文

English

中文

English

深色模式

OpenCode 连接 MiniMax M2.5/M2.1 实战教程 ​

📚 分类: AI 编程助手配置 ⏱️ 预计耗时: 10-15 分钟 🎯 难度: 入门 🔧 环境要求: 已安装 OpenCode，可访问互联网 🌐 原文来源: OpenCode 官方文档

你将学到什么 ​

完成本教程后，你将能够：

  • [ ] 在 MiniMax 平台获取专属的 API Key
  • [ ] 在 OpenCode 中通过命令或配置文件连接 MiniMax
  • [ ] 选择并使用 MiniMax-M2.5 或 M2.1 模型完成首次对话
  • [ ] 排查并解决常见的连接错误

最终效果 ​

你将在 OpenCode 的终端界面中，成功调用 MiniMax 的 AI 模型（如 M2.5），并收到它对问候或问题的回复。这意味着你的 AI 编程助手已经连上了一个强大的新“大脑”。

前置准备 ​

在开始前，请确认你的环境满足以下条件：

检查项要求验证命令
OpenCode已安装并能正常运行opencode --version
MiniMax 账号已注册并可登录访问 MiniMax 平台 确认

1. 了解 API Key ​

API Key (应用程序编程接口密钥) 是连接你与 MiniMax 服务的“密码”。你需要在 MiniMax 官网获取它，然后告诉 OpenCode。

🤔 为什么要先获取 API Key？ OpenCode 需要通过这个 Key 来证明你的身份，并授权使用 MiniMax 的 AI 模型。没有它，服务就无法确认你的使用权限。

第 1 步：注册并获取 MiniMax API Key ​

🎯 目标：在 MiniMax 官网完成注册，并获取一个专属的 API Key。

📝 操作：

  1. 访问 MiniMax 平台： 打开浏览器，根据你的网络环境访问对应平台：

  2. 选择获取 Key 的方式： 登录后，根据你的需求选择以下两种方式之一：

    • 方式 A：购买 Coding Plan (月卡/套餐) (推荐尝鲜) 在平台页面找到并订阅 “Coding Plan” (例如 Starter 月卡)。订阅成功后，在 “套餐管理” 页面复制系统为你生成的专属 API Key。

    • 方式 B：按量计费 在控制台找到 “API Key” 或 “接口密钥” 管理页面。点击 “创建” 或 “新建” 按钮，生成一个新的 API Key。 ⚠️ 立即复制并保存好这个 Key，页面关闭后将无法再次查看。

✅ 验证： 你手上应该已经有一个以 sk- 或其他特定前缀开头的字符串，这就是你的 MiniMax API Key。

第 2 步：在 OpenCode 中连接 MiniMax ​

🎯 目标：将上一步获取的 API Key 配置到 OpenCode 中，建立连接。

上一步我们获取了 API Key，现在需要把它“告诉” OpenCode。这里有两种方法，我们首先推荐最简洁的命令行方式。

📝 操作：

  1. 启动 OpenCode： 打开你的终端，输入以下命令启动 OpenCode：

    bash
    $ opencode

  2. 使用 /connect 命令 (推荐)： 在 OpenCode 的交互界面中，输入并执行以下命令：

    bash
    /connect

    系统会提示你搜索并选择模型提供商。在搜索框中输入 MiniMax 并选择它。然后，根据提示粘贴你刚才复制的 API Key 并回车。

    ✅ 验证： 如果看到类似 “Successfully connected to MiniMax” 的提示，说明连接成功。你可以直接跳转到第 3 步。

  3. （可选）手动配置自定义端点： 如果上述方法失败，或者你的 OpenCode 版本没有内置 MiniMax 入口，可以使用此方法。

    • 步骤 A：编辑配置文件 使用文本编辑器打开 OpenCode 的配置文件 ~/.config/opencode/opencode.json。如果文件或目录不存在，请手动创建。

      json
      // 文件路径: ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "minimax": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        // 国际版用户使用此地址
        "baseURL": "https://api.minimax.io/anthropic/v1"
        // 国内版用户请将上行替换为下面这行
        // "baseURL": "https://api.minimaxi.com/anthropic/v1"
      },
      "models": {
        "MiniMax-M2.5": {
          "name": "MiniMax-M2.5"
        },
        "MiniMax-M2.1": {
          "name": "MiniMax-M2.1"
        }
      }
    }
  }
}

      💡 提示：

      • 国内用户请将 baseURL 的值改为 https://api.minimaxi.com/anthropic/v1。
      • 这表示 MiniMax 提供了与 Anthropic 兼容的 API 接口，所以 npm 包名是 @ai-sdk/anthropic。

    • 步骤 B：运行登录命令 保存配置文件后，在 OpenCode 终端里运行：

      bash
      $ opencode auth login

      在交互界面中：

      1. 选择 Other。
      2. 输入 provider ID： minimax。
      3. 粘贴你的 MiniMax API Key。

    ✅ 验证： 命令执行后不应报错。

  4. 清理环境变量冲突 (重要)：

    ⚠️ 常见错误：如果你之前设置过 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_BASE_URL 环境变量，它们会干扰 MiniMax 的连接。

    💡 解决方案：在运行 OpenCode 的终端中，执行以下命令清理它们：

    bash
    $ unset ANTHROPIC_AUTH_TOKEN
$ unset ANTHROPIC_BASE_URL

第 3 步：选择模型并完成首次对话 ​

🎯 目标：在 OpenCode 中选择 MiniMax 模型，并发送一条消息来验证一切工作正常。

现在我们已经配置好了连接，接下来就是见证奇迹的时刻——让 AI 回复你的第一条消息。

📝 操作：

  1. 选择模型： 在 OpenCode 的交互界面中，输入并执行以下命令：

    bash
    /models

    从列表中选择 MiniMax-M2.5 或 MiniMax-M2.1。

  2. 发起对话： 输入一条测试消息，例如：

    text
    你好，请介绍一下你自己

    然后按回车发送。

✅ 验证：

  • 你应该能收到 MiniMax 模型的回复，它会介绍自己的身份和能力。
  • 检查 /models 命令的输出，确认 MiniMax 模型已出现在列表中。

常见问题与排错 ​

现象可能原因解决方案
Cannot read properties of undefined配置文件 opencode.json 格式错误或 API Key 无效1. 检查 baseURL 和 provider 字段是否正确。 2. 确认你复制的 API Key 是完整的且未过期。 3. 重新执行 opencode auth login 步骤。
发送消息后无响应环境变量冲突在终端中执行 unset ANTHROPIC_AUTH_TOKEN 和 unset ANTHROPIC_BASE_URL，然后重启 OpenCode。
提示 “401 Unauthorized”API Key 无效或已过期返回 MiniMax 平台，检查你的 API Key 状态并重新生成一个。

总结 ​

恭喜你完成了本教程！🎉

回顾一下我们今天学到的核心内容：

  1. 获取 API Key：在 MiniMax 平台通过月卡或按量计费方式获取了连接服务的“密码”。
  2. 配置 OpenCode：使用 /connect 命令或手动编辑配置文件，将 API Key 与 OpenCode 关联起来。
  3. 验证连接：通过 /models 选择模型并发送消息，成功完成了与 MiniMax AI 的首次对话。

© 2026 LowHow