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 đó.

1. Chung
| Mục | Mô 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ống | Bậ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 shell | Chỉ 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ục | Mô tả |
|---|---|
| Màu nhấn | Mà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” |
| Khung | Kiể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ện | Phông chữ của giao diện |
| Cỡ chữ giao diện | Cỡ 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ục | Mô 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 định | Shell 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 terminal | Phông chữ của terminal |
| Cỡ chữ terminal | Cỡ chữ của terminal (mặc định 13). ⌘+ / ⌘- / ⌘0 thay đổi cỡ chữ trong khi làm việc |
| Chiều cao dòng terminal | Khoả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ục | Mô tả |
|---|---|
| Phông chữ hội thoại, Cỡ chữ hội thoại, Chiều cao dòng hội thoại | Kiể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 tin | Nhữ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ục | Mô 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ái | Khi 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ền | Hiể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ên | Hiể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ụng | Giữ 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ụng | Khoả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ạn | Tự độ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án | Xó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ục | Mô 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ảnh | Giữ 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ên | Lư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.

| Mục | Mô tả |
|---|---|
| Loại tác nhân | Tá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ền | Quyề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 định | Vớ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

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 macOS | Windows, Linux |
|---|---|---|
| Mở dự án | ⌘O | Ctrl+Alt+O |
| Terminal mới | ⌘T | Ctrl+Alt+T |
| Phiên tác nhân mới | ⌘N | Ctrl+Alt+N |
| Thẻ trình duyệt mới (chỉ có trong ứng dụng máy tính) | ⌘⇧B | Ctrl+Alt+B |
| Chia sang phải | ⌘D | Ctrl+Alt+D |
| Chia xuống dưới | ⌘⇧D | Ctrl+Alt+E |
| Đóng khung / thẻ | ⌘W | Ctrl+Alt+W |
| Tìm trong terminal | ⌘F | Ctrl+Alt+F |
| Tìm mọi phiên | ⌘⇧F | Ctrl+Alt+G |
| Lưu tài liệu | ⌘S | Ctrl+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ím | Thao tác |
|---|---|---|
| Chế độ hội thoại | Enter / Shift+Enter | Gử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ệc | Esc | Dừ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ấp | Chọn nhiều phiên, hoặc chọn một dải phiên |