Hướng dẫn sử dụng

Cài đặt và phím tắt

Mở cài đặt bằng nút bánh răng trên thanh tiêu đề. Trên macOS, menu ứng dụng còn có mục “Settings…” (⌘,); trên Windows và Linux, nhấn Alt rồi chọn Tệp ▸ Cài đặt…. Cửa sổ cài đặt có tám nhóm: Chung, Giao diện, Terminal, Chế độ xem hội thoại, Hành vi, Nâng cao, Tác nhân và Phím tắt. Chương này mô tả từng mục và kết thúc bằng các tổ hợp phím mặc định. Cài đặt được dùng chung giữa ứng dụng máy tính và các máy khách trình duyệt kết nối tới ứng dụng đó.

Cài đặt · Giao diện

1. Chung

MụcMô tả
Ngôn ngữNgôn ngữ giao diện. “Tự động (hệ thống)” dùng theo ngôn ngữ của hệ thống; có mười một ngôn ngữ để chọn
Âm báoÂm thanh khi có thông báo (mặc định bật)
Thông báo hệ thốngBật hoặc tắt thông báo hệ thống (mặc định bật). Nếu hệ thống chưa cho phép thông báo, “Cho phép thông báo” sẽ xin quyền; nếu thông báo đang bị chặn, các bước cần làm trên hệ thống của bạn sẽ được hiển thị
Lệnh shellChỉ có trong ứng dụng máy tính trên macOS: “Cài đặt lệnh ‘vela’” thêm vela <project-path> vào shell của bạn để mở một dự án trong VelaTerm. “Gỡ lệnh ‘vela’” gỡ lệnh này
Kỹ năng Vela“Cài đặt” (về sau là “Cài đặt lại”) cài các kỹ năng VelaTerm cho Claude Code và Codex, chẳng hạn /vspawn và $vspawn. Hãy bắt đầu một phiên Codex mới nếu Codex chưa liệt kê các kỹ năng này. Xem Lệnh trong phiên §2

2. Giao diện

MụcMô tả
Màu nhấnMàu nhấn: “Theo chủ đề” hoặc một trong bốn màu
Mật độ“Gọn”, “Tiêu chuẩn” (mặc định) hoặc “Thoáng”
KhungKiểu khung: “Liền” (mặc định) hoặc “Thẻ”
Đường phân cách“Mờ” (mặc định) hoặc “Rõ”
Thanh bên“Dạng cây” (mặc định) hoặc “Gọn”
Phông giao diệnPhông chữ của giao diện
Cỡ chữ giao diệnCỡ chữ của giao diện; “Tự động” thay đổi theo mật độ

Chủ đề sáng và tối được chuyển trên thanh tiêu đề (theo hệ thống, tối, sáng), không phải ở đây. Các phiên Claude đang chạy trong chế độ terminal đổi theo chủ đề mà không cần khởi động lại.

3. Terminal

MụcMô tả
Dán ảnh“Dán đường dẫn tệp” (mặc định) lưu ảnh được dán thành tệp tạm và chèn đường dẫn của tệp. “Dán ảnh gốc” cho phép Claude Code hoặc Codex đọc ảnh từ bộ nhớ tạm; tùy chọn này chỉ có trong ứng dụng máy tính cục bộ
Gợi ý lệnh“Tự động”, “Khi nhấn Tab” hoặc “Tắt”. Có hiệu lực ngay, kể cả với các terminal đang mở; bị ẩn ở nơi không được hỗ trợ. Xem Gợi ý lệnh
Shell mặc địnhShell cho các terminal mới. Chỉ hiển thị trên Windows, nơi có nhiều shell để chọn; macOS và Linux luôn dùng shell của hệ thống
Phông terminalPhông chữ của terminal
Cỡ chữ terminalCỡ chữ của terminal (mặc định 13). ⌘+ / ⌘- / ⌘0 thay đổi cỡ chữ trong khi làm việc
Chiều cao dòng terminalKhoảng cách dòng của terminal (mặc định 1,2×)

4. Chế độ xem hội thoại

Các thiết lập này áp dụng cho chế độ hội thoại của phiên tác nhân; xem Chế độ hội thoại.

MụcMô tả
Phông chữ hội thoại, Cỡ chữ hội thoại, Chiều cao dòng hội thoạiKiểu chữ của cuộc hội thoại, độc lập với thiết lập của terminal (mặc định cỡ chữ 13,5, chiều cao dòng 1,2×)
Thanh công cụ soạn tinNhững nút điều khiển nào hiển thị cạnh ô nhập tin nhắn và theo thứ tự nào: Mô hình, Mức độ suy luận, Chế độ cộng tác, Chế độ cấp quyền, Chế độ nhanh, Tốc độ, Giọng điệu, Máy chủ MCP, Tác vụ nền, Tài khoản và Lượt đặt lại giới hạn Codex. Mỗi nút có công tắc Bật/Tắt; các mũi tên dùng để sắp xếp lại những nút đang bật. Mô hình, Mức độ suy luận, Chế độ cộng tác và Chế độ cấp quyền được bật theo mặc định

