讓 T3 Code 住進 Dev Container

package: devcontainer-t3code
era: agent
created_at: 2026/10/05 16:00:00
link: https://github.com/laijunbin/devcontainer-t3code

cover image

非官方專案，與 T3 Code 的維護者無關。

把 Dev Container 當成 T3 Code 的環境來用：Agent 在容器裡執行，由 T3 Code 桌面程式操作，容器不對外發布任何連接埠。

完整的來龍去脈可以看這篇文章：讓 T3 Code 住進 Dev Container

由兩個部分組成：

部分 執行位置 做什麼
t3-server Dev Container 裡 一個 Dev Container Feature：提供只能透過 docker exec 進入的 SSH 入口與資料 volume，桌面程式會經由它安裝並啟動和自己同版本的伺服器
t3-dev 執行 Docker 的主機 把每個這樣的容器登記成桌面程式看得到的 SSH 主機，也可以讓手機透過 Tailscale 連到各專案

快速開始

適用於 Windows，Docker 裝在 WSL 裡，T3 Code 桌面程式 0.1.0 以上。

  1. 在專案的 devcontainer.json 加上 Feature：
"features": {
  "ghcr.io/laijunbin/devcontainer-t3code/t3-server:1": {}
}
  1. 在 WSL 裡下載 t3-dev 並讓它自己安裝，只需要做一次：
$ curl -fsSLO https://github.com/laijunbin/devcontainer-t3code/releases/latest/download/t3-dev
$ bash t3-dev setup && rm t3-dev

  1. 啟動 Dev Container。

  2. 在 T3 Code：Settings -> Connections -> Add environment -> SSH，選 t3-<資料夾名稱>。第一次連線時，桌面程式會把伺服器下載到容器裡，之後 T3 Code 更新也會自動換版，Feature 不需要跟著改。

從 :0 升級：:0 是把固定版本(0.0.45)的伺服器裝進映像的舊設計，只能搭配 0.0.45 的桌面程式。改成 :1 並重建容器即可，Thread 都會保留。

手機存取

用手機的瀏覽器連回電腦，看到所有專案的 Thread，也能回覆 Agent。透過 Tailscale，只有自己的裝置連得到，預設關閉。

  1. 電腦和手機都安裝 Tailscale，登入同一個帳號，在管理頁面開啟 MagicDNS 與 HTTPS Certificates。
  2. 建立手機的入口(一個沒有專案的 Dev Container)，照指令的提示用 VS Code 開啟，並在 T3 Code 加入 t3-hub：
$ t3-dev hub init
  1. 啟用手機存取，並在手機打開它印出的入口網址：
$ t3-dev phone on
  1. 配對入口，把連結貼到手機入口的登入畫面：
$ t3-dev phone pair hub
  1. 加入各專案(名稱用 t3-dev phone 列出的)，把連結貼到手機的 Settings -> Connections -> Add environment：
$ t3-dev phone pair <host>

每個專案在手機上只要加入一次。在 iPhone 上建議先把入口「加入主畫面」再配對，主畫面的 App 和 Safari 的資料是分開的。

其他選項、疑難排解與安全性說明請看 repo 裡的文件。

前往GitHub