Tencent WorkBuddy

1下载安装包

1. 打开 WorkBuddy 官网，下载对应系统的安装包；
2. 运行安装包并按提示完成安装（官方文档提供 Windows 与 Mac 的安装指南）；
3. 启动 WorkBuddy 并登录账号。

2注册 Codelux 并创建 API 密钥

1. 打开 Codelux Portal 注册账号（已有账号直接登录）。
2. 在「财务中心」选择订阅套餐或按需充值——余额对所有 Agent 通用。
3. 在左侧菜单进入「API 密钥」，点击「新建密钥」，名称建议写成对应 Agent 的名字，方便以后区分用量。
4. 创建成功后，复制「API 密钥」（以 sk- 开头）和「API 地址」。密钥只完整显示一次，请妥善保存。

3在设置中添加自定义模型

1. 点击账户菜单进入「设置」，选择「模型」；
2. 在「自定义模型」中点击「添加模型」；
3. 展开「提供商」下拉框，滚动到最底部，选择「其他 → 自定义 / Custom」；
4. URL 填 https://codelux.io/v1。默认协议下 WorkBuddy 会自动校验并补全 /chat/completions 路径；
5. API Key 粘贴 Codelux 密钥；
6. 模型名称填 Portal「AI 中心」中的模型 ID，例如 glm-5.2、claude-sonnet-5；
7. 点击「保存」。需要多个模型时，重复添加即可。

4（可选）编辑 models.json

界面中的配置保存在本地（含 API Key，不上传云端）。批量添加时也可以直接编辑配置文件 ~/.workbuddy/models.json；apiKey 和 url 支持 ${VAR_NAME} 引用环境变量：

{
  "models": [
    {
      "id": "glm-5.2",
      "name": "GLM-5.2 (Codelux)",
      "vendor": "Codelux",
      "apiKey": "${CODELUX_API_KEY}",
      "url": "https://codelux.io/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true
    }
  ]
}

5选择模型并下达任务

新建对话，打开模型选择器，在「自定义模型」分组中选择刚添加的模型，然后用一句话描述任务，例如“整理本周会议纪要并生成周报”。

模型选择器支持快捷跳转到配置页面编辑自定义模型。每次请求的用量与扣费可在 Portal「使用日志」查看。