主题
Trae 安装与入门
Trae 是字节跳动推出的 AI 原生 IDE（基于 VS Code 内核），国内版从官网下载即可直连使用，个人版免费（部分能力采用积分制）。它和 Cursor 的定位接近，优势是国内网络无需折腾、中文体验完整；如果想要终端形态的国产工具，看《Qwen Code 安装与使用》。
⏳ 时效提示：积分政策与 SOLO 模式的免费范围变动较快，本页信息最后核对于 2026 年 9 月，以官网为准。
1. 下载与安装
- 打开官网下载页，选择 macOS 或 Windows 安装包；
- 安装过程与普通桌面软件一致；
- 已有 VS Code 的用户，首次启动可以选择导入插件、主题和快捷键配置，迁移成本很低。
2. 登录
启动后用手机号或账号登录即可。新用户通常会赠送积分，用于抵扣 AI 用量；积分消耗速度和免费范围随版本调整，在设置里能查看剩余量。
3. 先分清三种用法
Trae 里最容易迷糊的是模式选择。按任务选：
| 用法 | 适合 | 特点 |
|---|---|---|
| 普通编辑 + 补全 | 已有项目的日常修改 | AI 建议穿插在编辑流程里，逐条确认 |
| Builder 模式 | 从零搭一个小应用 | 对话式生成项目结构与页面，边生成边预览 |
| SOLO 模式 | 端到端交给 AI 自主开发 | AI 自主拆解并执行任务，你负责提需求和验收 |
新手最常见的错误是用 SOLO 去改一个复杂的老项目。SOLO 适合目标清晰的新任务，已有项目的改动用普通模式或 Builder 更可控。
4. 第一次真实任务
4.1 从零做一个小工具（Builder / SOLO）
- 新建项目，切换到 Builder 模式；
- 用一段话写清需求、页面内容和验收方式，例如：
text
做一个个人书签管理页：可以添加、删除书签，按标签筛选，数据保存在本地。
做完后我自己打开页面逐项检查这四个功能。- 生成后自己跑起来，逐项对照验收，再让 AI 修不对的地方。
4.2 改一个已有项目（普通模式）
- 打开本地项目文件夹；
- 先让 AI 解释："这个项目的入口、结构和主要逻辑是什么？";
- 再交代具体改动，每次只改一处，改完自己验证。
5. 验收清单
- [ ] AI 的每处修改你都看过差异，而不是只看最后结果；
- [ ] 项目真的跑起来验证过，不是"看起来对了"；
- [ ] 生成失败或报错时，把报错原文发给 AI，而不是重新描述一遍；
- [ ] 敏感信息（密钥、客户数据）没有放进对话。
6. 常见问题
6.1 积分消耗比预期快
SOLO 模式自动化程度高，同样消耗也大。日常小改动用普通编辑 + 补全基本不耗积分；把 SOLO 留给目标清晰的新任务。
6.2 SOLO 模式提示无权限或收费
SOLO 的免费范围随版本调整过多次，以官网说明为准；确认当前账号的套餐与活动状态。
6.3 想要终端 Agent 形态
Trae 是图形界面 IDE。需要命令行工作流时，用《Qwen Code 安装与使用》或《Claude Code 全平台安装》。