MiniMax-M3.1-Flash 接入 OpenCode：手动配置与上下文边界

一句话结论

MiniMax 官方文档给出了在 OpenCode 中选择 MiniMax-M3.1-Flash 的登录步骤和 opencode.json 手动配置；示例把客户端上下文设为 524288 token，同时说明模型本身支持最高 1M token。

适用场景

• 适合的任务：在 OpenCode 中使用 MiniMax M 系列模型进行终端编码任务。

• 不适合的任务：非 OpenCode 客户端；文档没有提供通用 API 请求示例，也没有给出 OpenCode 的思考保留或自动压缩参数。

• 适用的模型版本：MiniMax-M3.1-Flash。

• 适用的客户端、Agent 或 API：OpenCode（SST 开源终端编码 Agent）；MiniMax M Plan 的 minimax-coding-plan provider。

• 推荐的推理档位和参数：未注明。不要把其他客户端的 reasoning 配置直接迁移到 OpenCode。

可直接使用的内容

先安装并登录 OpenCode：

curl -fsSL https://opencode.ai/install | bash
# 或
npm i -g opencode-ai

opencode auth login

登录时搜索并选择 OpenCode 中的 MiniMax Token Plan (minimax.io)，然后输入 Subscription Key。启动 opencode 后，从模型列表选择 MiniMax-M3.1-Flash。

如果模型没有出现在列表中，编辑 ~/.config/opencode/opencode.json，加入以下配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "minimax-coding-plan": {
      "models": {
        "MiniMax-M3.1-Flash": {
          "name": "MiniMax-M3.1-Flash",
          "limit": { "context": 524288 }
        }
      }
    }
  }
}

通过 CC Switch 等工具配置时，确认协议和 Base URL 一致。官方给出的 Anthropic 兼容配置如下；该适配器会在 Base URL 后追加 /messages，因此保留 /anthropic/v1：

{
  "provider": {
    "minimax-coding-plan": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.minimax.io/anthropic/v1"
      },
      "models": {
        "MiniMax-M3.1-Flash": {
          "name": "MiniMax-M3.1-Flash",
          "limit": { "context": 524288 }
        }
      }
    }
  }
}

测试或工作流步骤

1. 安装 OpenCode，运行 opencode auth login。

2. 选择 MiniMax Token Plan (minimax.io) 并输入 Subscription Key。

3. 启动 OpenCode，选择 MiniMax-M3.1-Flash。

4. 若列表中没有模型，在 ~/.config/opencode/opencode.json 合并上面的 provider 和 model 配置，然后重新运行 OpenCode。

5. 若使用 CC Switch，检查协议为 Anthropic 兼容实现、npm adapter 为 @ai-sdk/anthropic，Base URL 为 https://api.minimax.io/anthropic/v1。

官方还提供一键安装向导：

npx -y mmx-cli@latest agent setup

向导中选择 OpenCode；文档称向导会安装官方 npm 包、验证其版本并设置 MiniMax 默认模型，完成后运行 opencode。本文不执行安装或写入配置。

原始证据与数据

• OpenCode 页将模型标为 MiniMax-M3.1-Flash，provider 为 minimax-coding-plan。

• 手动配置文件为 ~/.config/opencode/opencode.json；模型配置中的客户端上下文限制为 524288 token。

• 页面说明该示例使用 512K 客户端上下文以平衡成本与可用性，模型本身支持最高 1M 上下文。

• Anthropic 兼容配置使用 @ai-sdk/anthropic 和 https://api.minimax.io/anthropic/v1；适配器会追加 /messages。

• 页面没有给出 OpenCode 的自动压缩阈值、历史消息保留规则、思考内容保留格式或独立验证数据。

适用边界

• 524288 是文档示例中的客户端上下文设置，不应表述为模型的最大上下文；页面把模型上限写为 1M。

• 1M 上限如何由当前 OpenCode 版本实际承载，页面未提供验证步骤或版本号；使用 1M 前应在目标版本中自行确认。

• 文档没有为 OpenCode 公开推理档位、思考开关、思考摘要或压缩阈值。不要依据其他 Agent 的设置推断 OpenCode 行为。

• Subscription Key、账号资格和 M Plan 可用性取决于 MiniMax 账户；本文不包含密钥，也不实际登录或安装。

• 页面发布日期和 OpenCode/MiniMax 版本均未注明；复现时应记录实际版本。

复现说明

在隔离环境中按上面的步骤配置，不执行未经审查的安装脚本。启动后确认模型列表中的精确名称为 MiniMax-M3.1-Flash，检查 ~/.config/opencode/opencode.json 的 provider、adapter、Base URL 和 context: 524288，再发送一个无敏感信息的短编码任务验证请求是否成功。若使用 CC Switch，先核对它生成的协议和 Base URL，避免把 /anthropic/v1 重复拼接。