如何接入 Claude 到 WorkBuddy

如何接入 Claude 到 WorkBuddy

Claude 是 Anthropic 推出的旗舰大模型系列，Claude Sonnet 5 在代码与智能体场景表现卓越，Claude Opus 5 专注复杂推理，Claude Haiku 4.5 则以低成本覆盖高频任务。本教程教你把 Claude 接入腾讯推出的桌面端 AI 助手 WorkBuddy（域名 workbuddy.qq.com），在桌面 GUI 中直接使用 Claude 帮你写代码、做推理。

Claude 接入 WorkBuddy 有两种方式，选一种就行：

前置准备

不管选哪种方式，都需要这几样东西：

• 操作系统为 Windows 10 20H2+ 或 macOS 12+
• 已注册 Anthropic Claude 开放平台 账号
• 电脑能上网（国内访问 Claude 需梯子，建议全局模式）
• 已从 workbuddy.qq.com 下载安装 WorkBuddy 桌面端

步骤一：获取 Claude API Key

两种方式都要先领一张 Claude 的「通行证」（API Key）。

1.1 注册并登录

1. 访问 Anthropic Console，点击「Sign up」注册账号
2. 支持邮箱、Google 账号注册，需绑定信用卡预充值 credits 才能调用 API

1.2 创建 API Key

1. 登录后进入控制台，点击左侧菜单 「API Keys」
2. 点击 「Create Key」 按钮
3. 输入名称（如 workbuddy-dev），点击确认
4. 页面会显示一串以 sk-ant- 开头的长字符串，这就是你的通行证

1.3 了解可用模型

注：开启 Prompt 缓存后，缓存命中输入价格低至 $0.20-$0.50/M tokens，适合重复 system prompt 的生产环境。

步骤二：安装 WorkBuddy

如果你还没装 WorkBuddy 桌面端，先装上。

1. 下载客户端

1. 访问 workbuddy.qq.com，点击首页「下载客户端」
2. 根据系统选择 Windows 版 或 macOS 版安装包

2. 安装并登录

1. 双击安装包按提示完成安装
2. 启动 WorkBuddy，使用微信或 QQ 账号登录

步骤三：接入 Claude

从这里开始，方式 A 和方式 B 分开走，选一种跟着做即可。

方式 A：应用端交互接入（推荐新手）

在 WorkBuddy 桌面端的设置界面里点选 + 填写，全程不用手写配置。

A1. 打开设置

启动 WorkBuddy，点击主界面右上角的齿轮（设置）图标。

A2. 进入模型配置

在设置窗口左侧选择 「模型配置」（或「供应商」）标签。

A3. 添加自定义供应商

点击 「添加自定义供应商」 或 「+ 新增」 按钮。

A4. 填写供应商信息

按提示依次填入：

1. 供应商名称：填 Claude（仅作显示用，可自定义）
2. 协议类型：选 OpenAI-compatible（Claude 提供 OpenAI 兼容端点）
3. API Base URL：填

A5. 粘贴 Claude API Key

在 「API Key」 输入框里，把步骤一领到的 sk-ant- 开头的通行证粘进去。

A6. 选择模型

在模型列表中添加你想用的模型 ID，例如：

可继续添加 claude-opus-5、claude-haiku-4-5 备用。

A7. 测试连接并保存

1. 点击 「测试连接」 按钮，出现「连接成功」字样即说明接通了
2. 点击 「保存」 完成配置

方式 B：配置文件手动接入（进阶）

如果你更喜欢直接改配置文件，可以跳过界面，手动编辑。

B1. 找到配置文件路径

WorkBuddy 的配置文件位置因系统而异：

• macOS：~/.workbuddy/config.json
• Windows：%APPDATA%\WorkBuddy\config.json

B2. 备份配置文件

修改前先复制一份 config.json 作为备份，避免改错导致 WorkBuddy 启动异常。

B3. 编写 Claude 模型配置

打开 config.json，推荐用环境变量方式（最安全，避免 Key 明文写入）：

1{
2  "models": [
3    {
4      "name": "claude-sonnet-5",
5      "provider": "openai-compatible",
6      "baseURL": "https://api.anthropic.com/v1/openai/",
7      "apiKeyEnv": "ANTHROPIC_API_KEY",
8      "maxTokens": 4096,
9      "temperature": 0.7
10    },
11    {
12      "name": "claude-opus-5",
13      "provider": "openai-compatible",
14      "baseURL": "https://api.anthropic.com/v1/openai/",
15      "apiKeyEnv": "ANTHROPIC_API_KEY",
16      "maxTokens": 8192,
17      "temperature": 0.7
18    }
19  ],
20  "defaultModel": "claude-sonnet-5"
21}

