trae在windows/macos上5分钟跑通需三步：确认系统≥win10 1903/macos 12、下载对应架构安装包并绕过安全拦截、安装node.js 18.17+后执行npm install -g trae-cli初始化命令行工具。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在Windows或Mac上5分钟内跑起TRAE，不用折腾环境、不卡在权限报错、不被安全软件拦截，直接进入Builder模式写贪吃蛇——你得先绕过那些默认设置里的隐形陷阱。
确认系统与硬件门槛
打开“关于本机”（Mac）或“系统信息”（Win），核对两项：【macOS必须≥12（Monterey），Windows必须是Win10 64位1903及以上】。Win7或Catalina及更早系统会卡在启动瞬间，连欢迎界面都弹不出来——这不是安装失败，是底层运行时库根本不加载。
检查硬盘剩余空间是否≥15GB。Trae首次启动要下载模型缓存+索引库，低于10GB时安装包能装上，但第一次点击“新建项目”就会卡死在进度条99%，且无任何错误提示。
关闭Windows Defender实时防护或Mac防火墙。这一步不能跳过，否则安装进程会被静默终止，日志里只显示“exit code 1”，实际是杀毒软件把trae-cli进程当可疑程序干掉了。
下载与安装（分平台直链操作）
国内用户直接访问 www.trae.com.cn/download，页面自动识别系统并给出对应包：
→ Windows选 trae-win-x64.exe（不是.zip！exe才是带自签名的正式安装器）；
→ Mac选 trae-mac-darwin-arm64.dmg（M1/M2/M3芯片）或 trae-mac-darwin-x64.dmg（Intel芯片），别下错架构，否则双击图标没反应。
下载完成后，Windows用户右键安装包→“以管理员身份运行”；Mac用户拖拽到应用程序文件夹后，【首次打开需右键→“打开”，绕过Gatekeeper拦截】——这是Apple Silicon设备的强制验证步骤，直接双击会提示“已损坏”，不是文件问题。
命令行工具初始化（关键一步）
这步决定你后续能不能用终端一键创建项目。Windows用户：以管理员身份打开PowerShell → 执行：cd "C:\Program Files\Trae" ; npm install -g trae-cli；
Mac用户：终端执行：cd /Applications/Trae.app/Contents/Resources/app ; npm install -g trae-cli；
如果提示“npm not found”，说明Node.js未预装——Trae不自带Node运行时，【必须提前安装Node.js 18.17+】，低版本会导致trae-cli命令注册失败，Builder模式无法调用本地执行器。
验证是否成功：终端输入 trae --version，返回版本号即生效。
登录与模型切换（国内版专属）
启动Trae桌面端，用手机号或掘金账号一键登录——不需要科学上网，也不需要填API Key，字节云端算力已为你配好。
左下角齿轮图标→“AI Settings”→点击模型名称右侧的箭头→可切换为【doubao-1.5-pro（响应最快）、DeepSeek-R1（长文本推理强）、DeepSeek-V3（代码生成精准）】。首次切换后需等待10秒左右模型热加载，期间对话框会灰显，属正常现象。
Builder模式下输入“做个俄罗斯方块，带暂停键和得分板”，回车后AI开始生成，60秒内输出完整可运行工程目录，点“运行”按钮即唤起内置浏览器预览。
