---
title: WorkBuddy / CodeBuddy
description: 通过 models.json 为 WorkBuddy 和 CodeBuddy 添加 VC 自定义模型。
---

本页适用于支持 `.codebuddy/models.json` 自定义模型的 WorkBuddy / CodeBuddy 客户端。选择支持 Chat Completions 和工具调用的文本模型。

## 安装与准备

安装并登录 [CodeBuddy / WorkBuddy](https://www.codebuddy.ai/)，打开一次项目目录。准备 VC API Key 和可用模型 ID。

## 设置密钥

在终端设置密钥，然后从该终端启动客户端。Windows 也可以将变量保存到当前用户环境中，再完全退出并重新打开应用。

<CodeGroup>
```powershell Windows PowerShell
$env:VC_API_KEY="YOUR_VC_API_KEY"
[Environment]::SetEnvironmentVariable("VC_API_KEY", $env:VC_API_KEY, "User")
```
```bash macOS / Linux
export VC_API_KEY="YOUR_VC_API_KEY"
```
</CodeGroup>

## 创建模型文件

在项目目录下创建 `.codebuddy/models.json`；需要全局生效时，放到用户目录下的 `.codebuddy/models.json`。Windows 用户目录通常为 `C:\Users\你的用户名`。

以下配置使用 65,536 的输入上限和 8,192 的输出上限，请选择满足这些容量的模型，或按实际模型限制调整。将两处 `YOUR_MODEL_ID` 替换成相同的模型 ID。

```json
{
  "models": [
    {
      "id": "YOUR_MODEL_ID",
      "name": "VC 编程模型",
      "vendor": "VC",
      "url": "https://sub.vcnovb.cn/v1/chat/completions",
      "apiKey": "${VC_API_KEY}",
      "maxInputTokens": 65536,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["YOUR_MODEL_ID"]
}
```

保存为 **UTF-8 无 BOM**。已有文件时追加模型条目，并把 ID 加入 `availableModels`。只有所选模型支持图片输入时，才把 `supportsImages` 改为 `true`。

<Note>这里的 `url` 必须填写完整的 `/v1/chat/completions` 地址。</Note>

## 选择并使用

完全退出客户端后重新打开，在模型选择器中选择 **VC 编程模型**。先发送普通问题，再让它读取 README，随后到 VC [用量记录](/guides/usage)查看调用。

## 常见问题

- **模型未显示**：检查文件路径、JSON 格式、UTF-8 无 BOM 编码和 `availableModels`。
- **变量未展开**：从已设置 `VC_API_KEY` 的终端启动应用；若该版本仍不支持变量展开，可在本机用户级模型文件的 `apiKey` 中填入真实 Key，并保持文件私有。
- **401**：确认没有把 URL 填进密钥字段，并检查当前进程读取到的环境变量。

客户端的模型文件格式也可参考 [DeepSeek 官方 WorkBuddy / CodeBuddy 接入说明](https://api-docs.deepseek.com/quick_start/agent_integrations/workbuddy)。