快速开始
本指南将帮助你在 10 分钟内完成 Trae 的安装和基础配置，快速上手 AI 辅助开发。
安装 Trae
下载安装
bash
# macOS
brew install --cask trae
# Windows
winget install ByteDance.Trae
# 或访问官网下载
# 海外版：https://traeide.com
# 国内版：https://trae.cn配置 AI 模型
首次启动 Trae 后，需要选择并配置 AI 模型：
海外版可用模型：
- Gemini 系列：Gemini-3-Pro-Preview、Gemini-2.5-Pro、Gemini-3-Flash-Preview
- GPT 系列：GPT-5.3-Codex、GPT-5.2-Codex、GPT-5.2、GPT-5.1、GPT-5-medium
- Kimi：Kimi-K2-0905
模型选择建议：
- 代码生成任务：推荐 Gemini-3-Pro-Preview 或 GPT-5.3-Codex
- 快速响应场景：推荐 Gemini-3-Flash-Preview
- 大型项目（需要长上下文）：推荐 Kimi-K2-0905（支持 200K tokens）
- 国内用户：推荐豆包 Pro（免费且中文支持优秀）
基础配置
1. 创建项目规范文件
在项目根目录创建 .rules 文件，定义项目的技术栈、代码规范和约束条件：
markdown
# 项目规范
## 技术栈
- 后端：Node.js 20 + TypeScript 5
- 数据库：PostgreSQL + Prisma
- 测试：Jest
## 代码规范
- 使用 async/await
- 函数长度 < 50 行
- 测试覆盖率 > 80%
## 禁止
- ❌ 不使用 any 类型
- ❌ 不使用 console.log
- ❌ 不硬编码配置2. 配置 AI 设置
打开 Trae 设置面板（Cmd/Ctrl + ,），配置以下选项：
- AI Chat Language：选择 Auto（自动检测）、中文或 English
- Code Index：项目文件数 ≤ 5000 时自动启用，超过则需手动启用
- MCP 协议：v1.3.0+ 版本支持 Model Context Protocol 扩展工具
工作模式
Builder Mode - 自主执行模式
Builder Mode 适用于新项目初始化、复杂功能开发、多文件协同任务等场景。在此模式下，AI 会自主分解任务、读取相关文件、执行命令并生成代码。
使用方法：
bash
# 在 Chat 窗口顶部切换到 Builder 模式
"创建用户认证 API
- JWT Token
- bcrypt 密码加密
- 包含单元测试"Chat Mode - 交互式问答模式
Chat Mode 适用于代码审查、Bug 修复、代码重构等需要精细控制的场景。在此模式下，你可以逐步与 AI 交互，对每个建议进行审核和控制。
用法：
bash
# 选中代码，Cmd/Ctrl + U 打开 Chat
"优化这个查询的性能
- 减少数据库查询次数
- 添加缓存
- 目标响应时间 < 100ms"
# 接受：Cmd/Ctrl + Enter
# 拒绝：Cmd/Ctrl + Backspace上下文控制命令
通过上下文命令，你可以精确控制 AI 读取哪些文件和目录，优化上下文使用效率。
用法：
bash
# Code Index 智能检索
#Workspace 实现用户登录功能
# 指定目录
#Folder:src/auth 优化认证流程
# 单个文件
@file:src/utils/jwt.ts 这个 JWT 工具有什么问题？实战案例
案例 1：创建 REST API（Builder Mode）
bash
"创建用户管理 API
技术栈：Express + TypeScript + Prisma
功能：
- GET /users - 获取用户列表（分页）
- POST /users - 创建用户
- PUT /users/:id - 更新用户
- DELETE /users/:id - 删除用户
要求：
- JWT 认证
- 输入验证（Zod）
- 单元测试覆盖率 > 90%"Trae 将自动完成以下步骤：需求分析、文件读取、代码生成、依赖安装、测试执行、Bug 修复。
案例 2：性能优化（Chat Mode）
bash
# 选中慢查询代码，Cmd+U 打开 Chat
"这个查询太慢了（2秒），优化到 < 200ms
当前问题：
- N+1 查询
- 没有索引
- 加载了不需要的字段
参考：@file:src/services/PostService.ts 的优化方式"
# 给出方案后
# Cmd+Enter 接受 / Cmd+Backspace 拒绝案例 3：Code Index 全局检索（#Workspace）
bash
# 5000 文件以下自动索引，超过需要手动开
#Workspace 找出所有使用了 deprecated API 的地方
# Trae 将基于 Code Index 快速检索整个项目，定位所有相关代码位置并提供修复建议性能优化技巧
提示词缓存机制
markdown
# 固定前缀（会被缓存，节省 90% 成本）
[系统提示词]
[项目规范 .trae/rules.md]
# 变化部分
[具体任务]上下文管理
Trae 内置自动上下文管理机制，会在必要时自动压缩和优化上下文。
常见问题
Q: Builder Mode 和 Chat Mode 如何选择？
Q: 如何提高生成代码的质量？
通过配置 .rules 文件定义项目规范，启用 Code Index 进行智能检索，使用 Builder Mode 自动执行测试验证。
Q: 国内版和海外版有什么区别？
| 特性 | 海外版 | 国内版 |
|---|---|---|
| 模型 | Gemini/GPT/Kimi | 豆包/通义 |
| 价格 | 14天免费试用 | 完全免费 |
| 速度 | 快 | 更快 |
| 中文 | 好 | 更好 |
| 上下文 | 最高 200K (Kimi) | 视模型而定 |
下一步
如果你已有 AI 辅助开发经验，可以直接阅读 上下文工程 了解高级优化技巧。