快速上手：选择版本、安装与第一个任务

选择版本

	国内版	国际版
官网	trae.cn	trae.ai
内置模型	豆包、智谱、MiniMax、Kimi 等国内模型	OpenAI、Google、DeepSeek、Kimi 等
网络	国内直连	需要能访问海外服务
账号	国内账号体系	国际账号体系

两个版本账号不互通，按你的网络环境和想用的模型来选。内置模型、会员权益和计费规则会随时调整，以各自官网为准。

支持的操作系统

• macOS：12.0 及以上，Apple Silicon 和 Intel（macOS 低于 12 的，官方提供低于 3.3.25 版本的 TraeCode 下载）。
• Windows：Windows 10、Windows 11，64 位（x64）。
• Linux：Debian 格式（.deb）适用于 Ubuntu 20.04 及以上、Debian 10 及以上；RPM 格式（.rpm）适用于 Fedora 42、RHEL 9.x；架构为 64 位（x64）和 64 位（ARM64）。

安装与初始设置

前往 TRAE 官网，点击右上角的「下载 IDE」按钮，下载安装包并完成安装。启动 TraeCode，跟随界面指引完成初始设置：选择主题和语言；从 VS Code 或 Cursor 导入已有配置；添加 TraeCode 相关的命令行；登录（国内版支持手机号、抖音账号、苹果账号或稀土掘金账号）。

配置开发环境：前往 设置 > 开发环境，配置 TraeCode 的本地开发运行环境。目前支持配置 Node.js 版本，用于指定 TraeCode 在运行项目、安装依赖、执行构建或测试命令时使用的 Node.js 环境；点击 + 后，可以添加本地已安装的 Node.js SDK，也可以下载并使用 TraeCode 内置的 Node.js SDK 版本。

打开项目

直接导入本地文件夹，或克隆 Git 仓库（从 GitHub 或从 URL）：点击左侧面板中央的「打开文件夹」按钮，或在界面左上角点击 选择项目 > 打开文件夹，然后从本地选择文件夹在 TraeCode 里打开。

使用 IDE 或 SOLO 模式

在界面左上角按任务需要切换模式：IDE 模式保留传统的开发方式，开发者全程自主控制流程；SOLO 模式以 AI 为主导，自动规划任务并完成从需求理解、代码生成、测试到成果预览的全流程。IDE 模式下，和常规编辑器一样写代码，AI 在侧边栏协助：在对话框里提问、让 AI 解释或修改选中的代码；切换到智能体，描述任务后由它跨文件修改、运行命令；用 # 引用文件、文件夹或代码片段作为上下文。SOLO 模式适合从零搭建或大块需求，用自然语言描述要做什么，例如「做一个番茄钟网页：可以设置工作和休息时长，结束时有提示音，界面简洁」，AI 会自己拆解任务、写代码、运行预览，并在最后给出变更总结，你可以随时插话调整方向。

与智能体协作，开启 CUE 与 MCP

智能体是你面向不同开发场景的编程助手。TraeCode 提供内置智能体，你也可以创建自定义智能体，通过配置提示词和工具集让它更高效地完成复杂任务（见「智能体」）。CUE 是提升开发效率的智能编程工具，支持代码补全、多行修改、修改点预测、修改点跳转、智能导入和智能重命名（见「CUE 与 SOLO」）。MCP（Model Context Protocol）让大模型访问自定义的工具和服务：TraeCode 里的智能体作为 MCP 客户端，可以向 MCP Server 发起请求调用其提供的工具，你可以自行添加 MCP Server 并加入自定义智能体使用（见「MCP 与 Hooks」）。

下一步

• 想用自己的模型 API？看「模型」页。
• 想让 AI 遵守你的规范？看「规则、记忆与命令」。
• 想让 AI 按固定流程做事？看「技能」。