WorkBuddy 配置¶

WorkBuddy 是腾讯推出的全场景 AI 智能体桌面工作站（与代码助手 CodeBuddy 同源）。 其自定义模型仅支持 OpenAI 兼容协议，因此接入 Rutaceae API 时，GPT 与 Claude 均通过 OpenAI 兼容端点调用（Rutaceae 也以 OpenAI 格式提供 Claude）。 官方文档：https://www.codebuddy.cn/docs/workbuddy/ ｜ 自定义模型集成参考：https://api-docs.deepseek.com/quick_start/agent_integrations/workbuddy/

第一步：安装 WorkBuddy¶

前往 WorkBuddy 官网 下载并安装（支持 Windows / macOS），启动后登录即可。

第二步：获取 API 令牌¶

1. 访问 https://api.rutaceae.com/keys

2. 点击「添加令牌」

3. 选择包含目标模型的分组（可前往模型广场查看：https://api.rutaceae.com/pricing）

4. 令牌名称：随意填写（如 "WorkBuddy"）

5. 额度建议：设置为无限额度

6. 点击确认，复制生成的令牌

第三步：配置自定义模型¶

WorkBuddy 有两种配置方式，二选一即可。

方法一：编辑 models.json（推荐，稳定）¶

在以下任一位置新建 models.json（就近优先）：

• 用户级：~/.workbuddy/models.json（Windows：C:\Users\<用户名>\.workbuddy\models.json）
• 项目级：项目根目录下的 .workbuddy/models.json

CodeBuddy 用户对应目录为 .codebuddy/，配置结构相同。

粘贴以下内容，将 sk-xxxxxxxxxxxxxxxx 替换为你的令牌：

{
  "models": [
    {
      "id": "gpt-5.5",
      "name": "GPT-5.5 (Rutaceae)",
      "vendor": "Rutaceae",
      "url": "https://api.rutaceae.com/v1/chat/completions",
      "apiKey": "sk-xxxxxxxxxxxxxxxx",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "claude-sonnet-4-5",
      "name": "Claude Sonnet 4.5 (Rutaceae)",
      "vendor": "Rutaceae",
      "url": "https://api.rutaceae.com/v1/chat/completions",
      "apiKey": "sk-xxxxxxxxxxxxxxxx",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    }
  ],
  "availableModels": ["gpt-5.5", "claude-sonnet-4-5"]
}

字段说明：

提示：

• models.json 必须保存为 UTF-8 无 BOM，否则可能解析失败。
• id 与 availableModels 最易出错——请确保数组里包含同一个 id，否则模型可能不显示。

方法二：可视化设置界面（新版本）¶

较新版本的 WorkBuddy 支持在设置页直接添加自定义模型（填写名称、端点、API Key、参数等），无需手动编辑 JSON。端点填 https://api.rutaceae.com/v1/chat/completions，密钥填令牌即可。

第四步：生效与使用¶

1. 完全退出 WorkBuddy——从系统托盘 / 屏幕右下角选择「退出」，而不是仅关闭窗口——然后重新打开。

2. 在模型选择器中选择刚配置的模型（如 GPT-5.5 (Rutaceae)），即可开始使用。🚀

常见问题¶