在 macOS 上安装 CodeBuddy，其实比想象中还要简单——全程图形化操作，不需要跟命令行打交道。概括下来就是三步：下载官方 .dmg 文件、双击挂载后拖进 Applications、首次启动时授权并微信扫码登录。整个过程对新手非常友好，而且后续还支持自动更新，CLI 工具也可以按需安装。

下面直接拆开每一步讲清楚，确保你从零开始也能一次搞定。

下载官方安装包

打开 Safari 或 Chrome，访问腾讯 CodeBuddy 官方页面：https://www.codebuddy.cn（或者 WorkBuddy 下载页 https://www.codebuddy.cn/work/，目前这两个地址指向同一套安装资源）。页面会自动识别你的 macOS 系统，并显示「下载 CodeBuddy」或「下载 WorkBuddy」按钮。点击后就开始下载 .dmg 文件了，大小大概 150–180MB，默认存到「下载」文件夹里。

挂载并安装到 Applications

下载完成后，打开「访达 → 下载」，找到名为 CodeBuddy.dmg 或 WorkBuddy.dmg 的磁盘映像文件：

• 双击这个 .dmg 文件，系统会自动挂载出一个虚拟磁盘窗口（窗口名称通常是 “CodeBuddy”）
• 窗口左边是安装包图标，右边是「Applications」文件夹图标
• 按住左边那个安装包图标，直接拖到右边「Applications」文件夹里（这时会提示输入管理员密码，输一下就行）
• 等待复制完成（几秒到十几秒），然后关掉窗口

首次启动与登录

安装完就进入启动环节：

• 打开「启动台」或「访达 → 应用程序」，找到 CodeBuddy 图标并双击
• 第一次运行时，macOS 可能会弹个“无法验证开发者”的提示——别慌，点击「仍要打开」就行。这是 Gatekeeper 的正常防护，CodeBuddy 有 Tencent Cloud 的签名，安全可信。
• 进入欢迎界面，点击「Log in」或「开始使用」
• 推荐用微信扫码登录——用手机微信扫屏幕上的二维码，确认授权后可能还需要输入信息验证码
• 登录成功后自动进入主界面，接下来就可以新建项目或者打开已有文件夹了

小贴士：更新与权限

后续需要更新的话：

• 启动 CodeBuddy 后，点击菜单栏 Help → Check for Updates，有新版就会提示下载安装
• 如果想在终端里调用（比如用 codebuddy 命令），安装时记得勾选「Install the ‘buddycn’ command」选项，或者手动执行 CLI 安装脚本
• 遇到摄像头、麦克风或文件访问权限问题？去「系统设置 → 隐私与安全性」里，给 CodeBuddy 单独打开对应权限就行