本文介绍如何在 OpenCode 中配置并使用方舟 Agent Plan 企业版。
前提条件#
需由管理员账号完成以下前置操作后，子账号方可配置并使用 OpenCode：
- 购买方舟 Agent Plan 企业版套餐：一、购买 Agent Plan 企业版。
- 为子账号分配席位：二、分配席位。
安装 OpenCode#
前提条件：安装 Node.js 18 或更新版本。
在命令行界面，执行以下命令安装 OpenCode。
npm install -g opencode-ai
安装结束后，执行以下命令查看安装结果，若显示版本号则安装成功。
opencode --version
配置 OpenCode#
需配置的信息#
如您对 OpenCode 熟悉，或本地已有配置，可获取以下信息直接配置。
- Base URL：
https://ark.cn-beijing.volces.com/api/plan/v3。 - API Key：获取专属 API Key。
- Model：配置文本生成模型。可配置
ark-code-latest或 Model Name，模型信息参见支持模型及 Harness。
方式 1：一键配置（推荐）#
Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。
-
安装 Ark CLI
环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。
npm install -g @volcengine/ark-cli@latest
arkcli --version
-
登录 Ark CLI
根据界面提示选择登录方式，推荐选择 火山 SSO (浏览器登录)，在浏览器中完成授权即可。
arkcli auth login
- 一键配置 OpenCode
arkcli helper
运行 ArkCLI Helper，根据界面提示完成配置。
- 选择 Profile：
agent-plan-team_cn-beijing_team。 - 选择默认 model：按需选择。
- 选择 AI Agent：
OpenCode。
支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。
配置完成后，OpenCode 会自动识别配置的模型。启动 OpenCode 即可使用。
方式 2：手动配置#
新建 ~/.config/opencode/opencode.json（Windows 路径：%USERPROFILE%\.config\opencode\opencode.json），配置信息如下：
<ARK_API_KEY>：替换为您自己的 专属 API Key。
model：见支持模型及 Harness，需配置文本生成模型。
Agent Plan 企业版兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。
支持的两类 API 仅在 npm 配置上不同：
- Responses API 配置：
"npm": "@ai-sdk/openai" - Chat API 配置：
"npm": "@ai-sdk/openai-compatible"
以配置 ark-code-latest 为例，具体信息如下。
{
"$schema": "https://opencode.ai/config.json",
"model": "volcengine-enterprise-agent-plan/ark-code-latest",
"provider": {
"volcengine-enterprise-agent-plan": {
"npm": "@ai-sdk/openai",
"name": "Volcano Engine（Responses API）",
"options": {
"baseURL": "https://ark.cn-beijing.volces.com/api/plan/v3",
"apiKey": "<ARK_API_KEY>"
},
"models": {
"ark-code-latest": {
"name": "ark-code-latest",
"limit": {
"context": 256000,
"output": 32000
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"doubao-seed-2.1-pro": {
"name": "doubao-seed-2.1-pro",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"doubao-seed-evolving": {
"name": "doubao-seed-evolving",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"glm-5.3": {
"name": "glm-5.3",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"glm-5.3-flash": {
"name": "glm-5.3-flash",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"glm-latest": {
"name": "glm-latest",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"deepseek-v4.1-flash": {
"name": "deepseek-v4.1-flash",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"deepseek-v4.1-flash-economy": {
"name": "deepseek-v4.1-flash-economy",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"deepseek-v4-flash": {
"name": "deepseek-v4-flash",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"deepseek-v4-pro": {
"name": "deepseek-v4-pro",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"doubao-seed-2.1-lite": {
"name": "doubao-seed-2.1-lite",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"doubao-seed-2.0-mini": {
"name": "doubao-seed-2.0-mini",
"limit": {
"context": 256000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"kimi-k2.8-preview": {
"name": "kimi-k2.8-preview",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"kimi-k3.1-pro": {
"name": "kimi-k3.1-pro",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
}
}
}
}
}
{
"$schema": "https://opencode.ai/config.json",
"model": "volcengine-enterprise-agent-plan/ark-code-latest",
"provider": {
"volcengine-enterprise-agent-plan": {
"npm": "@ai-sdk/openai-compatible",
"name": "Volcano Engine（Chat API）",
"options": {
"baseURL": "https://ark.cn-beijing.volces.com/api/plan/v3",
"apiKey": "<ARK_API_KEY>"
},
"models": {
"ark-code-latest": {
"name": "ark-code-latest",
"limit": {
"context": 256000,
"output": 32000
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"doubao-seed-2.1-pro": {
"name": "doubao-seed-2.1-pro",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"doubao-seed-evolving": {
"name": "doubao-seed-evolving",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"glm-5.3": {
"name": "glm-5.3",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"glm-5.3-flash": {
"name": "glm-5.3-flash",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"glm-latest": {
"name": "glm-latest",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"deepseek-v4.1-flash": {
"name": "deepseek-v4.1-flash",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"deepseek-v4.1-flash-economy": {
"name": "deepseek-v4.1-flash-economy",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"deepseek-v4-flash": {
"name": "deepseek-v4-flash",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"deepseek-v4-pro": {
"name": "deepseek-v4-pro",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text"
],
"output": [
"text"
]
}
},
"doubao-seed-2.1-lite": {
"name": "doubao-seed-2.1-lite",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"doubao-seed-2.0-mini": {
"name": "doubao-seed-2.0-mini",
"limit": {
"context": 256000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"kimi-k2.8-preview": {
"name": "kimi-k2.8-preview",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
},
"kimi-k3.1-pro": {
"name": "kimi-k3.1-pro",
"limit": {
"context": 1024000,
"output": 65536
},
"modalities": {
"input": [
"text",
"image"
],
"output": [
"text"
]
}
}
}
}
}
}
使用 OpenCode#
-
启动 OpenCode：
opencode -
输入
/models，选择配置的模型并在 OpenCode 中使用。
其他操作#
添加图片生成/视频生成能力#
方舟 Agent Plan 企业版 Team Medium 及以上套餐提供图片生成模型配额，Team Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见 配置视觉模型。
切换模型#
你可以随时根据需求切换文本生成模型。方舟支持多种方式切换模型。
| 配置方式 | 通过控制台 | 通过命令参数 | 修改配置文件 |
|---|---|---|---|
| 切换模型操作 | 1. 参考配置 OpenCode配置模型名称为 ark-code-latest。2. 在 订阅页面，选择我的 - 使用配置，选择要使用的模型，切换后 3-5 分钟即可生效。 |
启动 OpenCode 后，执行/models 切换模型。 |
参考配置 OpenCode配置模型名称为您需要的模型。 |