Trae 上手：免费中文 IDE + SOLO 自主模式完整指南

最后更新 2026-06-25

你将学到

安装 Trae 并完成账号登录，不卡在配置环节
用对话模式完成一次改代码、看到结果的完整循环
理解 Builder 和 SOLO 模式的区别，能用 SOLO 交出一个完整小任务
独立排查登录失败、中文乱码、SOLO 卡住这几类常见问题

有朋友刚开始学 AI 编程，装了 Cursor 试了一下，发现要配 API Key、要充值，英文界面看着也费劲，就放弃了。后来发现了 Trae——装上去，中文界面，登录就能用，操作习惯和 VS Code 几乎一样。第一天就用它改了一个小脚本的 bug。

这就是很多中文用户选 Trae 作为起点的原因：门槛低，不需要先过一遍英文文档才能入门。

这篇从安装开始，带你把 Trae 的核心功能真正跑通，包括让很多人感兴趣但不清楚怎么用的 SOLO 模式。

Trae 是什么

Trae 是字节跳动推出的 AI IDE。它的定位是：给你一个带 AI 的编辑器，而不是让你去学一个全新的工具。

几个关键特征：

界面和 VS Code 几乎一样。插件生态、快捷键、设置面板，熟悉 VS Code 的人基本不用重新学习操作。
中文界面，中文文档。菜单、提示、报错说明默认中文，减少了一层认知负担。
内置 AI 对话和代码生成，不需要单独安装插件或配置第三方 API。
SOLO 模式：这是 Trae 的特色功能，让 AI 自主完成一个任务——分析、计划、写代码、运行验证，一条龙，你只在关键节点确认。

具体哪些功能免费、额度怎么算，以 Trae 官方说明为准（截稿 2026-06）。

和 Cursor 有什么不一样

很多人在 Trae 和 Cursor 之间纠结，简单说清楚区别：

维度	Trae	Cursor
价格	内置模型免费可用	付费订阅为主，有限免费额度
界面语言	中文为主	英文为主
基础	VS Code 兼容	VS Code 套壳
自主模式	SOLO 模式	Agent 模式
适合场景	中文用户入门、预算有限	深度用户、团队协作

两个工具没有绝对的好坏，看你的使用场景。Cursor 的详细上手见 2.4。

Claude Code 则完全不同——它是命令行工具，跑在终端里，没有编辑器界面，适合习惯终端操作的人。工具全景对比见 2.1。

安装与登录

第一步：下载安装包

去 trae.ai 下载对应平台的安装包。支持 Windows、macOS、Linux。

安装过程和普通软件一样，按提示完成即可。

第二步：登录账号

Trae 启动后会引导你登录。支持：

字节跳动账号（抖音、今日头条等）
GitHub 账号
邮箱注册

选你最方便的方式。登录完成后，界面右下角或设置面板会显示当前账号信息。

你应该看到什么：登录成功后，主界面加载完毕，左侧文件树、底部状态栏、右侧 AI 面板都正常显示。如果 AI 面板显示"已连接"或类似状态，说明可以开始用了。

第三步：打开你的项目

和 VS Code 一样：文件 → 打开文件夹，选择你的项目目录。

或者命令行启动：

# 先 cd 进项目目录
cd /path/to/your/project
trae .

为什么要进项目目录再开：Trae 的 AI 功能依赖对当前项目的理解——它会扫描文件结构、读取 package.json / requirements.txt 等配置。在空目录或家目录启动，AI 能帮的事情会少很多。

导入 VS Code 配置（可选）

如果你之前用 VS Code，Trae 提供了一键导入功能：设置 → 导入配置 → 选择 VS Code 配置文件。

主题、快捷键、常用插件可以一并迁移过来，不用重新调。

核心用法：对话改代码

Trae 的 AI 功能主要通过右侧的 AI 面板使用。

对话模式（Chat）

点击右侧面板的「对话」或「Chat」标签，就是一个对话框。用法和你熟悉的 AI 助手类似，但有几个关键差异：

它知道你当前项目是什么。你不需要把代码复制粘贴进去，可以直接说：

这个 utils.py 里的 calculate_total 函数有 bug，帮我看一下

它会自己去读文件，分析问题，给出修改建议。

可以直接应用修改。它给出代码改动后，有一个「应用」按钮，点击就把改动写进文件。不需要你手动复制粘贴。

引用文件或代码片段。在输入框里用 @ 符号可以引用特定文件：

@src/app.js 帮我加一个错误处理

这样 AI 会优先关注这个文件，而不是扫全项目。

你应该看到什么：AI 回复里会有高亮的代码块，旁边有「应用到文件」按钮。点击后，编辑器里该文件会显示 diff 视图——绿色是新增，红色是删除。确认没问题，接受改动；不满意，拒绝并继续对话。

SOLO 模式：让 AI 自主完成任务

SOLO 是 Trae 区别于普通 AI 补全工具的核心功能。它的逻辑是：你描述目标，AI 自己规划步骤、执行、验证，你在关键节点确认就行。

