Trae CN

Trae 是字节跳动做的 AI 原生 IDE，内核是 VS Code，所以插件、快捷键、settings.json 那一套你原来怎么用，现在还怎么用。国内站是 www.trae.cn，直连就能登；国际站是 www.trae.ai，需要海外网络环境。两边账号完全隔离，数据不互通。

• TraeCode：就是多数人口中的「Trae IDE」。覆盖代码编写、项目理解、调试运行到变更管理，提供 IDE 模式与 SOLO 模式两条开发路径。官方定义写得很直白：你可以像用传统 IDE 一样掌控每一步，也可以把复杂任务丢给智能体规划和执行。
• TraeWork：AI 原生工作台，有网页版、桌面版、移动版三种客户端，内部再分 Work、Code、Design 三种模式。它是从 IDE 的 SOLO 模式「升级并独立」出来的，桌面版装在本地但不是 IDE，不打开代码仓库也能用。
• TraeCode Plugin：把 TraeCode 的能力挂进其他编辑器。
• TraeCode CLI：终端里跑。
• 企业版：官网单独开了下载页，同时适配 macOS、Windows 与 Linux。

一句话区分：**TraeCode 面向开发者写代码，TraeWork 面向所有人交任务。**两者共用账号和积分池。

二、下载安装：认准三个条件

官网右上角「下载 IDE」按钮会自动识别你的系统，官方快速开始里给的硬性门槛如下：

 图 2：官网下载页会自动匹配系统（来源：runoob.com）

macOS 低于 12.0 不是不能装，是要装旧版：官方让走历史版本链接，下载低于 3.3.25 的 TraeCode，Apple Silicon 和 Intel 各有一个包。这一点新手最容易忽略，直接在官网点下载会得到一个装不上的 dmg。

第三方软件站也能下到，但注意它们给的版本号属于谁：

• 360 软件宝库的「Trae CN」：版本 3.3.38，更新于 2026-06-11，大小 221.00 MB。这条对应 IDE，但下载要先装 360 安全卫士、由软件管家接管安装。
• 腾讯软件中心的「Trae work」：版本 0.1.40，更新于 2026-07-28，大小 330.97MB。这条是 TraeWork，不是 IDE，版本号体系不同，别拿来对比。

Windows 的安装包文件名是 Trae CN-Setup-x64.exe。安装过程本身没什么可讲的，下一步到底即可。

三、首次启动要做的五件事

 图 3：初始配置第一步选语言，中文用户直接选简体中文（来源：runoob.com）

1. 选主题和语言——简体中文会把界面完全本地化。
2. 决定要不要迁移配置——点「从 VS Code 导入」或「从 Cursor 导入」，插件、主题、快捷键会一起同步过来。不兼容的插件可以之后在插件市场搜替代品，或用 .vsix 本地安装。
3. 安装命令行工具——授权后就能在终端里用 trae . 直接打开当前目录，以及 trae my-react-app 这类新建项目命令。建议勾上。
4. 登录——国内版支持 +86 手机号验证码、抖音、苹果账号以及企业账号；网上教程里常说「掘金授权」，实际登录页上不一定还挂着这个入口。国际版走谷歌授权。两边账户不通用。
5. 配开发环境——进「设置 > 开发环境」指定 Node.js 版本，可以加本地已装好的 SDK，也可以下载官方内置的版本。

 图 4：Node.js 环境在「设置 > 开发环境」里指定（来源：docs.trae.cn）

打开项目有三条路：点左侧面板中央的「打开文件夹」；或「选择项目 > 克隆 Git 仓库」，顶部面板点「从 GitHub 克隆」并完成授权；或直接粘贴仓库 URL 后点「存储库 URL」。

四、IDE 模式和 SOLO 模式，什么时候用哪个

界面左上角是模式开关。

IDE 模式保留完整工作流：多文件编辑、内置终端、调试器、插件、源代码管理。它给的是控制权——改哪一行、跑什么命令，你说了算。配合几个固定动作能省很多时间：

