【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 发布公告
如需更深入的实践示例和插件开发指南,敬请关注后续更新。