OpenCode

本文介绍如何在 OpenCode 中配置并使用方舟按量计费模型服务。

前提条件#

安装 OpenCode#

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

1npm install -g opencode-ai

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

1opencode --version

配置 OpenCode#

需配置的信息#

如您对 OpenCode 熟悉，或本地已有配置，可获取以下信息直接配置。

Base URL：https://ark.cn-beijing.volces.com/api/v3。
API Key：获取API Key。
Model：按需选择模型并获取 Model ID。可用模型参见模型列表。

手动配置#

创建并打开 OpenCode 的配置文件。文件路径因系统而异，具体操作如下：

macOS/Linux 系统 OpenCode 配置文件路径：~/.config/opencode/opencode.json。

如果在主目录下没有.config/opencode目录，执行以下命令创建目录。
Bash
```
1mkdir -p ~/.config/opencode
```
创建并打开配置文件。
Bash
```
1nano ~/.config/opencode/opencode.json
```

Windows 系统 OpenCode 配置文件路径：%USERPROFILE%\.config\opencode\opencode.json。以 CMD 命令行方式为例，操作如下。

如果当前用户目录下没有.config\opencode目录，执行以下命令创建目录。
Bash
```
1if not exist "%USERPROFILE%\.config\opencode" mkdir "%USERPROFILE%\.config\opencode"
```

创建并打开配置文件。

1notepad "%USERPROFILE%\.config\opencode\opencode.json"

编辑 opencode.json，需关注的配置信息如下：
- <ARK_API_KEY>：替换为您自己的 API Key。
- model：按需选择模型并获取 Model ID。可用模型参见模型列表。
按量计费模型服务兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。

支持的两类 API 仅在 npm 配置上不同：
- Responses API 配置："npm": "@ai-sdk/openai"
- Chat API 配置："npm": "@ai-sdk/openai-compatible"
以配置 doubao-seed-evolving 为例，具体信息如下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19{
  "$schema": "https://opencode.ai/config.json",
  "model": "volcengine/doubao-seed-evolving",
  "provider": {
    "volcengine": {
      "npm": "@ai-sdk/openai",
      "name": "Volcano Engine（Responses API）",
      "options": {
        "baseURL": "https://ark.cn-beijing.volces.com/api/v3",
        "apiKey": "<ARK_API_KEY>"
      },
      "models": {
        "doubao-seed-evolving": {
          "name": "doubao-seed-evolving"
        }
      }
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19{
  "$schema": "https://opencode.ai/config.json",
  "model": "volcengine/doubao-seed-evolving",
  "provider": {
    "volcengine": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Volcano Engine（Chat API）",
      "options": {
        "baseURL": "https://ark.cn-beijing.volces.com/api/v3",
        "apiKey": "<ARK_API_KEY>"
      },
      "models": {
        "doubao-seed-evolving": {
          "name": "doubao-seed-evolving"
        }
      }
    }
  }
}

使用 OpenCode#

启动 OpenCode：
Bash
```
1opencode
```
输入/models，选择配置的模型并在 OpenCode 中使用。

其他操作#

接入 MCP Server#

若内置工具未覆盖您的使用场景，可在 OpenCode 中接入二方、三方 MCP Server，扩展模型可用的能力。

获取 MCP Server#

二方：访问智能体工具商店，获取火山引擎生态内的 MCP 工具（如巨量千川、知识库等），在 MCP 详情页获取服务地址与鉴权信息。
三方：接入其他 MCP 市场提供的 MCP Server，或自行部署开源 MCP Server。

配置 MCP Server#

OpenCode 支持在设置中配置二方、三方 MCP Server，具体操作参考 OpenCode 官方文档。