Những nút mà tác nhân hoặc mô hình hiện tại không hỗ trợ sẽ không được hiển thị. Nút được hỗ trợ vẫn hiển thị khi tính năng của nút tạm thời không dùng được, ví dụ Máy chủ MCP và Tác vụ nền trong lúc tiến trình tác nhân đang dừng.

Những nút bị tắt, cùng những nút không đủ chỗ cạnh ô nhập tin nhắn, nằm trong menu Thêm, nên bạn có thể dùng mọi nút được hỗ trợ mà không cần bật trước tại đây. Menu Thêm không hiển thị khi mọi nút được hỗ trợ đều đang bật và đủ chỗ hiển thị. Một nút bị tắt rồi bật lại sẽ được chuyển xuống cuối hàng. Trên thiết bị di động, những nút đang tắt xuất hiện ở hàng thứ hai.

5. Hành vi

MụcMô tả
Thẻ“Đơn” (mặc định) dùng lại thẻ hiện tại khi bạn mở một phiên tác nhân và giữ thẻ trước đó tiếp tục chạy ở nền. “Nhiều” mở mỗi phiên trong một thẻ riêng
Tự động thêm vào bộ lọc trạng tháiKhi bộ lọc trạng thái trên thanh bên đang bật, các phiên bắt đầu khớp sẽ được thêm vào (mặc định bật)
Giới hạn nềnHiển thị ở chế độ Đơn: số thẻ nền tối đa (8, 16, 32 hoặc 64; mặc định 32). Khi vượt giới hạn, thẻ nền cũ nhất không hoạt động sẽ kết thúc
Xác nhận trước khi tạo phiênHiển thị thẻ xác nhận trước khi một phiên con khởi động (mặc định bật); xem Tạo phiên và hợp tác Git §4
Tự động làm mới mức sử dụngGiữ mức sử dụng tài khoản trong bảng Info luôn được cập nhật (mặc định bật)
Làm mới mức sử dụngKhoảng thời gian làm mới: 30 giây, 1 phút, 2 phút hoặc 5 phút (mặc định 5 phút)
Tiếp tục sau khi đặt lại giới hạnTự động tiếp tục tác vụ Claude hoặc Codex sau khi giới hạn sử dụng 5 giờ hoặc hằng tuần được đặt lại (mặc định bật)
Tự dọn ảnh đã dánXóa các tệp tạm của ảnh đã dán khi thoát ứng dụng, và xóa các tệp cũ hơn 24 giờ khi khởi động (mặc định bật). “Dọn ngay” xóa các tệp này ngay lập tức

Ngữ cảnh tham chiếu phiên quyết định cách vrefer --ask (và kỹ năng vask) chuyển cuộc hội thoại của một phiên khác cho tác nhân trả lời. “Toàn bộ bản ghi” (mặc định) chuyển toàn bộ cuộc hội thoại. “Tóm tắt trước” rút gọn cuộc hội thoại trước bằng “Tác nhân tóm tắt”, mô hình và mức suy luận được chọn tại đây. Xem Lệnh trong phiên §5.

6. Nâng cao

MụcMô tả
Bộ kết xuất terminal“DOM” (mặc định) hoặc “WebGL”. Hãy giữ giá trị mặc định trừ khi có lý do cụ thể để thay đổi
Vẽ lại khi chuyển thẻVẽ lại toàn bộ terminal khi bạn quay lại thẻ của terminal đó (mặc định tắt). Hãy bật nếu giao diện terminal thỉnh thoảng hiển thị lộn xộn sau khi chuyển thẻ
Ưu tiên đầu ra tiền cảnhGiữ thao tác gõ phím phản hồi nhanh trong lúc các tác nhân ở thẻ khác tạo ra lượng lớn đầu ra (mặc định bật)
Ghi nhật ký phiênLưu đầu ra terminal của các phiên tác nhân vào tệp nhật ký (mặc định tắt). Khi bật, có thể phát lại các phiên đã lưu trữ và tìm kiếm toàn cục cũng bao gồm đầu ra terminal. Phiên terminal thông thường không bao giờ được ghi lại

7. Tác nhân

“Mặc định cho phiên mới” áp dụng cho các phiên được tạo mới của tác nhân được chọn. Thiết lập riêng của từng phiên được ưu tiên hơn, trừ đường dẫn tệp thực thi, vốn luôn áp dụng cho cả loại tác nhân.

Cài đặt · Tác nhân

MụcMô tả
Loại tác nhânTác nhân có giá trị mặc định đang được chỉnh sửa
Đường dẫn tệp thực thi (tùy chọn)Đường dẫn đầy đủ tới tệp thực thi của tác nhân. Khi để trống, lệnh được tìm trên PATH. Mục này được điền tự động sau khi cài đặt thành công bằng một cú nhấp
Đối số khởi chạy (tùy chọn)Đối số dòng lệnh mặc định, ví dụ --model opus
QuyềnQuyền mặc định cho phiên mới. Claude, Codex và OpenCode có các chế độ được đặt tên riêng; phần lớn tác nhân khác có “Mặc định” và “YOLO” (bỏ qua mọi xác nhận quyền); Pi không có yêu cầu cấp quyền. Xem Phiên tác nhân AI §6
Chế độ xem mặc địnhVới Claude, Codex, OpenCode, Pi và OMP: “Chế độ hội thoại” (mặc định) hoặc “Chế độ terminal” cho phiên mới. Các phiên đã có giữ nguyên chế độ hiện tại

