WorkBuddy 换模型不用重装客户端，有三条路：对话入口的模型选择器直接切内置模型，设置页“模型”里接自定义模型，命令行用 codebuddy --model 指定一次任务的模型。日常办公用前两种就够了，免费版能切的范围先看档位，别一上来就折腾配置。
- 内置模型在对话入口直接选，默认是混元 hy3；只有一个档位的模型没有切换入口，换档位前先确认套餐。
- 自定义模型走设置页的可视化配置，支持腾讯云 Token Plan、Coding Plan、Ollama 与自定义 API，API Key 只保存在本地，不上传云端。
- 命令行用 codebuddy --model 单次指定模型，--fallback-model 给主模型被限流时留一条回退路。
- 自定义模型的费用向第三方付，WorkBuddy 只做转发，不代收。
先分清你要换的是什么
只想换个口味写东西、改代码，在对话入口点模型选择器就行，内置可选模型包括 hy3、hy3-x，以及 GLM、Kimi、DeepSeek 等系列，选完当次对话就生效。想用自己买的套餐或本地模型，才需要进设置页“模型”：选供应商、填 API Key、保存，配置好的模型会出现在选择器的自定义分组里，点一下就能用；Ollama 这类本地服务不用填 Key，启动后直接连默认的本地地址。
配置不完整时先看 4100
自定义模型没填接口地址或 API Key 时，它在选择器里是置灰的，点不上去，悬停会提示去配置页补全；如果已经发出了请求，对话里会给出同样的提示，错误码是 4100。补全保存后就能正常选。免费模型被限流时也别硬切：给它配一个回退模型，主模型过载时自动切过去，限流恢复后再切回来，比手动来回换省事。
三个容易踩的坑
一是档位：只有一个档位的模型本来就没有切换入口，调大档位只在处理超长文档、需要模型记住大量历史内容时才有意义，平时保持默认。二是权限：企业管理员可以关掉自定义接入，公司电脑上找不到入口先问管理员。三是账单：自定义模型产生的 Token 或订阅费用由你向第三方付，WorkBuddy 免费版够不够日常办公与积分不够用时的省法是另一笔账，别把两边的额度混在一起算。
