国内WorkBuddy 保姆级安装教程(真的很保姆)

大家好，我是惊鸿。

今天详细记录了自己从0到1安装并完成初步配置 workbuddy 的过程，与大家分享。

workbuddy 是国内，腾讯云 CodeBuddy 团队自研的国产桌面 AI 智能体。

一、先下载安装WorkBuddy

首先先去到百度搜索“workbuddy官网”，下载客户端。注意：认准带有官方标识的链接，别点错了。

点进去，右上角点击下载：根据你的电脑系统选择 Windows 或 Mac 版本，下载之后正常安装，打开软件，然后按提示登录账号。我的下载的是Windows的。

下载好后双击打开进行安装：

这一步不难，真正容易踩坑的是安装之后的设置。安装的时候：建议不要装在C盘，比如我这里专门在D盘建了一个文件夹安装 WorkBuddy。

然后接着点击下一步，等待安装完成。

接着就到了这里：

接着点击登录：

它会跳转到网页端，进行登录。这里我选择的是手机验证码登录。也可以直接微信扫码登录。

登录成功之后，它还会跳出一个官方的公众号二维码，我们可以扫码二维码持续关注关于 WorkBuddy的相关资讯。

然后再次返回安装页面就是这样啦。

WorkBuddy 后面会读写本地文件，所以我们第一次打开之后，不要急着开始提问，先把工作空间路径、模型、权限这几个基础项看明白。

因为这几个设置，会直接影响你后面能不能顺利让它处理文件。

二、先改工作空间路径

WorkBuddy 不是普通的聊天工具。它在执行任务时，可能会生成文件、保存结果、缓存内容，也可能留下中间过程文件。所以，我们可以把工作空间理解成 WorkBuddy 干活时用的“办公桌”。

这里的位置，最好一开始就设置清楚。

和安装目录同样的，如果默认路径在系统盘，长期使用后可能会占用 C 盘空间。

尤其是你经常让它处理 PDF、表格、图片、PPT、批量文件，生成的中间结果和缓存会越来越多。

所以建议新手一开始就新建一个固定文件夹，比如：

D:/WorkBuddyWorkspace/

这里顺手讲一下绝对路径。

绝对路径就是从盘符开始写完整地址。

比如：

D:/WorkBuddy/D:/WorkBuddy练习/表格.xlsxD:/工作周报/日报.md

到这里，大家可能会疑惑：workBuddy 的工作空间路径和这个安装路径适不适合放在一个文件夹下？

答案是不允许，当我们选择工作空间在安装目录下时，它自己都会提醒，不允许。

两者区分

D:\WorkBuddySetup\├─ bin├─ resources└─ workspace  ← 把工作空间嵌套在安装目录内，错误！更新极易丢失项目文件，软件设置直接不让保存

✅推荐正确目录布局（同级，互不嵌套）

D:\WorkBuddy     # 软件安装目录D:\WorkBuddyWorkspace  # 工作空间目录，和安装文件夹平级，不在里面D:\WorkBuddyWorkspace  # 练习空间

所以，最终的路径安排是这样的：

除了安装路径，一个放 WorkBuddy 工作空间，一个放练习文件。这样后面学习时不容易乱。

三、模型怎么选

可能很多新手一看到模型就开始纠结：

哪个模型最好？哪个模型最聪明？哪个模型最便宜？我要不要自己配置 API？

先别急。

我们可以把模型理解成 WorkBuddy 背后的“大脑”。

WorkBuddy 已经支持大部分主流国产模型，比如混元、DeepSeek、Kimi、GLM、MiniMax 等，新手不用一上来就自己申请 API，先用默认模型跑通任务就行。

不同模型适合不同任务：写作看表达，长文档看上下文，表格分析看结构化能力，代码和批量处理看执行稳定性。

另外，WorkBuddy 也支持自定义模型，但目前只支持 OpenAI 兼容协议 API。也就是说，你需要准备支持该协议的 API Key 和模型名称，再添加进去。

新手建议：先用内置模型跑通第一个任务，再考虑自定义模型。

最后最后🌟希望我的分享能帮到你，如果有什么想和我分享的，可以在评论区留言，也可以私信我聊聊。

如果某个点对您有帮助的话，可以点赞、转发，分享给身边有需要的朋友。谢谢！

也可以点击下方名片关注我，后续我继续记录并分享自己应用实战的过程。

@陪你一起仗剑走天涯@