腾讯 WorkBuddy 接入 BigBong AI

适合使用腾讯 WorkBuddy 桌面端，或希望在 CodeBuddy CLI 中添加 BigBong 自定义模型的用户。本文所指的是腾讯 WorkBuddy，不是其他同名产品。

主路径：WorkBuddy 图形界面进阶：CodeBuddy CLI 核对日期：2026-07-30

先分清两种 URL。

WorkBuddy 普通“自定义”模式填 Base URL：https://api.bigbong.top/v1。只有开启“自定义协议”或编辑 CodeBuddy models.json 时，才填完整的 https://api.bigbong.top/v1/chat/completions。

准备事项

安装并登录腾讯 WorkBuddy。
在 BigBong 我的令牌中创建并复制 API 令牌。
从模型广场复制要使用的模型 ID。

图形界面配置

打开模型设置。在 WorkBuddy 中进入“设置 → 模型”。
添加自定义模型。点击添加或编辑自定义模型，在服务商中选择“Custom / 自定义”。
保持“自定义协议”关闭。普通模式会校验 URL，并自动补全标准 /chat/completions 路径。
填写 URL。输入 https://api.bigbong.top/v1。
填写 API Key。粘贴 BigBong 令牌，示例格式为 YOUR_API_KEY。
填写模型名。从模型广场复制完整 ID，例如 gpt-5.6-sol 或 claude-sonnet-5。
设置能力开关。只开启模型广场明确标注且你已实际验证的工具调用、图像、推理等能力；不确定时先关闭增强能力，用纯文本对话验证。
保存并测试。保存后回到会话，在自定义模型分组中选择该模型，发送“请回复：连接成功”。

BigBong 填写值总表

场景 / 字段	填写值	说明
普通自定义模式 URL	`https://api.bigbong.top/v1`	推荐的 GUI 主路径。
自定义协议 URL	`https://api.bigbong.top/v1/chat/completions`	开启开关后 WorkBuddy 会直接请求此地址。
API Key	`YOUR_API_KEY`	从“我的令牌”复制。
GPT 示例	`gpt-5.6-sol`	以模型广场当前显示为准。
Claude 示例	`claude-sonnet-5`	作为另一条独立模型配置添加。

成功标志

配置完成后应看到：

保存的模型出现在会话的自定义模型分组中。
能够选中该模型并收到纯文本测试回复。
启用某项模型能力后，对应功能实际执行成功。

进阶：CodeBuddy CLI 的 models.json

CLI 用户可使用用户级 ~/.codebuddy/models.json，或项目级 <项目根目录>/.codebuddy/models.json。项目级配置优先级更高。

这里必须写完整接口。

url 使用 https://api.bigbong.top/v1/chat/completions。CodeBuddy 当前只支持 OpenAI 格式的自定义 API。

先设置环境变量，避免把令牌明文写进 JSON：

macOS / Linux：

export BIGBONG_API_KEY="YOUR_API_KEY"

Windows PowerShell：

$env:BIGBONG_API_KEY = "YOUR_API_KEY"

再写入以下配置：

{
  "models": [
    {
      "id": "gpt-5.6-sol",
      "name": "BigBong GPT 5.6 Sol",
      "vendor": "BigBong AI",
      "apiKey": "${BIGBONG_API_KEY}",
      "url": "https://api.bigbong.top/v1/chat/completions"
    },
    {
      "id": "claude-sonnet-5",
      "name": "BigBong Claude Sonnet 5",
      "vendor": "BigBong AI",
      "apiKey": "${BIGBONG_API_KEY}",
      "url": "https://api.bigbong.top/v1/chat/completions"
    }
  ],
  "availableModels": [
    "gpt-5.6-sol",
    "claude-sonnet-5"
  ]
}

保存后配置会自动热加载。若环境变量是在 CodeBuddy 启动后才设置，请重启当前 CLI 进程。

常见错误

现象	原因	处理方法
保存后模型不显示	未保存、模型 ID 不在可用列表，或 `models.json` 路径/JSON 错误	GUI 中重新保存；CLI 检查文件路径、JSON 语法和 `availableModels`。
401 / Unauthorized	令牌无效，或 CLI 环境变量未生效	重新复制令牌；CLI 重开终端并确认启动前已设置环境变量。
404 / Not Found	URL 模式填反	普通 GUI 模式用 Base URL；自定义协议和 `models.json` 用完整接口。
普通对话成功，工具调用失败	模型、接口或客户端版本不支持该能力	关闭工具能力后复测纯文本；只对已验证模型开启工具调用。
图像/推理功能异常	能力开关与模型实际能力不匹配	关闭不确定的能力开关，按模型广场说明逐项验证。

官方资料

页面配置字段最后核对：2026-07-30。客户端升级后如字段名称变化，请以腾讯官方文档为准。