Appearance
豆包大模型 - 开源工具配置文档(方舟 API 调用方式)
火山方舟 API 兼容 OpenAI 和 Anthropic 接口协议。
基础配置信息
核心配置参数
| 配置项 | 值 |
|---|---|
| API Key 获取 | 火山方舟控制台 → API Key 管理 |
| Model ID 获取 | 模型广场 |
| OpenAI 兼容 Base URL | https://ark.cn-beijing.volces.com/api/v3 |
| Anthropic 兼容 Base URL | https://ark.cn-beijing.volces.com/api/compatible |
| 支持的模型列表 | 模型广场 |
接口协议与适用工具
| 接口协议 | Base URL | 适用工具 |
|---|---|---|
| Anthropic 兼容 | https://ark.cn-beijing.volces.com/api/compatible | Claude Code |
| OpenAI 兼容 | https://ark.cn-beijing.volces.com/api/v3 | Chatbox、Cherry Studio、OpenClaw、TRAE、Cline、Cursor、Kilo Code、Roo Code、OpenCode、Codex CLI 等 |
前置准备:配置前需在火山方舟控制台开通模型服务,获取 API Key 和模型 Endpoint ID。
Chatbox
安装
通过 Chatbox 官网 下载安装,或使用网页版。
配置
| 配置项 | 值 |
|---|---|
| Model Provider 添加方式 | OpenAI API Compatible |
| API Key | 你的方舟 API Key |
| API Host | https://ark.cn-beijing.volces.com/api/v3 |
| API Path | /chat/completions |
| Model | 模型 ID |
Cherry Studio
安装
通过 Cherry Studio 官网 下载安装。
配置
| 配置项 | 值 |
|---|---|
| 提供商类型 | OpenAI |
| API 密钥 | 你的方舟 API Key |
| API 地址 | https://ark.cn-beijing.volces.com/api/v3 |
| 模型 | 添加模型 → 填写模型 ID |
Codex CLI
前置条件
Node.js 18 及以上版本。
安装
bash
npm i -g @openai/codex配置文件
macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml
toml
model = "<Model ID>"
model_provider = "volcengine"
[model_providers.volcengine]
name = "volcengine"
base_url = "https://ark.cn-beijing.volces.com/api/v3"
env_key = "ARK_API_KEY"
wire_api = "responses"环境变量
macOS / Linux:
bash
echo 'export ARK_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrcWindows:
cmd
setx ARK_API_KEY "YOUR_API_KEY"使用
bash
codexClaude Code
前置条件
- Node.js 18 及以上
- Windows 需安装 Git for Windows
安装
bash
npm install -g @anthropic-ai/claude-code配置文件
macOS / Linux: ~/.claude/settings.jsonWindows: C:\Users\<用户名>\.claude\settings.json
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "<ARK_API_KEY>",
"ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/compatible",
"ANTHROPIC_MODEL": "doubao-seed-2-1-pro-260628",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "doubao-seed-2-0-lite-260428",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "doubao-seed-2-1-pro-260628",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "doubao-seed-2-1-pro-260628",
"CLAUDE_CODE_SUBAGENT_MODEL": "doubao-seed-2-1-pro-260628"
}
}初始化配置
macOS / Linux: ~/.claude.jsonWindows: C:\Users\<用户名>\.claude.json
json
{
"hasCompletedOnboarding": true
}使用
bash
cd my-project
claudeCC Switch
安装
macOS:
bash
brew tap farion1231/ccswitch
brew install --cask cc-switchClaude Code 供应商配置
| 配置项 | 值 |
|---|---|
| 添加方式 | 自定义配置 |
| API Key | 你的方舟 API Key |
| 请求地址 | https://ark.cn-beijing.volces.com/api/compatible |
高级选项中分别配置 Sonnet、Opus、Fable、Haiku 对应的模型 ID。
OpenCode
安装
bash
npm install -g opencode-ai配置文件
macOS / Linux: ~/.config/opencode/opencode.jsonWindows: C:\Users\用户名\.config\opencode\opencode.json
json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"myprovider": {
"npm": "@ai-sdk/openai-compatible",
"name": "volcengine",
"options": {
"baseURL": "https://ark.cn-beijing.volces.com/api/v3",
"apiKey": "<ARK_API_KEY>"
},
"models": {
"doubao-seed-evolving": {
"name": "doubao-seed-evolving"
}
}
}
}
}使用
bash
opencode输入 /models 选择豆包模型。
OpenClaw
安装
macOS:
bash
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell:
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex配置
配置文件:~/.openclaw/openclaw.json
json
{
"models": {
"providers": {
"volcengine": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
"apiKey": "<ARK_API_KEY>",
"api": "openai-completions",
"models": [
{
"id": "doubao-seed-1-8-251228",
"name": "doubao-seed-1-8-251228"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "volcengine/doubao-seed-1-8-251228"
},
"models": {
"volcengine/doubao-seed-1-8-251228": {}
}
}
},
"gateway": {
"mode": "local"
}
}重启生效:
bash
openclaw gateway restartTRAE
安装
TRAE 官网 下载安装。
配置
| 配置项 | 值 |
|---|---|
| 服务商 | 火山引擎 |
| 模型 | 列表选择或手动输入模型 ID |
| API 密钥 | 你的方舟 API Key |
Cline
安装
VSCode 扩展市场搜索 Cline 安装。
配置
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://ark.cn-beijing.volces.com/api/v3 |
| API Key | 你的方舟 API Key |
| Model ID | 模型 ID |
Cursor
安装
Cursor 官网 下载安装(需 Pro 及以上套餐)。
配置
| 配置项 | 值 |
|---|---|
| OpenAI API Key | 你的方舟 API Key |
| Override OpenAI Base URL | https://ark.cn-beijing.volces.com/api/v3 |
| Add Custom Model | 填写模型 ID |
Roo Code
安装
VSCode 扩展市场搜索 Roo Code 安装。
配置
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://ark.cn-beijing.volces.com/api/v3 |
| API Key | 你的方舟 API Key |
| Model | 模型 ID |
Kilo Code
安装
VSCode 扩展市场搜索 kilo code 安装。
配置
选择 Use your own API key:
| 配置项 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://ark.cn-beijing.volces.com/api/v3 |
| API Key | 你的方舟 API Key |
| Model | 模型 ID |
LangChain
安装
bash
pip install langchain-openai示例代码
python
from langchain_openai import ChatOpenAI
import os
llm = ChatOpenAI(
openai_api_key=os.environ.get("ARK_API_KEY"),
base_url="https://ark.cn-beijing.volces.com/api/v3",
model="doubao-pro-32k"
)
result = llm.invoke("你好")
print(result.content)Dify
配置
| 配置项 | 值 |
|---|---|
| 供应商类型 | OpenAI 兼容 / 火山引擎 |
| API 密钥 | 你的方舟 API Key |
| 基础 URL | https://ark.cn-beijing.volces.com/api/v3 |
| 模型名称 | 模型 ID |
| 最大 token 数 | 根据模型配置 |
统一 Base URL:
- OpenAI 兼容工具:
https://ark.cn-beijing.volces.com/api/v3- Anthropic 兼容工具(Claude Code):
https://ark.cn-beijing.volces.com/api/compatible
文档来源:火山引擎方舟官方文档 - 接入三方工具 更新时间:2026.07.06