---
title: 客户端配置
description: 从密钥页面获取匹配分组的客户端配置，避免地址和协议不一致。
---

## 获取客户端配置

需要安装与完整操作步骤，请查看[接入 Agent 工具](/agents/overview)。其中包含 DeepSeek Harness、Claude Code、Codex、OpenCode、OpenClaw、Hermes、Reasonix、WorkBuddy / CodeBuddy、Qoder 的接入说明，以及 Gemini CLI 配置。

1. 打开 [API 密钥](https://sub.vcnovb.cn/keys)，找到要使用的 Key。
2. 确认绑定的分组和模型。
3. 点击该密钥的使用入口，选择客户端与操作系统。
4. 按弹窗中的文件路径或终端命令配置，再重新打开客户端。

使用说明会给出与所选分组匹配的地址、密钥和模型配置，复制后按提示完成设置。

## 地址速查

| 客户端类型 | 常用基础地址 | 说明 |
| --- | --- | --- |
| OpenAI 兼容聊天客户端 | `https://sub.vcnovb.cn/v1` | 填 VC Key，并选择支持 Chat Completions 的模型 |
| [Codex](/agents/codex) | 使用密钥弹窗生成的配置 | 使用 Responses 协议，确认模型目录和认证方式 |
| [Claude Code](/agents/claude-code) | `https://sub.vcnovb.cn` | 对应 Messages 兼容入口；不要重复加 `/v1/messages` |
| [OpenCode](/agents/opencode) / [Hermes](/agents/hermes) / [Reasonix](/agents/reasonix) | `https://sub.vcnovb.cn/v1` | 自定义 OpenAI 兼容服务商 |
| [Gemini CLI](/agents/gemini-cli) | 使用密钥弹窗生成的 Gemini 配置 | 需要适配 Gemini 原生接口的分组 |

<Warning>有些客户端会自动拼接 `/v1` 或具体接口路径。出现 `/v1/v1`、返回网页 HTML 或 404 时，先核对客户端要求的是基础地址还是完整接口地址。</Warning>

## 常见配置问题

### Key 正确，但客户端没有模型

检查 Key 绑定的分组，并通过[模型列表](/api/models)确认可用模型。修改配置后，刷新客户端的模型列表或重启客户端。

### 能聊天，图片或视频却失败

检查分组是否开通图片或视频权限，并选择对应模型和接口。网页创作可使用[对话广场](/guides/playground)或[绘图工作台](/guides/studio)。

### 同一模型在不同分组费用不同

不同分组有独立定价。客户端显示的费用估算可能不包含 VC 的倍率、赠金和套餐规则，请以控制台实际使用记录为准。