T3 Code Windows 安裝教學:用網頁介面管理 Codex、Claude、Cursor 與 OpenCode

T3 Code Windows 安裝與排錯指南:透過 winget 或 npx 啟動網頁 GUI,連接 Codex、Claude、Cursor、OpenCode,並處理登入、連接埠和遠端存取問題。

T3 Code 的本篇教學圍繞著標題中的具體任務。 T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

下面使用測試環境和可撤銷資料演示。涉及帳號、金鑰、機器控制、投資或緊急通訊時,必須再做人工確認。

T3 Code 管理的是會話而不是模型帳號

這一節只處理「T3 Code 管理的是會話而不是模型帳號」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-Command codex, claude -ErrorAction SilentlyContinue

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

Windows 上先核對 Node.js 版本

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
2
node --version
npm --version

完成標準是「Windows 上先核對 Node.js 版本」得到可核驗結果,而不是指令剛好沒有報錯。

從官方倉庫取得原始碼

檢查項 通過標準 停止訊號
從官方倉庫取得原始碼 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
git clone https://github.com/pingdotgg/t3code.git

出現停止訊號時先恢復,不要繼續下一步。

安裝依賴前查看套件管理器鎖定文件

這一節只處理「安裝依賴前查看套件管理器鎖定檔案」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-ChildItem -Name *lock*

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

啟動 Web UI 後確認監聽位址

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
netstat -ano | Select-String '3000|5173'

完成標準是「啟動 Web UI 後確認監聽位址」得到可核驗結果,而不是指令剛好沒有報錯。

Codex 找不到時檢查 PATH 繼承

檢查項 通過標準 停止訊號
Codex 找不到時檢查 PATH 繼承 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
Get-Command codex

出現停止訊號時先恢復,不要繼續下一步。

Claude 已登入但 T3 Code 未識別

這一節只處理「Claude 已登入但 T3 Code 未識別」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
2
Get-Command claude
claude --version

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

多個專案目錄如何分開授權

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
git worktree list

完成標準是「多個專案目錄如何分開授權」得到可核驗結果,而不是命令剛好沒有報錯。

會話清單與真實進程如何對應

檢查項 通過標準 停止訊號
會話清單與真實流程如何對應 輸入、輸出與權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
Get-Process node,codex -ErrorAction SilentlyContinue

出現停止訊號時先恢復,不要繼續下一步。

瀏覽器頁面打不開先查什麼

這一節只處理「瀏覽器頁面打不開先查什麼」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Test-NetConnection 127.0.0.1 -Port 3000

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

遠端存取為什麼不能直接開放端口

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
Get-NetTCPConnection -State Listen

完成標準是「遠端存取為什麼不能直接開放連接埠」得到可核驗結果,而不是命令剛好沒有報錯。

反向代理前先解決應用認證

檢查項 通過標準 停止訊號
反向代理前先解決應用認證 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
# 未确认认证能力前保持 127.0.0.1

出現停止訊號時先恢復,不要繼續下一步。

Agent 修改檔案後從 Git 驗收

這一節只處理「Agent 修改檔案後從 Git 驗收」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
2
git status --short
git diff --stat

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

結束會話不等於結束子進程

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
Get-Process node,codex -ErrorAction SilentlyContinue

完成標準是「結束會話不等於結束子程序」得到可核驗結果,而不是指令剛好沒有報錯。

升級 T3 Code 時要保留什麼

檢查項 通過標準 停止訊號
升級 T3 Code 時保留什麼 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
git rev-parse HEAD

出現停止訊號時先恢復,不要繼續下一步。

卸載後恢復原 CLI 工作流程

這一節只處理「卸載後恢復原 CLI 工作流程」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
2
codex --version
claude --version

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

不同 Agent 的工作目錄不能混用

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
git worktree list

完成標準是「不同 Agent 的工作目錄不能混用」得到可核驗結果,而不是指令剛好沒有報錯。

Web UI 刷新後會話仍在不在

檢查項 通過標準 停止訊號
Web UI 刷新後會話仍在不在 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
Get-Process node,codex -ErrorAction SilentlyContinue

出現停止訊號時先恢復,不要繼續下一步。

後台啟動時日誌應該寫到哪裡

這一節只處理「後台啟動時日誌應該寫到哪裡」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-ChildItem -Recurse -Filter *.log -ErrorAction SilentlyContinue

對 T3 Code 來說,判斷結果時必須結合這一邊界:T3 Code 是管理多個編碼 Agent 的網頁介面;它不會取代 Codex、Claude、Cursor 或 OpenCode 本身的安裝、登入和權限模型。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

T3 Code 的最終核對

  • 使用的版本和來源已經記錄。
  • 測試輸入與正式資料已經隔離。
  • 命令、配置和實際輸出能夠對應。
  • 失敗路徑至少主動測試過一次。
  • 金鑰、帳號和私人資料沒有進入 Git 或日誌。
  • 升級、停止和恢復都有明確動作。

如果仍無法解釋結果如何產生,就繼續把 T3 Code 保持在測試環境,不要擴大權限或取代現有穩定流程。