Trae 橙皮书上手与进阶指南

如何使用本书：本书允许你免费下载、传播、翻译、改编，但必须署名作者并保持相同协议开源，禁止任何形式的"封装售卖"或"去名转售"。

这本书是写给谁的

• 完全没听过 Trae，但听说"国内有个免费的 AI 编程工具"，想找一个能"替自己干活"的 AI 工具的人。
• 用过 ChatGPT、文心、豆包、Kimi、DeepSeek，发现"它知道很多但做不了什么实事"，正在寻找下一站的人。
• 销售、运营、市场、HR、设计师、产品经理、行政、自由职业者——任何想让"重复劳动 / 数据搬运 / 文档整理 / 报表生成"自动化的上班族。
• 想做一个个人小工具、个人小程序、个人网站、甚至自己的副业 SaaS 的非程序员。
• 想给爸妈、给伴侣、给团队配一个"中文 AI 小工程师"的人。
• 听过 Cursor、Claude Code、Copilot 但被英文界面、付费门槛、网络问题劝退过的人。
• 已经会写一点点代码、想从此告别"复制粘贴 Stack Overflow"的初级开发者。

如果你属于以上任何一类，你来对地方了。

这本书不是什么

• 不是 Trae 的 API 文档，也不是源码导读。
• 不是面向资深工程师的"高级架构剖析"。
• 不是堆术语、堆参数、堆截图的"功能罗列"。
• 不是"AI 取代程序员"或"AI 焦虑营销"的内容。

它是一本实战手册。每一章都让你"打开 Trae 跟着做"，做完就能立刻看到效果。

为什么是 Trae（而且为什么是国内版）

2026 年，AI 编程工具已经多如牛毛——Cursor、GitHub Copilot、Claude Code、v0、Lovable、Bolt、Replit Agent、Windsurf、CodeBuddy、通义灵码…… 为什么我们要专门写一本面向"中国普通人"的 Trae 橙皮书，而且重点放在国内版？

因为 Trae 国内版在所有这些工具里，做对了三件中国普通人最关心的事：

1. 完全免费、零门槛——不需要订阅、不需要绑信用卡、不需要信用卡、不需要科学上网，手机号一键登录就能用，模型上 DeepSeek R1/V3、豆包 1.5-pro，完全不限次数。
2. 中文是它的母语——界面、菜单、报错信息、对话、代码注释、提示词全部使用中文，你用大白话写"我想做一个记账网页"，它就能听懂，不需要纠结"prompt 写得够不够英文化"。
3. 它是一个真正的 IDE，不是聊天框——基于 VS Code 深度定制，AI 能看到整个项目、跨文件改动、跑命令、看浏览器、读 Excel、生成图、调 Figma，是一个能动手的"工程师"，不是只能在右边给建议的"助手"。

再加上字节跳动是国内最不缺算力的公司，国内版的响应速度、稳定性、和持续更新都有保障。对于"想试试 AI 编程但又被门槛劝退"的中国普通人，Trae 国内版几乎是 2026 年的最优解。

你将获得什么

读完整本书并跟着做完练习，你会：

1. 真正理解 Trae 是什么、和 ChatGPT / Cursor / Copilot 有什么本质差别、它能不能解决你的问题。
2. 在自己的电脑上把 Trae 跑起来，登录手机号，找到中文界面，不再被任何"配置"问题卡住。
3. 学会用 Chat、Builder、SOLO 三种工作模式，分清楚"什么时候该用哪一个"。
4. 看懂豆包 1.5-pro 和 DeepSeek R1 / V3 的差别，知道做什么任务该选哪个模型。
5. 写出让 Trae 稳定执行的提示词，并通过 #File、#Folder、#Web、#Doc 把"上下文"喂得明明白白。
6. 用 .trae/rules/ 把你的偏好"写进它的脑子"，它会按你的习惯、术语、风格写代码。
7. 把至少 7 个生活场景 + 8 个工作场景交给 Trae 自动化，比如周报、客户跟进表、PDF 拆合、Excel 透视、个人简历网站等。
8. 学会用 Trae 的 MCP 市场，让 Trae 接入你的 Figma、飞书、Notion、GitHub、PostgreSQL 等真实工作工具。
9. 创建你自己的"AI 小团队"——把"前端工程师""文案策划""数据分析师""设计师"做成几个自定义智能体，让它们配合干活。
10. 把一个"想法"端到端做成"上线产品"——本地预览、Vercel 部署、买域名，发给真人用。
11. 知道怎么把 Trae 用得安全、隐私不泄露、API Key 不被偷、不会因为模型乱跑命令把电脑弄坏。
12. 避开新手最容易踩的 8 大坑。
13. 如果你愿意，还能开始把 Trae 用成一个"长期生产力系统"，做副业、做内部工具，甚至变成一个 Indie Hacker。

阅读路径建议

