workbuddy 支持直接填写 api key 接入 gemini、gpt-4、claude 等主流模型，无需改代码或重装；需确保版本 ≥ v1.8.0、正确填写 base url、api key、model name 和 timeout 四项参数，并手动启用流式响应与调整 token 限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
直接填 API Key 就能用，不需要改代码或重装软件。WorkBuddy 对 Gemini、GPT-4、Claude 等主流模型的 API 支持已内建在「自定义模型」流程里，关键在于参数填对、权限开全、网络通得过。
确认 WorkBuddy 版本支持自定义 API
低于 v1.8.0 的旧版本不显示「自定义模型」入口，会直接灰显配置项。检查方式：打开 设置 → 模型管理，若只有「智谱」「Kimi」等内置选项，没有「添加自定义模型」按钮，就得先升级。官网下载页（https://www.codebuddy.cn/work/）提供最新安装包，Windows 用户注意别用微软商店旧版。
填写 API 配置时必须核对的 4 个字段
以 GPT-4 为例，常见填错导致 401 Unauthorized 或 model not found 错误：
-
API Base URL：OpenAI 官方是https://api.openai.com/v1；如用代理或中转服务（如 FastGPT），必须带/v1后缀，少写会报404 -
API Key：从 OpenAI Platform →API Keys页面复制，不是 Dashboard 的个人 token；开头是sk-，长度约 51 位，中间不能有空格或换行 -
Model Name：填gpt-4o或gpt-4-turbo，不是gpt4或GPT-4（大小写敏感，且不接受别名） -
Timeout (s)：国内直连 OpenAI 容易超时，建议调高到60，否则任务中途卡死无报错
企业环境常见拦截点
公司内网或安全软件可能阻断 outbound HTTPS 请求，尤其针对非标准端口或境外域名：
- 检查系统代理设置：WorkBuddy 默认走系统代理，若公司用 PAC 脚本，需确保
api.openai.com不在 bypass 列表里 - 杀毒软件日志里搜
WorkBuddy.exe blocked，部分国产安全软件会默认拦截 AI 工具外联 - 尝试在 PowerShell 手动测试连通性：
curl -X POST https://api.openai.com/v1/chat/completions -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}'—— 若命令行能通但 WorkBuddy 不行，基本是软件沙箱策略问题
最易被忽略的是：WorkBuddy 的自定义模型配置**不会自动继承内置模型的上下文长度或流式响应开关**。比如你填了 gpt-4o，但没手动打开 Enable streaming，长回复就会卡住不动；又或者没调高 Max tokens，遇到复杂任务直接截断。这些都得进单个模型的编辑页里逐项确认。
