T3 Code 是一款免費、開源的 AI 編碼代理管理工具,由 Theo Browne 團隊在 2026 年 3 月推出。它在同一個介面管理 Claude Code、Codex、Cursor、Grok Build、Antigravity 等代理,讓你查看哪條任務在跑、哪些動作在等核准、改了哪些檔案。代理與 Git 操作在你指定的電腦或伺服器執行,模型與訂閱額度由供應商提供。T3 Code 本體採 MIT 授權,既有代理訂閱可依供應商的規則繼續使用。
T3 Code 是什麼:控制平面而不是編碼代理
T3 Code 的正式定位是 agent harness 的控制平面,它在技術堆疊裡的位置比任何一個編碼代理都高一層。Claude Code 底下是 Anthropic Agent SDK 組成的 harness,Codex 底下是 Codex App Server,T3 Code 做的是驅動這些現成的 harness,而不是再造一個。官方 FAQ 用餐廳比喻:LLM 是主廚,harness 是廚房,T3 Code 是一間讓你自帶任何廚房的餐廳。
使用前先在 T3 Code 接上一個代理。Claude Code 要在執行 T3 Code 伺服器的機器安裝並執行 claude auth login。Codex 可以在 Settings → Providers 直接連結 ChatGPT,由 T3 Code 安裝 Codex,也可沿用透過 codex login 登入的 CLI。模型與工具能力由供應商決定,T3 Code 統一呈現專案、對話與審查。兩種 Codex 登入方式的差異可見官方 Codex 設定說明,harness 的分層則可參考 Theo 的What is a harness?。
GitHub 儲存庫 pingdotgg/t3code 建立於 2026 年 2 月。Theo 在3 月 7 日的發布貼文宣布開放使用,首版以 Codex CLI 為基礎。10 月 16 日(台灣時間)的 v0.1.0推出 Orchestrator V2,11 月 17 日的 v0.1.10包含 360 位貢獻者的 1,924 項變更。
截至 2026 年 11 月 18 日,T3 Code 的 GitHub 儲存庫累積超過 6.4 萬顆星、1.1 萬次 fork。團隊在官方網站提供各平台的下載入口與桌面介面範例。
Theo 在 2026 年 3 月的發布影片示範 T3 Code 首版工作流程。
核心架構:本機伺服器驅動你已登入的 CLI
T3 Code 的一切圍繞著一個跑在你機器上的伺服器運作,官方遠端文件稱每個伺服器實例為 environment,桌面版、網頁版與手機版都只是連向這個伺服器的操作介面。實際工作全部發生在 environment 所在的機器:代理程序、Git 操作、檔案讀寫、終端機與狀態儲存都在那裡,連線斷了工作也不中斷。一句話記這個模型:client 顯示工作,environment 執行工作。

