乐于分享
好东西不私藏

TRAE安装教程:从下载到写代码,我踩了3个坑

TRAE安装教程:从下载到写代码,我踩了3个坑
AI工具实战

TRAE是字节跳动出的AI编程工具,免费、全中文界面、支持AI自动写代码。听起来很美好,但作为一个前程序员,我知道"安装"这关就能劝退不少人。

我帮3个朋友装过TRAE,每个都遇到了不同的问题。所以我把完整的安装过程和踩坑记录写下来,你照着做,应该能顺利跑通。

一、你的电脑能装吗?

先确认你的电脑满足最低要求:

项目
最低要求
推荐配置
操作系统
Windows 10 / macOS 12
Windows 11 / macOS 14
内存
4GB
8GB+
硬盘
2GB可用
4GB+可用
网络
需要联网
稳定网络

大部分2018年以后买的电脑都能装。唯一需要注意的是:macOS必须12.0以上,如果是老款Mac(2015年之前的),可能需要装低版本。

二、下载和安装(3分钟搞定)

TRAE的安装非常简单,基本上就是"下载→双击→下一步"。

Step 1:下载

打开 trae.ai(国内用户也可以用 trae.com.cn),点击右上角"下载"。

Step 2:安装

Windows用户:双击下载的 Trae-Setup-x64.exe,按向导安装,默认路径就行。

Mac用户:打开下载的 .dmg 文件,把TRAE图标拖到Applications文件夹。

Step 3:首次启动

打开TRAE,跟着界面走就行:选主题(深色/浅色)→ 选语言(中文)→ 添加命令行(跳过)→登录(根据需要选个人用户还是企业用户我选个人用户)(手机号或掘金账号)。→出现如下界面,输入你好有反应恭喜你成功。

⚠️ 坑1:Windows提示"已保护你的电脑"

现象:双击安装包后弹出"Windows已保护你的电脑"蓝色提示框

解决:点"更多信息" → 点"仍要运行"。这是Windows的SmartScreen提示,不是病毒。

三、从VS Code迁移(可选但推荐)

如果你之前用VS Code或Cursor,TRAE可以一键导入你的配置,包括:

• 快捷键设置

• 已安装的扩展

• 主题和字体

• 用户设置(settings.json)

首次启动时TRAE会自动检测你电脑上的VS Code和Cursor,弹窗问你要不要导入。建议选"是",这样你不用重新适应快捷键。

⚠️ 坑2:迁移后扩展不兼容

现象:从VS Code导入的扩展,有些在TRAE里不能用

原因:TRAE基于VS Code内核,但不是100%兼容所有扩展

解决:不兼容的扩展禁用就行,TRAE自带的AI功能已经够用。常用的Python、Git、ESLint扩展都兼容。

四、两种开发模式

TRAE有两个模式,在左上角可以随时切换:

模式
说明
适合谁
IDE模式
传统编程方式,你写代码,AI辅助补全和建议
有编程基础的人
SOLO模式
AI主导,你描述需求,AI自动写代码、测试、部署
编程小白 / 想快速出活的人

我的建议:先用SOLO模式体验一下AI编程的感觉,然后再切到IDE模式学习细节。SOLO模式下你只需要用自然语言描述你想做什么,TRAE会自动帮你完成。

五、安装完第一件事:写个Hello World

装好TRAE之后,别急着做复杂项目。先写一个最简单的程序,验证AI功能是否正常。

用SOLO模式试试:

1. 切换到SOLO模式(左上角)

2. 在对话框输入:"帮我写一个Python脚本,打印Hello World"

3. 等TRAE自动生成代码

4. 点运行,看输出结果

如果能正常输出 Hello World,说明TRAE安装成功,AI功能正常。

七、关闭AUTO模式(重要!)

TRAE默认开启了AUTO模式,会自动读取你的项目文件并发送给AI。这意味着你打开一个项目,TRAE可能会自动把代码上下文发送出去。

如果你不希望项目代码被自动上传,建议关闭AUTO模式。

操作步骤:

1. 点击右下角的模型名称

2. 找到"AUTO"开关

3. 关闭它

关闭后TRAE只在你主动提问时才会读取代码,更安全。如果你对隐私比较敏感,强烈建议关掉。

八、切换AI模型

TRAE默认使用自带的云雀模型,但你也可以切换到其他模型。

支持的模型包括:kimi-K2.5、GLM、Qwen3等。

操作步骤:

1. 点击右下角的模型名称

2. 选择你想用的模型

3. 如果你有API Key,还可以接入自己的模型(比如火山引擎/阿里云)

建议:日常写代码用默认模型就行,复杂任务可以试试kimi-K2.5或GLM,效果会更好。

⚠️ 坑3:AI功能提示"网络错误"

现象:安装完能打开,但AI聊天和代码补全不工作,提示网络错误

原因:公司网络/VPN/防火墙拦截了TRAE的API请求

解决:关闭VPN试试;如果是公司网络,联系IT开放 api.trae.ai 的访问权限

如果你也在用TRAE写代码,欢迎关注「极客雷达」,每周分享前程序员的AI实战记录,踩过的坑帮你避开。

九、安装后推荐做的5件事

1. 导入VS Code配置 — 如果你之前用VS Code,一键导入快捷键和扩展

2. 安装语言扩展 — 根据你常用的编程语言,安装对应的语法高亮和调试扩展

3. 试试SOLO模式 — 用自然语言描述一个简单需求,体验AI自动编程

4. 配置Git — 如果你用GitHub,在TRAE里登录Git账号,方便版本管理

5. 试试AI聊天 — 按 Ctrl+Shift+A 打开AI聊天,问它任何编程问题

总结

TRAE的安装本身很简单,3分钟就能搞定。真正需要注意的3个坑:

• Windows的SmartScreen提示 — 点"仍要运行"就行

• VS Code扩展不兼容 — 禁用不兼容的,TRAE自带AI功能够用

• AI功能网络错误 — 检查VPN和防火墙设置

装好之后,先用SOLO模式写个Hello World验证一下,然后就可以开始你的AI编程之旅了。

数据来源

TRAE官方文档(docs.trae.ai)、Trae学习指南(ykzm.cn)、作者2026年4月实测记录

💬 今日话题

你现在用什么编程工具?

A VS Code

B Cursor

C TRAE

END

极客雷达

发现科技新物种 · 解码AI新趋势

📱 长按关注「极客雷达」每周分享AI工具实战经验

📰 往期推荐

 DeepSeek专家模式上线:比免费版强多少?

 TRAE SOLO独立端上线:字节跳动要让AI替你上班了?