这本书一共 1 个序言 + 12 章 + 5 个附录，全书约 11 万字。你不必从头读到尾，下面几条路径任选其一。

路径 A：完全新手（推荐）

按章节顺序从 00 序言 一路读到 12 避坑指南与持续成长，每章跟着做完再看下一章。预计 1 个周末看完，跑通整套体验。

路径 B：只想立刻用起来

• 02 五分钟快速上手
• 03 三种工作模式
• 05 学会和它对话
• 附录 B 30 个开箱即用提示词

预计 1 小时跑通，先用起来再说。

路径 C：已经会用，想进阶

• 06 给 Trae 立规矩
• 09 MCP 与扩展能力
• 10 自定义智能体与 AI 团队
• 11 从想法到上线

预计 1 个晚上读完，立刻让生产力翻倍。

路径 D：想给爸妈、给团队挑工具的"决策者"

• 01 认识 Trae 的"自检清单"
• 07 生活场景实战 的"给爸妈做的一键工具"
• 08 工作场景实战 的"团队内部工具"
• 12 避坑指南与持续成长

路径 E：非程序员、想直接做出"自己的小产品"

• 02 五分钟快速上手
• 03 三种工作模式 的 Builder 实战
• 08 工作场景实战 的"个人 SaaS 雏形"
• 11 从想法到上线
• 附录 E 100 项达成清单 跟踪自己的成长

完整目录

如何使用这本书

1. 先看「30 秒导读」：每一章开头都有一段 30 秒就能读完的导读，告诉你这章在解决什么问题、做完会得到什么。如果不感兴趣，可以直接跳过。
2. 跟着「先做这一步」：所有命令、配置、提示词都给了完整可复制版本，建议至少跑通一次，再回头看原理。
3. 对照「本章一图回顾」：章末的小结帮你把这章串成一条线，方便日后翻查。
4. 遇到报错先翻附录：80% 的常见报错都收录在 第十二章 避坑指南 与 附录 A 快捷键与常用操作速查表 里。

本书使用约定

• 代码块：可以直接复制到终端、提示词输入框或配置文件里运行的内容。
• 「引号」：界面上的按钮、菜单或选项名称。
• 粗体：值得你停下来重点理解的关键词。
• 命令前面的 $ 表示这是终端里输入的命令，复制时不要带 $。
• 出现 ~/.trae/ 路径时，~ 代表你的用户主目录（macOS 是 /Users/你的名字/，Windows 是 C:\Users\你的名字\）。
• 快捷键格式统一使用 Cmd+L（macOS）/ Ctrl+L（Windows、Linux），后续章节有时只写 Cmd+L，请读者按系统对换。
• 模型相关的描述以 2026 年 4 月的可用版本为准，后续模型更新会在版本变更里同步。
• 截图较少，更多依赖文字描述操作路径，方便你在不同 Trae 版本中也能找到对应位置。

本书风格的小约定

• 我们假设你不是程序员，但愿意学一点点新东西。所有名词第一次出现都给"白话解释"。
• 我们不会让你"先理解原理再动手"，恰恰相反，我们让你先动手做出一个能跑的东西，再回头讲为什么。
• 我们不推荐你"先订阅 Pro 再说"。整本书 90% 的内容用 Trae 国内版（免费档）就能跑通，每章都标注"是否需要付费"。
• 我们也不会假装 Trae 没缺点。第十二章会老老实实告诉你它在哪些场景会让你失望、什么时候应该用别的工具。

一句话总结

这本书要做的事情只有一件：让你这个普通人，不靠任何技术背景、不花一分钱、不需要科学上网，也能把 Trae 用得比 90% 的同类用户都好——而且越用越好。

准备好了吗？翻开 00 序言 开始吧。

版本与变更

后续如有新增 / 勘误，会在本表追加，并在每章相关段落加 （v1.x 更新） 标注。

通用版工具箱（附录卷）

本书是 Trae 的"产品专属指南"。如果你想要一份跨工具、不绑定任何产品的"通用 AI 工具箱"——100 个通用提示词、150+ AI 黑话翻译、30 天通用打卡计划、50 个高频 FAQ、安全红线、家庭 AI 公约——请翻 《AI 橙皮书（附录卷）：通用 AI 工具箱》。

它和本书是"互补"的：本书讲 "Trae 怎么用"，附录卷讲 "任何 AI 都通用的方法"——换工具不卡壳。

版权与署名

• 本书根据 CC BY-SA 4.0 协议开源，欢迎转载、翻译、改编。
• 转载请注明原书《Trae 橙皮书：上手与进阶指南》及原始仓库地址。
• 改编版本必须保持同一协议开源。
• 商业用途（如纳入付费课程、纸质出版、收费社群）请先联系作者邮箱获取授权。

如果这本书帮到了你，最好的"赞赏"就是把它转发给一位被重复劳动压垮的朋友——也许他下周就因为你这个动作，每天多睡了 30 分钟。