Trae 安装与配置：10 分钟上手指南

开篇：10 分钟，从零到第一次 AI 对话

上一篇我们聊了 Trae 是什么。这篇文章不废话，直接带你把 Trae 装好、配好、用起来。整个过程不超过 10 分钟。

下载安装

第一步：获取安装包

打开浏览器，访问 Trae 官网：

# Trae 官网
https://trae.ai

目前 Trae 支持两个平台：

平台	支持状态	芯片架构
macOS	✅ 支持	Intel / Apple Silicon
Windows	✅ 支持	x64
Linux	❌ 暂不支持	-

如果你是 Linux 用户，目前只能等待官方支持，或者考虑在虚拟机中使用。

第二步：安装

macOS 用户下载 .dmg 文件后：

# 1. 双击 .dmg 文件挂载
# 2. 将 Trae 拖入 Applications 文件夹
# 3. 首次打开可能需要在"系统设置 > 隐私与安全性"中允许

# 如果遇到"无法验证开发者"的提示：
sudo xattr -rd com.apple.quarantine /Applications/Trae.app

Windows 用户下载 .exe 安装程序后，双击运行，按提示完成安装即可。

第三步：安装 CLI 命令

安装完成后，你可以配置命令行工具，方便从终端启动 Trae：

# 在 Trae 中打开命令面板
# macOS: Cmd + Shift + P
# Windows: Ctrl + Shift + P

# 输入并选择：
Shell Command: Install 'trae' command in PATH

配置完成后，你就可以在终端中使用 trae 命令了：

# 启动 Trae
trae

# 打开指定项目
trae ~/projects/my-app

# 打开指定文件
trae ~/projects/my-app/src/index.ts

首次启动：导入已有配置

第一次启动 Trae 时，它会询问你是否要导入已有的编辑器配置。这是一个非常贴心的功能。

支持导入的编辑器

{
  "importSources": [
    {
      "editor": "VS Code",
      "imports": ["设置", "扩展", "快捷键", "代码片段"]
    },
    {
      "editor": "Cursor",
      "imports": ["设置", "扩展", "快捷键"]
    }
  ]
}

导入步骤

1. 首次启动时选择”Import from VS Code”或”Import from Cursor”
2. Trae 会自动检测并列出可导入的配置项
3. 勾选你需要的配置，点击”Import”
4. 等待导入完成，重启 Trae

如果你之前没用过 VS Code 或 Cursor，直接跳过这一步，使用默认配置即可。

界面布局

Trae 的界面和 VS Code 非常相似，但多了几个 AI 专属区域：

┌─────────────────────────────────────────────────┐
│  菜单栏                                          │
├──────┬──────────────────────┬───────────────────┤
│      │                      │                   │
│ 活动 │                      │   AI 面板          │
│ 栏   │    编辑器区域          │   ┌─────────────┐ │
│      │                      │   │ Chat Mode   │ │
│ ┌──┐ │                      │   │             │ │
│ │📁│ │                      │   │ Builder     │ │
│ │🔍│ │                      │   │ Mode        │ │
│ │🔀│ │                      │   │             │ │
│ │🧩│ │                      │   │ 输入框       │ │
│ │🤖│ │                      │   └─────────────┘ │
│ └──┘ │                      │                   │
├──────┴──────────────────────┴───────────────────┤
│  终端 / 输出 / 问题                               │
├─────────────────────────────────────────────────┤
│  状态栏                                          │
└─────────────────────────────────────────────────┘

关键区域说明：

区域	位置	功能
活动栏	最左侧	文件、搜索、Git、扩展、AI
编辑器区域	中央	代码编辑主区域
AI 面板	右侧	Chat 和 Builder 交互区
终端面板	底部	集成终端、输出、问题
状态栏	最底部	当前模型、语言、编码等信息

登录与账户设置

要使用 Trae 的 AI 功能，你需要登录账户：

1. 点击左下角的用户图标
2. 选择登录方式（Google、GitHub 或邮箱）
3. 完成验证后自动返回 Trae

# 登录后可以在设置中查看账户信息
# 打开设置：Cmd + , (macOS) / Ctrl + , (Windows)
# 搜索 "Trae Account"

查看使用额度

登录后，你可以在账户页面查看当前套餐的使用情况：

{
  "account": {
    "plan": "Free",
    "usage": {
      "chatMessages": "142 / 500",
      "builderTasks": "8 / 20",
      "codeCompletions": "无限制"
    },
    "billingCycle": "2026-03-01 ~ 2026-03-31"
  }
}

模型选择与配置

Trae 支持多个 AI 模型，切换方式非常简单。