8. Phím tắt

Cài đặt · Phím tắt

Nhấp vào tổ hợp phím của một thao tác, rồi nhấn tổ hợp phím mới; Escape để hủy. Tổ hợp phím gồm một chữ cái cùng ⌘ (trong ứng dụng máy tính trên macOS) hoặc Ctrl, có thể thêm Shift và Option/Alt. Nếu tổ hợp phím đã được dùng, thông báo sẽ cho biết thao tác nào đang dùng tổ hợp đó. “Khôi phục mặc định” đặt lại mọi tổ hợp phím.

Thao tácỨng dụng máy tính trên macOSWindows, Linux
Mở dự án⌘OCtrl+Alt+O
Terminal mới⌘TCtrl+Alt+T
Phiên tác nhân mới⌘NCtrl+Alt+N
Thẻ trình duyệt mới (chỉ có trong ứng dụng máy tính)⌘⇧BCtrl+Alt+B
Chia sang phải⌘DCtrl+Alt+D
Chia xuống dưới⌘⇧DCtrl+Alt+E
Đóng khung / thẻ⌘WCtrl+Alt+W
Tìm trong terminal⌘FCtrl+Alt+F
Tìm mọi phiên⌘⇧FCtrl+Alt+G
Lưu tài liệu⌘SCtrl+S

Trình duyệt thông thường. Khi bạn dùng VelaTerm trong một trình duyệt thông thường (truy cập từ xa qua URL), bản thân trình duyệt đã dùng nhiều tổ hợp với ⌘ và Ctrl, nên các tổ hợp phím Windows và Linux ở trên được áp dụng trên mọi hệ điều hành, và trang cài đặt cũng hiển thị như vậy. Ngoại lệ là trình duyệt trên macOS, nơi chia sang phải và chia xuống dưới vẫn là ⌘D và ⌘⇧D. Cửa sổ kết nối từ xa của ứng dụng máy tính dùng các tổ hợp phím của ứng dụng máy tính.

Phím cố định không thể thay đổi: ⌘1–9 chuyển thẻ, và ⌘+ / ⌘- / ⌘0 thay đổi hoặc đặt lại cỡ chữ terminal (dùng Ctrl trên Windows, Linux và trong trình duyệt).

9. Bộ chọn phiên tác nhân mới

“Phiên tác nhân mới” mở danh sách có ô tìm kiếm gồm các loại tác nhân và cấu hình sẵn đã lưu (“Tìm tác nhân và cấu hình sẵn”). Các lựa chọn dùng gần đây được xếp lên đầu và đánh dấu “Dùng gần nhất”.

Bộ chọn cho biết phiên sẽ được tạo ở đâu. Khi một phiên đã lưu đang được chọn, hãy chọn “Cùng cấp” để tạo phiên mới ngang cấp với phiên đó, hoặc “Phiên con” để tạo phiên mới bên dưới phiên đó. Khi ô tìm kiếm đang có tiêu điểm:

  • Tab chuyển qua lại giữa “Cùng cấp” và “Phiên con”.
  • ↑ và ↓ chọn một kết quả; Enter tạo phiên.
  • Shift+Tab chuyển tiêu điểm về nút điều khiển trước đó; Escape đóng bộ chọn.

Bạn cũng có thể nhấp vào một kết quả rồi chọn “Tạo”. Nếu chưa có dự án nào, hãy chọn một dự án hoặc dùng “Mở dự án” trước.

Bộ chọn có địa chỉ riêng, lưu lại đích tạo phiên, vị trí, nội dung tìm kiếm và lựa chọn hiện tại. Sao chép liên kết, làm mới trang hoặc quay lại và tiến tới đều khôi phục bộ chọn mà không tạo phiên. Nếu tạo phiên thất bại, bộ chọn vẫn mở để bạn thử lại.

10. Các phím khác

Vị tríPhímThao tác
Chế độ hội thoạiEnter / Shift+EnterGửi / xuống dòng
Chế độ hội thoại, khi tác nhân đang làm việc⌥Enter (Alt+Enter)Thêm tin nhắn vào lượt đang chạy
Chế độ hội thoại, khi tác nhân đang làm việc⌘Enter (Ctrl+Enter)Dừng lượt hiện tại và gửi tin nhắn này
Chế độ hội thoại, khi tác nhân đang làm việcEscDừng lượt hiện tại
Thẻ xác nhận tạo phiên con⌘Enter (Ctrl+Enter)Khởi chạy phiên
Thanh thẻNhấp chuột giữaĐóng thẻ
Thanh bên⌘/Ctrl-nhấp, Shift-nhấpChọn nhiều phiên, hoặc chọn một dải phiên