腾讯 WorkBuddy 国际版接入 Claude API 完整教程（2026 最新）

腾讯 WorkBuddy 国际版接入 Claude API 完整教程（2026 最新）

一句话总结：本文手把手教你在腾讯 WorkBuddy 中配置 Claude API，5-10 分钟即可在国内网络环境下使用 Claude Opus / Sonnet / Haiku 全系模型。提供 GUI 界面配置和 models.json 文件配置两种方式，覆盖 Windows、macOS、Linux 全平台。

一、为什么要在 WorkBuddy 中使用 Claude

腾讯 WorkBuddy 是一款功能强大的 AI 办公工作台，内置了混元、DeepSeek、GLM、Kimi、MiniMax 等国产模型。但在以下场景中，Claude 模型（尤其是 Opus）的表现明显优于内置模型：

• 复杂逻辑推理：架构设计、多步推理链、数学证明
• 长上下文理解：200K token 窗口，处理超长文档、大型代码库
• 高质量代码生成：TypeScript 类型推导、复杂重构、跨文件修改
• 英文内容处理：翻译、英文技术文档理解、国际化项目
• 精确指令遵循：严格按 SPEC 生成代码，减少"创造性发挥"

WorkBuddy 支持 OpenAI 兼容协议的自定义模型接入，这意味着只要有一个支持 Claude 的 API 服务，就可以在 WorkBuddy 的丝滑界面中直接使用 Claude 的全部能力。

二、前置准备

2.1 安装 WorkBuddy

如果尚未安装，请前往官网下载：

• 国际版（支持更多模型选择）：https://www.workbuddy.ai/

💡 本教程以 WorkBuddy 国际版为例。国内版操作步骤完全一致。

2.2 获取 Claude API Key

由于 Anthropic 不直接向中国大陆用户提供 API 服务，你需要通过支持 OpenAI 兼容协议的第三方 API 服务获取 Claude 的调用能力。

当前主流的服务平台包括（按字母排序，非推荐排序）：

操作步骤（以通用流程为例）：

1. 注册上述任一平台的账号
2. 进入控制台 → API 密钥/令牌管理
3. 创建新的 API Key（通常以 sk- 开头）
4. 复制并妥善保存密钥

2.3 确认关键信息

配置前，确保你手头有以下三项信息：

三、方式一：GUI 可视化界面配置（推荐新手）

适合：第一次配置、只需添加 1-2 个模型的用户。全程无需写代码。

步骤 1：打开模型设置

1. 启动 WorkBuddy 客户端
2. 点击左下角 ⚙️ 设置（齿轮图标）
3. 在左侧菜单中选择 「模型」

或者更快的方式：

• 点击对话框底部的模型名称（如显示 "Auto" 或当前模型名）
• 在弹出的模型列表中，滚动到底部
• 点击 「+ 配置自定义模型」

步骤 2：填写模型配置

在弹出的「添加模型」对话框中，你会看到顶部提示：「仅支持 OpenAI 兼容协议 API」。

逐项填写：

关于接口地址的注意事项：

• 如果平台文档给的是 Base URL（如 https://gw.claudeapi.com/v1），直接填入
• 如果给的是完整地址（如 https://gw.claudeapi.com/v1/chat/completions），也可以填入
• WorkBuddy 默认会在 Base URL 后自动拼接 /chat/completions
• 如果出现 404 错误，尝试在「高级配置」中开启「自定义协议」开关

步骤 3：配置高级选项（建议）

在对话框底部找到 「高级配置」 区域，按需勾选：

上下文窗口设置（可选）：

• 输入：选择 128K 或 256K（Claude 支持 200K）
• 输出：选择 8K 或 16K

步骤 4：保存并重启

1. 点击 「保存」 按钮
2. 完全退出 WorkBuddy（⚠️ 重要！）
   • Windows：右键系统托盘图标 → 退出（不是只关闭窗口）
   • macOS：菜单栏 → WorkBuddy → 退出 / Cmd+Q
3. 重新启动 WorkBuddy

