pingdotgg/t3code 跨裝置遙控程式代理實戰:從桌機到手機無縫調度 Claude Code 與 Codex

pingdotgg/t3code 讓工程師能跨桌機與手機遠端調度 Claude Code 與 Codex 等終端機代理,一篇拆解其輕量架構、安裝方式與多裝置協作安全邊界。

Share
t3code官方 GitHub 專案封面圖:t3code 教學
t3code官方開源專案視覺圖。 圖片來源:官方原文。

寫程式時最無奈的場景之一,就是你在公司桌機開了一個龐大的重構任務給 AI 代理跑,快下班時它還沒跑完,結果隔天回來才發現它中途卡在一個指令權限確認,整晚算力完全空轉。

這篇 t3code 教學要帶你實戰的,正是近期在開發者社群爆紅的開源控制面板。它讓你在桌機啟動任務後,走進捷運站就能直接拿出手機核准指令、切換模型,甚至一鍵建立拉取請求。

先講我的結論:如果你同時使用 Claude Code、Codex 或 Cursor 等多種終端機代理,又常有離開座位後遠端監工的需求,這套工具非常值得立刻裝起來。但如果你只用單一編輯器寫簡單腳本,或公司內網嚴禁任何外部中繼連線,那用傳統本機終端機就好。

與市面上賣 Token 額度的雲端開發平台不同,它採用完全開放的 MIT 授權,也不轉售任何模型算力。它做的是「本機代理的統一控制平面」,直接驅動你電腦裡已經登入帳號的各大代理,而且所有程式碼檔案與執行過程都留在你自己的硬體上。

接下來我會從它的控制平面架構講起,完整示範桌面版與命令列安裝、T3 Connect 與區網配對設定、四種權限模式的切換差異,以及多裝置遙控時必須守住的安全防線。

什麼是 pingdotgg/t3code?控制平面架構與核心亮點

簡單來說,它是一套把「代理執行」與「操作介面」拆開的開源控制中心。代理本身依然跑在你自己可控的電腦或工作站上,負責讀取本機檔案與執行測試。控制中心則把對話串流同步到桌面端、網頁端與 iOS、Android 手機應用程式。

因為所有客戶端連線的都是同一台主機上的伺服器,你在桌機開了一條任務執行緒,出門後打開手機 App 看到的會是完全同步的進度。甚至當某個代理在半路卡關時,你可以在同一條對話裡直接把後續步驟交棒給另一家模型接手,不需要重新解釋上下文。

目前它原生支援的代理陣容相當完整,包含 Claude Code、Codex、Cursor、OpenCode、Grok Build、Antigravity、Kiro、Pi、Muse Code 與 fx。只要是有實作 ACP 協定的代理,或是已經在你電腦裡完成認證的工具,都能直接納管。

在效能設計上,開發團隊把畫面流暢度視為核心指標,即使同時開著好幾個正在高速串流輸出的對話執行緒,切換與捲動依然保持順滑,不會像傳統終端機或網頁外殼一樣卡頓掉幀。

在版控整合方面,這套工具把 Git 工作流程做得非常直覺。每一條任務執行緒都可以獨立建立專屬的 Git Worktree 工作目錄,讓多個平行任務各自改檔卻不會互相覆蓋衝突。

等代理改完程式碼後,你可以直接在手機或桌面上檢視乾淨的 Diff 差異,確認沒問題就一鍵完成提交、推送遠端分支並開啟拉取請求,整個過程完全不用切回終端機敲複雜的 Git 指令。

延伸閱讀:Apple 宣布 macOS 27.3 拆分裝置控制與資料存取權限:AI 代理時代的 Mac 資安新防線

t3code官方 GitHub 專案封面圖:t3code 教學
t3code官方開源專案視覺圖。 圖片來源:官方原文。

t3code 教學:安裝桌面端、CLI 與前置代理認證

在動手安裝控制面板之前,有一個前提必須先確認:這套工具本身不包含語言模型,所以你的主機上至少要先裝好並登入一個支援的程式代理。

例如,你可以先安裝 Claude Code 並執行 claude auth login 完成帳號授權,或是安裝 Codex CLI 並執行 codex login。只要本機代理能正常運作,控制中心就能立刻接管。

步驟一:安裝桌面端應用程式或命令列工具

官方針對各作業系統都提供了極為簡便的套件管理器安裝方式,桌面版包含 macOS、Windows 與 Linux 三大平台。如果你習慣在無圖形介面的遠端 Linux 主機或工作站上執行,也可以直接安裝 t3 命令列工具。

# macOS 使用 Homebrew 安裝桌面版
brew install --cask t3-code

# macOS / Linux 安裝 CLI 命令列工具
curl -fsSL https://t3.codes/install.sh | sh

# 免安裝直接試用一次
npx t3@latest

