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

安装与准备

安装并登录 CodeBuddy / WorkBuddy，打开一次项目目录。准备 VC API Key 和可用模型 ID。

设置密钥

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

创建模型文件

在项目目录下创建 .codebuddy/models.json；需要全局生效时，放到用户目录下的 .codebuddy/models.json。Windows 用户目录通常为 C:\Users\你的用户名。 以下配置使用 65,536 的输入上限和 8,192 的输出上限，请选择满足这些容量的模型，或按实际模型限制调整。将两处 YOUR_MODEL_ID 替换成相同的模型 ID。
保存为 UTF-8 无 BOM。已有文件时追加模型条目，并把 ID 加入 availableModels。只有所选模型支持图片输入时，才把 supportsImages 改为 true。
这里的 url 必须填写完整的 /v1/chat/completions 地址。

选择并使用

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

常见问题

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