AI API 统一网关

WorkBuddy 如何接入 Claude 5？2026 最新配置教程 ​

在 WorkBuddy 中接入 Claude 5，最稳的方式是通过本地 models.json 配置 OpenAI-compatible 模型入口。当前“Claude 5”并不是一个应直接写进代码的泛称；Anthropic 在 2026 年 7 月 24 日 发布的当前主力 API 模型是 claude-opus-5[^1]。通过 ClawSocket 使用时，先以控制台显示的实际模型 ID 为准，再将该 ID、完整聊天补全地址和 API Key 写入 WorkBuddy 配置文件，最后把相同 ID 添加到 availableModels 并重启应用。

本文面向需要在腾讯 WorkBuddy 中使用 Claude 5 的个人用户和团队管理员。它会说明模型名为什么不能猜、Windows/macOS 文件路径怎么找，以及配置成功后如何先用小请求验证，再上长文档或复杂任务。

WorkBuddy 通过 ClawSocket 接入 Claude 5 的 models.json 配置流程图
先确认 ClawSocket 的实际 Claude 5 模型 ID，再写入 WorkBuddy 的 models.json；模型对象和 availableModels 必须保持一致。

快速结论 ​

  • WorkBuddy 使用本地 models.json 注册自定义模型；macOS 常用路径是 ~/.workbuddy/models.json，Windows 常用路径是 %USERPROFILE%\.workbuddy\models.json[^2]
  • 当前 Claude 5 的官方主力 API 模型名是 claude-opus-5，但第三方入口可能使用不同别名，不能盲目写死[^1]
  • 通过 ClawSocket 接入 WorkBuddy 时，常用请求地址为 https://api.clawsocket.com/v1/chat/completions；模型 ID、价格和可用性以 ClawSocket 控制台 为准
  • models.id 和 availableModels 必须填入完全相同的模型 ID，修改后要完全退出再重启 WorkBuddy
  • 先发一条短消息验证，再处理企业文档、代码或长上下文任务；不要把 API Key 提交到 Git 或共享配置仓库

Claude 5 在 WorkBuddy 中应该怎么选 ​

目前文章所说的 Claude 5，具体指 Anthropic 发布的 Claude Opus 5。Anthropic 将其定位为处理复杂编码、知识工作和长任务 agent 的旗舰模型，官方标价为每 100 万 输入 token $5、每 100 万 输出 token $25[^1]。这适合 WorkBuddy 中要求质量优先的方案撰写、复杂资料归纳、代码审阅和多步骤分析。

WorkBuddy 场景Claude 5 是否适合使用建议
关键方案、复杂分析、跨文档归纳很适合先给清楚的目标、范围和输出格式，再让模型分步骤完成
代码审阅、技术方案比较很适合将相关代码和报错上下文一并提供，要求输出风险与最小修复建议
日常短问答、简单摘要可用但可能过重优先确认控制台是否有更经济的 Claude 路由或模型可选
高敏感企业材料需谨慎先确认组织的数据处理规则，并清理不必要的个人信息和密钥

表中的价格来自 Anthropic 官方 API，不代表 ClawSocket 的最终账单。统一入口的价格、模型别名、并发和可用范围都可能不同，因此实际部署必须以控制台显示为准。对团队而言，这样做的好处是能在不改 WorkBuddy 配置结构的情况下，按任务选择合适的模型路由。

第一步：在 ClawSocket 确认 Claude 5 的实际模型 ID ​

进入 ClawSocket 控制台 后，先创建 API Key，再检查当前的模型列表和接口说明。记录 4 项信息：实际模型 ID、完整 Chat Completions 地址、当前价格或额度规则、以及模型是否允许你的账号调用。

不要仅凭文章里的 claude-opus-5 直接上线。这个名称是 Anthropic 官方 API 的模型名，统一网关可能沿用它、提供兼容别名，或按路由策略展示不同名称。WorkBuddy 发送请求时用的是 id 字段，因此需要把控制台实际展示的值同时写入 models.id 与 availableModels。

ClawSocket 接入提示：通过同一套 API Key 与兼容地址管理 Claude、GPT、Gemini 等模型，可以减少 WorkBuddy、Cursor、Cline 和自建服务分别维护供应商配置的工作量。建议专门给 WorkBuddy 创建一把有独立额度的 Key，便于撤销、审计和成本统计。

第二步：创建或打开 WorkBuddy 的 models.json ​

腾讯云 WorkBuddy 的公开文档支持通过本地 models.json 接入自定义模型[^2]。路径因系统而异：

系统配置文件创建目录命令
macOS~/.workbuddy/models.jsonmkdir -p ~/.workbuddy
Windows PowerShell$env:USERPROFILE\.workbuddy\models.jsonNew-Item -ItemType Directory -Force "$env:USERPROFILE\.workbuddy"

macOS 在终端运行：

bash
mkdir -p ~/.workbuddy
nano ~/.workbuddy/models.json

Windows PowerShell 则可运行：

powershell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.workbuddy"
notepad "$env:USERPROFILE\.workbuddy\models.json"

若这个文件已经配置了其他模型，请在原有 models 和 availableModels 数组中增加 Claude 5，不要用新文件覆盖原配置。Windows 用户保存时还要确认扩展名没有被记事本自动改成 models.json.txt。

第三步：填写 Claude 5 的 ClawSocket 配置 ​

以下是最小配置示例。示例使用 Anthropic 的官方模型名 claude-opus-5，但你应当先把它替换成 ClawSocket 控制台中的实际 ID；name 只是 WorkBuddy 的显示名称，可按团队的命名规范调整。

