WorkBuddy 接入 Claude API：先别急着保存，先把权限和字段锁死

结论先说。WorkBuddy 接入 Claude API，也就是把模型入口指向 Claude 系服务接口，技术上不复杂，按教程大约十来分钟能跑通。容易翻车的是 API Key 怎么管、合同文件谁能读、字段规则有没有先定好。我用了 WorkBuddy 大约一个月，这次换模型入口，主要是手上有批供应商框架协议和邮件附件，想让它先做条款摘要和差异粗筛。

教程说 WorkBuddy 国际版接入 Claude API 大约 5 到 10 分钟能配好。我试下来，界面操作差不多，但合同场景真正花时间的是脱敏和字段。

所里对数据外流敏感，我没直接传原始合同。先建测试工作区，把 PDF、Word、邮件导出件脱敏：客户名换成甲乙丙，金额换成区间，身份证号和银行卡号不保留。AI 工具再顺手，也不能越过保密义务。

配置路径我是从 WorkBuddy 左下角 设置 进，选 模型。也可以点对话框底部当前模型名，比如 Auto，滑到底部选 + 配置自定义模型。提供商选 自定义。接口地址填 Base URL，也就是调用接口的基础地址，通常带 /v1。API Key 是平台生成的密钥，一般以 sk- 开头，粘贴后点旁边眼睛图标核对一次。模型名称填 Model ID，也就是平台给模型起的准确编号，必须完全一致。

高级配置我勾了 工具调用 和 图片输入。工具调用让模型能读文件、执行操作；图片输入适合扫描件。上下文我保守选了 128K，也就是一次能处理的文本长度；输出选 8K。保存后不能只关窗口，要完全退出 WorkBuddy，Windows 上从托盘右键退出，再重新打开。重启后在模型列表里能看到这个自定义入口，对话框底部切过去，再发一句测试问题，能正常返回就通了。

第一次跑，我让它按固定字段抽取：合同主体、服务期限、付款节点、验收标准、违约责任、数据保护、终止条件、争议解决。它把大部分列出来了，漏了“数据保护”，我追问一句才补上。这个结果能接受，但不能直接当交付稿。

权限策略我也单独设了。这个工作区只有我和主办律师可读，助理只能上传脱敏版，不能导出完整汇总。

文件访问范围按最小权限处理：原始附件只留一份，AI 生成的中间摘要另放一个目录，标注“未核验”。协作时不要多人同时改同一份提示词和字段表，否则版本会乱。我习惯在文件名里加日期和版本号，比如 20260903_框架协议字段表_v2.xlsx。

效果上，换模型后长条款摘要更像可用初稿，付款节点、违约责任这类字段不用逐页找。但它不能替代逐句比对。我用 WorkBuddy 的逐句比对功能看了两版合同，它能列差异，可涉及“应当”“可以”“有权”这种措辞轻重，还是要律师判断。之前我说过 WorkBuddy 无法有效识别合同中的 AI 生成内容，这次接入 Claude API 后，这个判断没有变。它更会整理，不代表更会担责。

坑也有。接口地址如果填完整 /v1/chat/completions，有时 WorkBuddy 会自动拼接路径，出现 404。遇到这种情况，可以改回 Base URL，或到高级配置里开 自定义协议。另一个坑是一键汇总。字段没喂准，AI 会把不同合同的付款周期混成一条。我现在的做法是先用语义比对统一表头术语，清洗完字段，再让 WorkBuddy 汇总。这一步看似慢，其实省返工。我的环境是 Windows 和所内测试目录，不一定适用所有人。

核心观点就一句：WorkBuddy 接入 Claude API 可以提效，但律师用它的前提，是先把它当成一个需要权限、脱敏和字段约束的助理，而不是可以随意投喂合同的万能大脑。