在OpenCode中使用MaaS模型API

在软件开发过程中，开发者经常面临代码编写效率低、调试困难等问题。OpenCode是一款AI编程工具，通过接入大模型可帮助开发者高效完成代码开发、调测。然而，如何将这些先进的AI能力快速集成到现有的开发环境中，成为了一个新的挑战。您可通过简单配置，把MaaS模型API接入OpenCode，从而轻松实现AI能力的集成，提高开发效率。本文档旨在帮助开发者快速配置并高效、安全地在OpenCode环境中集成MaaS模型的API。

前提条件

已注册华为云账号，并进行实名认证。具体操作，请参见注册华为账号并开通华为云和实名认证。
已开通预置服务，或已创建接入点。具体操作，请参见开通预置服务或创建自定义接入点。

计费说明

在调用MaaS模型服务时，将根据实际使用的Tokens数量进行计费。计费详情请参见MaaS文本生成模型。

约束限制

该功能仅支持“西南-贵阳一”区域。

步骤一：安装OpenCode

安装Node.js 18或更高版本。

node -v #运行该命令可验证Node.js版本

打开命令行界面，执行以下命令，安装OpenCode。
```
npm install -g opencode-ai
```
运行以下命令验证安装。若有版本号输出，则表示安装成功。若安装失败，请检查Node.js版本是否为18及以上。可运行node -v查看当前版本。
```
opencode -v
```

步骤二：在OpenCode中接入MaaS模型API

在OpenCode的配置文件~/.config/opencode/opencode.json中配置MaaS的API。本文档以模型GLM-5为例。

不同系统的配置文件路径不同，请按实际情况执行命令。如果没有opencode.json文件，请在对应目录进行新增。

macOS/Linux：~/.config/opencode/opencode.json
Windows：C:\Users\您的用户名\.config\opencode\opencode.json

表1 配置参数说明
参数	说明	示例
name	自定义模型名称	MaaS
baseURL	https://api.modelarts-maas.com/openai/v1或https://api.modelarts-maas.com/v2	https://api.modelarts-maas.com/openai/v1
apiKey	获取API Key。	***SOYrkryjO-Jcd-X0-YQIA_oALlv*-xVhElZgwtV3-3aXiuiac6bW******
models	支持的模型及model参数值，请参见支持模型。	glm-5

<API_KEY>：替换为您自己的获取API Key。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MaaS",
      "options": {
        "baseURL": "https://api.modelarts-maas.com/openai/v1",
        "apiKey": "<API_KEY>" 
      },
      "models": {
        "glm-5": {
            "name": "glm-5"
        }
      }
    }
  }
}

在终端执行如下命令开启OpenCode。
```
opencode
```
输入/models，选择配置的GLM-5模型并在OpenCode中使用。
对话，如下图所示。

常见问题

OpenCode如何开启深度思考模式？

编辑OpenCode的配置文件~/.config/opencode/opencode.json，在参数models模型信息配置中新增options配置，内容为{"thinking": {"type": "enabled"}}。参考示例如下：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MaaS",
      "options": {
        "baseURL": "https://api.modelarts-maas.com/openai/v1",
        "apiKey": "<API_KEY>" 
      },
      "models": {
         "glm-5": {
            "name": "glm-5",
            "options": {
                 "thinking": {
                      "type": "enabled"
                  }
             }
        }
      }
    }
  }
}