WorkBuddy
自定义 API · Chat Completions
添加自定义模型
- 打开 WorkBuddy「设置 → 模型」，添加模型。
- 选择 Custom，填写下面的值。将
<YOUR_FOXMU_API_KEY>替换为完整密钥，<MODEL_ID>替换为准确的模型 ID。 - 按模型实际能力设置工具调用、图片和推理等选项。厂商预设可能自动填写这些标记，自定义模型仍需正确配置。
Provider: Custom
URL: https://foxmu.ai/v1
API Key: <YOUR_FOXMU_API_KEY>
Model: <MODEL_ID>
Custom Protocol: Off
保存并选择模型
点击 Save，在聊天模型选择器的自定义模型分组中选择新模型，发送简短消息，并在使用记录中查看结果。
| Custom Protocol | URL 行为 |
|---|---|
| 关闭 | 校验 URL 并补全标准 /chat/completions 路径 |
| 开启 | 直接使用完整 URL，不自动补全路径 |
上面的根地址加版本号写法保持关闭。若填写完整地址 https://foxmu.ai/v1/chat/completions，则开启该选项。
检查 WorkBuddy 接入设置
| 现象 | 检查项 |
|---|---|
| 401 | 完整应用密钥、环境与密钥状态 |
| 404 | URL 与 Custom Protocol 开关，避免重复路径 |
| 文本正常但工具失败 | 工具能力标记与模型实际支持 |
| 模型不符合预期 | 聊天中实际选择的模型，而不仅是已保存的配置 |
旧的 ~/.codebuddy/models.json 配置仍可在模型设置中查看和编辑。混用文件和 UI 配置前，先核对已安装的 WorkBuddy 版本。