切换模型

在 Chat 或 Builder 的输入框底部，你会看到当前使用的模型名称。点击它就能切换：

┌─────────────────────────────────┐
│ 输入你的问题...                   │
│                                 │
│ [Claude 3.7 Sonnet ▼] [发送]    │
└─────────────────────────────────┘

模型推荐

不同场景下，我建议使用不同的模型：

场景	推荐模型	原因
日常编码问答	Claude 3.5 Sonnet	速度快，质量够用
复杂逻辑实现	Claude 3.7 Sonnet	推理能力最强
快速原型	GPT-4o	响应速度快
算法与推理	DeepSeek R1	推理链清晰

常用快捷键速查表

这些快捷键你一定要记住，它们会大幅提升你的效率：

AI 相关快捷键

功能	macOS	Windows
打开 AI Chat	Cmd + L	Ctrl + L
打开 Builder	Cmd + B	Ctrl + B
Inline Edit	Cmd + I	Ctrl + I
代码补全接受	Tab	Tab
代码补全拒绝	Esc	Esc
将选中代码发送到 Chat	Cmd + Shift + L	Ctrl + Shift + L

编辑器通用快捷键

功能	macOS	Windows
命令面板	Cmd + Shift + P	Ctrl + Shift + P
快速打开文件	Cmd + P	Ctrl + P
全局搜索	Cmd + Shift + F	Ctrl + Shift + F
打开终端	Cmd + `	Ctrl + `
多光标	Cmd + D	Ctrl + D
格式化文档	Shift + Option + F	Shift + Alt + F

第一次 AI 对话

一切准备就绪，让我们来完成第一次 AI 对话。

用 Chat 写一个 Hello World

1. 按 Cmd + L 打开 Chat 面板
2. 输入以下内容：

帮我用 TypeScript 写一个简单的 HTTP 服务器，返回 "Hello World"

3. Trae 会生成类似这样的代码：

import { createServer, IncomingMessage, ServerResponse } from 'http';

const PORT = 3000;

const server = createServer(
  (req: IncomingMessage, res: ServerResponse) => {
    res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
    res.end('Hello World');
  }
);

server.listen(PORT, () => {
  console.log(`服务器运行在 http://localhost:${PORT}`);
});

4. 点击代码块右上角的”Apply”按钮，代码会自动插入到当前文件
5. 或者点击”Copy”复制到剪贴板

继续对话

你可以继续追问：

帮我加上路由功能，支持 /api/users 和 /api/posts 两个端点

Trae 会基于之前的对话上下文，在原有代码基础上扩展。

中文界面设置

Trae 默认是英文界面。如果你想切换到中文：

# 方法一：通过命令面板
# 1. Cmd + Shift + P
# 2. 输入 "Configure Display Language"
# 3. 选择 "中文(简体)"
# 4. 重启 Trae

# 方法二：安装中文语言包
# 1. 打开扩展面板 (Cmd + Shift + X)
# 2. 搜索 "Chinese (Simplified)"
# 3. 安装 "Chinese (Simplified) Language Pack"
# 4. 重启 Trae

推荐的初始配置

以下是我推荐的一些初始设置，可以在 settings.json 中配置：

{
  "editor.fontSize": 14,
  "editor.lineHeight": 1.6,
  "editor.minimap.enabled": false,
  "editor.wordWrap": "on",
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "terminal.integrated.fontSize": 13,
  "workbench.colorTheme": "One Dark Pro",
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 1000
}

打开设置文件的方式：

# macOS
# Cmd + Shift + P → "Open User Settings (JSON)"

# 或者直接编辑文件
# macOS: ~/Library/Application Support/Trae/User/settings.json
# Windows: %APPDATA%\Trae\User\settings.json

验证安装

最后，让我们确认一切正常：

# 检查 CLI 是否可用
trae --version

# 打开一个测试项目
mkdir -p ~/trae-test && trae ~/trae-test

在 Trae 中：

1. ✅ 能打开文件和编辑代码
2. ✅ 能打开 AI Chat 面板（Cmd + L）
3. ✅ 能发送消息并收到 AI 回复
4. ✅ 能在终端中执行命令

如果以上都没问题，恭喜你，Trae 已经准备就绪了。

小结

安装和配置 Trae 的过程非常简单，基本上就是下载、安装、登录三步。如果你之前用过 VS Code，你会发现 Trae 的上手成本几乎为零。

下一篇文章，我们会深入 Chat Mode 和 Inline Edit，看看如何在日常编码中高效使用 AI。

“工具的价值不在于它有多强大，而在于你用它的第一分钟就能感受到效率的提升。”