close

T3 Code

Mã nguồn mở bởi pingdotgg

AI mã nguồn mởGit server & DevOps

T3 Code là giao diện điều khiển các agent lập trình AI đang cài trên máy bạn, như Claude Code, Codex, Cursor, OpenCode. Nó gồm một máy chủ chạy trên máy có mã nguồn, cùng ứng dụng desktop, web và điện thoại để giao việc và theo dõi agent từ xa. T3 Code không tự chứa mô hình AI: nó dùng tài khoản và gói đăng ký nhà cung cấp mà bạn đã có.

T3 Code dùng để làm gì?

  • Điều khiển Claude Code, Codex, Cursor, OpenCode, Grok Build… trong một giao diện chung
  • Giao việc và duyệt thao tác của agent từ điện thoại hoặc trình duyệt khi máy chạy agent ở nơi khác
  • Chạy máy chủ T3 Code trên VPS Linux như một dịch vụ nền để agent làm việc liên tục
  • Chọn mức quyền cho agent theo từng luồng công việc, từ hỏi trước mọi lệnh tới toàn quyền
  • Chia việc thành nhiều luồng (thread) chạy song song và sắp xếp chúng ở thanh bên

Cần biết trước khi dùng

  • Cần chú ýHướng dẫn cài có dạng "curl … | sh": chạy script từ Internet trực tiếp, nên đọc script trước khi chạy.
  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýDependency được khai báo theo khoảng phiên bản (ví dụ ">="), chưa tra lỗ hổng tự động được. Cần quét trên bản cài thật.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

T3 Code là gì?

Mỗi agent lập trình có giao diện riêng: Claude Code chạy trong terminal, Codex có ứng dụng riêng. T3 Code gom chúng về một chỗ. Theo tài liệu, T3 Code không phải harness: nó không biến mô hình thành agent mà gọi các harness có sẵn (Claude Code qua Anthropic Agent SDK, Codex App Server, ACP…) đã được cài và đăng nhập trên máy.

Kiến trúc gồm hai phần. Máy chủ T3 Code chạy trên máy đặt mã nguồn và CLI của nhà cung cấp: máy cá nhân, máy chủ hoặc VPS. Phía người dùng là ứng dụng desktop (Electron), web app tại app.t3.codes hoặc ứng dụng iOS, Android. Điện thoại chỉ là bộ điều khiển; máy chạy máy chủ phải luôn bật.

Để kết nối từ xa có ba cách: T3 Connect (dùng đường hầm Cloudflare qua cloudflared, cần tài khoản T3), ghép nối qua mạng LAN hoặc Tailscale bằng mã ghép nối, hoặc SSH. Theo FAQ, mã nguồn và prompt đi thẳng từ máy bạn tới nhà cung cấp mô hình; T3 Code chỉ gửi dữ liệu sử dụng cơ bản (nhà cung cấp, mô hình, tổng token) và tắt được bằng biến môi trường.

T3 Code miễn phí, giấy phép MIT. T3 Connect miễn phí cho tối đa 3 máy mỗi tài khoản; muốn thêm máy phải liên kết gói T3 Chat trả phí. README ghi rõ dự án còn rất sớm và dễ gặp lỗi.

Nên dùng khi

  • Bạn đã dùng Claude Code, Codex hoặc Cursor CLI và muốn quản lý nhiều luồng việc trong một giao diện
  • Bạn muốn để agent chạy trên VPS hoặc máy ở nhà và giao việc từ điện thoại
  • Bạn dùng nhiều nhà cung cấp và muốn chuyển qua lại mà không đổi công cụ

Không nên dùng khi

  • Bạn muốn dùng mô hình chạy tại chỗ: FAQ ghi T3 Code không hỗ trợ local model
  • Bạn chưa có tài khoản hay gói đăng ký của nhà cung cấp nào: T3 Code không có mô hình riêng
  • Máy chủ chứa dữ liệu quan trọng mà bạn chưa đổi chế độ quyền: mặc định luồng mới là Full access, agent chạy lệnh và sửa file không cần hỏi
  • Bạn cần công cụ ổn định cho cả nhóm: README ghi dự án còn rất sớm và chưa nhận đóng góp lớn

Tính năng chính

  • Hỗ trợ Codex, Claude Code, Cursor, Grok Build, OpenCode, Google Antigravity, Pi, Muse Code, fx
  • Ứng dụng desktop (Windows, macOS, Linux), web app và ứng dụng iOS, Android
  • Bốn chế độ quyền: Supervised, Auto-accept edits, Auto, Full access
  • Truy cập từ xa qua T3 Connect, LAN, Tailscale hoặc SSH
  • Chạy làm dịch vụ nền trên Linux (systemd user service) và macOS
  • Nhiều instance cho một nhà cung cấp, mỗi instance có biến môi trường và khoá API riêng
  • Lệnh t3 doctor dọn và thu gọn cơ sở dữ liệu
  • Chạy agent trong WSL trên Windows

