# OpenCode
在软件开发过程中，开发者经常面临代码编写效率低、调试困难等问题。OpenCode是一款AI编程工具，通过接入大模型可帮助开发者高效完成代码开发、调测。然而，如何将这些先进的AI能力快速集成到现有的开发环境中，成为了一个新的挑战。您可通过简单配置，把MaaS模型API接入OpenCode，从而轻松实现AI能力的集成，提高开发效率。本文档旨在帮助开发者快速配置并高效、安全地在OpenCode环境中集成MaaS模型的API。
#### 前提条件
- 已注册华为云账号，并进行实名认证。具体操作，请参见[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)和[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。
- 已开通预置服务，或已创建接入点。具体操作，请参见[开通预置服务](https://support.huaweicloud.com/model-call-maas/model-call-052.html)或[创建自定义接入点](https://support.huaweicloud.com/model-call-maas/model-call-048.html)。
 
#### 计费说明
在调用MaaS模型服务时，将根据实际使用的Tokens数量进行计费。计费详情请参见[MaaS文本生成模型](https://support.huaweicloud.com/price-maas/price-maas-0002.html)。
#### 约束限制
该功能仅支持"西南-贵阳一"区域。
#### 步骤一：安装OpenCode
1. 安装[Node.js 18或更高版本](https://nodejs.org/en/download/)。
   ```
   node -v #运行该命令可验证Node.js版本
   ```
   
2. 打开命令行界面，执行以下命令，安装OpenCode。
   ```
   npm install -g opencode-ai
   ```
   
3. 运行以下命令验证安装。若有版本号输出，则表示安装成功。若安装失败，请检查Node.js版本是否为18及以上。可运行node -v查看当前版本。
   ```
   opencode -v
   ```
   
 
#### 步骤二：在OpenCode中接入MaaS模型API
1. 前往OpenCode的配置文件路径（Windows路径：C:\\Users\\您的用户名\\.config\\opencode\\）下编辑opencode.json文件。本文以模型GLM-5.2为例，参考[表1]进行配置。
    表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](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。                       | \*\*\*\*\*SOYrkryjO-Jcd-X0-YQIA_oALlv\*\*\*\*\*-xVhElZgwtV3-3aXiuiac6bW\*\*\*\*\*\*\*\* |
   | models  | 支持的模型及model参数值，请参见[支持模型](https://support.huaweicloud.com/model-call-maas/model-call-021.html#section2)。 | glm-5.2                                                                                 |
      
   - \<API_KEY\>：替换为您自己的[获取API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。
     ```
     {
       "$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.2": {
                 "name": "glm-5.2"
             }
           }
         }
       }
     }
     ```
     
    
2. 在终端执行如下命令开启OpenCode。
   ```
   opencode
   ```
   
3. 输入/models，选择配置的GLM-5.2模型并在OpenCode中使用。 ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002686741444.png "点击放大")
   
   
4. 对话，如下图所示。 ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002716263505.png "点击放大")
   
   
   
 
#### 常见问题
- **OpenCode如何开启深度思考模式？**
  1. 编辑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.2",
                 "options": {
                      "thinking": {
                           "type": "enabled"
                       }
                  }
             }
           }
         }
       }
     }
     ```
     
  
  2. 配置完成后执行命令"opencode"重新启动。如果在对话时仍看不到Thinking信息，可以在输入框按ctrl+p，搜索think，选中Show thinking，则可以查看思考的信息。 ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002569016004.png)