搜「Trae」的人通常會被三樣東西搞糊塗：一個 AI 編輯器、一個辦公助手、還有一個 GitHub 上的開源命令行程式，三個都叫 Trae，都出自字節跳動，但是三個不同的產品。這篇文章把它們一次拆開，重點講第一個——作為 Cursor 同形態競爭者的 AI IDE。
Trae 是什麼
Trae 是字節跳動推出的 AI IDE（整合開發環境），官網是 trae.ai，下載在 trae.ai/download。桌面版支援 macOS 12 以上（Apple Silicon）、Windows 10／11（x64）、Linux（.deb／.rpm 套件），另有手機端。計費走免費層加付費方案的模式，具體額度以官網為準。
它最大的特點是一個產品裡有兩種模式，可以無縫切換（官方原話：Seamless switch between IDE and SOLO Mode）：
IDE 模式：跟 Cursor 同一形態——圖形編輯器，AI 在旁邊做補全、對話、跨檔案改動，diff 呈現給你逐塊審查。方向盤在你手上。用過 VS Code 系編輯器的人幾乎零學習成本，而且它有中文介面，這對不少讀者是實際的差異點。
SOLO 模式：自主編程 agent。你定義任務，它自己拆解、自己執行、跑完整條流程再交付。方向盤交出去大半，你的角色從「看著它改」變成「驗收它交了什麼」。官方對 TraeCode 的定位口號是「Your 10x AI Coding Engineer」——行銷話不必當真，但「從助手到承包者」這個模式切換是真實存在的設計。
同一個產品塞進兩種形態，等於把 工具地圖 上的第一格和第二格摺疊在一起：小改動你在 IDE 模式裡盯著做，大任務切到 SOLO 模式放它跑。代價也跟地圖上講的一樣：SOLO 模式跑得越自主，你事後要審的東西越多，權限與沙箱設定越不能馬虎。
Trae 不是什麼之一：開源的 trae-agent
GitHub 上的 bytedance/trae-agent 是另一個東西——一個開源（MIT 授權）的 Python 命令行 agent 框架，跟上面那個圖形 IDE 沒有共用外殼。它在這個名單裡的位置是「終端機 Agent」，跟 Claude Code、Codex CLI 同形態。
它的特色是透明與研究導向：架構模塊化、刻意做得容易改和容易分析，官方技術報告（arXiv，2025 年）把它定位成研究 agent 架構、做消融實驗的平台。實際能力包括：
- 多家模型隨插：OpenAI、Anthropic、Google Gemini、Doubao、Azure、OpenRouter，甚至 Ollama 跑的本地模型，YAML 設定檔裡換一行就換一家；
- 一套標準工具：檔案編輯、bash 執行、結構化思考（sequentialthinking）、任務完成宣告，並支援 MCP（模型上下文協議） 外接更多工具；
- 軌跡記錄：每一步模型互動與工具呼叫都存成 JSON，事後可以逐條回放除錯；
- Docker 模式：把整個任務丟進容器裡跑，天然的 Sandbox（沙箱）。
用法就是一行：trae-cli run "Add unit tests"，加 --provider 與 --model 指定模型。它適合的人畫像很具體：想讀懂「一個 CLI agent 是怎麼搭出來的」、甚至想動手改一個的學習者與研究者。想直接要生產力的人，用 Claude Code 或 Codex 更省事。
Trae 不是什麼之二：TraeWork
官網下載頁上跟 TraeCode 並排的 TraeWork，是字節跳動的 AI 辦公助手（macOS、Web、手機端），面向文檔、報告這類辦公交付，不寫程式。它跟 WorkBuddy、豆包工作 是同一格——巧合的是，那兩個分別是騰訊與字節的競品，豆包工作同樣出自字節跳動。本文講的「Trae」默認都指 TraeCode 那個 AI IDE。
具體長什麼樣
一個典型的下午：你在 IDE 模式裡改一個表單元件，Tab 補全一路幫你把重複的驗證邏輯寫完；改到一半發現要動的東西橫跨好幾個檔案、你還沒想清楚方案，於是切到 SOLO 模式，把需求整段描述給它，先去倒杯咖啡；回來時它交付了一組改動與說明，你逐個檔案看 diff、跑一遍測試、決定收下還是退回。同一個視窗，兩種分工。
兩種模式，怎麼切換
切換的依據不是任務大小，而是兩個更具體的問題。
第一問：驗收標準寫不寫得出來？「把這個按鈕的文字改成 XX」「給這個 API 補一個欄位和對應的型別定義」——正確結果能一句話描述清楚的任務，交給 SOLO 也驗收得了。「把這個模組的效能優化一下」這種連你自己都還說不清要什麼的需求，先在 IDE 模式裡邊看邊討論。
第二問：錯誤的影響半徑可不可控？ 改動落在 Git 工作區裡，錯得再離譜也有 diff 與版本控制擋著，SOLO 的風險有底。涉及資料庫遷移、部署設定這類真實外部效果的任務，留在你全程盯著的模式裡做。
新手建議的路徑：先把 IDE 模式用熟（它就是 Cursor 式的用法），對它的產出品質有了感覺，再把小而明確的任務交給 SOLO。自主性是逐步放出去的，不是第一天就拉滿——這條原則對 地圖 上所有工具都成立。
常見誤解
誤解一：「GitHub 上的 trae-agent 是 Trae 編輯器的命令列安裝器。」 不是。兩者除了名字與字節跳動的出身，產品本體完全獨立：一個是閉源的商業 IDE 軟體，一個是研究導向的開源 Python 框架。想用編輯器，去官網下載；想研究 agent 架構，去 GitHub clone 倉庫。
誤解二：「SOLO 模式等於不用看了。」 自主性越高，驗收越不能省。SOLO 交付的仍然是一組改動：該跑的測試要跑，該看的 diff 要看。跳過驗收不是省事，是把債留給未來的自己——演化史 裡「審查趕不上生產」那一節講的就是這件事。
誤解三：「字節跳動的 AI 工具就 Trae 一個。」 Trae 管寫程式，豆包工作 管辦公交付，是同一家公司互不重疊的兩條產品線。trae-agent 可以接豆包的模型 API，但那只是可選引擎之一，不是品牌綁定。
誰適合、誰不適合
適合：想要免費額度先試水溫的人；需要中文介面的人；從 VS Code 遷移、不想重學編輯器的人；以及想拿 trae-agent 研究 agent 架構的學習者。
不適合：依賴成熟外掛生態的專業開發者（IDE 的底子年輕，生態深度還追不上老牌）；嚴格離線的合規環境（模型在雲端）；以及完全不會程式、只想交付辦公成果的人——那請直接走 辦公工作台 那條線。
下一步
- 直接動手：Trae 安裝與上手。
- 對照組先讀：Cursor 是什麼：住在你編輯器裡的 AI 編程工具，同形態最成熟的競品，兩篇讀完你就知道 IDE 這一格的共同語言。
- SOLO 模式交出去的方向盤，概念上就是它：Agent Harness 是什麼：模型外面那層普通程式。
- 開源 CLI agent 的另外兩個樣板：Claude Code 是什麼：終端機 Agent 的參考樣板 與 Codex 是什麼：OpenAI 的編程 Agent，本地與雲端兩條腿；想親手跑一個循環，走 你的第一個 Agent。
- 全景與挑選順序：AI 編程工具地圖：先認形態，再記名字。