做完這篇你會得到：一台裝好 Trae（官方現在把這個 IDE 叫做 TraeCode）的電腦、一個登入完成的帳號、一個打開著的專案，以及你在兩種模式下各跑過一個任務的經驗 —— IDE 模式（你主導，AI 輔助）與 SOLO 模式（AI 主導，先給計畫再執行）。最後你會把權限模式設定成自己睡得著的等級。
動手做完大約 20 分鐘。不需要程式基礎，但你需要會打開 Terminal（終端機） 貼指令 —— 只有 Linux 路線會用到。
適用平台
官方 Quickstart 列出的支援範圍：
| 平台 | 架構 | 支援版本與格式 |
|---|---|---|
| macOS | Apple Silicon、Intel | 12.0 或之後 |
| Windows | 64 位元（x64） | Windows 10、Windows 11 |
| Linux | 64 位元（x64）、64 位元（ARM64） | .deb：Ubuntu 20.04+、Debian 10+；.rpm：Fedora 42、RHEL 9.x |
macOS 版本低於 12 的人，官方文件另外給了一支早於 3.5.25 的 TraeCode 下載連結（分 Apple Silicon 與 Intel），在 Quickstart 頁面裡。
來源：docs.trae.ai/ide/set-up-trae、www.trae.ai/download。
前置需求
- 一個 Trae 帳號。初始設定精靈會帶你登入，沒有的話在畫面上註冊。
- 一個練習用的專案資料夾，或一個你想 clone 下來的 Git 倉庫網址。
- Linux 路線要在 Shell（殼層） 裡用
sudo安裝.deb／.rpm，這會動到系統層級的 PATH 與路徑 與套件庫。 - 若你打算接自己的模型而不是用內建模型：先讀 API Key。本文金鑰範例一律寫
sk-xxxxxxxx這種佔位符，不要把真金鑰貼進聊天視窗，也不要 commit 進 git。 - 公司或學校網路有出口白名單的話，官方列出需要放行的網域：
*.trae.ai、*.traeapi.us、*.mchost.guru、open-vsx.org、*.supabase.com、*.vercel.com。
步驟
步驟一：到官網下載頁挑你的安裝檔
打開 www.trae.ai/download。頁面上有兩個產品區塊：TraeWork（一般工作助理）與 TraeCode（寫程式用的 IDE）。這篇文章要的是 TraeCode，它的標語是「Your 10x AI Coding Engineer」，並註明可在 IDE 與 SOLO 模式之間無縫切換。在 TraeCode 區塊選你的平台按鈕：macOS (Apple Silicon)、Windows (x64) 或 .deb (x64)。
預期輸出：瀏覽器開始下載，完成後你會拿到一個 .dmg（macOS）、.exe（Windows）或 .deb／.rpm（Linux）檔案。檔案名稱裡會有 Trae 字樣與版號。
失敗長這樣：頁面只顯示 TraeWork 的下載鈕 —— 你卷錯區塊了，往下找 TraeCode。
步驟二：安裝並完成初始設定
macOS 打開 .dmg，照指示把 Trae 拖進「應用程式」；Windows 執行 .exe 照精靈走；Linux 用系統套件管理器安裝（例如 sudo apt install ./Trae*.deb，.rpm 則用 sudo dnf install ./Trae*.rpm）。
官方文件只列出 Linux 支援的格式（.deb／.rpm）與發行版，沒有給安裝指令；上面那兩行是 Debian／RPM 系發行版通用的本地安裝寫法，不是從 Trae 官方文件抄來的，檔名以你實際下載到的為準。
啟動後，官方 Quickstart 列出初始設定會依序問你四件事：
- 選主題與語言
- 視需要從 VS Code 或 Cursor 匯入既有設定
- 加入 TraeCode 相關命令
- 用你的帳號登入
預期輸出：一個精靈式的視窗，一步步走完上面四項；登入會在瀏覽器完成授權後跳回 IDE，最後你看到 TraeCode 的主畫面。官方文件沒有逐欄描述 IDE 模式的版面，但有三個你可以認得的標誌：介面左上角是 IDE／SOLO 模式切換開關，聊天輸入框的右下角是目前模型名稱，左下角是權限模式圖示。
失敗長這樣：Windows 上安裝或升級時跳出「The window terminated unexpectedly」—— 官方文件說這是安全軟體干擾，機率很低但確實存在；解法是重新開機，或先停用安全軟體再裝。
步驟三：打開一個專案
官方給三條路：直接匯入本機資料夾；或點左側面板中間的按鈕，在彈出的面板選 Clone from GitHub（會帶你完成 TraeCode 與 GitHub 之間的授權）；或在同一個面板輸入 Git 倉庫網址，然後點顯示出來的 Repository URL {URL}。
預期輸出：左側檔案樹列出該專案的檔案與目錄，點檔案會在編輯器打開。用 clone 的話，你會先看到授權畫面與下載進度，結束後專案自動被打開。
失敗長這樣：檔案樹空白 —— 你選到的是檔案而不是資料夾。
步驟四：認出兩種模式與模型選擇器
看介面左上角：那裡有一個模式切換開關，可以在 IDE 模式與 SOLO 模式之間切。官方對兩者的定義是：IDE 模式保留傳統開發方式，由你完整掌控流程；SOLO 模式由 AI 主導，自動規劃任務並完成從理解需求、產生程式碼、測試到預覽與部署的整條路。
再看聊天輸入框：右下角是目前模型名稱（點它可開啟模型清單換模型），左下角是權限模式圖示（步驟七會用）。
預期輸出：切到 SOLO 模式後，整個介面換成三欄 —— 左邊任務管理面板、中間 AI 聊天面板、右邊工具面板。切回 IDE 模式就回到一般編輯器版面。點模型名稱會展開一份內建模型清單，滑鼠停在名稱上會顯示該模型支援的能力。
步驟五：在 IDE 模式跑第一個任務
留在 IDE 模式，打開右側聊天面板，用一句話描述一個小改動，例如請它在某個檔案加一個函式並解釋改了什麼。送出。
預期輸出：聊天面板出現模型的回覆，涉及改檔時會顯示要改的內容與 diff；需要你同意才會套用的動作會出現確認卡片。你可以點進 diff 檢視，再決定接受或拒絕。
失敗長這樣：聊天框出現「Service is unavailable」，或送出後一直沒有回應 —— 官方 troubleshooting 文件把這類問題歸到網路與代理設定，先看下面「常見錯誤與修法」。
步驟六：在 SOLO 模式跑第一個任務
切到 SOLO 模式。官方說明 SOLO 內建的「Agent」與一般聊天型 agent 不同：它會先根據你的目標與專案脈絡產出一份可執行計畫，等你確認計畫之後才逐步開發。所以流程是：輸入需求 → 看計畫 → 確認 → 等它執行。
需求可以用自然語言輸入，官方也支援語音與上傳本機檔案。
跑完之後，在聊天面板點 Open Diff 打開 DiffView。
預期輸出：先出現一份任務計畫（可展開的步驟清單）與確認按鈕；你核准後，中間面板逐步顯示它做的事，右側工具面板會出現編輯器、文件檢視器、瀏覽器等內建工具的畫面。完成後按 Open Diff，DiffView 會顯示受影響的檔案數量、總共變動的行數，以及被修改檔案的清單；點任一檔案可看它的 diff。
步驟七：設定權限模式
官方文件把這個功能叫做 Permission Approval，它決定三件事：命令是否在沙箱裡隔離執行、是否啟用危險命令攔截與檔案保護等安全檢查、以及核准決策由你、由 TraeCode 內建的 LLM Guardian、還是由你自訂的模型來做。預設有三種模式：
| 模式 | 官方行為描述 |
|---|---|
| Manual Approval | agent 存取預設範圍外的檔案路徑，或執行命中安全規則的危險命令時，會在聊天流顯示核准卡片等你確認 |
| Automatic Approval | 除危險命令以外，原本需要你核准的操作改由 LLM Guardian 自動評估是否放行 |
| Full Access | 放行範圍最大，官方提醒謹慎使用 |
換模式有兩個入口：聊天輸入框左下角的權限模式圖示，或 Settings > Permission Approval 裡的 Regular Tasks > Permission Mode。
預期輸出：選定後，圖示與設定頁顯示你選的模式名稱。想驗證它真的有作用，就在 Manual Approval 下請 agent 改一個專案外的檔案 —— 你應該會看到核准卡片，而不是檔案直接被改。
注意兩個官方明講的限制：Automatic Approval 模式不對美國使用者開放；更細的自訂（沙箱策略、核准決策者、風險情境規則、檔案系統與網路存取策略）要透過 global.json 設定。
怎麼確認你裝對了
不需要指令，三個畫面檢查就夠：
- 按
Cmd+Shift+P（Windows／Linux 是Ctrl+Shift+P）打開命令面板。打得開、能搜到指令，代表 IDE 核心正常。 - 右上角點 Profile > Settings，進到 Models。看得到內建模型清單，代表帳號與模型服務都通。
- 左上角的模式切換能來往 IDE 與 SOLO，且 SOLO 下出現三欄介面，代表兩種模式都裝好了。
三項都過，你就可以開始用它做正事。
常見錯誤與修法
以下都是官方 troubleshooting 文件列出的真實問題，不是推測：
| 症狀 | 原因 | 修法 |
|---|---|---|
| Windows 安裝或升級時「The window terminated unexpectedly」 | 安全軟體干擾 | 官方建議：重新開機（推薦），或停用安全軟體後重裝 |
| Windows 自動更新後圖示打不開，出現「Access is Denied. (os error 5)」 | 更新過程的權限問題 | 不必解除安裝。到官網重新下載 Windows 版再裝一次，既有的程式碼、外掛與 IDE 設定都會保留 |
| Windows 上畫面局部模糊 | GPU 加速 | Ctrl+Shift+P → 執行 Preferences: Configure Runtime Arguments → 在打開的 argv.json 加 "disable-hardware-acceleration": true → 重啟 TraeCode |
| 外掛商店搜不到東西、或外掛連不上網路 | 代理設定失效 | 右上角 Profile > Settings → General 的 Editor Settings → 搜 Proxy → 檢查 Http: Proxy；若裡面的代理已經不能用就刪掉，然後重啟 |
| 聊天框顯示「Service is unavailable」或送出無回應 | 網路受限、代理、或輸入過長 | 先確認上面那串放行網域；再看輸入長度 —— 官方說明輸入長度是「輸入框內容 + 自訂 agent 的 prompt + 該 agent 用到的 MCP 工具 + 使用者與專案規則」的總和，超長會出錯，解法是精簡或換模型 |
| 重啟 IDE 後程式碼退回舊版本 | 快照資料異常 | 刪掉快照資料夾後重啟：macOS 是 ~/Library/Application Support/Trae/ModularData/ai-agent/snapshot，Windows 是 %USERPROFILE%\AppData\Roaming\Trae\ModularData\ai-agent\snapshot |
下一步
- 想在終端機裡工作而不是在 IDE 裡：安裝 Claude Code、安裝 OpenAI Codex CLI、安裝 DeepSeek Harness
- 字節跳動另外開源了一支研究取向的命令列 agent
trae-agent（github.com/bytedance/trae-agent），與這裡的 IDE 是兩件不同的東西：它用git clone+uv sync --all-extras安裝，執行入口是trae-cli run "任務"，適合想讀 agent 原始碼與做實驗的人 - 想搞懂權限與沙箱在講什麼：Sandbox（沙箱）、Prompt Injection（提示詞注入）、官方文件之外可先讀 AI 安全與紅隊測試
- 這類工具怎麼挑：AI 工具挑選框架、2026 年 AI 開發工具全景
- 想接自己的模型：上文 Settings > Models 那條路之外，先讀 五分鐘設置你的 LLM 開發環境 與 API Key