【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 安裝與首啟向導

1. 右鍵 Trea-Setup-<version>.exe → 以管理員身份運行。
2. 自定義安裝目錄（建議英文路徑，避免空格/中文）。
3. 首次啟動時將彈出 模型倉庫向導：
   • 勾選 國內鏡像 或 國際鏡像。
   • 選擇需要緩存到本地的模型（可稍后在設置里添加）。
4. 如觸發 Microsoft Defender SmartScreen，點擊 更多信息 → 仍要運行。

提示：如果在企業網絡內，請在“設置 ? 網絡”里配置 HTTP/SOCKS5 代理，否則模型下載將超時。

---

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: 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

---

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

如需更深入的實踐示例和插件開發指南，敬請關注后續更新。