怎么启动 SOLO

在 AI 面板里找到「Builder」或「SOLO」标签（不同版本入口名称可能略有差异），或者在对话框里选择「Agent 模式」类似选项。

输入一个明确的任务目标，比如：

帮我写一个 Python 脚本，读取 data.csv，统计每个城市的销售总额，输出到 output.csv

SOLO 的执行过程

启动后，Trae 会：

分析任务：理解你的需求，拆成子任务。
列出计划：告诉你它打算做什么，创建哪些文件、运行什么命令。
等你确认：这一步别跳过——看一遍计划，确认方向对了再继续。
自主执行：创建文件、写代码、运行脚本验证输出。
遇到问题自己处理：如果运行报错，它会读错误信息，修改代码，重新运行，不需要你介入。
完成后汇报：告诉你做了什么，结果是什么，有没有需要注意的地方。

你应该看到什么：执行过程中，左下角或底部状态栏会显示当前步骤；文件树里会出现新建的文件；终端面板里能看到 AI 运行的命令和输出。整个过程你可以随时暂停或中断。

SOLO 适合什么任务

SOLO 在任务边界清晰的时候效果最好：

「给这个目录下所有 Python 文件加上类型注解」
「把这个 REST API 加上单元测试」
「把这段 JavaScript 重构成 TypeScript」

边界模糊的任务（「帮我做一个网站」）容易让 SOLO 走偏。拆细一点再交给它。

确认节点不要跳过

SOLO 执行前会展示计划，一定要看。它偶尔会误解需求——比如你说"重构"，它可能理解成"重写"，把你原有的逻辑删掉。在计划阶段发现问题，补充说明修正；等它执行完再改，成本高很多。

适合谁用

Trae 不是人人都适合的工具，但有几类用户特别对口：

中文用户入门 AI 编程：不需要适应英文界面，文档、报错说明都是中文，降低了认知门槛。如果你之前因为英文 IDE 卡住过，Trae 可能是一个好的起点。

预算敏感、想先尝鲜：Trae 的内置 AI 功能不需要另外配 API，上手成本低。先用 Trae 建立对 AI 编程工具的感知，之后再考虑要不要换更专业的工具。

VS Code 老用户过渡：操作习惯基本不用改，插件生态兼容，迁移成本低。

不太适合 Trae 的场景：需要深度团队协作（Cursor 的共享配置更成熟）、重度依赖特定付费模型（可以自己配 API Key 的工具更灵活）、只用命令行不想要 GUI（考虑 Claude Code）。

故障排查表

症状	原因	解法
登录后 AI 面板显示「服务不可用」	网络问题或账号未激活	检查网络是否能访问 trae.ai；退出重新登录；等几分钟再试
中文输入法在 Trae 里打不了字	输入法与 Electron 框架冲突	切换到其他输入法；或在系统设置里关闭输入法的「候选框跟随光标」选项
SOLO 模式卡在某一步不动了	AI 遇到无法自动解决的问题	查看底部终端输出，手动解决卡住的问题（如缺少依赖），然后让 AI 继续
「应用」代码后文件没变化	文件被只读锁定，或路径不对	确认文件权限；检查 AI 引用的文件路径是否和实际路径一致
对话里 AI 回复很慢	高峰期服务器负载，或网络延迟	换个时间段；检查本地网络；SOLO 模式耗时本身比对话长，正常
SOLO 执行完但结果不对	任务描述不够清晰	在对话里继续补充要求；或撤销改动，重新用更精确的描述启动 SOLO

常见问题

Q：Trae 支持哪些编程语言？

主流语言都支持——Python、JavaScript / TypeScript、Java、Go、Rust、C/C++ 等。语言支持由底层的语言服务器（LSP）提供，和 VS Code 生态一致。具体支持列表以官方文档为准。

Q：我的代码会上传到字节的服务器吗？

AI 功能需要将代码片段发送到后端模型处理，这是 AI 能「理解」你代码的原理。如果代码包含敏感信息（密钥、私有算法），在使用前需要自己权衡。详细数据政策见 Trae 官方隐私说明。

Q：Trae 和 VS Code 的插件完全兼容吗？

大部分兼容，但不是 100%。少数深度依赖 VS Code 特定内部 API 的插件可能无法正常工作。如果你有必须依赖的插件，建议安装 Trae 后先验证一下。

Q：SOLO 模式执行到一半，我想停下来可以吗？

可以。任何时候点「停止」或按 Esc，SOLO 会暂停。已经写入的文件改动不会自动回滚——如果不想要这部分改动，用 git checkout 或编辑器的撤销功能恢复。

Q：用 Trae 写的代码，之后想迁移到 Cursor 或 Claude Code，方便吗？

完全方便。这些工具都是作用在你本地文件上的，代码是你的，放在 git 里，随时切换工具。不存在被绑定的问题。

下一步去哪

Trae 是一个很好的入门工具，但 AI 编程的深度在于怎么描述任务、怎么给 AI 提供正确的上下文——这和用哪个工具关系不大，是一个需要刻意练习的能力。