• Command/Ctrl + U 唤出侧边对话框，右键代码选 Ask Trae 解释逻辑；
• 用 # 引上下文：#File 整个文件、#Folder 文件夹、#Code 具体函数或类、#Workspace 整个工作区；
• 接受改动用 Cmd/Ctrl + Enter，拒绝用 Cmd/Ctrl + Backspace，Cmd/Ctrl + Shift + D 看差异对比；
• 中文注释写完按 Tab 直接补全函数；光标处按回车做行内补全。

SOLO 模式把控制权交出去。用自然语言或语音描述需求，AI 自己规划任务、生成代码、跑测试、出预览，走完「需求理解 → 代码生成 → 测试 → 成果预览」全流程。

 图 5：左上角切换 IDE / SOLO 两种模式（来源：docs.trae.cn）

SOLO 进去之后是三栏：左边任务管理，中间 AI 对话，右边工具面板（编辑器、文档、浏览器）。具体这么用：

• 在输入框左下角打 @，从菜单里选智能体。SOLO Coder 处理复杂项目，从需求迭代到架构重构；SOLO Builder 主打从 0 到 1 快速落一个完整 Web 应用。
• 长任务建议勾上 Plan 模式（macOS Option + P，Windows Alt + P）：先出计划给你确认，再逐步执行；不满意可以直接改计划文本或发指令调整。
• 改完想看动了什么，点「查看变更」打开 Diff 视图，能看到文件数量、变更行数和逐文件 diff。
• 有 Figma 设计稿的话，可以让它解析成可运行代码，粒度可选整个 Frame 或单个组件（按钮、表单、卡片）。
• 一个项目可以同时挂多个任务，主控智能体会把任务拆开、让子智能体各自带独立上下文跑。

已知限制：SOLO Coder 默认走 Auto 模式且不可修改。Auto 会综合速度、性能和占用自动挑模型，省心，但也可能在一个问题上反复打圈——遇到这种情况，手动在对话面板切一个明确的模型，比一直等它自己绕出来快。

五、TraeWork：不写代码的那条线

TraeWork 网页版在 work.trae.cn，桌面版走官网下载页，手机端在应用商店搜「TRAE」。三种模式的定位分得很清：

• Work：面向产品、运营、数据分析，主要处理文档、表格和演示稿；
• Code：面向习惯智能体主导开发的工程师，聚焦编码、调试、代码库管理与 Git；
• Design：一站式做设计、修改、定稿交付。

 图 6：TraeWork 的三种模式（来源：docs.trae.cn）

几个和 IDE 不一样的地方：

• 运行环境：网页版只能跑云端；桌面版可以选「本地」或「云端」。选本地意味着代码和数据完全留在自己机器上，云端环境则会把相关数据上传处理。
• 输入方式：文字、语音，加上附件（.pptx、.xlsx、.pdf、.docx、图片、代码文件都吃）、斜杠命令和技能。
• 工具面板：右上角展开，多个页签——「任务摘要」放待办和交付物；「浏览器」三个模式都能用，用来预览 AI 输出的结果；「终端」只在 Code 模式出现；「画布」只在 Design 模式出现，可以整理设计稿、导入图片、导出设计文件。
• 改产物：Web 应用跑完后开产物预览页签，点右上角「选择元素」，选中元素后可以直接改设计或 CSS、把评论发到对话里。
• 分享：悬浮任意一条问答点分享图标，或在任务列表里右击任务选「分享」，可以只选部分对话，输出成图片或带二维码的链接。
• 手机控电脑：桌面版设置里开启「允许 TRAE 移动端控制当前设备」，手机 App 里选「任务运行环境 → 连接我的电脑」，挑一个电脑上的项目目录就能远程下任务。

外部应用授权目前支持 GitHub 和飞书；上下文侧支持 MCP、技能、斜杠命令和规则四类扩展。

六、内置模型有哪些，怎么切

国内版 TraeCode 的内置模型清单（官方模型页）已经全是国产模型：