對話單位是 thread,一條 thread 綁定一個 provider、一個工作目錄與完整歷史,伺服器重啟後依然存在。每次你送出訊息到代理完成是一個 turn,T3 Code 會在 turn 前後建立 workspace 檢查點,所以能回答「這次提示到底改了什麼」並支援逐訊息回溯。工作目錄有兩種模式:直接用專案目前的 checkout,或是為 thread 建立獨立的 Git worktree。
供應商整合透過 adapter 接收結構化事件。Codex 透過 app-server 的 JSON-RPC 溝通,Claude 走 Anthropic Agent SDK 與 claude 執行檔,Cursor 用官方 SDK 搭瀏覽器登入,Grok Build 與 Antigravity 走 ACP 通訊協定,其餘代理各自透過 CLI 啟動。T3 Code 因此能統一呈現訊息、工具呼叫、核准請求、計畫與子代理事件,這是它與終端機多工器最根本的差異。
| Provider | 登入方式 | 預設開啟 |
|---|---|---|
| Codex | 在 T3 Code 連結 ChatGPT,或執行 codex login | 是 |
| Claude Code | claude auth login | 是 |
| Cursor | 執行 agent login 完成登入 | 否 |
| Grok Build | grok login | 否 |
| OpenCode | opencode auth login | 否 |
| Pi | pi 後執行 /login | 否 |
| Muse Code | muse login | 否 |
| fx(Vercel) | fx login | 否 |
| Kiro | kiro-cli login | 否 |
| Antigravity | 由 T3 Code 安裝 runtime,再用 Google 帳號登入 | 否 |
這十個內建選項的安裝與驗證方式整理在官方供應商設定表。如果遇到版本衝突,可在 Settings → Providers 查看這台伺服器的建議版本。T3 Code 也可連接ACP Registry中的代理,或在ACP 設定中加入本機啟動指令,例如用 dsh --profile acp 連接 DeepSeek Harness。官方 FAQ 目前將本地模型列為不支援。
同一個 provider 也能掛多個實例給不同帳號用。Claude 以 CLAUDE_CONFIG_DIR、Codex 以 shadow CODEX_HOME 隔離設定,個人與工作訂閱並存時直接在介面裡切換帳號,既有對話歷史留在原帳號的設定目錄內。敏感的環境變數與金鑰存在伺服器端的密鑰庫,手機與瀏覽器看得到名稱卻拿不回值,1Password 也可以作為憑證來源。
"Why should I use T3 Code instead of Claude Code or Codex?"
— theo (@theo) October 29, 2026
Short answer: T3 Code is way better for developers.
Long answer: https://t.co/npZNmzRkzy
Theo 說明為何把多個編碼代理的工作放在同一個介面管理。
安裝與第一條 thread:從桌面 app 到 worktree
從官方下載頁取得桌面版。macOS 可用 brew install --cask t3-code,Windows 用 winget install T3Tools.T3Code,Arch 用 yay -S t3code-bin,另有 Nix、Debian 的 .deb 與 AppImage。Intel Mac 可裝桌面 app,若要單獨跑 CLI 伺服器,可依官方 Intel Mac 指引自行編譯。裝好後到 Settings → Providers 接上第一個代理。
Omarchy is going to ship with an installer for T3 Code
— DHH (@dhh) August 20, 2026
命令列路線一樣簡單。macOS 與 Linux 執行 curl -fsSL https://t3.codes/install.sh | sh 會把 t3 指令裝進使用者目錄,Windows PowerShell 用 irm https://t3.codes/install.ps1 | iex,想先試跑不安裝就 npx t3@latest,需要先備好 Node.js,版本可查官方命令列安裝文件。常用子指令不多:t3 起伺服器、t3 up 開遠端、t3 update 升級、t3 doctor 回收資料庫空間。
第一條 thread 的流程是加專案、開新對話、選 provider 與模型、選權限模式、選工作目錄,再送出第一個提示。工作目錄的選擇是新手第一個實務決策:current checkout 讓代理直接動你眼前的目錄,適合單一寫入者的連續工作;new worktree 給 thread 一個獨立分支與資料夾,適合多條平行任務。經驗法則是一個 checkout 只留一個寫入者,研究與審查類 thread 另開。如果你還想讓各任務依相同標準驗收與重試,可以接著看多代理工作流程的設計方法。

