腾讯 WorkBuddy 超详细安装教程(Windows+macOS 全步骤)
一、安装前准备(必看)
1. 系统与硬件要求
- Windows 系统:Windows 10(1909 版本及以上)、Windows 11 全版本(64 位);内存≥8GB,剩余存储空间≥200MB
- macOS 系统:macOS 10.15(Catalina)及以上,兼容 Intel 芯片 / Apple Silicon(M1/M2/M3 系列);内存≥8GB,剩余存储空间≥200MB
- 网络:首次安装、登录、模型推理需稳定联网(Wi‑Fi / 宽带),基础本地文件操作后续可离线
- 账号:微信 / 企业微信 / QQ 账号(腾讯系通用,无需额外注册)
- 安全提醒 :安装前关闭电脑中已运行的 CodeBuddy(两款工具同架构,易冲突);仅从官方渠道下载,拒绝第三方安装包
2. 官方下载地址(唯一安全入口)
https://www.codebuddy.cn/work/
-
页面自动识别电脑系统,显示对应下载按钮(Windows x64 / Mac ARM64 / Mac x64)
-
安装包大小:Windows 版约 150‑180MB(WorkBuddySetup.exe);macOS 版约 150‑180MB(WorkBuddy.dmg)


二、Windows 系统详细安装步骤(保姆级)
步骤 1:下载安装包
- 打开浏览器,输入官方地址,进入 WorkBuddy 下载页
- 点击绿色「下载 WorkBuddy」按钮,自动匹配 Windows 版本,开始下载
- 下载完成后,文件默认保存在「下载」文件夹,找到
WorkBuddySetup.exe
步骤 2:启动安装程序(权限授权)
- 双击
WorkBuddySetup.exe,弹出 ** 用户账户控制(UAC)** 提示:「是否允许此应用对你的设备进行更改?」 - 务必点击 「是」(腾讯官方软件,安全无风险,需权限才能完成安装)
步骤 3:安装向导配置(关键步骤)
- 选择安装路径
- 默认路径:
C:\Program Files\WorkBuddy - 建议修改:选择非系统盘(如 D 盘、E 盘)新建文件夹安装,避免占用 C 盘空间
- 默认路径:
- 附加任勾选
- 勾选「创建桌面快捷方式」「添加到开始菜单」(方便后续快速启动)
- 勾选「同意用户许可协议」(必选,否则无法继续)
- 点击 「立即安装」,等待进度条走完(约 1‑3 分钟,取决于电脑性能)
步骤 4:完成安装与首次启动
- 进度条 100% 后,勾选 「立即启动 WorkBuddy」,点击「完成」
- 软件自动启动,桌面生成 WorkBuddy 快捷图标,开始菜单同步添加入口
步骤 5:Windows 防火墙授权(首次启动必弹)
- 首次启动弹出「Windows 防火墙」提示,勾选 「专用网络」「公用网络」,点击「允许访问」
- 若被杀毒软件拦截,选择「允许程序所有操作」「添加信任」(腾讯官方软件,无安全风险)
三、macOS 系统详细安装步骤(含安全授权)
步骤 1:下载安装包
- 浏览器打开官方地址,点击「下载 WorkBuddy」,自动匹配 macOS 版本(ARM64 对应 M 系列芯片,x64 对应 Intel)
- 下载完成后,得到
WorkBuddy.dmg文件,默认保存在「下载」文件夹
步骤 2:挂载镜像与拖拽安装
- 双击
WorkBuddy.dmg,弹出挂载窗口(左侧显示 WorkBuddy 图标,右侧显示「应用程序」文件夹) - 按住
WorkBuddy.app图标,拖拽至右侧「应用程序」文件夹(完成安装,无需额外操作) - 安装完成后,可右键点击桌面挂载的镜像,选择「推出」,关闭窗口
步骤 3:解决「无法验证开发者」(macOS 必做)
macOS 安全机制限制,首次启动非 App Store 软件会报错,按以下步骤授权:
- 启动台找到 WorkBuddy 图标,右键点击→选择「打开」(不要直接双击)
- 弹出提示「无法验证开发者,无法打开」,点击「取消」
- 打开「系统设置→隐私与安全性→安全性」
- 下滑找到「WorkBuddy 被阻止使用,因为它来自身份不明的开发者」,点击 「仍要打开」
- 再次弹出确认框,点击「打开」,完成安全授权(后续启动无需重复操作)
步骤 4:辅助权限授权(macOS 功能完整必备)
- 首次启动后,弹出「需要辅助功能权限」提示,点击「打开系统设置」
- 进入「隐私与安全性→辅助功能」,解锁设置(点击左下角锁形图标,输入电脑密码)
- 勾选「WorkBuddy」,关闭设置页,软件即可正常操作本地文件
四、首次启动初始化配置(安装后必做)
1. 账号登录(3 种方式)
- 启动后弹出登录界面,支持微信扫码、企业微信扫码、QQ 扫码
- 推荐选择微信扫码(操作最便捷,数据同步稳定)
- 手机扫码后,在手机端点击「确认登录」,电脑端自动跳转主界面
- 登录成功:新用户自动赠送 5000 Credits(免费算力积分),可用于基础任务执行
2. 文件夹授权(核心安全步骤)
- 登录后弹出「授权文件夹访问」窗口,WorkBuddy 需权限才能处理本地文件
- 安全授权原则 :仅勾选工作常用文件夹(桌面、文档、下载、指定项目文件夹)
- 禁止授权:系统盘(C 盘)、个人隐私文件夹(照片、银行卡资料、密码文档等)
- 勾选完成后,点击「确定」,授权立即生效
3. 基础设置优化
- 默认模型选择
- 进入左下角「头像→设置→模型选项」
- 日常办公:选混元(响应快、中文优化好)
- 复杂数据分析:选DeepSeek(推理能力强)
- 代码 / 技术文档:选GLM/Kimi
- 快捷键设置
- 默认唤醒 / 隐藏快捷键:
Ctrl+Alt+W(Windows)、Command+Option+W(macOS) - 可在「设置→快捷键」自定义为个人习惯组合
- 默认唤醒 / 隐藏快捷键:
- 工作目录设置
- 选择一个固定文件夹(如「桌面 - WorkBuddy 成果」),作为文件默认保存路径
五、安装常见问题与解决方案(避坑指南)
Windows 问题
- 安装包双击无反应
- 原因:安装包损坏、系统权限不足
- 解决:重新官网下载;右键安装包→「以管理员身份运行」
- 安装进度条卡住
- 原因:后台程序冲突、磁盘空间不足
- 解决:关闭杀毒 / 安全软件;清理磁盘空间(≥200MB);重启电脑后重装
- 启动后闪退
- 原因:系统版本过低、内存不足
- 解决:升级 Windows 10 至 1909+;关闭后台冗余程序;重启软件
macO 问题
- 拖拽安装后找不到应用
- 原因:未成功拖拽至「应用程序」
- 解决:重新打开 dmg,确认拖拽至「应用程序」;在启动台搜索「WorkBuddy」
- 「仍要打开」按钮不显示
- 原因:系统版本过低、操作顺序错误
- 解决:升级 macOS 10.15+;先右键点击「打开」取消,再进入安全设置
- 无文件操作权限
- 原因:未授权辅助功能 / 文件夹
- 解决:重新进入「隐私与安全性」,勾选辅助功能与对应文件夹权限
通用问题
- 登录失败 / 扫码无响应
- 原因:网络不稳定、账号异常
- 解决:切换 Wi‑Fi;重启软件;更换微信 / QQ 账号登录
- Credits 未到账
- 原因:登录延迟、账号未激活
- 解决:退出重登;等待 1‑2 分钟;联系官方客服(设置 - 帮助与反馈)
六、安装后验证(确认安装成功)
- 双击桌面图标,软件正常启动,无报错、闪退
- 主界面显示「AI 助手」「技能市场」「任务看板」核心模块
- 测试简单指令:输入「整理桌面文件,按类型分类」,工具正常执行
- 查看 Credits:右上角显示「5000 Credits」(新用户额度)
七、安全与使用提醒
- 仅通过官方地址下载,拒绝第三方安装包,避免捆绑恶意软件
- 文件夹授权遵循「最小权限」原则,不授权敏感目录
- 定期更新软件(设置 - 关于 - 检查更新),获取最新功能与安全补丁
- 查看 Credits:右上角显示「5000 Credits」(新用户额度)
七、安全与使用提醒
- 仅通过官方地址下载,拒绝第三方安装包,避免捆绑恶意软件
- 文件夹授权遵循「最小权限」原则,不授权敏感目录
- 定期更新软件(设置 - 关于 - 检查更新),获取最新功能与安全补丁
- 安装后可重启电脑一次,确保所有权限、服务正常加载