T3 Code: điều khiển AI coding agent từ điện thoại

Bạn giao cho Claude Code một task dài rồi rời bàn làm việc. Giữa chừng, agent hỏi một câu cần phê duyệt, hoặc dừng lại vì gặp lỗi. Mở SSH trên điện thoại lúc này vẫn làm được việc, nhưng không được thiết kế cho việc giám sát agent: bạn cần thấy phiên đang ở đâu và quyết định cho phép hay dừng lại nhanh chóng, rõ ràng.

T3 Code sinh ra cho đúng khoảng trống đó. Nó không phải một coding agent mới, cũng không thay thế Claude Code, Codex hay Cursor. Nó là lớp điều khiển đặt lên trên các agent đó, để bạn mở thread, theo dõi tiến trình và phê duyệt từ điện thoại, web hoặc máy tính khác, trong khi agent vẫn chạy trên máy chủ của bạn.

Nói thẳng từ đầu: dự án tự nhận còn rất sớm và có thể gặp lỗi. Các bước dưới đây đối chiếu tài liệu chính thức; mình chưa chạy thử toàn bộ luồng trên máy thật.

T3 Code là gì?

Dự án dùng thuật ngữ “agent harness control surface”. Hiểu đơn giản: agent thật sự viết code vẫn là Claude Code, Codex, Cursor, OpenCode hoặc một provider khác bạn đã cài đặt. T3 Code chỉ là bề mặt để mở phiên, xem agent đang làm gì và trả lời các điểm cần phê duyệt, từ một thiết bị khác.

Sự phân biệt này quyết định kỳ vọng. T3 Code không làm code tốt hơn, không chọn model thay bạn, và không gộp billing của các provider thành một hóa đơn. Cái được thống nhất chỉ là nơi bạn điều khiển các phiên làm việc.

Theo mình, nhóm hưởng lợi rõ nhất là người đã chạy AI coding agent hằng ngày và thường phải rời máy khi agent còn chạy. Nếu bạn chỉ mở agent vài phút rồi ngồi xem trực tiếp, T3 Code chỉ thêm một lớp trung gian không cần thiết. Nếu bạn cần hệ thống ổn định cho doanh nghiệp, dự án nightly này chưa phù hợp.

Tổng quan: một giao diện cho nhiều provider

Tại ngày kiểm chứng 2026-11-02, T3 Code hỗ trợ Claude Code, Codex, Cursor, Grok Build, OpenCode, Google Antigravity và fx. Điều kiện bắt buộc là ít nhất một provider phải được cài đặt và xác thực trước khi mở thread đầu tiên. Không có provider, T3 Code không có agent nào để điều khiển.

Về thiết bị điều khiển, bạn có ba lựa chọn: ứng dụng di động cho iOS và Android, ứng dụng web tại app.t3.codes, và ứng dụng desktop Electron.

Điều khiển từ điện thoại, trong thực tế, nghĩa là ba việc: mở và theo dõi phiên làm việc, xem agent đã thay đổi những gì, và phê duyệt hoặc dừng các bước cần can thiệp. Điện thoại ở đây là thiết bị giám sát và quyết định, còn việc viết code nặng vẫn thuộc về agent chạy trên host. Model, giới hạn sử dụng và quyền tool vẫn do CLI gốc và tài khoản của provider đó quyết định.

Kiến trúc và cơ chế hoạt động

Theo mình, đây là phần đáng hiểu nhất, vì nó giải thích cả tiện lợi lẫn rủi ro. Mô hình gồm ba thành phần: host chạy agent, T3 server chạy trên host, và control surface là ứng dụng điện thoại, web hoặc desktop. Host là nơi code thật sự được đọc, sửa và chạy. T3 server nhận lệnh từ thiết bị điều khiển và chuyển cho agent, đồng thời đẩy trạng thái phiên về cho bạn. Control surface chỉ gửi lệnh và hiển thị trạng thái.

Vì vậy, trải nghiệm phụ thuộc vào host và mạng nhiều hơn vào chiếc điện thoại. Host tắt, ngủ, mất mạng hoặc bị firewall chặn là bạn mất điều khiển.

T3 Connect đi qua tài khoản T3: trên host, bạn vào Settings, mục Sharing & access, đăng nhập tài khoản và bật T3 Connect, rồi chạy t3 up hoặc t3 connect. Trên thiết bị khác, bạn đăng nhập cùng tài khoản và chọn environment tương ứng. Cách này tiện khi bạn ở ngoài mạng nhà, nhưng bạn thêm một tài khoản trung gian vào chuỗi tin cậy, và tài khoản miễn phí giới hạn liên kết 3 máy.

LAN pairing đi trong mạng nội bộ: bạn chạy t3 up --lan hoặc t3 serve --lan, rồi dùng t3 pair để tạo link hoặc mã QR ghép nối. Thiết bị quét mã hoặc mở link đó sẽ được ủy quyền cho các lần kết nối sau. Cách này không phụ thuộc tài khoản trung gian, nhưng chỉ an toàn khi mạng nội bộ thật sự đáng tin, và không dùng được khi bạn rời khỏi mạng đó.

