前置条件
- 1Windows 10 20H2+ 或 macOS 12+
- 2已注册 Claude（Anthropic）开放平台账号
- 3电脑能联网（国内访问 Claude 需梯子）
常见问题
Q我连配置文件是什么都不懂，能用吗？
能用。选方式 A，全程在 WorkBuddy 桌面端的设置界面里点选、粘贴 API Key，不用手写任何配置代码。
Q方式 A 的设置入口在哪？
打开 WorkBuddy 桌面端，点击右上角的齿轮（设置）图标，进入「模型配置」/「供应商」标签，点击「添加自定义供应商」或「+ 新增」即可开始配置。
QAPI Key 填了但还是报 401 错误？
请检查 Key 是否有多余空格或换行符。建议方式 B 用环境变量 apiKeyEnv 而非直接填写 apiKey。确认 Key 未过期且账户余额充足（Anthropic 需预充值 credits）。
Q调用时出现 404 Not Found？
baseURL 必须正确：原生 Anthropic 协议用 https://api.anthropic.com/v1，OpenAI 兼容协议用 https://api.anthropic.com/v1/openai/（注意末尾斜杠）。漏写 /openai 是最常见错误。
Q响应很慢或者超时怎么办？
国内访问 Anthropic 必须开全局梯子，否则会连接超时；先将 maxTokens 降到 1024 测试连通性；Opus 系列因深度思考机制本身较慢属正常现象。