Windows 使用者則可以選擇 winget install T3Tools.T3Code 或 scoop install extras/t3code 來取得桌面版,若要安裝命令列版本則在 PowerShell 執行對應腳本即可。

Linux 桌面環境也支援得很完整,Arch 使用者可以透過 yay -S t3code-bin 取得套件,Nix 使用者可直接從不穩定頻道安裝,Ubuntu 與 Debian 用戶則能到官方發布頁面下載獨立封裝檔。

irm https://t3.codes/install.ps1 | iex

步驟二:啟動本地伺服器與配對手機端

安裝完命令列工具後,直接在終端機輸入 t3 就會啟動本機伺服器並自動打開網頁介面。接著只要前往 App Store 或 Google Play 下載官方手機應用程式,就能準備進行跨裝置連線。

如果你使用桌面版應用程式,只要把視窗開著並啟用本機環境,伺服器就會維持連線;但要注意一旦關閉桌面版最後一個視窗,本機伺服器也會隨之停止運作,這點在離開座位前特別容易忘記。

跨裝置遠端連線實戰:T3 Connect 與區網配對設定

想要在離開電腦後還能用手機遙控代理,官方提供兩種完全不同的連線架構,分別適用於跨網域外出與純內網環境。

第一種方式是使用官方的 T3 Connect 中繼服務。它的好處是不必設定路由器通訊埠轉發,也不需要懂複雜的防火牆規則,在桌面版進入設定裡的 Sharing & access 登入並開啟即可。

如果是沒有桌面介面的命令列主機,只要執行 t3 up 或 t3 connect,系統就會在背景啟動常駐服務並引導你完成裝置認證。就算透過 SSH 連線操作,終端機也會印出驗證網址與短代碼,讓你在手機或筆電瀏覽器點一下就完成授權,完全免去本地回呼埠轉發的麻煩。

# 引導設定並啟動背景遠端服務
t3 up

# 直接啟用 T3 Connect 遠端連線
t3 up --connect

# 查看目前遠端服務與連線狀態
t3 status
t3 status --json

在裝置額度方面,每個免費的 T3 Connect 帳號預設可以綁定最多 3 台主機電腦,手機與瀏覽器客戶端則不計入上限。如果你有串接 T3 Chat 付費方案,綁定上限會放寬到 Pro 版的 10 台與 Premier 版的 100 台。

第二種方式則是完全不經過外部伺服器的「區網或虛擬私人網路配對」。如果你的電腦與手機在同一個區域網路,或者已經用 Tailscale 串起私有網路,建議優先走這條路線,延遲更低也更隱密。

# 啟動僅限區域網路與 Tailnet 連線的服務
t3 up --lan

# 若伺服器已在運行,直接產生新的配對 QR Code 與連結
t3 pair

執行 t3 pair 後,終端機或桌面設定頁會產生專屬的配對連結與 QR Code。用手機 App 掃描一下就能立刻接上主機,不過要留意網址列上的位址不能是 127.0.0.1 本機迴環位址,否則其他裝置會連不到。

四種權限模式解析與跨代理差異比較表

當代理在背景跑任務時,你最常在手機上收到的通知就是「請求核准執行終端機指令或修改檔案」。為了平衡開發效率與系統安全,控制面板提供四種權限層級,在對話中按下 mod+shift+a 就能快速切換。

必須特別提醒的是,系統初始預設值為 Full access 全權限模式。雖然這樣代理跑得最快,但面對陌生專案或高風險重構時,建議在建立新執行緒的設定中把預設權限調降,或是針對單一對話手動降級。

權限模式 運作行為 適用情境與注意事項
Supervised 所有指令執行與檔案變更都必須人工核准 修改正式環境設定、刪除資料夾等高風險任務
Auto-accept edits 自動放行程式碼編輯,其餘指令仍須確認 日常功能開發,想把關測試與系統指令時
Auto 交由各代理內建的自動安全審查決定是否放行 Codex、Claude、Cursor 等支援自動審查的代理
Full access 不跳出確認提示,直接允許執行指令與改檔 搭配獨立 Git Worktree 進行實驗性原型開發

此外,不同底層代理對這四種模式的支援度並不完全一致,這在跨模型切換時非常關鍵。例如 Muse Code 與 Kiro 僅支援 Supervised 與 Full access 兩種模式。而 fx 代理為了安全考量,完全不允許套用 Auto-accept edits 與 Full access,即便強制選取也會自動退回人工確認模式。

更實用的細節是,當 Claude Code 在等待你的指令核准時,如果你覺得它的指令參數不妥,不用急著按拒絕,直接在對話框輸入文字回饋即可退回該筆請求並讓它現場修正。