TraeWork 这边按模式给不同选项：Work 模式与 Code 模式基本共用上面这套（Code 模式额外有 Seed-Code），Design 模式收窄到 Seed-2.1-Pro、Seed-2.1-Turbo、GLM-5.2、DeepSeek-V4-Pro、Kimi-K2.7-Code 五个。另有 Auto Mode 自动挑。

切换很轻：AI 对话输入框右下角点一下当前模型名就出列表，悬停能看到各模型擅长的方向。换过之后它会记住上次的选择——顺带提醒一句，没有「设置默认模型」这样的按钮，想固定某个模型就每次对话开头留意一眼右下角。

自定义模型的边界要记牢：只能配在 TraeWork 桌面版，而且只在本地环境生效。入口在「设置 → 模型服务商 → 添加」，填 Base URL 和 API Key，接口格式支持 OpenAI Chat Completions（/v1/chat/completions）和 Anthropic Messages（/v1/messages）。可选服务商涵盖 Anthropic、OpenAI、Gemini、xAI、OpenRouter、Ollama、DeepSeek、火山引擎、阿里云、腾讯云、硅基流动等。采样参数范围：Temperature [0, 2]、Top P [0, 1]、Top K [1, 100]；GPT-5 系列 Temperature 固定为 1，Gemini-3 与 DeepSeek-4 系列固定 0.1。

还有一层区别：GPT-5、Gemini-3、DeepSeek-4 系列个人版和企业版都能用，而 Kimi、GLM-5、GPT-6、Claude-4 只对企业版开放。

怎么选，实操里比较稳的搭配是：**补全交给 Seed-Code（快、便宜），对话和重构交给 GLM-5.3 或 DeepSeek-V4-Pro，要读超长代码库时换 Kimi-K3。**补全和对话的模型可以分开设，不必统一。

七、MCP 配置：两种方式，几个坑

MCP 是 Trae 接入外部能力的通道——数据库、接口文档、设计稿、内部系统，都通过它接进来。配置方式有两种：

**方式一，从市场添加。**IDE 模式点右上角设置图标（SOLO 模式点对话面板右上角设置），左侧导航选「MCP」，右上角「添加 > 从市场添加」，在市场里找到目标 Server 点 +，填好配置后确认。

**方式二，手动添加。**同样路径选「添加 > 手动添加」，直接粘 JSON：

远程服务用 HTTP 形式，把 command/args 换成 url 和 headers：

TraeWork 的入口在左下角「头像 > 设置 > MCP」，桌面版还要先选运行环境是本地还是云端。

项目级 MCP 是另一条路：在项目根目录建 .trae/mcp.json 声明 Server，再去「设置 > MCP」打开「启用项目级 MCP」开关并确认弹窗。适合团队共享配置，但官方也明确提示——要确保项目文件可信再开，否则等于让别人的配置文件在你机器上跑命令。

配置时容易卡住的几个点：

1. command 不能含空格，否则解析直接报错。路径带空格的要换写法。
2. Local 类型的 Server 依赖本地的 NPX 或 UVX，没装就是起不来。Windows 上如果 npx 无效，把 command 改成 "cmd"、在 args 里加 /c 和原参数。
3. env 里的 API Key、Token、Access Key 必须换成真实值，照抄示例里的 value 是配不通的。
4. 变量引用只支持 ${workspaceFolder}，例如 "args": ["${workspaceFolder}/plugins/mcp.js"]。
5. 超时可以在 env（或 HTTP 的 headers）里调：START_MCP_TIMEOUT_MS 和 RUN_MCP_TIMEOUT_MS，单位毫秒，默认示例给的是 "60000"。
6. 配完怎么确认生效？Server 名称旁边会出现绿色状态指示灯。灯不绿就是没起来，别急着去调业务。

配好之后，用「Builder with MCP」智能体或自建智能体去调它。顺带说一句，MCP 在官方文档里的定义是 Model Context Protocol，模型上下文协议；网上有文章把它写成「官方应用商店」，那是错的，照那个理解去配会完全找不到北。

八、免费额度与收费：积分怎么算

这是变化最快、也最容易被过时教程误导的部分。2026 年 7 月 31 日，Trae 从「按速通次数」切换成按 Token 计费的积分制。所以在 4 月前写的「国内版完全免费无限制」，现在已经不成立了。

