【Trea】Trea国内版｜国际版｜海外版下载｜Mac版｜Windows版下载配置教程
本文适用读者：
- 想要第一次安装 Trea
- 需要在 Windows 或 macOS 上完成环境配置
- 想深入了解 Doubao、DeepSeek、ChatGPT、Claude 等模型在 Trea 中的接入细节
- 遇到版本兼容或网络连接问题，需要排障方案
Trae，致力于成为真正的 AI 工程师（The Real Al Engineer）。Trae 旗下的 AI IDE 产品，以智能生产力为核心，无缝融入你的开发流程，与你默契配合，更高质量、高效率完成每一个任务。
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 citeturn5view0 |
| Win11 启动闪退 | 删除 %APPDATA%\Trea\cache，升级显卡驱动，再重装 |
| 请求超时 / 429 | 检查代理、API 额度；API Key 超额时可在 Billing Panel 开启 Pay-As-You-Go |
| 中文提示词乱码 | 确保文件编码为 UTF-8，无 BOM |
10 FAQ & 资源索引
如何同步配置到多台电脑？
在「设置 › 账户」启用 Trea Cloud Sync，配置文件会加密存储。可以自部署私有模型吗？
支持加载 GGUF / TensorRT 格式的本地模型，在「模型管理 › 自托管」里填写端口即可。许可证与收费
核心 IDE 保持免费；模型调用按各家 API 实际消耗计费，国内版默认绑定 Doubao 免费额度 50 万 tokens。
结语
至此，你已完成 Trea 国内版 / 国际版 在 Windows 与 macOS 上的下载、安装与大模型接入配置。无论是本地开发还是远程协作，Trea 都能把主流 LLM 的能力融入日常编码流程，显著提升开发效率。若后续遇到新问题，欢迎在评论区留言交流，祝你使用愉快!
参考链接
- CSDN Trea 版本差异原始帖
- macOS 10.15 兼容性回滚教程
- Doubao 方舟官方 API 文档
- DeepSeek API 首次调用文档
- Anthropic Claude 3.5 Sonnet 发布公告
如需更深入的实践示例和插件开发指南，敬请关注后续更新。