为什么选 MiniMax M3？

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

一、安装 OpenCode

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

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

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

npm i -g opencode-ai

方式三：桌面端 Beta

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

访问 opencode.ai 下载桌面 Beta 版。

二、首次登录配置

Step 1：登录 OpenCode

opencode auth login

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

Step 2：连接项目

进入你的代码目录：

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

配置文件内容：

{
  "$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）中设置环境变量：

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

保存后重载配置文件：

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

然后再运行 opencode。

四、验证是否成功接入

运行以下命令验证：

1. 查看状态

opencode --status

确认 Provider 显示为 MiniMax。

2. 查看模型列表

opencode /models

确认 MiniMax-M3 在列表中。

3. 快速测试

cd /path/to/your/project
opencode

在对话中输入：

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

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

五、切换不同模型

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

/model MiniMax-M3

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

六、MiniMax API Key 获取方式

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

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

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

方式二：MiniMax 官网

访问 minimax.io → 注册 → 控制台 → API Key。

价格说明

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

七、常见问题

Q1：报错 "Cannot find provider"

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

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

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 支持在同一项目启动多个 Agent 并行工作。用 MiniMax M3 的大上下文，可以同时处理多个大型任务：

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

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

LSP 自动加载

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

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

分享会话

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

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

总结

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