在 WorkBuddy 桌面版里使用珂艾网关

能用。 在设置里加一个「自定义模型」，填三项，重启后切换即可。
整理日期：2026-10-18 ｜相关：按任务选模型 · 桌面 AI 工作台

一、配置三要素

要素	填什么
接口地址（Base URL）	`https://turbo.apimax.host/v1`
API Key	珂艾控制台「令牌管理」生成的 `sk-` 开头密钥
模型名称	网关模型 ID，如 `claude-sonnet-5-5`

⚠️ 接口地址必须包含末尾的 /v1，这是最常见的失败原因。

二、配置步骤

点左下角头像 → 设置 → 模型。

点 + 配置自定义模型。

在「提供商」列表里滑到最底部，选 「自定义 / Custom」。

🔴 这一步最容易错：列表顶部的 DeepSeek、GLM、Kimi 是预置入口，点它们会跳到厂商授权页，填不了自己的地址。只有最底部的「自定义」才能填 Base URL 和密钥。

填三项：

字段	填什么
接口地址	`https://turbo.apimax.host/v1`
API Key	你的 `sk-` 密钥（注意首尾不要多空格）
模型名称	完整的网关模型 ID，如 `claude-sonnet-5-5`

点保存。

完全退出 WorkBuddy，再重新打开。

🔴 第二个高频坑：只保存不重启，配置不生效。

回到聊天页，在顶部模型下拉菜单里选中刚配置的模型。

🔴 第三个坑：保存并重启后仍需手动切换一次模型，不会自动套用。

三、验证是否真的通了

发送：

用一句话说明你现在用的是哪个模型

判定标准：

✅ 正常回复，且顶部下拉显示的是你配的模型名 → 通了

❌ 回复正常但模型名不对 → 第 7 步没切

❌ 提示无可用模型 / 配置不生效 → 第 6 步没重启

❌ 401 → 密钥错或带空格

❌ 404 → 接口地址漏 /v1

四、推荐模型搭配

使用场景	模型 ID	为什么
主力对话、写作、分析	`claude-sonnet-5-5`	综合最稳，长文不易散
多语言、通用问答	`gpt-6-astra`	覆盖面广
省钱大批量	`deepseek-v4-flash`	单价低，日常够用
复杂推理、代码	`claude-opus-5-5`	难任务才开，单价最高
看图片	`gemini-3.8-flash`	截图识别准

五、常见报错

现象	原因	解决
找不到「自定义」选项	列表没滑到底	提供商列表继续往下滚
点了 DeepSeek 跳到授权页	选错了预置入口	返回，选最底部的「自定义 / Custom」
保存后没生效	没重启客户端	完全退出后重新打开
重启后模型仍不对	没在模型下拉里切换	聊天页顶部手动切一次
`401`	密钥错误 / 带空格	粘到记事本核对首尾再贴
`404`	接口地址漏 `/v1`	改成 `https://turbo.apimax.host/v1`
图片 / 文件用不了	选了纯文本模型	换支持多模态的模型

六、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
可用分组	取决于令牌所属分组
建议	配一个专用令牌，便于和手动聊天分开对账

实际单价以价格页为准。

七、进阶：为什么不直接用内置模型

WorkBuddy 内置模型走官方积分体系，不同模型消耗倍率差很多。自己接第三方（比如珂艾）的三个实际好处：

好处	说明
成本可控	按 token 实付，可给令牌设额度上限
选择更多	一个网关里能切 GPT / Claude / Gemini / DeepSeek / GLM / MiMo
Key 只在本地	配置存在你电脑上

注意：自定义模型模式下，部分依赖官方模型的专属功能可能不可用。日常对话、写作、分析、代码类任务不受影响。

八、相关阅读

不确定选哪个模型：按任务选模型

其它桌面端：DeepSeek Harness · ZCode · MiMo Desktop

聊天客户端：Cherry Studio

第一次接入：5 分钟接入

九、更新记录

日期	改了什么
2026-10-18	首次发布。重点记录三个生效条件：选「自定义」而非预置入口、保存后必须重启、重启后必须手动切模型

在 WorkBuddy 桌面版里使用珂艾网关

一、配置三要素#

二、配置步骤#

三、验证是否真的通了#

四、推荐模型搭配#

五、常见报错#

六、计费与分组#

七、进阶：为什么不直接用内置模型#

八、相关阅读#

九、更新记录#