---
title: 接入 Agent 工具
description: 使用 VC API Key 配置编程助手和个人 Agent，按客户端选择接入方式。
---

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

## 选择工具

| 工具 | 接入方式 | 教程 |
| --- | --- | --- |
| DeepSeek Harness | Custom model API | [配置模型与工作区](/agents/deepseek-harness) |
| Claude Code | Anthropic Messages | [终端配置](/agents/claude-code) |
| Codex | Responses | [配置文件与环境变量](/agents/codex) |
| OpenCode | 自定义 Provider | [配置服务商与模型](/agents/opencode) |
| OpenClaw | 自定义 OpenAI 兼容服务商 | [个人 Agent 配置](/agents/openclaw) |
| Hermes | Custom endpoint | [向导与配置文件](/agents/hermes) |
| Reasonix | OpenAI 兼容 Provider | [项目配置](/agents/reasonix) |
| WorkBuddy / CodeBuddy | 自定义模型文件 | [桌面端配置](/agents/codebuddy) |
| Qoder | 查看 BYOK 服务商范围 | [接入条件与替代方式](/agents/qoder) |
| Gemini CLI | Gemini 原生 API | [终端配置](/agents/gemini-cli) |

## 准备 API Key 和模型

1. 在 [API 密钥](https://sub.vcnovb.cn/keys) 创建密钥，绑定所需的文本模型分组。
2. 打开该密钥的使用说明，查看匹配分组的配置。
3. 从当前密钥的模型目录复制完整模型 ID，填写教程中的 `YOUR_MODEL_ID`。

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

<CodeGroup>
```bash macOS / Linux
export VC_API_KEY="YOUR_VC_API_KEY"
curl https://sub.vcnovb.cn/v1/models \
  -H "Authorization: Bearer $VC_API_KEY"
```
```powershell Windows PowerShell
$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
```
</CodeGroup>

## 地址与协议

| 配置项 | 地址 |
| --- | --- |
| 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 属于媒体生成模型，请使用[媒体接口](/models/overview)；它们不作为编程 Agent 的对话模型。

## 确认接入成功

在客户端选中 VC 模型，发送「请用一句话介绍你能帮助我完成哪些任务」。收到回复后，到[用量与任务记录](/guides/usage)确认这次调用。再尝试「读取当前项目的 README，概括项目用途，不修改文件」，检查工具调用是否正常。

模型对话与工具执行过程中的模型请求按所选分组计费，详情见[模型与价格](/guides/models)。遇到 401、403、404 或限流，先查看[故障排查](/help/troubleshooting)。