Mac电脑安装CodeBuddy时，最常卡在「拖进Applications后打不开」「首次启动弹窗反复拒绝」「微信扫码后没反应」这三个环节——不是软件有问题，而是系统权限、签名验证和路径细节没处理到位。下面把每一步的关键操作和避坑要点拆开说清楚，照着走基本能一次过。

下载前确认系统与硬件兼容性

打开「关于本机」→「系统报告」，核对两项硬指标：【macOS 10.15（Catalina）及以上版本】，低于此版本无法运行；芯片类型必须是Intel或Apple Silicon（M1/M2/M3），旧款Mac Pro（2013年前）或iMac（2014年前）直接放弃尝试。

内存小于8GB会导致启动缓慢甚至无响应，建议先关闭Xcode、Docker等重型应用再安装。

下载与挂载阶段避坑

方法一：官网直下（推荐）
用Safari或Chrome访问CodeBuddy官网，页面会自动识别Mac系统并显示「下载 WorkBuddy」按钮（当前CodeBuddy与WorkBuddy共用同一安装包）。【不要从第三方论坛、网盘或微信群链接下载.dmg文件】，非官方包可能被篡改或缺失签名。

方法二：VS Code插件方式（仅限已有VS Code用户）
Cmd+Shift+X → 搜索“腾讯云代码助手CodeBuddy” → 点击安装 → 重启VS Code → 左侧边栏出现CodeBuddy图标 → 点击微信登录。这种方式跳过系统级安装，但无法使用CLI命令行工具。

拖入Applications时的关键操作

第一步：双击下载好的WorkBuddy.dmg文件，等待虚拟磁盘窗口弹出（名称为“WorkBuddy”，不是“WorkBuddy Installer”或带数字编号的变体）；
第二步：将左侧WorkBuddy图标拖拽到右侧「Applications」图标上，松手后系统会提示输入管理员密码——【必须输密码，不能点取消或跳过】，否则只是复制快捷方式而非真正安装；
第三步：等待进度条走完（通常3–8秒），关闭该窗口，【不要直接关掉.dmg挂载窗口右上角的×，要先拖拽图标完成再关】，否则文件复制中断导致后续启动失败。

首次启动被拦截怎么办

打开「启动台」或「访达 → 应用程序」，双击WorkBuddy图标，若弹出“已损坏，无法打开”或“无法验证开发者”，说明Gatekeeper拦截生效。
正确解法：不卸载重装，而是去「系统设置 → 隐私与安全性」→ 拉到最底部找到「已阻止使用…WorkBuddy」→ 点击「仍要打开」。
注意：这一步只能在弹窗出现后立刻操作，窗口关闭后再找就藏在“安全性”历史记录里，得点三次才显示。

微信扫码登录失败排查

① 手机微信扫描后无反应：检查Mac端是否停留在「Log in」界面，而非已跳转至主界面但黑屏——此时按Cmd+R强制刷新；
② 扫码后提示“授权失败”：退出微信重新登录一次，关闭手机端微信的“隐私保护→禁止其他应用获取信息”开关；
③ 验证码收不到：确认Mac联网正常（尤其检查是否连着公司V-P-N，部分企业网络会拦截腾讯系信息通道），换用手机号注册的QQ号备用登录。

安装后必须立即配置的三项权限

进入「系统设置 → 隐私与安全性」：
→「摄像头」：开启WorkBuddy（用于AI图像理解功能）；
→「辅助功能」：开启WorkBuddy（否则无法自动聚焦输入框、响应快捷键）；
→「完全磁盘访问权限」：开启WorkBuddy（【关键！不开启则无法读取项目文件、无法生成代码、无法调试】，此权限需手动勾选，系统不会默认授予）。

《夸克》非常好用的免费AI浏览器

下载APP查看