02 · 安装与登录

3 分钟装好 Trae，根据你的情况选择国内版或国际版。

01 先决定：装哪个版本

在动手安装之前，花 10 秒做一个选择：

两个版本的安装步骤几乎一样，只是下载地址不同。下面以国际版为例演示，国内版把网址换成 trae.cn 即可。

02 三步安装

macOS

# 方式一：官网下载（推荐）
# 国际版：打开 https://trae.ai → 点击 Download
# 国内版：打开 https://trae.cn → 点击 下载
# 下载 .dmg 文件 → 双击 → 拖入 Applications
 
# 方式二：Homebrew（国际版）
brew install --cask trae

安装后建议配置命令行工具：

1. 打开 Trae
2. 按 Cmd+Shift+P
3. 输入 install command
4. 选择 “Install ‘trae’ command in PATH”
5. 终端验证：trae --version

Windows

# 官网下载 .exe 安装包 → 双击 → 按向导完成
# 国际版：https://trae.ai
# 国内版：https://trae.cn

安装时自动注册 PATH 和右键菜单。

Linux

# 下载 .AppImage 文件（从 trae.ai 或 trae.cn）
chmod +x trae-*.AppImage
./trae-*.AppImage
 
# 或使用 .deb / .rpm 包
sudo dpkg -i trae_*.deb    # Debian/Ubuntu
sudo rpm -i trae_*.rpm     # Fedora/RHEL

03 登录与认证

国内版（trae.cn）

支持以下登录方式：

• 手机号 → 验证码登录（最常用）
• 抖音账号 → 扫码登录
• 火山引擎账号 → 企业用户

首次打开 Trae 国内版 → 点击「登录」→ 输入手机号 → 输入验证码 → 完成。

国际版（trae.ai）

支持以下登录方式：

• 邮箱 → 验证码登录
• Google 账号 → OAuth 授权
• GitHub 账号 → OAuth 授权

首次打开 Trae 国际版 → 点击「Sign In」→ 选择登录方式 → 完成。

注意：国内版和国际版的账号体系不互通。你在 trae.cn 注册的账号不能在 trae.ai 用，反之亦然。

04 选择订阅方案

国内版定价

国内版目前以免费为主，Pro 解锁国际顶级模型。

国际版定价（2026 年 token 计费制）

Trae 在 2026 年 2 月从按请求计费改为按 token 计费。基础额度用完后按量付费。以 GPT-5.4 为例：

• 输入：$2.50/百万 token
• 输出：$15.00/百万 token

新手建议：国内版直接免费开始；国际版先用 Free，觉得不够再升 Pro（$10/月）。

国际版新用户绑定支付方式后有 7 天 Pro 试用。

05 代理配置（国内用户可能需要）

如果你使用国际版且在国内，需要配置代理才能正常连接 AI 服务。

Trae 默认跟随系统代理。如需单独配置：

1. 打开 Trae → Cmd+Shift+P → Preferences: Open User Settings (JSON)
2. 添加：

{
  "trae.http.proxy": "http://127.0.0.1:7890"
}

替换端口号为你代理软件的实际端口。

国内版（trae.cn）走字节自己的火山引擎网络，不需要额外配置代理——这也是国内版的一大优势。

06 安装后第一件事

导入 VS Code 配置

和 Cursor 一样，Trae 基于 VS Code 内核，支持一键导入：

1. 打开 Trae
2. Cmd+Shift+P → 输入 Import VS Code Settings
3. 勾选要导入的内容（设置、快捷键、插件、主题）
4. 等待完成

你的 VS Code 主题、快捷键、插件，全部直接搬过来。

安装命令行工具

花 10 秒注册 trae 命令：

1. Cmd+Shift+P → 输入 install command
2. 验证：trae --version

跑一次诊断

Trae 自带诊断工具，先跑一遍确保环境正常：

# 在终端
trae --doctor

会检查：网络连接、模型可用性、插件兼容性、系统依赖等。

07 小结

下一篇：03 核心概念 —— 理解 Trae 的三大模式和 Agentic Loop 原理。