Cách cài đặt T3 Code

  1. Cài và đăng nhập ít nhất một nhà cung cấp Ví dụ với Claude Code. Nhà cung cấp khác: codex login (Codex), agent login (Cursor), grok login (Grok Build), opencode auth login (OpenCode). CLI phải nằm trong PATH của máy chạy máy chủ T3 Code. 
    claude auth login
  2. Cài lệnh t3 (Linux, macOS) Cài file chạy t3 vào ~/.local/bin. Nếu báo command not found, thêm thư mục này vào PATH theo dòng trình cài in ra. Mac chip Intel không có file chạy t3, phải dùng ứng dụng desktop hoặc build từ mã nguồn. 
    curl -fsSL https://t3.codes/install.sh | sh
  3. Cài lệnh t3 (Windows, PowerShell) Trên Windows không có dịch vụ nền; giữ t3 serve chạy trong terminal hoặc để ứng dụng desktop mở. 
    irm https://t3.codes/install.ps1 | iex
  4. Khởi động máy chủ Mở máy chủ và web app trên máy. Dùng t3 serve nếu không cần mở trình duyệt. Muốn thử một lần không cài, chạy npx t3@latest (cần Node.js). 
    t3
  5. Mở truy cập từ thiết bị khác và chạy nền Lệnh hỏi bạn dùng T3 Connect, mạng LAN hay cả hai; trên Linux và macOS nó cài luôn dịch vụ nền. Chỉ muốn cài dịch vụ nền thì chạy t3 service install. 
    t3 up
  6. Hoặc cài ứng dụng desktop Ví dụ cho Windows. macOS: brew install --cask t3-code. Debian, Ubuntu: tải file .deb từ trang GitHub Releases rồi chạy sudo apt install ./T3-Code-*.deb. Ứng dụng desktop có kèm lệnh t3. 
    winget install T3Tools.T3Code

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cấu hình quan trọng

MụcÝ nghĩa
T3CODE_PORTCổng của máy chủ; tài liệu lấy ví dụ 3773 trong service.env
T3CODE_HOSTĐịa chỉ máy chủ lắng nghe, ví dụ 127.0.0.1; giá trị này thay cho thiết lập T3CODE_LAN
T3CODE_LANtrue để dịch vụ nghe trên địa chỉ LAN và Tailscale (t3 up --lan tự đặt)
T3CODE_TELEMETRY_ENABLEDĐặt false để tắt gửi dữ liệu sử dụng cơ bản
T3CODE_CHANNEL, T3CODE_VERSIONKhi chạy trình cài: chọn kênh nightly hoặc ghim một phiên bản cụ thể
~/.t3/service.envFile biến môi trường cho dịch vụ nền, giữ nguyên qua các lần cập nhật; nên chmod 600 nếu chứa khoá

Cách tích hợp và sử dụng

  1. Bật nhà cung cấpMở Settings → Providers trên web hoặc desktop, chọn môi trường và bật nhà cung cấp đã đăng nhập. Nếu không thấy, đặt Binary path tới CLI của nhà cung cấp.
  2. Chọn chế độ quyềnĐặt mặc định ở Settings → Threads → New threads → Permissions. Supervised hỏi trước mọi lệnh và thay đổi file; Full access (mặc định ban đầu) cho agent làm mà không hỏi.
  3. Kết nối điện thoạiCài ứng dụng iOS hoặc Android, đăng nhập cùng tài khoản T3 Connect, hoặc chạy t3 pair trên máy chủ rồi quét mã QR.
  4. Giữ máy chủ chạy trên VPS Linuxt3 service install cài dịch vụ systemd của người dùng. Nếu dịch vụ dừng khi thoát SSH, quản trị viên chạy sudo loginctl enable-linger "$(id -un)". Không chạy T3 Code bằng root.
  5. Kiểm tra và xử lý lỗit3 service status in trạng thái và vị trí log; t3 status cho biết thiết bị khác kết nối bằng cách nào.

Cập nhật và sao lưu

Chạy t3 update để lên bản mới; dịch vụ nền khởi động lại sẽ ngắt các agent đang chạy nên lệnh hỏi trước. Ứng dụng desktop tự cập nhật; nút cập nhật ở thanh bên cập nhật luôn các máy chủ đang kết nối. Cài qua Nix thì cập nhật bằng Nix.

Dự án, luồng chat và cài đặt nằm trong ~/.t3/userdata, biến môi trường dịch vụ ở ~/.t3/service.env. Sao lưu hai chỗ này nếu muốn chuyển máy. t3 uninstall gỡ dịch vụ và file chạy nhưng giữ lại dữ liệu.

Câu hỏi thường gặp

T3 Code có mất phí không?

Không. T3 Code miễn phí, giấy phép MIT. Bạn vẫn trả tiền cho nhà cung cấp mô hình như bình thường. T3 Connect miễn phí cho 3 máy mỗi tài khoản; thêm máy cần gói T3 Chat trả phí.

Dùng gói Claude Pro, Max qua T3 Code có bị khoá tài khoản không?

FAQ của dự án nói T3 Code nằm trong điều khoản của Claude Code, Codex và Antigravity. FAQ cũng nêu dùng qua Agent SDK có thể làm hết giới hạn 5 giờ của Claude nhanh hơn. Không nên gom nhiều tài khoản để xoay vòng giới hạn.

Có cài T3 Code lên VPS được không?

Được. Máy chủ T3 Code chạy được trên VPS Linux như dịch vụ nền, agent làm việc trên VPS và bạn điều khiển từ điện thoại hoặc trình duyệt. CLI nhà cung cấp phải được cài và đăng nhập ngay trên VPS đó.

Mã nguồn có bị gửi lên máy chủ của T3 không?

Theo FAQ thì không: mã và prompt đi thẳng tới nhà cung cấp mô hình. T3 Code gửi dữ liệu sử dụng cơ bản như nhà cung cấp, mô hình, tổng token; đặt T3CODE_TELEMETRY_ENABLED=false để tắt.

Nội dung được AI hỗ trợ soạn từ README và dữ liệu GitHub của dự án.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với T3 Code hay nhóm phát triển pingdotgg. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

T3 Code được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.