Service chạy nền chỉ có trên macOS và Linux; trên Windows cần giữ terminal chạy lệnh serve. Không có binary t3 cho Mac Intel. T3 Code cũng không phải service Docker Compose tiêu chuẩn.

Hướng dẫn triển khai từng bước

Trước khi cài đặt, kiểm tra: hệ điều hành của host, ít nhất một provider đã cài đặt và xác thực, và mạng — cùng mạng LAN để dùng pairing, hoặc tài khoản T3 Connect để truy cập từ xa.

Bài này đối chiếu tài liệu tại ngày 2026-11-02: kho pingdotgg/t3code, giấy phép MIT, TypeScript, khoảng 38.828 star và 8.963 fork, bản nightly v0.1.7-nightly.20261102.4066. Cần ghi rõ phiên bản vì nhịp nightly thay đổi nhanh.

Trên macOS và Linux, lệnh cài đặt chính thức là curl -fsSL https://t3.codes/install.sh | sh. Trên Windows, mở PowerShell và chạy irm https://t3.codes/install.ps1 | iex. Nếu chỉ muốn thử nhanh, dùng npx t3@latest, nhưng cách này cần Node.js và phù hợp cho một lần thử nghiệm hơn là vận hành lâu dài.

Để điều khiển từ máy tính khác: Windows dùng winget install T3Tools.T3Code, macOS dùng brew install --cask t3-code, Debian/Ubuntu tải gói .deb từ trang Releases rồi cài bằng sudo apt install ./T3-Code-*.deb.

Chỉ cần đăng nhập provider mình sẽ dùng: codex login, claude auth login, agent login, grok login, opencode auth login, fx login. Cursor dùng agent login, còn Antigravity đăng nhập qua Settings bằng tài khoản Google. Hãy thử chạy provider gốc một lần trước khi mở T3 Code, để khi có lỗi bạn biết lỗi nằm ở provider hay ở lớp điều khiển.

Sau đó, chạy t3 để khởi động server và mở ứng dụng web cục bộ. Trên macOS và Linux, muốn chạy nền sau khi đóng terminal, chạy thêm t3 service install. Trên Windows, giữ một terminal chạy lệnh serve mà t3 up in ra. Cập nhật sau này dùng t3 update; với nhịp nightly, hãy thử bản mới trên máy ít quan trọng trước.

Qua T3 Connect: trên host, vào Settings, mục Sharing & access, đăng nhập tài khoản và bật T3 Connect, rồi chạy t3 up hoặc t3 connect. Nếu kết nối qua SSH, CLI sẽ in ra một link trình duyệt kèm mã ngắn để phê duyệt. Trên điện thoại, đăng nhập cùng tài khoản và chọn environment tương ứng.

Qua LAN: khi điện thoại và host cùng mạng nội bộ, chạy t3 up --lan hoặc t3 serve --lan trên host, rồi chạy t3 pair để tạo link hoặc mã QR ghép nối. Quét mã hoặc mở link trên điện thoại để hoàn tất. Sau lần đầu, thiết bị được ủy quyền cho các lần sau, nên hãy coi link và mã QR này như một chìa khóa, chỉ dùng trên thiết bị tin cậy.

Để kiểm chứng, chạy t3 --help để xác nhận CLI đã vào PATH. Khi chạy t3 up, bạn kỳ vọng nhận được link hoặc mã phê duyệt, thay vì lỗi provider chưa xác thực. Trên điện thoại sau ghép nối, bạn kỳ vọng thấy environment đã liên kết.

Đánh giá kỹ thuật

Điểm mạnh rõ nhất là tính thống nhất: một giao diện cho nhiều agent, thay vì mỗi provider một cửa sổ terminal và một thói quen thao tác khác nhau. Điểm mạnh thứ hai là sự tách biệt giữa host và thiết bị điều khiển: bạn không cần mang laptop theo. Điểm mạnh thứ ba là tốc độ can thiệp: phê duyệt hoặc dừng một bước từ điện thoại nhanh hơn mở laptop, kết nối SSH và tìm đúng phiên.

Ngược lại, dự án tự nhận còn rất sớm, nên bug và thay đổi breaking là điều cần tính trước. Tính năng của từng provider qua giao diện chung có thể không đầy đủ như khi dùng CLI gốc. Host phải luôn bật và reachable. Giới hạn 3 máy của tài khoản miễn phí sẽ trở thành rào cản nếu bạn có nhiều host hơn.

Về bảo mật, đây là phần theo mình cần thận trọng nhất. Khi ghép nối một thiết bị hoặc đăng nhập T3 Connect, bạn trao cho thiết bị hoặc tài khoản đó quyền chạm tới các phiên agent trên host, mà agent lại có quyền thực thi code. Lộ pairing link, mã QR hoặc tài khoản T3 Connect vì vậy có thể cho người khác quyền điều khiển agent chạy code, không chỉ xem màn hình.

