【Trea】Trea国内版｜国际版｜海外版下载｜Mac版｜Windows版下载配置教程

本文适用读者：

想要第一次安装 Trea
需要在 Windows 或 macOS 上完成环境配置
想深入了解 Doubao、DeepSeek、ChatGPT、Claude 等模型在 Trea 中的接入细节
遇到版本兼容或网络连接问题，需要排障方案

Trae，致力于成为真正的 AI 工程师（The Real Al Engineer）。Trae 旗下的 AI IDE 产品，以智能生产力为核心，无缝融入你的开发流程，与你默契配合，更高质量、高效率完成每一个任务。

【Trea】Trea国内版｜国际版｜海外版下载｜Mac版｜Windows版|Linux下载配置教程

文章目录

【Trea】Trea国内版｜国际版｜海外版下载｜Mac版｜Windows版下载配置教程
- 1 Trea 是什么？
- 2 海外版 vs. 国内版：核心差异
- 3 安装包 & 镜像下载
- 4 环境与依赖要求
- - Windows
  - macOS
- 5 Windows 安装与首启向导
- 6 macOS 安装与首启向导
- 7 大模型接入与密钥配置
- - 7.1 Doubao-1.5-pro（火山方舟）
  - 7.2 DeepSeek-V3 / DeepSeek-R1
  - 7.3 ChatGPT-4o
  - 7.4 Claude 3.5 / 3.7 Sonnet
- 8 进阶：代理、插件、团队协作
- 9 常见问题 & 故障排除
- 10 FAQ & 资源索引
- 结语
- - 参考链接

1 Trea 是什么？

Trea 是一款由 字节跳动 Seed 团队孵化的跨平台 AI 编程助手／IDE，可在本地调用多家大模型，为开发者提供代码自动补全、文档生成、单元测试生成、对话式重构等能力。从 2025 年 3 月起官方同时维护：

发行通道	默认定位
Trea 国内版	对中国大陆网络环境做了优化，预置 Doubao & DeepSeek 模型
Trea 国际/海外版	面向全球用户，预置 ChatGPT & Claude 模型

全家桶（含国内/国际双版本 + 旧版回滚包）：


https://pan.baidu.com/s/1eCefrC-PsqPx1q7XJTVogQ?pwd=Trae

2 海外版 vs. 国内版：核心差异

功能点	国内版	海外版
内置大模型	Doubao-1.5-pro、DeepSeek-V3、DeepSeek-R1	ChatGPT-4o、Gemini2.5 Pro 、Claude 3.5 Sonnet、Claude 3.7 Sonnet
界面语言	简体中文 / 英文	英文（默认，可切换）
登录方式	手机号 + 验证码 / 字节账号	邮箱 + 密码 / OAuth(GitHub · Google)
网络依赖	无需科学上网	建议全局代理或直连海外

在这里插入图片描述

3 安装包 & 镜像下载

平台	文件类型	获取方式
Windows 10/11 (64-bit)	`.exe` 安装包	官网 / 百度网盘全家桶
macOS ≥ 10.15 (Intel & Apple Silicon)	`.dmg` 镜像	官网 / 百度网盘全家桶
Linux (x64)	`.AppImage` / `.tar.gz`	官网（暂不含图形安装向导）

全家桶（含国内/国际双版本 + 旧版回滚包）：https://pan.baidu.com/s/1eCefrC-PsqPx1q7XJTVogQ 提取码 Trae

校验：下载完成后，在终端执行 certutil -hashfile <filename> SHA256 或 shasum -a 256 <filename> 与官网提供的哈希比对，确保镜像未被篡改。

在这里插入图片描述

4 环境与依赖要求

Windows

组件	版本要求
操作系统	Windows 10 21H2 或更高
运行库	Visual C++ Redistributable ≥ 2019
GPU（可选）	NVIDIA CUDA 11+，用于本地 LoRA 微调

macOS

