> ## Documentation Index
> Fetch the complete documentation index at: https://platform.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> 在 OpenCode 中接入 MiniMax 模型。

<div style={{background:"#fffbeb",borderLeft:"4px solid #d97706",padding:"12px 16px",borderRadius:"6px",margin:"16px 0"}}>[**OpenCode**](https://github.com/sst/opencode) 是 SST 出品的开源终端 AI 编程 Agent，支持多服务商接入和 LSP 集成。</div>

<Tabs sync={false}>
  <Tab title="方式一：一键配置向导">
    直接运行：

    ```bash theme={null}
    npx -y mmx-cli@latest agent setup
    ```

    在工具列表中选择 **OpenCode**。如果尚未安装，在第二个多选列表中保留 OpenCode。向导会安装官方 npm 包并检查版本，然后写入 MiniMax 默认模型。

    完成后运行 `opencode`。
  </Tab>

  <Tab title="方式二：手动配置">
    <Steps>
      <Step title="安装 OpenCode">
        ```bash theme={null}
        curl -fsSL https://opencode.ai/install | bash
        # 或 npm i -g opencode-ai
        ```
      </Step>

      <Step title="登录认证">
        运行 `opencode auth login`，选择 provider 时搜索并选择 **MiniMax Token Plan (minimaxi.com)**（OpenCode 中的名称），填入你的 [订阅 Key](https://platform.minimax.cn/console/plan)。
      </Step>

      <Step title="启动">
        回到命令行运行 `opencode`，在模型列表中选择 `MiniMax-M3.1-Flash-Preview`。如果当前版本未列出该模型，在 `~/.config/opencode/opencode.json` 中加入以下内容后重新运行：

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

        示例将客户端上下文窗口设为 **512K（524288 tokens）**，以兼顾使用体验与成本；模型本身最高支持 1M。详见[512K 配置建议](/docs/m-plan/codex#context-window-512k)。
      </Step>
    </Steps>
  </Tab>
</Tabs>