步骤 5：选择模型开始使用

1. 在对话面板底部，点击模型选择器
2. 在「自定义模型」分组下，找到你刚添加的 Claude 模型
3. 选中即可开始对话

四、方式二：models.json 配置文件（推荐批量管理）

适合：需要同时配置多个模型、多个平台，或喜欢用配置文件管理的用户。

4.1 配置文件路径

如果目录或文件不存在，手动创建即可。

⚠️ Windows 用户注意：文件浏览器默认隐藏以 . 开头的文件夹，需要开启「显示隐藏文件」 文件必须保存为 UTF-8 无 BOM 编码（建议用 VS Code 编辑） 中文逗号, 会导致 JSON 解析失败，请确保全部使用英文标点

4.2 完整配置示例

以下是一个包含 Claude 全系列模型的完整配置：

{
  "models": [
    {
      "id": "claude-opus-4-7",
      "name": "Claude Opus 4.7",
      "vendor": "Custom",
      "url": "https://gw.claudeapi.com/v1/chat/completions",
      "apiKey": "sk-你的API密钥",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "claude-sonnet-4-6",
      "name": "Claude Sonnet 4.6",
      "vendor": "Custom",
      "url": "https://gw.claudeapi.com/v1/chat/completions",
      "apiKey": "sk-你的API密钥",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    },
    {
      "id": "claude-haiku-4-5-20251001",
      "name": "Claude Haiku 4.5",
      "vendor": "Custom",
      "url": "https://gw.claudeapi.com/v1/chat/completions",
      "apiKey": "sk-你的API密钥",
      "maxInputTokens": 200000,
      "maxOutputTokens": 4096,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": [
    "claude-opus-4-7",
    "claude-sonnet-4-6",
    "claude-haiku-4-5-20251001"
  ]
}

4.3 字段说明

4.4 保存并生效

1. 保存 models.json 文件
2. 完全退出 WorkBuddy（参见步骤 4）
3. 重新打开 WorkBuddy
4. 在模型选择器中找到新增的 Claude 模型

五、可用模型一览与选型建议

Claude 模型矩阵

选型建议

六、验证配置是否成功

配置完成后，在 WorkBuddy 中发送一条测试消息：

你好，请告诉我你是什么模型，你的 model ID 是什么？

预期响应：Claude 会自报家门，告诉你它是 Claude Sonnet/Opus/Haiku 及具体版本。

验证 Checklist：

• ✅ 模型在下拉列表中可见
• ✅ 发送消息后有正常回复
• ✅ 回复速度在 2-5 秒内（首次可能稍慢）
• ✅ 回复内容确认是 Claude 风格（详细、结构化）

七、常见报错与排查指南

排查步骤优先级：

1. 先确认 API Key 能单独调通（用 curl 或 Postman 测试）
2. 再确认 URL 格式和 Model ID 是否正确
3. 最后检查 WorkBuddy 是否完全重启

八、进阶：多模型组合策略

WorkBuddy 支持同时配置多个模型。推荐的成本优化策略：

日常编码（70% 时间）→ Claude Sonnet 4.6（中等成本）
快速问答（20% 时间）→ Claude Haiku 4.5（低成本）
深度推理（10% 时间）→ Claude Opus 4.7（高成本）

在 models.json 中同时配置三个模型，对话时根据任务复杂度手动切换。

真实案例：某开发者上月使用此策略，全月 API 费用不到 70 元人民币，完成了一个开源项目的完整重构。

九、费用说明与成本控制

API 费用（由第三方平台收取）

各平台定价不同，以下为典型参考：

💡 实际价格以各平台官网为准，不同平台差异较大。

成本控制技巧

1. 简单任务用 Haiku——补全、格式化、注释这类不需要 Opus
2. 控制上下文长度——不要把整个项目丢给 AI，精选相关文件
3. 利用 WorkBuddy 的积分模型——日常用内置免费模型，只在关键时刻切到 Claude
4. 设置消耗预警——在 API 平台设置月度预算上限

十、常见问题 FAQ

Q1：WorkBuddy 国际版是不是原生内置了 Claude？

WorkBuddy 国际版的 Default 模型经用户实测为 Claude 级别。如果你使用的是国际版且选择 Default 模型，可能已经在使用 Claude 了。可以直接问模型"你是什么模型"来确认。

本教程主要面向需要明确指定 Claude 版本或使用国内版 WorkBuddy的用户。

Q2：接入 Claude 后还会消耗 WorkBuddy 积分吗？

不会。自定义模型走的是你自己的第三方 API，费用由 API 平台收取，不消耗 WorkBuddy 内置积分。

Q3：数据安全怎么保障？

• 你的代码和对话经过第三方 API 平台转发
• 建议选择有明确隐私政策的平台
• 敏感项目建议使用企业版或私有化部署方案
• WorkBuddy 本身不会存储经过自定义 API 的对话数据

Q4：中转 API 和 Anthropic 官方有什么区别？

本质区别是：中转平台以自己的企业身份与 Anthropic 合作（或通过合规渠道获取服务），再向终端用户提供访问。用户不需要自己注册 Anthropic 账号，不受 KYC 验证和地区封锁的影响。

Q5：一个 models.json 可以配多个平台吗？

可以。每个模型条目的 url 和 apiKey 互相独立。你可以在同一个文件中配置来自不同平台的模型。

Q6：配置之后模型更新了怎么办？

当平台支持新模型版本时，只需修改 id 字段为新的 Model ID，保存并重启 WorkBuddy 即可。

免责声明

重要提示，请仔细阅读： 本文仅为技术教程，旨在介绍如何在 WorkBuddy 中配置自定义模型。文中提及的第三方 API 服务平台仅供参考，不构成任何推荐、背书或担保。 第三方服务风险：通过中转 API 使用 Claude 模型，其服务稳定性、数据安全性、合规性均由第三方平台负责。用户应自行评估并承担使用风险，包括但不限于：服务中断、API Key 失效、数据泄露、费用争议等。 合规责任：用户应确保其使用方式符合所在地区的法律法规，以及 Anthropic、腾讯及第三方平台各自的服务条款。本文不鼓励任何违反平台使用规则的行为。 模型使用：Claude 模型的输出不应作为专业建议（法律、医疗、金融等）的唯一依据。AI 生成的代码应经过人工审查后再用于生产环境。 信息时效性：AI 行业变化极快，本文中的平台信息、模型版本、配置方式可能随时间变化而过时。请以各平台官方文档的最新信息为准。 与腾讯官方的关系：本文为独立技术教程，不代表腾讯或 WorkBuddy 官方立场。WorkBuddy 的自定义模型功能是产品本身的开放能力，但其对第三方模型的兼容性不提供官方技术支持。 费用说明：通过第三方 API 使用 Claude 产生的费用由用户与 API 平台之间结算，与腾讯 WorkBuddy 无关。请务必了解清楚平台计费规则后再使用。

总结

通过本教程，你应该已经能在 WorkBuddy 中成功使用 Claude 模型了。核心步骤就三个：

1. 获取 API Key（选一个中转平台注册）
2. 配置模型（GUI 或 models.json）
3. 重启使用（完全退出再打开）

如果你想要更简单的体验——WorkBuddy 国际版（https://www.workbuddy.ai/）的 Default 模型本身已具备 Claude 级别的能力，注册即可直接使用，无需任何额外配置。

👉 WorkBuddy 国际版官网：https://www.workbuddy.ai/

本文最后更新：2026 年 7 月

相关关键词：WorkBuddy Claude API 配置教程、WorkBuddy 接入 Opus、WorkBuddy 自定义模型、腾讯 WorkBuddy Claude、WorkBuddy models.json 配置、国内使用 Claude 方法、WorkBuddy API 中转教程、WorkBuddy 国际版 Claude

相关搜索：workbuddy怎么用claude / workbuddy接入opus教程 / workbuddy自定义模型配置 / 国内用claude的方法 / workbuddy api设置 / 腾讯ai工具用claude