Khởi đầu
Hướng dẫn này đưa bạn từ bước cài đặt đến terminal đầu tiên và phiên tác nhân AI đầu tiên. Nội dung ở đây đủ để bắt đầu làm việc; từng tính năng được mô tả chi tiết trong các chương khác (xem tổng quan hướng dẫn).
1. VelaTerm là gì
VelaTerm là trình quản lý terminal được xây dựng để làm việc với các tác nhân lập trình AI. VelaTerm sắp xếp các phiên terminal và phiên tác nhân theo cây dự án → nhóm → phiên, đồng thời chạy các tác nhân lập trình như Claude Code và Codex dưới dạng phiên riêng: bạn luôn biết tác nhân đang làm việc, đang cần bạn phản hồi hay đã xong, và khi mở lại một phiên, cuộc hội thoại sẽ được tiếp tục. Tác nhân có thể chạy trong giao diện terminal riêng hoặc trong chế độ hội thoại với tin nhắn, thẻ công cụ và các nút cấp quyền. Nhờ truy cập từ xa qua trình duyệt và phát triển từ xa qua SSH, bạn có thể tiếp tục các phiên của mình từ thiết bị khác.
2. Cài đặt
Tải gói cài đặt cho nền tảng của bạn từ trang tải xuống:
| Nền tảng | Gói cài đặt | Ghi chú |
|---|---|---|
| macOS | .dmg (bản riêng cho Apple Silicon và Intel) | Mở tệp và kéo VelaTerm vào thư mục Applications. Ứng dụng đã qua quy trình công chứng (notarization) của Apple |
| Windows | Trình cài đặt -setup.exe, gồm hai biến thể min và full | Bản full (khoảng 360 MB) có sẵn Git Bash đầy đủ; bản min (khoảng 25 MB) tải các lệnh còn thiếu khi cần. Cả hai bản đều cài vào cùng một vị trí, vì vậy chỉ nên chọn một bản |
| Linux | .AppImage (x86_64 và aarch64) | Cấp quyền thực thi cho tệp rồi chạy; không cần cài đặt |
VelaTerm tự động kiểm tra bản cập nhật; mục “Check for Updates…” trong menu ứng dụng (trên Windows và Linux là “Kiểm tra cập nhật…”) sẽ kiểm tra ngay lập tức.
3. Lần khởi chạy đầu tiên: thêm dự án
Ở lần khởi chạy đầu tiên, thanh bên còn trống và đưa ra ba cách để thêm dự án:
- “Tạo dự án” tạo một thư mục mới rồi thêm thư mục đó vào.
- “Mở dự án” (⌘O; Ctrl+Alt+O trên Windows và Linux) thêm một thư mục có sẵn.
- “Sao chép từ Git” sao chép (clone) một kho mã rồi thêm kho đó vào.
Các thao tác này cũng có dưới dạng nút ở đầu thanh bên. Trong một dự án, bạn có thể tạo các nhóm lồng nhau với số cấp tùy ý (ví dụ frontend, backend, testing) và tạo các phiên bên trong nhóm:
4. Mở terminal đầu tiên
Có thể mở một terminal nháp bằng một trong các cách sau:
- Nhấn ⌘T (Ctrl+Alt+T trên Windows và Linux).
- Di chuột lên một dự án, nhóm hoặc phiên ở thanh bên, nhấp nút ＋ rồi chọn “Terminal mới”. Terminal sẽ khởi động trong thư mục của nút đó. Menu ngữ cảnh của dự án và nhóm cũng có mục này.
- Khi khung giữa trống, nhấp “Tạo terminal”.
Terminal nháp chỉ tồn tại dưới dạng thẻ: terminal nháp không bao giờ trở thành nút trong cây và bị loại bỏ khi đóng, vì vậy rất phù hợp để chạy nhanh các lệnh.
5. Mở phiên tác nhân AI đầu tiên
Nhấp chuột phải vào một dự án hoặc nhóm rồi chọn “Phiên Claude mới”. Cấp đầu tiên của menu có Claude, Codex và OpenCode; mục “Thêm phiên tác nhân” liệt kê đủ mười bốn tác nhân được hỗ trợ. Bạn cũng có thể nhấn ⌘N (Ctrl+Alt+N trên Windows, Linux và trong trình duyệt thông thường) để mở danh sách tác nhân có ô tìm kiếm.
VelaTerm khởi động tác nhân trong thư mục dự án. Các phiên Claude, Codex, OpenCode, Pi và OMP mở trong chế độ hội thoại: nhập tin nhắn vào ô ở phía dưới rồi nhấn Enter. Các tác nhân khác mở trong chế độ terminal, nơi hiển thị giao diện terminal riêng của tác nhân. Nút chuyển trên thanh tiêu đề của khung dùng để chuyển một phiên qua lại giữa hai chế độ; xem Chế độ hội thoại.
Từ đó, bạn có thêm ba tiện ích:
- Chấm trạng thái: chấm bên cạnh phiên ở thanh bên cho biết trạng thái của tác nhân. Màu xanh lá nghĩa là đang làm việc, màu vàng nghĩa là tác nhân cần bạn (có câu hỏi hoặc yêu cầu cấp quyền), còn màu đỏ tím nghĩa là tác nhân đã trả lời và bạn đã xem.
- Thông báo hệ thống: khi tác nhân dừng lại để chờ bạn, bạn sẽ nhận được thông báo. Nếu bạn đang xem đúng phiên đó, thông báo sẽ không xuất hiện.
- Tự động tiếp tục: sau khi bạn đóng thẻ hoặc thoát ứng dụng, lần sau mở lại phiên, cuộc hội thoại sẽ tiếp tục từ chỗ đã dừng. Muốn có cuộc hội thoại mới, hãy tạo phiên mới.
Nếu CLI của tác nhân chưa được cài đặt, phiên sẽ hiển thị thẻ cài đặt với lệnh cài đặt được khuyến nghị cho hệ thống của bạn và nút “Cài đặt ngay”.
6. Giới thiệu nhanh
- Thanh bên trái: cây dự án cùng ô tìm kiếm và bộ lọc trạng thái. Các nút ở đầu thanh bên gồm Tạo dự án, Nhập dự án, Sao chép từ Git, Tìm mọi phiên và Phiên đã lưu trữ.
- Khung giữa: thanh thẻ và các phiên đang mở. Theo mặc định, khi bạn nhấp vào một phiên tác nhân trong cây, VelaTerm dùng lại thẻ hiện tại, còn thẻ trước đó tiếp tục chạy ở nền. Đóng thẻ sẽ kết thúc các tiến trình của thẻ đó. Có thể chia thẻ thành nhiều khung (⌘D chia sang phải, ⌘⇧D chia xuống dưới).
- Bảng bên phải: hiển thị theo phiên hiện tại, gồm bốn thẻ: Files, Info (chi tiết phiên, mức sử dụng tài khoản, ngữ cảnh và mức sử dụng tài nguyên), Git (nhánh, thay đổi và commit) và Kho kiến thức.
- Thanh trạng thái: số phiên, loại phiên hiện tại, nhánh Git, chế độ quyền, công tắc thông báo và các bộ đếm Đang làm việc / Đang chờ / Đã xem. Nhấp vào một bộ đếm để thanh bên chỉ hiển thị các phiên ở trạng thái đó.
- Bên phải thanh tiêu đề: nút chuyển chủ đề, Truy cập từ xa, Kết nối máy chủ từ xa, Chia sẻ, Cài đặt, Tài khoản, Phản hồi và các nút ẩn hoặc hiện hai bảng bên.
7. Đọc tiếp
- Cây dự án, thẻ, chia khung, lưu trữ và tìm kiếm toàn cục: Quản lý giao diện và phiên làm việc.
- Khả năng của tác nhân, tiếp tục hội thoại, phân nhánh và quyền: Phiên tác nhân AI.
- Làm việc trong chế độ hội thoại: Chế độ hội thoại.
- Cho tác nhân khởi chạy phiên con trong các worktree riêng: Tạo phiên và hợp tác Git.
- Các tính năng của terminal (tìm kiếm, dán ảnh, gợi ý lệnh): Sử dụng terminal.
- Dùng VelaTerm từ điện thoại hoặc máy tính khác: Phát triển và quản lý từ xa.