前置条件
- 1Windows 10 20H2+ 或 macOS 12+
- 2已注册智谱开放平台账号
- 3电脑能联网（国内访问 GLM 可直连，不用梯子）
常见问题
Q我用不惯命令行，能用 WorkBuddy 吗？
能用。选方式 A，全程在 WorkBuddy 桌面端 GUI 里点选，不用打开终端、不用写任何配置代码。
Q方式 A 的「模型配置」入口在哪？
打开 WorkBuddy 桌面端，点击右上角设置（齿轮）图标，进入「模型配置」/「供应商」标签即可看到「添加自定义供应商」按钮。如看不到该入口，请到 workbuddy.qq.com 下载最新版客户端。
QAPI Key 填了但还是报 401 错误？
请检查 Key 是否有多余空格或换行符。建议方式 B 用环境变量 apiKeyEnv 而非直接填写 apiKey。智谱 Key 格式为 xxxxxxxx.yyyyyyyy（含点号），请整体复制，确认未过期。
Q调用时出现 404 Not Found？
baseURL 必须包含 /api/paas/v4 后缀，正确格式为 https://open.bigmodel.cn/api/paas/v4，遗漏版本号是最常见的新手错误。
Q响应很慢或者超时怎么办？
先将 maxTokens 降低到 2048 测试网络连通性；GLM-4.5 推理较慢属正常现象；高峰期可考虑错峰使用；GLM-4-Flash 永久免费且响应更快，可优先用于轻量任务。