在 macOS 上安装 Trae 独立客户端的过程与安装其他桌面应用一致，安装完成后即可直接使用，无需手动搭建额外的开发环境。以下操作适用于 macOS 11.0（Big Sur）及以上版本。
1. 下载与版本选择
- 通过浏览器访问 Trae 官方网站的下载页面（地址以官方最新公告为准）。
- 在下载区域找到 macOS 版本，请注意区分 CPU 架构：
- Apple 芯片版：适用于搭载 M1 / M2 / M3 / M4 等 Apple Silicon 芯片的 Mac。原生构建，性能和能效表现更好。
- Intel 芯片版：适用于搭载 Intel Core 系列处理器的旧款 Mac。
如果不确定 Mac 的芯片类型，可以点击桌面左上角苹果菜单 → “关于本机”，在“芯片”或“处理器”一栏中查看。一般情况下，2020 年之后发布的 MacBook Air、MacBook Pro、Mac mini、iMac 多数为 Apple 芯片；之前的机型多为 Intel 芯片。选择错误的版本可能导致程序运行异常，所以这一步值得花几秒钟确认。
- 点击对应的下载按钮，浏览器会开始下载一个
.dmg磁盘映像文件。
2. 安装步骤
- 在“下载”文件夹中找到刚刚下载的
.dmg文件（名称通常类似Trae-xx.dmg），双击打开。 - 系统会挂载磁盘映像并弹出一个窗口，里面包含 Trae 的应用图标和一个“应用程序”文件夹的快捷方式。
- 将 Trae 图标直接拖入右侧的“应用程序”文件夹。这个过程会将 Trae 复制到 macOS 的标准应用目录中。
- 等待复制进度完成，随后可以在“启动台”（Launchpad）或 Finder 的“应用程序”文件夹中找到 Trae。
- 第一次打开 Trae 时，双击应用图标，系统可能会弹出提示：“是从互联网下载的应用程序，您确定要打开它吗？”，直接点击 打开 即可。
- 应用启动后将进入账号登录/注册界面，按提示完成操作（详见 2.3.1 节），即可进入主界面。
3. 常见问题与处理
提示“无法打开，因为它来自未认证的开发者”
这是 macOS 的 Gatekeeper 安全机制所致，尤其多见于刚发布还未来得及广泛签名的版本。解决方法：
- 打开 系统设置（旧版为系统偏好设置）→ 隐私与安全性。
- 在“安全性”区域中，你应该能看到关于 Trae 被阻止运行的提示，点击旁边的 仍要打开 按钮，然后再次输入系统密码确认。
- 再次双击 Trae，此时系统会给出“打开”选项，正常启动即可。
安装后无法启动，或在 Dock 上跳几下就消失
通常是由于下载的版本与 Mac 芯片不匹配引起。请卸载当前版本（拖入废纸篓），然后根据前文方法确认芯片类型，重新下载对应版本。
第一次启动时间较长
Trae 首次启动可能需要联网拉取一些必要的组件和模型配置，请确保网络连接稳定。如果长时间停留在启动画面，可以尝试重启应用或检查网络防火墙设置是否限制了 Trae 的网络访问。一般情况下等待一两分钟即可。
如何卸载
如果后续不再需要 Trae，卸载方法与普通 macOS 应用一样：打开 Finder 的“应用程序”文件夹，找到 Trae，拖移到废纸篓（或右键选择“移到废纸篓”），然后清空废纸篓。若有残留配置文件，通常在 ~/Library/Application Support/Trae 目录，可以手动删除。
4. 安装完成后的建议
为了确认 Trae 正常工作，可以在登录后尝试打开一个简单的代码文件或新建一个空项目，检查编辑器界面是否正常显示，侧边栏对话功能是否可用。如果一切就绪，建议花几分钟时间熟悉界面布局和核心快捷键（见 2.4 节），这些基础设置能显著提升后续使用的舒适度。