📌

WorkBuddy 是腾讯云推出的桌面 AI 智能体工作台，专门为职场办公场景设计。本教程教你给 WorkBuddy 添加星狐云中转 API 作为自定义模型，让你直接用上 Claude Sonnet / Opus 等顶级模型，价格还比官方便宜几倍。

💼 为什么要在 WorkBuddy 里配星狐云

WorkBuddy 是腾讯云推出的桌面 AI 助手，它的强项是：

直接执行任务，不只是聊天回答 —— 自动操作本地文件，做完整的多步骤工作

办公场景全覆盖 —— 一句话生成周报、自动整理表格、批量处理文件、深度调研报告、PPT 生成

自带多个模型 —— 内置了 GLM、混元、Kimi、MiniMax、DeepSeek 等国产模型

但 WorkBuddy 内置的模型里没有 Claude 系列。如果你想用 Claude Sonnet / Opus 这些强模型来：

写更高质量的工作报告 / 文档

处理英文资料 / 翻译

做需要强逻辑推理的数据分析

使用 Claude 独有的"长上下文"能力（处理超长文档）

就需要通过 WorkBuddy 的自定义模型功能接入第三方 API。

📋 准备工作

已安装并登录 WorkBuddy（未安装可前往官网下载：copilot.tencent.com/work）

已注册星狐云账号

🔑 第一步：创建星狐云 API 令牌

前往 https://xinghuapi.com/ 注册并登录，进入 控制台 → API 令牌 页面，点击 添加令牌。

📝 创建令牌时的建议设置：

配置项	建议值
名称	随意命名，如 `workbuddy`
分组	选 Claude Code 专属分组或 Claude Code 专属 2 分组（最稳定）
额度	选无限额度
其他选项	保持默认

保存后复制以 sk- 开头的令牌密钥备用，下一步会用到。

⚙️ 第二步：在 WorkBuddy 中添加星狐云为自定义模型

打开模型配置

在 WorkBuddy 主界面，点击左下角头像 → 设置

在设置左侧菜单选择 「模型」

找到 「自定义模型」 区块，点击 「添加模型」 按钮

填写模型配置信息

在添加模型的弹窗中，按以下信息填写：

字段	填入内容	说明
提供商 / Provider	选「自定义 / Custom」	不要选其他预设厂商
接口地址（API 地址）	`https://xinghuapi.com/v1`	⚠️ 必须带 `/v1`
API Key	`sk-你的星狐云令牌密钥`	第二步复制的令牌
模型名称（显示名）	`claude-sonnet-4-6`	这是真实调用的模型 ID

能力标记（建议勾选）

Claude 系列支持以下能力，按需勾选：

✅ 工具调用（Function Calling） —— 让 AI 能调用工具、操作文件（强烈推荐勾选）

✅ 图片输入（Vision） —— 让 AI 能看图片、截图（Claude 全系列支持）

⬜ 推理模式（Reasoning） —— Claude 默认不需要勾选

高级配置：自定义协议开关

状态	适用场景
🔘 关闭（默认推荐）	WorkBuddy 自动在 URL 后拼接 `/chat/completions`，标准 OpenAI 协议
🔘 开启	仅当出现 404 路径错误时再开启，直接按填写 URL 原样发请求

一般情况下保持默认关闭即可，星狐云完全兼容标准协议。

保存配置

填写完毕后点击保存，刚添加的模型会出现在「自定义模型」列表中。

💬 第三步：在对话中使用星狐云模型

回到 WorkBuddy 主界面

点击输入框上方的 模型选择器

在弹出的列表中找到 「自定义模型」 分组

点击刚刚添加的 「Claude Sonnet 4.6」

输入一个问题测试，例如：

帮我写一份本周工作总结，要点：完成了 3 个项目、参加了 5 次会议、准备明天的客户演示

如果能收到回复，说明配置成功！🎉

📊 推荐添加的模型清单

星狐云支持 Claude 全系列，建议按用途分别添加：

显示名	Model ID（填入「模型 ID」字段）	适用场景
Claude Sonnet 4.6	`claude-sonnet-4-6`	日常使用首选，性价比高
Claude Opus 4.6	`claude-opus-4-6`	最强性能，复杂分析、深度报告
Claude Haiku 4.5	`claude-haiku-4-5-20251001`	速度最快，简单任务、批量处理

完整模型列表和价格见星狐云文档：xinghuapi.apifox.cn

添加多个模型的方法：重复"第二步"的操作，每次填不同的模型 ID 即可。对话时通过模型选择器随时切换。

❓ 常见问题解答

Q: 保存后对话报错 401（认证失败）？

A: 大概率是令牌分组的问题，按以下步骤排查：

先在星狐云控制台把令牌的分组改成 Claude Code 专属分组 或 Claude Code 专属 2 分组

如果之前没设置过分组，先设置一下再试

还不行的话，截图发给客服看具体报错

Q: 报 404 错误或路径错误？

A: 检查两点：

URL 字段确认填的是 https://xinghuapi.com/v1（必须带 /v1）

如果 URL 没错还报 404，尝试在「高级配置」中**开启「自定义协议」**开关再试

Q: 提示「模型在该分组下无法使用」？

A: 你选的模型和当前令牌分组不匹配。换到模型对应的分组：日常用模型推荐 Claude Code 专属分组 或 专属 2 分组。

Q: 出现 400 报错 / 请求格式错误？

A: WorkBuddy 调用 Claude 偶尔会出现这种报错，解决办法：

换一个令牌分组试试

或者关闭当前对话，新建对话重新发送

Q: 添加完模型后在对话中找不到？

A: 三个常见原因：

没保存成功 → 重新进设置确认「自定义模型」列表里有这个模型

没启用 → 部分版本需要在模型旁边手动开启「启用」开关

客户端缓存 → 完全退出 WorkBuddy 再重新打开

Q: 想同时用多个 Claude 模型怎么办？

A: 重复"第二步"添加多次，每次填不同的模型 ID（如 claude-sonnet-4-6、claude-opus-4-6、claude-haiku-4-5-20251001）。对话时在模型选择器里随时切换。

Q: 怎么查看自己的费用消耗？

A: 登录星狐云控制台 → 使用记录 或 账单明细，可以看到每次调用的时间、模型、消耗的 Token 和扣费金额。

Q: 一刀（1 美元额度）能用多久？

A: 每次消耗的 Token 不同，内容越长扣费越多。1 美元大概对应 10-30 万 Token，不同模型价格不一样。建议先小额充值体验，根据自己的使用习惯再决定后续充多少。

📌 注意事项

妥善保管你的 sk- 开头的 API 令牌，避免泄露

推荐使用 Claude Code 专属分组 或 Claude Code 专属 2 分组，最稳定最兼容

额度建议设为无限（实际消耗受账户余额限制）

处理重要文件前建议先备份，让 AI 操作本地文件时务必检查权限范围

WorkBuddy 升级到新版本后，自定义模型配置不会丢失（保存在 ~/.codebuddy/models.json）

🔗 相关链接

WorkBuddy配置API教程

💼 为什么要在 WorkBuddy 里配星狐云#

就需要通过 WorkBuddy 的自定义模型功能接入第三方 API。#

📋 准备工作#

🔑 第一步：创建星狐云 API 令牌#

⚙️ 第二步：在 WorkBuddy 中添加星狐云为自定义模型#

打开模型配置#

填写模型配置信息#

能力标记（建议勾选）#

高级配置：自定义协议开关#

保存配置#

💬 第三步：在对话中使用星狐云模型#

📊 推荐添加的模型清单#

❓ 常见问题解答#

📌 注意事项#

🔗 相关链接#