网站导航
> 技术文档 > 【Trea】Trea国内版｜国际版｜海外版下载｜Mac版｜Windows版|Linux下载配置教程_trea中文官网

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

网友: 技术文档 2025-07-30 10:36:03

【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】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) 网络依赖 无需科学上网 建议全局代理或直连海外

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

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 SHA256 或 shasum -a 256 与官网提供的哈希比对，确保镜像未被篡改。

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

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 并关闭自动更新

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

5 Windows 安装与首启向导

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

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

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

6 macOS 安装与首启向导

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

7 大模型接入与密钥配置

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

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

provider: doubaoendpoint: https://ark.cn-beijing.volces.com/api/v3model: doubao-1.5-proapi_key: ARK_API_KEY

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

7.2 DeepSeek-V3 / DeepSeek-R1

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

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

7.3 ChatGPT-4o

provider: openaibase_url: https://api.openai.com/v1model: gpt-4oapi_key: OPENAI_API_KEY

7.4 Claude 3.5 / 3.7 Sonnet

provider: anthropicbase_url: https://api.anthropic.com/v1model: claude-3.5-sonnet-20240620# 或model: claude-3.7-sonnet-20250215api_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

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 发布公告

如需更深入的实践示例和插件开发指南，敬请关注后续更新。

网络标签：

相关问题