訊息輸入欄的上限是 12 萬字元,貼整份規格書或錯誤 log 都夠用,圖片可以直接附加,iPhone 拍的 HEIC 會自動轉檔。輸入斜線叫出指令選單,錢字號搜尋 skills,/clear 則是在同一條 thread 重開全新的 provider session。檔案面板支援瀏覽專案樹、開檔改檔,選取特定幾行附評論直接丟進下一條提示,審查迴圈不必離開介面。
專案層的可重複行為寫進專案根目錄的 t3.json,上限 50 個 script。常用設定包含預設工作目錄模式、一鍵啟動的開發伺服器指令,以及 runOnWorktreeCreate 讓每個新 worktree 自動跑 npm install 之類的準備命令。T3 Code 會在 script 環境注入 T3CODE_PROJECT_ROOT 與 T3CODE_WORKTREE_PATH 兩個變數,供腳本區分共用資源與隔離目錄。各代理的安裝細節可對照站上的Claude Code 完整教學與OpenAI Codex 教學。
權限四模式與安全邊界:預設值要自己改
權限模式決定代理何時需要你點頭,而新 thread 初始預設為 Full access。第一次試用可先切換到 Supervised。新增 thread 時在訊息列就能切換,快速鍵是 mod+shift+a,管理員也能用託管政策把可用模式封頂。預設可在 Settings → Threads → New threads → Permissions 設定,專案可以再覆寫環境預設。各供應商的限制見官方權限模式文件。
| 模式 | 檔案編輯 | 指令與其他動作 | 適合情境 |
|---|---|---|---|
| Supervised | 先詢問 | 先詢問 | 重要目錄、不熟悉的任務 |
| Auto-accept edits | 自動核准 | 需要時詢問 | 例行改碼但要管住指令 |
| Auto | 例行動作放行 | 高風險動作詢問 | 受控環境中的信任任務 |
| Full access | 不詢問 | 不詢問 | 可丟棄或隔離良好的環境 |
四種模式是 T3 Code 的統一介面,實際能擋到哪裡仍由 provider 決定,這是選型時容易誤判的地方。Auto 模式在 Codex、Claude、Cursor、Grok 與 fx 會使用供應商自己的自動審查,OpenCode 與 Antigravity 沒有對應機制就退回詢問。Muse Code 與 Kiro 只有 Supervised 和 Full access 兩檔,Grok 沒有 Auto-accept edits,fx 不提供 Auto-accept edits 或 Full access。
供應商的細部差異還有幾處值得記。Claude 在 Full access 下仍可能因自身設定跳出詢問,Grok 被自動審查擋下的指令會轉成核准請求等你決定,Kiro 在 Supervised 的每個 turn 結束都要求你確認該輪檔案變更。代理反問任務問題不受權限模式約束,子代理的核准請求會帶著名稱出現在父對話裡,不必切換視窗就能回應。
審查與回溯機制建在 turn 邊界上。每個 turn 的 checkpoint 存在隱藏的 Git refs 裡,對任何一則歷史訊息按 Edit from here 可以選 Revert files too 回溯對話與檔案,或 Revert and keep changes 只回溯對話保留改動。Antigravity、Muse Code 與 ACP 代理不支援對話回溯,有其他 thread 在同一目錄工作時檔案還原也會被拒絕。Claude 原生權限的細節差異,可對照Claude Code 安全設定教學。
兩個邊界觀念值得內化。worktree 隔離的是 checkout 之間互踩,隔離不了代理對整台機器的存取,Full access 會放行指令和檔案編輯,實際可存取的資源取決於代理程序、供應商與作業系統的權限。檢查點也不是備份,它救得了一次錯誤的 turn,救不了硬碟與整個儲存庫,重要工作仍然要進 Git、推遠端。
遠端與手機:T3 Connect、區網配對與 Tailscale 三條路
遠端能力把 T3 Code 從桌面 GUI 變成個人代理機房的控制台,三條路線對應不同的網路與信任條件。命令列主機執行 t3 up 會問你其他裝置怎麼連進來:走 T3 Connect、區網或兩者都要,選 T3 Connect 就會以背景服務常駐。桌面版則在 Settings → Sharing & access 開啟,手機端可安裝官方iOS app或Android app,再登入同一個 T3 Connect 帳號。
T3 Connect 是官方代管的穿牆方案,技術上是在你的機器跑 cloudflared 建立 Cloudflare tunnel,官方 relay 只負責牽線,不代理你的 HTTP 或 WebSocket 流量。每個帳號免費連 3 台機器,手機與瀏覽器不計數,連結付費 T3 Chat 帳號可提高到 Pro 的 10 台或 Premier 的 100 台。主機端可要求逐一核准新裝置,每個核准請求會在十分鐘後失效。
不想經過代管服務的人有兩條替代路線。區網配對用 t3 pair 產生 QR code 或配對連結,Tailscale 則讓 tailnet 內的裝置直連,兩者都把網路路徑完全留在自己手上。桌面版還能透過 SSH 接管遠端主機上的伺服器,適合儲存庫與建置環境本來就在伺服器的團隊。Theo 自己說他不到百分之五的提示是在筆電上跑的。