组件	版本要求
操作系统	macOS 10.15 (Catalina) 及以上
芯片	Intel 或 Apple Silicon
兼容性注意	10.15 用户更新最新版后可能无法启动，请回滚旧 DMG 并关闭自动更新

在这里插入图片描述

5 Windows 安装与首启向导

右键 Trea-Setup-<version>.exe → 以管理员身份运行。
自定义安装目录（建议英文路径，避免空格/中文）。
首次启动时将弹出 模型仓库向导：
- 勾选 国内镜像 或 国际镜像。
- 选择需要缓存到本地的模型（可稍后在设置里添加）。
如触发 Microsoft Defender SmartScreen，点击 更多信息 → 仍要运行。

提示：如果在企业网络内，请在“设置 › 网络”里配置 HTTP/SOCKS5 代理，否则模型下载将超时。

在这里插入图片描述

6 macOS 安装与首启向导

双击 .dmg，将 Trea.app 拖入 Applications。
Finder › 应用程序 中右键打开，绕过首次 未被认证开发者 的 Gatekeeper 阻拦。
Catalina (10.15) 若提示无法运行：
- 删除新版 Trea.app；
- 安装网盘里 2024-04-25 前的旧 DMG；
- 在 偏好设置 › 软件更新 里关闭 自动更新。
Apple Silicon 如需运行仅编译给 x64 的旧版，可执行：

softwareupdate --install-rosetta --agree-to-license

7 大模型接入与密钥配置

Trea 的后端使用 OpenAI-兼容 调用协议；只需在 ~/.trea/config.yaml 写入对应环境变量即可启用。

7.1 Doubao-1.5-pro（火山方舟）

provider: doubao
endpoint: https://ark.cn-beijing.volces.com/api/v3
model: doubao-1.5-pro
api_key: ARK_API_KEY

Doubao 支持 32 k - 128 k 上下文，费用远低于 GPT-4o，适合中文长文生成

7.2 DeepSeek-V3 / DeepSeek-R1

provider: deepseek
base_url: https://api.deepseek.com/v1     # 与 OpenAI SDK 兼容
model: deepseek-chat        # V3
# 或
model: deepseek-reasoner    # R1
api_key: DEEPSEEK_API_KEY

DeepSeek 的 off-peak 价格在 2025-02-26 下调 75 %，是目前最具性价比的推理服务之一

7.3 ChatGPT-4o

provider: openai
base_url: https://api.openai.com/v1
model: gpt-4o
api_key: OPENAI_API_KEY

7.4 Claude 3.5 / 3.7 Sonnet

provider: anthropic
base_url: https://api.anthropic.com/v1
model: claude-3.5-sonnet-20240620
# 或
model: claude-3.7-sonnet-20250215
api_key: ANTHROPIC_API_KEY

Claude 3.5 Sonnet 在 2024-06-21 发布，主打推理与代码能力；3.7 Sonnet 继续扩容上下文窗口与速度

多模型热切换：在 Trea 设置中勾选 Auto Fail-Over，即可在请求失败时自动回退到备选模型。

8 进阶：代理、插件、团队协作

场景	推荐做法
跨境网络	设置 `ALL_PROXY=socks5://127.0.0.1:7890` 或在 GUI 里填写；建议勾选开启 DNS 代理，防止 `api.openai.com` 被污染
GitHub Copilot 共存	在 VS Code > Extensions 禁用 Copilot 的 Inline Suggestion，避免冲突
函数调用 / 工具插件	Doubao Pro & DeepSeek R1 均支持 Function Calling，在“插件商店”启用后可自动解析 JSON Schema

9 常见问题 & 故障排除

症状	解决方案
macOS 10.15 打不开	回滚旧 DMG → 关闭自动更新；或安装 Rosetta 2 citeturn5view0
Win11 启动闪退	删除 `%APPDATA%\Trea\cache`，升级显卡驱动，再重装
请求超时 / 429	检查代理、API 额度；API Key 超额时可在 Billing Panel 开启 Pay-As-You-Go
中文提示词乱码	确保文件编码为 UTF-8，无 BOM