同時,子代理觸發的核准請求也會直接呈現在父層對話裡,不用在多個視窗之間切來切去就能統一批示。若你想在腳本裡自動化設定遠端連線,也可以善用 t3 up --connect --yes 或 t3 up --lan --yes 等無互動旗標,搭配 t3 status --json 檢查目前狀態。

多裝置遠端協作的安全邊界與必做防護

把本機的程式碼修改與 Shell 執行權限暴露到手機端,資安防護是不能妥協的底線。官方在遠端連線設計了幾道保護機制,建議每位使用者在啟用當天就一併打開。

第一道防線是開啟「新裝置核准鎖」。預設情況下,只要登入同一個 T3 Connect 帳號的任何新裝置都能直接存取已綁定的主機。一旦你的帳號密碼不幸外洩,攻擊者就能遠端控制你的開發機。

請務必在 Sharing & access 設定中勾選 Require approval for new devices。開啟後,任何未經授權的新設備嘗試連線時,畫面上會出現一組有時效性的配對碼例如 K7QM-2XFD。

這組配對碼必須由已經連線的信任設備點選核准,或是在無頭主機上執行以下指令驗證放行,超過 10 分鐘未處理請求就會自動失效。

# 查看等待核准的新裝置清單與驗證碼
t3 auth connect-device list

# 確認配對碼相符後放行裝置
t3 auth connect-device approve K7QM-2XFD

# 若懷疑裝置遺失,立即撤銷該裝置存取權限
t3 auth connect-device revoke K7QM-2XFD

第二道防線是留意區網模式的存取範圍。當你使用 t3 up --lan 或 t3 serve --lan 開放網路存取時,同一個咖啡廳 Wi-Fi 或公司內網裡的其他機器都能試著連線你的服務埠,此時唯一擋在外面的是配對連結裡的驗證碼。

因此,在外使用公共網路時千萬不要隨意開啟區網分享,改用加密的 Tailscale 虛擬內網或受裝置鎖保護的中繼通道才安全。

第三道防線則是工作站權限治理。如果是企業團隊配發的電腦,系統管理員也能透過受管政策檔案限制該台主機最高只能開到哪一種權限模式,從源頭鎖死全權限放行的風險。

延伸閱讀:Anthropic 宣布 2027 年起將高風險資安漏洞揭露期從 90 天縮至 30 天:AI 挖漏洞太快,軟體修補來得及嗎?

常見問題

這套工具需要付費訂閱才能遠端操控代理嗎?

不需要。專案本體採 MIT 開源授權完全免費,T3 Connect 遠端中繼也免費提供最多 3 台主機電腦的綁定額度,而且不會在你的模型 API 用量上抽成,你用的全都是自己原本已經登入的代理額度。

為什麼我在手機上看到主機顯示離線?

這通常是因為你在電腦上關掉了桌面版的所有視窗,導致內建的本機伺服器跟著關閉。若需要長時間出門遠端監工,建議改用命令列執行 t3 up 讓它以背景常駐服務的方式運行。

在同一條對話裡把任務從 Claude 交棒給 Codex 會遺失脈絡嗎?

不會。這正是控制平面的核心設計之一,所有對話歷史與 Git Worktree 狀態都由底層伺服器統一管理,你在對話中途切換模型或代理後,新接手的代理能繼續在同一個工作目錄接力完成任務。

如果手機遺失了,怎麼快速切斷它對公司電腦的控制權?

只要在桌機的 Sharing & access 設定頁面找到已綁定的裝置清單將該手機移除,或是在終端機執行 t3 auth connect-device revoke 加上該裝置代碼,就能立刻撤銷存取權限;同時建議確認已開啟新裝置核准鎖,防止該設備再次自動連入。

結語

整份 t3code 教學實測下來,它最打動工程師的地方,在於用極為輕量且高效能的架構,把原本被綁死在單一終端機視窗裡的 AI 代理徹底解放出來。加上原生整合的 Git Worktree 隔離與手機端核准機制,讓非同步寫程式真正成為日常。

  • 適合誰:同時訂閱或使用多種終端機 AI 代理的工程師、習慣用多條 Git Worktree 平行開發的技術人員,以及常需要離開座位用手機遠端確認進度與批示權限的開發者。
  • 不適合誰:只使用單一編輯器行內補全功能的使用者、電腦環境無法安裝任何原生命令列代理的新手,以及處於絕對實體斷網、完全不允許跨裝置連線的軍工或金融內網環境。
  • 為什麼:因為它本身是代理的遙控器與調度中心,只有當你已經習慣驅動多個命令列代理工作時,這種跨裝置、跨模型與視覺化 Diff 的整合體驗才會帶來倍數級的效率提升。

如果你想持續獲得更多開源 AI 開發工具的第一手實戰評測與架構拆解,歡迎免費訂閱 AI 郵報,每週精選最實用的技術攻略直送你的信箱。

資料來源

Read more