手機端呈現的是同一套 thread 介面,代理停下來等核准時推播到手機,點開就能准或退,終端機登入流程也備有回應欄位。iOS 與 Android 都支援聽寫輸入,語音轉出的文字先進草稿欄,檢查過再送出。連線認證的設計也嚴謹:配對權杖只換到約五分鐘效期的 WebSocket ticket,一般工作階段三十天,走 relay 的 DPoP 工作階段約一小時並綁定用戶端金鑰。
無人值守的部署要注意作業系統差異。背景服務在 Linux 是附 lingering 的 systemd user service,開機即起;macOS 是 LaunchAgent,受登入狀態與 FileVault 限制,冷開機後的自動登入會衝突,真正常駐的機房環境建議用 Linux。各路線的完整設定細節在官方遠端文件,也可從T3 Code 網頁版連回自己的機器。
多代理編排:delegate_task、訊息佇列與一鍵 PR
0.1.0 引入的 Orchestrator V2 把跨供應商協作變成產品功能,delegate_task 是官方推薦的組合方式。一條 thread 裡的代理可以派子代理給任何 provider 與模型並等待結果,典型打法是 Claude 規劃、Codex 實作,子代理的核准請求會帶著名稱出現在父對話裡。子代理卡片會顯示模型、耗時、Token 與工具使用,Lineage 區塊列出整條委派鏈。

對話中途換模型是允許的,但交接有損:新 provider 拿不到先前的推理過程、工具呼叫與附件,介面會標記模型與推理強度的切換點。要借另一個 harness 的長處就用 delegate_task,要把整段歷史帶過去則不行。訊息佇列存在伺服器端,代理工作中送出的訊息可以轉向當前 turn 或排隊,重啟不消失,還能編輯與重排;排程任務支援固定重複與單次定時,撞到用量上限的 thread 會在限額重置後自動續跑。
完成定義由你自己給:thread 可以 settle 收進封存,預設七天沒活動或 PR 合併自動 settle,進行中與待核准的 thread 保持活躍。送出提示後按 Cmd 加 Enter 直接丟到背景並開新對話,側欄即時顯示每條 thread 的狀態與經過時間,重要 thread 可釘選在最上方。想針對當前 thread 提問又不想打斷,用 /side 開側聊帶回結論,thread 連結還能從外面直接打開特定對話。
diff 面板提供三種檢視範圍,對應三個不同的審查問題。Latest turn 回答單次提示改了什麼,Changes 對比分支與遠端基底,Uncommitted 收住還沒 commit 的部分,diff 行上可以直接選取程式碼加評論送回對話。終端機抽屜掛在對話下方,跑測試、看 log、手動重現代理下的指令都在同一個視窗,這些終端機跑在伺服器機器上,手機開的指令也不會跑到手機。
原始碼管理的深度超出多數 GUI 工具。用獨立 worktree 執行的 thread 可以在自己的分支 commit、push 並開 PR,標題與內文自動生成,draft PR、stack PR 與 amend 都支援。GitHub 認證的優先序是設定內 token、GH_TOKEN 環境變數、再來是 gh CLI 2.81 以上,GitLab、Bitbucket、Azure DevOps、Forgejo 與 Gitea 都有對應整合。
訂閱額度與 Usage 儀表板:5 小時額度的 1.7 倍事件
Usage 頁把各家訂閱的用量集中顯示。2026 年 10 月,T3 Code 維護者用同一個 Claude Max 帳號跑相同工作,發現經 Agent SDK 執行的 T3 Code,每百萬快取寫入 Token 消耗的五小時額度約為互動式 Claude Code CLI 的 1.7 倍。該次測試的週限額消耗相同。GitHub 問題 #24649已在 11 月 2 日關閉,公開紀錄未說明修正方式。若現在遇到異常,可先更新 T3 Code,並對照 Claude 帳號的五小時額度。