Vì vậy, vài kỷ luật là bắt buộc: chỉ ghép nối thiết bị bạn tin cậy; thu hồi quyền của thiết bị không còn dùng; và trước khi bấm phê duyệt trên màn hình nhỏ, hãy xem đủ diff và ngữ cảnh, đừng phê duyệt chỉ vì agent hỏi. Nếu cần truy cập từ xa mà vẫn muốn giảm phụ thuộc vào tài khoản trung gian, hãy cân nhắc VPN riêng như NetBird.

Hiện chưa có kết quả audit bảo mật độc lập nào được trích dẫn trong tài liệu đối chiếu, nên bài này không khẳng định mức an toàn vượt ra ngoài tài liệu chính thức.

Về hiệu năng, bài này không đưa ra con số latency, pin hay băng thông, vì không có benchmark độc lập và không có phép đo thực tế. Giới hạn thực tế nằm ở host, provider và mạng.

Về vận hành, hãy sao lưu cấu hình T3 Code và thông tin xác thực provider trên host. Nếu cần quay lại bản cũ, hãy dừng service hoặc đóng terminal serve, quay lại bản trước đó, thu hồi pairing không còn dùng, rồi xác nhận CLI gốc vẫn hoạt động.

So sánh với các lựa chọn cùng phạm vi

So sánh dưới đây dùng cùng tiêu chí: số provider, trải nghiệm điện thoại, đường truy cập từ xa, tự chủ dữ liệu, độ trưởng thành và chi phí.

SSH kết hợp terminal di động cho mức tự chủ cao nhất và không tốn thêm dịch vụ trung gian, nhưng trải nghiệm giám sát và phê duyệt agent kém: bạn phải tự tìm phiên, tự đọc log, tự gõ lệnh phê duyệt.

Web UI hoặc chế độ serve riêng của từng agent, ví dụ OpenCode, gắn chặt với một provider: ít gánh nặng tài khoản ngoài, nhưng mất tính thống nhất khi dùng nhiều provider.

VS Code Tunnel hoặc SSH mạnh cho lập trình từ xa nói chung, nhưng không phải control surface chuyên cho phiên agent.

Use case thực tế theo từng đối tượng

Với lập trình viên cá nhân, kịch bản rõ nhất là giao task dài cho agent rồi rời bàn: kiểm tra tiến trình từ điện thoại, phê duyệt khi agent hỏi, dừng lại khi thấy hướng đi sai.

Với người dùng homelab, T3 Code biến một máy chủ tại nhà thành agent host luôn bật, điều khiển được qua T3 Connect hay VPN riêng. Nhưng “luôn bật” là cam kết vận hành thật sự: nguồn điện, tản nhiệt, cập nhật và sao lưu của host đều trở thành một phần của quy trình.

Với người làm việc đa provider, giá trị nằm ở việc chuyển đổi trong một giao diện chung. Bài viết về cc-switch đi sâu vào việc chuyển provider ở tầng CLI, còn T3 Code giải quyết ở tầng điều khiển phiên — hai lớp khác nhau và có thể kết hợp.

Với DevOps hoặc quản trị IT, T3 Code giúp giám sát agent trên máy chủ và can thiệp kịp thời khi task kẹt. Tuy nhiên, đừng dùng dự án nightly cho hệ thống production nhạy cảm; hãy giới hạn ở máy chủ thử nghiệm.

Với nhóm nhỏ trong doanh nghiệp, T3 Code phù hợp cho thử nghiệm nội bộ. Triển khai diện rộng nên chờ tới khi dự án có audit và chính sách ổn định hơn. Nếu nhóm chạy nhiều agent song song, worktrunk đáng xem, và nếu agent cần bộ nhớ xuyên phiên, claude-mem giải quyết một lớp khác.

Kết luận: phù hợp với ai, không phù hợp với ai

Nên dùng ngay nếu bạn đã chạy Claude Code, Codex hoặc OpenCode hằng ngày, có một host luôn bật, và muốn phê duyệt agent từ điện thoại thay vì quay lại bàn làm việc mỗi lần agent hỏi.

Nên chờ hoặc tránh nếu bạn cần một service Docker self-host thuần túy, cần độ ổn định cho triển khai doanh nghiệp, hoặc không chấp nhận rủi ro của một dự án nightly tự nhận còn rất sớm.

Bước tiếp theo, theo mình, là thử bằng npx t3@latest trên một máy không quan trọng, ghép nối đúng một thiết bị duy nhất, và kiểm chứng trọn vẹn luồng phê duyệt.

Tham khảo

• Kho mã nguồn và tài liệu chính thức: https://github.com/pingdotgg/t3code
• Trang chủ và hướng dẫn cài đặt: https://t3.codes
• Tài liệu cài đặt: https://github.com/pingdotgg/t3code/blob/main/docs/user/install.md
• Tài liệu truy cập từ xa: https://github.com/pingdotgg/t3code/blob/main/docs/user/remote-access.md