TRAE IDE 安装与使用指南

TRAE（The Real AI Engineer）是字节跳动推出的 AI 原生 IDE，国内版（trae.cn）完全免费、内置国产大模型；国际版（trae.ai）支持 Claude/GPT 等。本文以国内版 TRAE IDE 为主。

产品概览

安装步骤

1. 下载

访问 trae.cn 或 下载页，点击 「下载 IDE」：

2. 安装

Windows：

1. 双击 Trae CN-Setup-x64.exe
2. 安装路径选纯英文目录，如 D:\Trae
3. Defender 提示时选「仍要运行」

macOS：

1. 拖入「应用程序」
2. 若提示「无法验证开发者」：系统设置 → 隐私与安全性 → 仍要打开
3. 或终端执行：

# 解除 macOS 隔离属性（TRAE 安装后无法打开时使用）
sudo xattr -rd com.apple.quarantine /Applications/Trae.app

Linux：

# Debian/Ubuntu 安装 .deb 包
sudo dpkg -i trae_*.deb

# Fedora/RHEL 安装 .rpm 包
sudo rpm -i trae-*.rpm

3. 初始设置

首次启动按向导完成：

1. 选择语言 — 简体中文 / English
2. 选择主题 — 深色 / 浅色
3. 导入配置 — 可从 VS Code 或 Cursor 导入扩展与设置
4. 安装命令行 — 推荐安装 trae 命令

# 终端用 TRAE 打开项目
trae .
trae ~/my-project

4. 登录

国内版使用手机号验证码登录（支持抖音、苹果、掘金等账号绑定）。登录后 AI 功能才可用，无需信用卡。

5. 验证

1. 打开或新建项目
2. 在编辑器中写代码，观察 AI 补全
3. 打开 AI 对话面板，发送「解释当前文件」

核心功能与用法

IDE 模式 vs SOLO 模式

在界面左上角切换：

AI 对话与补全

• 补全：写代码时自动建议，Tab 接受
• 对话：选中代码后右键「询问 AI」，或打开侧边栏聊天
• @ 引用：引用文件、文件夹作为上下文

内置模型切换

在模型选择器中按任务切换：

智能体（Agent）

TRAE 提供内置智能体，也可自定义：

1. 配置系统提示词与工具集
2. 绑定 MCP Server 扩展能力
3. 复杂任务交给 Agent 多步执行

MCP 集成

Model Context Protocol 让智能体访问数据库、API、文档等外部工具。在设置中添加 MCP Server 即可扩展 Agent 能力。

优缺点分析

优点

缺点

国内版 vs 国际版选型

常见问题

延伸阅读

• 编程工具专栏总索引
• TRAE Work CN 指南
• Cursor 指南
• 官方文档

本文由 xueyise 创作，AI 编程工具专栏。