免费档（¥0）：每月 500 积分，功能不锁，支持同时跑 2 个云端任务。

积分从哪来，官方计费文档列得很细：

付费套餐（官网定价页，有效期均为 31 个自然日）：

几个容易忽略的规则：

• **只有内置模型消耗积分，接自定义模型的调用不扣。**这也是为什么重度用户会去配自己的 API Key。
• TraeCode 优先消耗剩余有效期最短的那批积分；有效期相同时，奖励积分先于会员积分；TraeWork 则是 Work 专属积分先于通用积分。
• 积分可以单独买：每 1000 积分 50 元，档位有 1000 / 2000 / 3000 / 5000 / 10000 / 20000，有效期 31 个自然日，免费用户不能买。
• 能退的场景：命中敏感词被拦截、底层模型报错、死循环导致任务失败。不能退的场景：客户端本地报错，比如磁盘满了。
• 模型有折扣：Seed-2.1 系列约 2.5 折，GLM 与 DeepSeek-V4 约 5 折，免费用户和会员调用 GLM-5.2 都有专属补贴。
• 支付支持抖音支付、支付宝、微信支付，连续包月不支持微信。

九、国内版还是国际版

结论不绕弯：**在国内做开发，用国内版。**模型够用、延迟低、不需要额外网络成本。只有当你的任务必须落在 GPT 或 Claude 上时，才值得为国际版同时准备网络和订阅两笔开销。另外两边的账号和资产是完全隔离的，别指望能互相迁移。

十、用久才会注意到的几件事

• **内存别卡线。**一个简单的 Vue 项目，Trae 大概占 1.3GB；多项目或大型工程会到 2-3GB。建议 8GB 以上内存，否则一边跑构建一边问 AI 会很难受。
• **上下文别一次喂满。**大项目用 #Folder 指定相关目录，别直接 #Workspace 把整个工作区塞进去，否则响应慢、还容易答偏。
• **报错处理有套路。**把终端日志直接拖进对话区，输入「解释这 3 行报错」；或复制报错贴进 Chat；也可以直接说「当前程序出错，检查 xx 文件」。另外 /fix 做智能修复、/test 生成单元测试。
• **依赖装不上先换源。**把 npm 源切到国内镜像（npmmirror），pip 换清华源，比反复重试有效。
• 提示词要具体。「添加登录功能」这种说法生成的代码基本要重写；写成「使用 JWT 实现用户登录，有效期 7 天」才有能用的产出。
• **陷入 Bug 循环就回起点。**如果修补半天都修不好，回到最初把需求补全重新生成一轮，通常比继续打补丁快。
• 安全侧的开关：隐私模式开启后，对话内容、代码片段和 AI 输出不会被用于数据分析、产品优化或模型训练，代码库文件始终留在本地；沙箱运行会把智能体生成的命令关进受限环境，带文件访问控制和高风险命令拦截。

**它不适合什么：**想完全不动手就拿到生产级项目——Builder 第一次生成的代码基本都要调试；超长单文件重构——上下文会被撑爆，得分块；以及需要 Claude、GPT 顶级模型的场景——国内版目前拿不到，这属于产品策略而非配置问题。

参考资料

• 产品定义与模式：什么是 TraeCode？、TraeCode 快速开始、SOLO 模式
• 模型清单：TraeCode 内置模型、TraeWork 模型
• 费用与积分：套餐与计费说明、官网定价页
• TraeWork 操作：网页版与桌面版快速开始、www.trae.cn/work
• 下载与安装：官网下载页、企业版下载、菜鸟教程 Trae 快速上手、菜鸟教程 Trae 教程、博客园 Trae 国内版安装教程、w3cschool TRAE IDE 入门
• 国内版与国际版差异：掘金《Trae CN 和 Trae 的区别》、什么值得买《Trae 国际版 vs 国内版》
• 版本与包体数据：360 软件宝库 Trae CN、腾讯软件中心 Trae work
• 登录入口：www.trae.cn/login