json
{
  "models": [
    {
      "id": "claude-opus-5",
      "name": "Claude Opus 5 - ClawSocket",
      "vendor": "OpenAI",
      "url": "https://api.clawsocket.com/v1/chat/completions",
      "apiKey": "你的-ClawSocket-API-Key",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192
    }
  ],
  "availableModels": [
    "claude-opus-5"
  ]
}
字段作用Claude 5 配置原则
idWorkBuddy 实际请求的模型名以 ClawSocket 控制台返回的 ID 为准
name模型选择器中的显示名称建议包含 Claude 5 和入口名，方便区分
vendor请求协议类型走 OpenAI-compatible 路线时写 OpenAI
url完整接口地址写完整的 https://api.clawsocket.com/v1/chat/completions
apiKey认证凭据使用专门给 WorkBuddy 创建的 Key
maxInputTokens / maxOutputTokens客户端限制声明以控制台限制为准，不确定时先使用保守值

不要将 url 只写成 https://api.clawsocket.com 或 https://api.clawsocket.com/v1。WorkBuddy 的这类配置需要完整的聊天补全路径；而且两个数组里的模型 ID 只要少一个字符，应用就可能不显示模型或报“模型不存在”。

第四步：重启 WorkBuddy 并验证 Claude 5 ​

保存文件后，请完全退出 WorkBuddy，再重新启动。新模型出现在选择器后，先发一条可快速验证的请求，例如“把下面三条会议结论整理为行动项，并给出负责人和截止时间的表格”。成功返回后，再逐步增加资料长度和任务复杂度。

若 WorkBuddy 中看不到 Claude 5 或请求失败，按下面顺序检查：

  1. 使用编辑器格式化 JSON，确认没有遗漏逗号、引号或括号。
  2. 检查 availableModels 是否包含与 models.id 完全一致的值。
  3. 确认文件位于当前用户目录下的 .workbuddy/models.json，不是另一个账户目录。
  4. 确认 url 是完整的 /v1/chat/completions，并在 ClawSocket 控制台检查 Key 与模型状态。
  5. 先改用一条简短文本测试；持续失败时保留 HTTP 状态码和 request ID，以便定位问题。

WorkBuddy 接 Claude 5 的安全和成本建议 ​

models.json 中的 apiKey 是明文密钥。不要上传 Git、不要粘贴到工单或群聊，也不要将它写进可公开分发的镜像文件；团队场景下应按人员或环境分开创建 Key，并设置额度和轮换机制。使用任何第三方统一入口前，也应阅读其数据处理与隐私说明，再决定能否发送企业材料。

Claude Opus 5 更适合复杂任务，不代表所有聊天都需要用它。先把高价值、需要较强推理或长文本处理的任务分配给 Claude 5；短摘要、分类和格式转换可选择控制台中成本更合适的模型。记录模型、token、失败率和人工返工时间，才能判断它在 WorkBuddy 工作流里的真实收益。

FAQ ​

WorkBuddy 可以直接接入 Claude 5 吗？ ​

可以，前提是 WorkBuddy 支持读取本地 models.json，且你的 API 平台提供 Claude 5 的兼容聊天接口。腾讯云公开文档给出了本地自定义模型配置方式；调用前仍应在 ClawSocket 控制台确认模型状态和实际 ID。

WorkBuddy 配 Claude 5 时应该填 claude-opus-5 吗？ ​

只有当 ClawSocket 控制台显示该 ID 时才应填写 claude-opus-5。它是 Anthropic 官方 Claude Opus 5 的模型名，但第三方入口可能使用不同别名；最稳的做法是把控制台中的 ID 原样填入 id 和 availableModels。

WorkBuddy 的 Claude 5 URL 应该怎么填？ ​

通过 ClawSocket 使用 OpenAI-compatible 接口时，填写完整地址 https://api.clawsocket.com/v1/chat/completions。不要只写域名或 /v1，否则 WorkBuddy 无法把请求发到聊天补全端点。

WorkBuddy 中 Claude 5 配好后为什么不显示？ ​

优先检查配置文件路径、JSON 语法和 availableModels。macOS 应放在 ~/.workbuddy/models.json，Windows 应放在当前用户目录的 .workbuddy 文件夹；保存后还必须完全重启 WorkBuddy。

Claude 5 在 WorkBuddy 中适合处理企业文档吗？ ​

适合长文档归纳、方案和代码审阅等复杂任务，但是否能处理企业材料取决于你的组织安全要求和上游服务的数据规则。上传前应删除密码、密钥和不必要的个人信息，并使用有明确额度和权限边界的独立 API Key。

总结 ​

WorkBuddy 接入 Claude 5 的重点不在于复制一段固定 JSON，而是确认真实模型 ID、使用完整的 OpenAI-compatible 地址，并让 models.id 与 availableModels 一致。当前 Claude Opus 5 适合复杂知识工作、代码与长任务；通过 ClawSocket 控制台 统一管理 Key、模型和额度，可以让 WorkBuddy 的多模型配置更容易维护。

完成最小测试后，再按工作负载逐步增加上下文长度和任务复杂度。想继续扩展客户端接入，可阅读 WorkBuddy 第三方大模型 API 教程、WorkBuddy 接入 GPT-5.6 教程、Claude API Proxy 接入说明 和 OpenAI-compatible API 说明。

参考资料 ​

[^1]: Anthropic《Introducing Claude Opus 5》，2026 年 7 月 24 日：Claude Opus 5 发布、官方模型名和每百万 token 输入/输出价格。 [^2]: 腾讯云《WorkBuddy 知识引擎原子能力》：WorkBuddy 通过本地 models.json 配置文件接入自定义模型的公开说明。

Last updated:

本站为独立第三方信息与服务站点，非 OpenAI、Google、Anthropic 官方网站，与上述品牌无官方隶属关系 · 免责声明

Copyright © 2026 AI API 统一网关