儀表板內容跨 provider 整合 Codex、Claude Code、Grok Build、OpenCode、Antigravity、Pi、Muse Code 與 Cursor 的歷史,顯示 Token 用量、快取節省、模型分佈與 API 等效成本估計。依官方 Usage 文件,這裡顯示的是 API 等效成本,訂閱帳單仍以供應商為準。Fast 與 Ultrafast 的加價列在 Premium 項目,沒有公開牌價的模型可手動填每百萬 Token 費率,或把 preview 模型映射到正式名稱歸戶。0.1.7 起可以按 provider 與模型篩選總量。
Usage 能讀取多少歷史,取決於各環境仍保有的供應商紀錄。T3 Code 可透過 usageHistoryRetentionDays 調整自己的掃描範圍,已被供應商清掉的紀錄無法靠這項設定復原。官方也記載 Usage 可以顯示自架 CLIProxyAPI hub 的合併額度。用這類代理服務前,先查各訂閱方案的條款。各方案的基本額度可對照站上的Claude Code 費用教學。
Theo 在影片中示範自己的多帳號工作流程,涉及代理服務與合併額度。一般的 Claude Code 或 Codex 登入可直接使用各自的帳號。
費用結構:軟體免費,加購只在機器數
T3 Code 的商業結構簡單到罕見:軟體完全免費,官方 FAQ 明言目前沒有任何付費使用 T3 Code 的入口,訂閱費用照舊付給 Anthropic、OpenAI 這些供應商。T3 Connect 另外以帳號計算機器數,免費帳號 3 台,超過才需要付費 T3 Chat 方案換 10 台或 100 台額度。官方也留了但書,若轉送帳單失控未來可能調整,屆時 fork 自架或退回 Tailscale 都是完整出路。
已有可用的 Claude Code 或 Codex 方案時,T3 Code 本體不另外收費,用量沿用各供應商規則。Codex 透過內建 ChatGPT 連線與既有 CLI 登入時的功能可能不同,例如前者不提供 Fast 或 Ultrafast。
與 Conductor、cmux、Herdr 怎麼選
同類工具的真正差異在抽象層高度,T3 Code 押的是結構化 thread 模型勝過終端機 pane。Conductor 與 Codex 桌面版給了它靈感但非開源,cmux 是為代理時代打造的原生 macOS 終端機,Herdr 像為代理重造的 tmux 加 SSH 手機版,託管平台則連機器都代管。選擇取決於你對「控制」的定義要落在哪一層。
| 工具 | 核心抽象 | 工作執行位置 | 手機用戶端 | 適合誰 |
|---|---|---|---|---|
| 單一 CLI | 一個終端機視窗 | 本機 | 無 | 單一任務、追最新官方功能 |
| IDE 內建代理 | 編輯器附加對話 | 本機 | 無 | 大部分程式碼仍自己寫 |
| cmux | 終端機工作區與 pane | 本機 Mac | 無 | 要可程式化瀏覽器的 Mac 終端機 |
| Herdr | 持久終端機 pane | 任何可連上的機器 | 有,走 SSH | 要可腳本化的常駐終端機代理 |
| 託管平台 | 雲端任務環境 | 平台機器 | 視平台 | 不想管機器的大量隔離任務 |
| T3 Code | thread 與 environment | 你自己的機器 | 有,iOS 與 Android | 多供應商並行監督 |
直接 CLI 仍是特定場景的最短路徑。供應商推出新事件或新設定時,T3 Code 的 adapter 需要時間跟進,趕最新功能的人留在原廠 CLI 最快,兩者可以並存,T3 Code 當儀表板、CLI 處理單發任務。跨供應商工作流的選型前置功課,〈Codex vs Claude Code 比較〉一文有完整拆解。第三方長文以 Flavio Copes 的T3 Code 深度指南最完整,本文多處事實與其交叉核對。
輔助支援與效能文化也值得記一筆。0.1.9 起螢幕閱讀器會在 turn 進行中播報代理訊息與步驟,不必離開輸入欄;官方把掉幀視為 bug 的效能紀律寫進 README,在 Electron 應用裡相當少見。這些細節反映團隊把 T3 Code 當日常主力工具在磨,而非展示用的副業。
邊界與風險:beta 節奏、遙測與升級紀律
把它當 beta 產品管理是使用心法的核心,三個紀律撐起安全邊界:版本一起升、權限起手 Supervised、重要工作進 Git。Orchestrator V2 之後伺服器與用戶端共用型別協定,V2 伺服器會拒絕 V1 app,所以桌面、手機與各台機器的伺服器要同批更新,而且不要在代理 turn 執行中重啟伺服器。介面與設定在 0.1 系列仍持續變動,文件明說 expect bugs。
升級機制本身有保險設計。t3 update 會先對 SQLite 狀態拍快照,新版本健康檢查沒過就自動回退到原版本,這對跑在遠端、長時間沒人看的環境是關鍵防護。升級前把進行中的 turn 收尾、commit 推上遠端,是文件建議的標準動作。桌面版首次啟動也會順手裝好 t3 指令,避免兩條安裝路徑版本漂移。
依官方遙測文件,伺服器會送出模型、權限模式、執行結果和 Token 統計等產品事件,並轉發至 PostHog。這類事件不含提示詞、回應、檔案內容或認證權杖。T3 Connect 另把連線診斷送到 Axiom,可能包含機器名稱或錯誤訊息。伺服器可用 T3CODE_TELEMETRY_ENABLED=false 關閉自己的產品事件和連線追蹤,瀏覽器與手機則有獨立的診斷行為。
T3 Code 官方 FAQ表示,Claude Code、Codex 與 Antigravity 的整合依各供應商規則運作。SpaceX Super Intelligence 的公告也確認 T3 Code 可使用 SuperGrok 與 X 訂閱。多帳號共用額度或透過第三方代理服務時,仍應以各供應商的方案條款為準。供應商如何處理資料,可參考本站的Grok Build 隱私事件解析。
平行開多個 worktree 會增加磁碟用量,也可能各自下載相同的專案依賴。Settings 的 Worktrees 頁可開啟自動清理,資料庫空間可用 t3 doctor 回收。本文以 2026 年 11 月 18 日的穩定版 v0.1.10 為基準,後續變更以官方發布紀錄為準。
T3 Code 常見問題
T3 Code 免費版有功能限制嗎?
T3 Code 本體採 MIT 授權並免費提供。代理訂閱用量依各供應商方案計算。T3 Connect 免費帳號可連結 3 台執行 T3 Code 的機器,手機和瀏覽器不計入。需要連結更多主機時,可使用 T3 Chat Pro 或 Premier。若裝置已能直接連到主機,也可用區網配對或 Tailscale。
用 T3 Code 會違反 Claude Code 或 Codex 的服務條款嗎?
T3 Code 團隊表示,它對 Claude Code 與 Codex 的官方整合依兩家供應商的規則運作。用量仍按各供應商的方案計算。若自行用 proxy 共用多帳號額度,應先查帳號與方案條款。
為什麼設定裡看不到我裝好的代理?
先檢查代理 CLI 是否裝在執行 T3 Code 伺服器的那台機器,並確認該機器的 PATH 找得到它。用 CLI 的話,先在主機登入,例如 codex login 或 claude auth login。再到 Settings → Providers 選正確的環境並啟用供應商,必要時用 Binary path 指定執行檔。透過 ChatGPT 連線的 Codex 和由 T3 Code 管理的 Antigravity 可使用自己的 runtime。官方供應商設定列有各代理的登入方式。
Windows 與 WSL 要怎麼跑?
Windows 有原生的 winget 與 Scoop 套件,桌面版與 CLI 都能直接用,PowerShell 也有一鍵安裝腳本,操作與 macOS、Linux 對等,更新同樣走 t3 update 指令。代理可以跑在 WSL 裡面,T3 Code 支援這種混合配置,文件將 WSL 列為正式安裝路徑之一。背景服務在 0.1.10 起支援以 Windows 服務形式運作並遠端更新,想改跟 nightly 版本的讀者再設 T3CODE_CHANNEL 環境變數就行。
介面有繁體中文嗎?
截至 v0.1.10,內建的中文選項是簡體中文。官方發布紀錄指出 Settings 支援九種語言,切換時不用重新載入 app,翻譯範圍以已支援的設定頁文字為主。
thread 停掉之後可以接著跑嗎?
v0.1.10 的 native resume支援把停下的 Claude、Codex、OpenCode 與 Cursor thread 直接接續執行,不必補一條新訊息。伺服器保存完整 thread 歷史,重啟後照常讀取,工作目錄與分支也跟著 thread 走,訊息佇列裡排隊的內容依序送達,跨天的長專案可以直接接手,脈絡完整保存在伺服器。對話層的逐訊息回溯則依 provider 而定,Antigravity、Muse Code 與 ACP 代理不支援這段機制。
一個專案同時開多條 thread 安全嗎?
開 worktree 的 thread 之間檔案互不干擾,平行跑多條任務正是這個設計的目的。要小心的是 worktree 共用的外部資源,兩份程式可能搶同一個埠、容器名稱或本機資料庫,t3.json 的 runOnWorktreeCreate 腳本可以在建立時分配資源。current checkout 只建議一條寫入者的 thread,同目錄有別的 thread 在工作時,T3 Code 也會拒絕觸發檔案還原。






討論與提問