接入 Agent 工具 - VC API 文档

使用 VC 的 API Key、服务地址和可用模型，将模型接入你常用的 Agent。各工具的配置步骤见下表。

选择工具

工具	接入方式	教程
DeepSeek Harness	Custom model API	配置模型与工作区
Claude Code	Anthropic Messages	终端配置
Codex	Responses	配置文件与环境变量
OpenCode	自定义 Provider	配置服务商与模型
OpenClaw	自定义 OpenAI 兼容服务商	个人 Agent 配置
Hermes	Custom endpoint	向导与配置文件
Reasonix	OpenAI 兼容 Provider	项目配置
WorkBuddy / CodeBuddy	自定义模型文件	桌面端配置
Qoder	查看 BYOK 服务商范围	接入条件与替代方式
Gemini CLI	Gemini 原生 API	终端配置

准备 API Key 和模型

在 API 密钥创建密钥，绑定所需的文本模型分组。
打开该密钥的使用说明，查看匹配分组的配置。
从当前密钥的模型目录复制完整模型 ID，填写教程中的 YOUR_MODEL_ID。

YOUR_VC_API_KEY 表示你的 VC 密钥，YOUR_MODEL_ID 表示模型目录里的真实名称。替换这些值后再运行命令。模型显示名称与 API 模型 ID 可能不同，请复制 ID。

export VC_API_KEY="YOUR_VC_API_KEY"
curl https://sub.vcnovb.cn/v1/models \
  -H "Authorization: Bearer $VC_API_KEY"

$env:VC_API_KEY="YOUR_VC_API_KEY"
$models = Invoke-RestMethod -Uri "https://sub.vcnovb.cn/v1/models" -Headers @{Authorization="Bearer $env:VC_API_KEY"}
$models.data | Select-Object id

地址与协议

配置项	地址
OpenAI Chat Completions / Responses 的 Base URL	`https://sub.vcnovb.cn/v1`
Claude Code 的 `ANTHROPIC_BASE_URL`	`https://sub.vcnovb.cn`
Gemini CLI 的 `GOOGLE_GEMINI_BASE_URL`	`https://sub.vcnovb.cn`
要求填写完整 Chat Completions URL 的客户端	`https://sub.vcnovb.cn/v1/chat/completions`

密钥使用说明如果给出了专用路径，请使用该路径。Base URL、完整接口地址和不同协议的地址不能混填。

选择适合 Agent 的模型

选择支持工具调用的文本模型，并确认分组支持客户端使用的协议。模型目录中存在某个模型，并不代表该模型支持所有协议、图片输入或工具调用。 H3、WAN 3.0、Grok 视频和 Image 属于媒体生成模型，请使用媒体接口；它们不作为编程 Agent 的对话模型。

确认接入成功

在客户端选中 VC 模型，发送「请用一句话介绍你能帮助我完成哪些任务」。收到回复后，到用量与任务记录确认这次调用。再尝试「读取当前项目的 README，概括项目用途，不修改文件」，检查工具调用是否正常。模型对话与工具执行过程中的模型请求按所选分组计费，详情见模型与价格。遇到 401、403、404 或限流，先查看故障排查。