然后设置环境变量：

1# PowerShell（临时，当前会话有效）
2$env:ANTHROPIC_API_KEY = "sk-ant-你的实际Key"
3
4# 或设为系统永久环境变量（重启终端仍有效）
5[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-你的实际Key", "User")

1# macOS / Linux（临时）
2export ANTHROPIC_API_KEY="sk-ant-你的实际Key"
3
4# 写入 ~/.zshrc 永久生效
5echo 'export ANTHROPIC_API_KEY="sk-ant-你的实际Key"' >> ~/.zshrc
6source ~/.zshrc

B4. 关键参数说明

B5. 重启 WorkBuddy

完全退出 WorkBuddy（不是最小化）后重新启动，让它加载新的配置文件。

步骤四：测试验证

4.1 选择 Claude 模型

在 WorkBuddy 主聊天界面顶部的模型下拉框中，选择刚配置的 claude-sonnet-5（方式 A 已自动列出，方式 B 需确认重启后已加载）。

4.2 发送测试消息

在聊天输入框发送一条测试消息：

如果收到来自 Claude 的回复（通常会自报为 Claude，由 Anthropic 创建），恭喜你——接入成功！🎉

4.3 Python 快速验证（可选）

绕过 WorkBuddy 直接验证 API Key 是否有效：

1from openai import OpenAI
2
3client = OpenAI(
4    api_key="你的Claude API Key",   # 替换为实际 Key（sk-ant- 开头）
5    base_url="https://api.anthropic.com/v1/openai/"
6)
7
8response = client.chat.completions.create(
9    model="claude-sonnet-5",
10    messages=[
11        {"role": "system", "content": "你是一个有用的 AI 助手。"},
12        {"role": "user", "content": "说一句'Hello, Claude!'"}
13    ],
14    max_tokens=100
15)
16
17print("✅ 连接成功！模型回复：")
18print(response.choices[0].message.content)

运行前确保已安装依赖并开启梯子：

1pip install openai
2python test_claude.py

场景应用示例

🧩 场景 1：智能编程助手

将 claude-sonnet-5 设为默认模型，在 WorkBuddy 中描述需求：

使用示例：

1请帮我用 Python 写一个读取 CSV 文件并计算每列均值的函数，
2要求处理缺失值并加上类型注解。

效果：

• 生成完整可运行的函数代码
• 自动添加参数说明、类型注解与边界处理
• 解释关键逻辑并提供调用示例

🧩 场景 2：深度推理分析

切换到 claude-opus-5 模型处理需要逻辑推理的任务：

使用示例：

1请帮我分析这段代码的时间复杂度和空间复杂度，
2并给出优化建议：
3[粘贴你的代码]

效果：

• Opus 5 的深度思考机制会展示完整推导过程
• 特别擅长数学计算、逻辑证明、复杂 Bug 定位
• 适合算法重构、架构设计等高难度任务

🧩 场景 3：长文档/整库代码处理

利用 Claude 的 1M tokens 上下文窗口：

效果：

• 单次处理数十万字的论文、合同、报告
• 整个中型代码库的全局分析与重构建议
• 跨文件依赖梳理与影响面评估

最佳实践

💰 成本优化技巧

1. 利用 Prompt 缓存：将 system prompt、工具定义等固定内容放在消息开头，缓存命中后输入成本降低 90%

2. 按需选模：

   • 简单问答 / 高频调用 → claude-haiku-4-5（最便宜）
   • 代码生成 / 智能体 → claude-sonnet-5（性价比之选）
   • 复杂推理 / 数学证明 → claude-opus-5（最强但最贵）

3. 控制输出长度：输出 token 通常是输入的 5 倍价格，合理设置 maxTokens（一般 2048-4096 即够用）

4. 使用 Batch API：非实时任务用批量接口，可享 50% 折扣

🔒 安全建议

1. 永远不要将 API Key 提交到 Git 仓库 —— 确保 .gitignore 包含 .env 和 config.json
2. 定期轮换 Key —— 在 Anthropic Console 定期更新密钥
3. 设置用量告警 —— 在控制台设置预算上限，防止意外超额
4. 使用最小权限原则 —— 仅授予必要的 API 权限范围

🐛 故障排查速查表

扩展与进阶

📚 更多学习资源

🚀 进阶玩法

• 多模型混合部署：在 config.json 中同时配置 Claude + 其他模型，根据任务类型动态切换
• 流式输出（Streaming）：开启 SSE 流式返回，提升长文本的交互体验
• 工具调用（Tool Use）：Claude 支持精准的函数调用能力，可对接本地文件、API
• Prompt 缓存：对长 system prompt 开启缓存，重复请求大幅降本