OpenCode

OpenCode 是一款开源的 AI 编程代理工具，提供终端界面、桌面应用和 IDE 扩展等多种使用方式。

1. 前提准备

1.1 安装 Node.js

已安装 Node.js 18 及以上版本。如未安装，请前往 Node.js 官网下载安装。
运行以下命令可验证 Node.js 版本：

node -v

1.2 安装 opencode

在命令行界面，执行以下命令安装 OpenCode。

npm install -g opencode-ai

安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。

opencode -v

1.3 获取 Sophnet 配置信息

进入 Sophnet 控制台 alt text 在 Sophnet 用户中心按照创建项目→选择服务→设置API KEY的路径进行配置，确保获取以下配置信息：

Sophnet API Key (密钥)
Base URL (接口地址) 地址: https://www.sophnet.com/api/open-apis/v1
模型名称请在复制完整模型名称，如：DeepSeek-V3.2-Fast / MiniMax-M2.5 。

2. 编辑 OpenCode 的配置文件

在以下路径编辑配置信息：
macOS / Linux：~/.config/opencode/opencode.json
Windows：C:\Users\您的用户名\.config\opencode\opencode.json
需要修改的配置信息如下：
your_apikey：替换为您自己的 API Key。
models：更新为需要使用的模型名称。

注意：若需开启模型图片理解能力，需在模型配置节点下新增如下配置项：
"modalities": {"input": ["text", "image"], "output": ["text"]}

以配置DeepSeek-V3.2-Fast、MiniMax-M2.5、Qwen2.5-VL-32B-Instruct为例，具体配置信息如下：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myprovider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "sophnet",
      "options": {
        "baseURL": "https://www.sophnet.com/api/open-apis/v1",
        "apiKey": "your_apikey"
      },
      "models": {
        "DeepSeek-V3.2-Fast": {
          "name": "DeepSeek-V3.2-Fast"
        },
        "MiniMax-M2.5": {
          "name": "MiniMax-M2.5"
        },
        "Qwen2.5-VL-32B-Instruct": {
          "name": "Qwen2.5-VL-32B-Instruct",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
     }
  }
}

3. 启用 OpenCode

3.1 启动 opencode

运行以下命令启动 OpenCode：

opencode

alt text

3.2 连接模型服务

方式一：
在输入框输入/models并单击 Enter。
在搜索框中输入sophnet进行搜索。
即可选择刚刚配置的模型。
alt text

方式二：
在输入框输入/connect并单击 Enter。
在 Provider 列表的搜索框中输入sophnet进行搜索，选中 sophnet。
alt text 输入API KEY 并单击 Enter。
即可选择刚刚配置的模型。

验证调用
输入对话问题，显示回答即为调用成功。
alt text