2.1 桌面客户端安装

桌面客户端适合在不方便打开 IDE 时，进行代码讨论、技术咨询或快速梳理项目结构。前往官网下载对应系统的安装包，安装过程与常规软件类似，按提示操作即可。

2.1.1 Windows 系统安装

1. 下载 .exe 安装包（目前仅提供 64 位版本）。
2. 双击运行安装向导，保持默认安装路径即可，有特殊需求可手动更改目录。
3. 按需勾选"创建桌面快捷方式"，点击安装等待完成。
4. 安装结束后点击"立即体验"启动客户端，进入账号登录界面。

注意：若 Windows Defender 或其他安全软件弹出拦截提示，请选择"允许运行"或"仍要安装"。

2.1.2 macOS 系统安装

1. 下载 .dmg 文件（Intel 芯片选择 x64 版本，Apple Silicon 选择 ARM64/Apple 芯片版本）。
2. 双击挂载镜像，将 CodeBuddy 图标拖拽至 Applications 文件夹。
3. 首次通过启动台打开时，若系统提示"无法打开"，请进入 系统设置 > 隐私与安全性 > 安全性，点击"仍要打开"。
4. 正常启动后，进入登录界面完成后续配置。

2.1.3 Linux 系统安装

Linux 平台通常提供 AppImage 或系统级安装包，任选其一即可：

• AppImage（通用，免安装）：

下载后赋予执行权限，直接运行：

  chmod +x CodeBuddy-*.AppImage
  ./CodeBuddy-*.AppImage
  

• Debian / Ubuntu（.deb）：

  sudo dpkg -i codebuddy-*.deb
  sudo apt-get install -f   # 自动修复可能的依赖缺失
  

• RedHat / CentOS / Fedora（.rpm）：

  sudo rpm -i codebuddy-*.rpm
  

安装完成后，可在应用菜单搜索"CodeBuddy"启动，或在终端直接输入 codebuddy 启动客户端。