Bắt đầu

Tải MXterm Pro ở trang tải về. Trên Mac bạn nhận một file DMG chạy trực tiếp trên cả chip Apple silicon lẫn Intel, và cần macOS 10.15 trở lên. Trên máy Windows, trang tải về có bộ cài cho Windows 10 hoặc 11 bản x64; không có bản ARM64. Phần còn lại của trang này được kiểm tra trên bản macOS, và chỗ nào biết Windows khác thì văn bản có ghi rõ.

Sau khi bạn bấm một nút tải trên trang web, cửa sổ nhỏ Cài đặt trong ba bước hiện các bước cho file bạn chọn. Các bước giống như bên dưới.

1. Mở file DMG vừa tải về.
2. Kéo MXterm Pro vào thư mục Applications.
3. Mở MXterm Pro từ Applications.
4. Nếu macOS hỏi bạn có chắc muốn mở ứng dụng tải từ Internet không, chọn Open.

Trên macOS, app được ký bằng Apple Developer ID và đã được Apple notarize.

Trên Windows:

1. Chạy file .exe vừa tải về.
2. Nếu Windows SmartScreen hiện Windows protected your PC, bấm More info, rồi Run anyway. Bộ cài chưa được ký số (code-signed), nên Windows ghi nhà phát hành là Unknown.
3. Làm theo các bước của bộ cài.

Lần đầu mở app sẽ có một tour 6 trang tên Chào Mừng Đến Với MXterm Pro. Bấm Tiếp Theo để xem tiếp hoặc Bỏ qua để đóng; menu ngôn ngữ ở góc trên liệt kê mọi ngôn ngữ app có, và chọn một ngôn ngữ thì tour và app đổi theo. Tour tự mở một lần và không hiện lại sau khi đóng; bạn có thể xem lại từ menu logo, ở mục Xem lại phần giới thiệu.

Phía sau tour, cửa sổ có đúng một tab New Tab đang mở form tạo workspace. Giao diện bắt đầu bằng ngôn ngữ đầu tiên trong danh sách ngôn ngữ hệ thống của bạn mà app có, và bằng tiếng Anh nếu không ngôn ngữ nào có; ngôn ngữ bạn đã chọn trước đó được giữ lại. App có English, Tiếng Việt, 简体中文, 日本語, 한국어, Español, Français, Türkçe, Bahasa Indonesia, Português (Brasil) và Deutsch. Bạn đổi được sau trong Cài đặt, nơi mỗi ngôn ngữ hiện dưới tên riêng của nó.

Workspace là một tab chứa lưới các pane terminal, tất cả khởi động trong cùng một thư mục. Chưa có gì chạy cho tới khi bạn bấm tạo.

1. Ở Thư mục làm việc, gõ đường dẫn hoặc bấm Duyệt…. Mặc định là thư mục home; các thư mục bạn từng dùng nằm trong Thư mục gần đây.
2. Ở Số lượng terminal?, chọn 1, 2, 4, 6, 8, 9, 10, 12, 16 hoặc 20. Khung xem trước bên dưới vẽ đúng lưới bạn sẽ có. Bố cục chuyển giữa Ngang (một lưới) và Dọc (một hàng cột cao, các pane xếp cạnh nhau). Bố cục dọc có 1 đến 6 pane, và số không có sẵn sẽ lùi về số lớn nhất nhỏ hơn nó.
3. Ở AI agents, dùng nút − và + để đặt số pane chạy từng agent. Danh sách mở đầu bằng Claude Code, Codex, Grok và Gemini CLI, rồi tới dòng Terminal (Plain Shell), rồi OMP; các agent còn lại theo sau, agent đã cài đứng trước. Agent nào app không tìm thấy CLI được đánh dấu Chưa cài đặt kèm nút Cài đặt, bấm vào mở hướng dẫn cài của agent đó; MXterm Pro không bao giờ tự chạy lệnh cài cho bạn. Với Cursor Agent, CLI đó là cursor-agent. Khi app còn đang kiểm tra, hoặc việc kiểm tra lỗi (có liên kết Thử lại), chưa thể chọn agent nào và mọi pane là shell thường.
4. Pane nào chưa gán agent sẽ chạy shell thường. Dòng Terminal (Plain Shell) cho bạn chọn shell và đặt rõ số pane shell thường.
5. Xem lại ba tuỳ chọn dưới khung xem trước (bảng bên dưới), rồi bấm Tạo không gian làm việc hoặc nhấn Cmd+Enter (Ctrl+Enter trên Windows).

Form luôn hiện sẵn Claude Code, Codex, OpenCode, GitHub Copilot, Qwen Code, Amp, Gemini CLI, Cursor Agent, Antigravity, OMP (Oh My Pi) và Grok. Các agent khác, như Aider, Goose, Kimi Code và Devin, chỉ hiện khi MXterm Pro tìm thấy CLI của chúng trên máy bạn. Form bắt đầu với 2 terminal và chỉ đặt lên đó những agent bạn đã cài. Có cả Claude Code và Codex thì đề xuất mỗi loại một pane. Nếu không, hai agent đã cài đầu tiên trong danh sách chia các pane, một nửa (làm tròn lên) cho agent thứ nhất; chỉ cài một agent thì nó được một nửa và phần còn lại là shell thường, không cài agent nào thì mọi pane là shell thường. Khi bạn bấm Tạo không gian làm việc, form nhớ lựa chọn đó (agent, terminal thường, bố cục và số pane) và lần sau bắt đầu từ đó, chia lại theo số pane bạn chọn; agent đã nhớ mà không còn được cài sẽ thành shell thường. Hãy xem các dòng AI agents trước khi tạo workspace.

Nếu thư mục đã có phiên agent từ trước, danh sách Khôi phục phiên cũ sẽ hiện dưới ô thư mục. Tick một phiên để mở lại nó trong pane riêng. Mỗi workspace tối đa 20 pane, nên đủ số đó thì không tick thêm được. Phiên bạn tick được ưu tiên hơn tuỳ chọn khôi phục cho pane của nó.

Nếu thư mục là git repository chưa có commit nào, Tách biệt tính năng bằng Git Worktree sẽ commit trước một file .gitkeep rỗng với tên Initial commit, vì worktree cần một commit để bắt đầu. Không có gì khác trong thư mục được stage hay commit.

Form có hai cột, thư mục làm việc ở bên trái và các terminal ở bên phải, miễn là tab đủ rộng. Khi không đủ rộng, ví dụ khi thanh bên và panel bên phải cùng mở, hai cột xếp chồng thành một.

Chi tiết về agent và worktree có ở Agent và Control Room (trước đây là War Room).

Bypass Mode bảo agent bỏ qua bước xin phép, nên agent chạy lệnh và sửa file mà không hỏi bạn trước. Chế độ này tắt cho tới khi bạn tự bật: mặc định, agent vẫn dừng lại và hỏi bạn.

Nếu bạn từng dùng bản cũ hơn, form tạo workspace sẽ hiện một thông báo cho tới khi bạn bỏ qua nó hoặc đổi ô tick: Chế độ Bypass giờ mặc định tắt. Agent sẽ hỏi trước khi chạy lệnh hoặc sửa file. Bật lại bằng công tắc ngay bên dưới. Nếu trước đó bạn đã tự tick hoặc bỏ tick ô này, lựa chọn của bạn được giữ nguyên.

Cách bật:

1. Mở form tạo workspace: nhấn Cmd+T (Ctrl+T trên Windows), hoặc bấm + ở cuối dải tab rồi chọn Tab mới.
2. Tick Bật Chế độ Bypass (Tự động duyệt quyền CLI).

Bypass Mode thêm cờ bỏ qua xin phép của chính từng agent được hỗ trợ; MXterm Pro biết cờ này cho 14 agent. Các agent còn lại, trong đó có OpenCode, GitHub Copilot, Amp, Cursor Agent, Antigravity và OMP, chạy bằng lệnh bình thường dù Bypass Mode bật hay tắt.

Lựa chọn được lưu ngay khi bạn đổi. Mọi pane agent khởi động sau đó đều theo lựa chọn này, kể cả các pane được mở lại ở lần chạy app tiếp theo. Ô này trong form tạo workspace là công tắc cho kiểu bypass dùng cờ. Goose không có cờ, nên chế độ tự động của nó là một biến môi trường chỉ có trong Cài đặt.

• Tab mới: nhấn Cmd+T (Ctrl+T). Tab mới mở ra form tạo workspace và chưa khởi động shell nào cho tới khi bạn bấm tạo. Bấm + ở cuối dải tab thì mở một menu, mô tả ngay dưới đây; hàng đầu của menu, Tab mới, làm giống Cmd+T.
• Menu +: trên cùng có ô tìm kiếm; gõ để lọc thư mục và agent, nhấn Enter để mở kết quả đầu tiên. Terminal mới mở một tab có một shell thường trong thư mục của tab đang hiện nếu đó là tab trên máy này và có thư mục, nếu không thì trong thư mục gần đây nhất, nếu không nữa thì trong thư mục home. Terminal mới trong ~ làm giống vậy trong thư mục home khi nó khác thư mục trên, còn Mở thư mục… hỏi chọn thư mục trước. Dưới Thư mục gần đây, tối đa sáu thư mục gần đây, mỗi cái mở một tab terminal trong thư mục đó (khi tìm kiếm thì liệt kê mọi kết quả khớp). Dưới Agent trong và tên thư mục, mỗi agent đã cài mở một tab có một pane chạy agent đó trong thư mục này, không worktree và không resume. Nếu chưa cài agent nào, có một hàng đưa bạn tới Settings → Agents. Mọi hàng trừ Tab mới đều mở đúng một tab có một pane, và giới hạn của gói Free áp dụng như với mọi tab mới.
• Tên: tab workspace lấy tên theo thư mục. Double-click vào tab để đổi tên; Enter để lưu, Esc để huỷ.
• Chuyển tab: bấm vào một tab, nhấn Cmd+1 đến Cmd+8 để tới tab theo số, hoặc nhấn Cmd+← / Cmd+→ trên macOS để tới tab trước hoặc sau (Ctrl+Alt+← / Ctrl+Alt+→ trên Windows).
• Thứ tự: kéo tab để đổi vị trí, hoặc nhấn Cmd+↑ (Ctrl+↑ trên Windows) để dời tab đang mở sang trái một vị trí. Cmd+Shift+← và Cmd+Shift+→ dời tab sang trái hoặc phải, nhưng macOS có thể lấy chúng trước khi app nhận được. Cmd+↓ không dời tab: nó cuộn pane đang focus xuống cuối và focus vào ô nhập của pane. Danh sách ở thanh bên cũng theo đúng thứ tự đó.
• Độ rộng: mỗi tab rộng tối đa 220px, tên dài hơn sẽ bị cắt bớt. Rê chuột lên tab để xem trọn tên.
• Cửa sổ riêng: chuột phải vào tab và chọn Chuyển tab sang cửa sổ mới (chỉ có khi cửa sổ có nhiều hơn một tab). Chuyển sang cửa sổ chính đưa nó về, còn Merge All Windows trong menu của biểu tượng trên thanh menu gom tất cả lại. Xem Pane và chia màn hình.
• Đóng: rê chuột lên tab và bấm dấu ×. Nếu tab có nhiều hơn một terminal, hộp thoại Xác Nhận Đóng Tab sẽ hỏi trước, và Đóng Tab sẽ kết thúc mọi tiến trình trong tab. Tab chỉ có một terminal thì đóng ngay.
• Đóng tab cuối cùng thì form tạo workspace hiện lại.

Thanh bên trái liệt kê các workspace dưới mục Không gian làm việc. Mỗi hàng có ô icon dự án và hai dòng: tên, rồi số terminal và, khi đã biết các phiên của nó, số token chúng đã dùng trên máy Mac này (tối đa 30 ngày qua) cùng chi phí theo giá niêm yết, ví dụ 6 Terminal · 1.7M · $0.41. Rê chuột lên một workspace và dùng menu ⋮ để Rename hoặc Close, hoặc kéo để đổi thứ tự. Nút Thêm Không gian mở một tab tạo workspace mới. Không gian làm việc, Terminals và nhóm Machines và SSH lúc đầu chia đều ba phần chiều cao của thanh bên, hàng dạng thẻ mềm. Kéo đường giữa hai mục để đổi kích thước, nhấp đúp vào nó để đặt lại. Chiều cao được giữ khi bạn ẩn thanh bên và khi khởi động lại. Machines và SSH dùng chung một chiều cao, vì chỉ một trong hai mở tại một thời điểm. Dưới các workspace, Terminals liệt kê terminal của workspace đang mở, dòng thứ hai có tên agent và số token của nó, rồi đến nhánh git của thư mục pane khi đã biết nhánh (không có với pane SSH hay pane của máy khác); bấm vào một dòng để focus pane đó. Nút Tất cả | Gần đây đổi danh sách: Gần đây hiện mọi pane của mọi tab trên máy Mac này, output mới nhất lên đầu, và thứ tự giữ yên khi bạn đang dùng, nên bấm vào đâu là vào đúng hàng đó (pane của máy khác không có trong đó). Rê chuột vào tiêu đề bị cắt để xem đủ tên. Dưới nữa, Machines liệt kê các máy MXterm Pro khác mà bạn đã ghép (xem Pane và chia màn hình) và chỉ mở sẵn khi đã ghép một máy; nút cài đặt ở đầu mục này mở Cài đặt ở phần Truy cập từ xa & Thiết bị. Mở một máy để thấy các tab của nó dạng thẻ kèm các pane, mỗi pane ở một trong năm trạng thái như trên điện thoại, và, với tab có Control Room đang hoạt động, một hàng mở ra đọc được 100 tin gần nhất (chỉ đọc). Menu ⋯ của một máy còn có Control Room mới… và Phiên mới… (xem Pane và chia màn hình). Bạn có thể ghim một máy hoặc một tab và kéo thả các dòng để đổi thứ tự; nếu địa chỉ đã lưu không còn dùng được, MXterm Pro tự thử các địa chỉ khác mà nó biết của máy đó (mạng nội bộ hoặc Tailscale). Một tab bạn mở từ máy khác có dòng thứ hai trong Không gian làm việc kết thúc bằng tên máy đó và đường kết nối, ví dụ 4 Terminal · Mac Thuy · Tailscale, còn các pane của nó trong Terminals hiện tên và agent riêng của chúng, kèm tên máy ở cuối. Tiếp theo, Máy chủ SSH liệt kê các host SSH đã lưu: bấm vào một host để mở nó trong tab mới. Đầu mục này có nút Tạo Mới và một nút mở trình quản lý SSH & SFTP. Cuối thanh bên có Cài đặt và số phiên bản app.

Ẩn hoặc hiện thanh bên bằng Cmd+B trên macOS (Ctrl+B trên Windows) hoặc nút thanh bên ở góc trái thanh tiêu đề. Các phím tắt khác có ở Phím tắt, còn cách chia và sắp xếp pane nằm ở Pane.

Mọi thứ trên trang này đều dùng được ở gói Free. Gói Free không giới hạn số pane: bạn mở bao nhiêu pane cũng được, trên mọi tab và cửa sổ. Ngoài pane, gói Free mặc định giới hạn sáu thứ, và license Pro gỡ tất cả các giới hạn đó. Pro còn thêm My Devices (mở các máy Mac khác đã đăng nhập mà không cần mã hay mật khẩu) và mật khẩu truy cập Thường trực (không hết hạn).

Đây là các con số mặc định. mxterm.net có thể đổi chúng cho gói Free trong những khoảng cố định, và một thay đổi có thể hết hạn, sau đó các số mặc định được áp dụng lại. Giới hạn chỉ được kiểm tra khi bạn thêm một thứ gì đó: hạ giới hạn không bao giờ đóng những gì đang mở hoặc đã lưu, và thêm máy thứ hai ở gói Free sẽ mở hộp thoại nâng cấp, còn các máy bạn đã có vẫn giữ nguyên. Control Room thứ hai có thành viên cũng vậy: phòng không có thành viên không được tính, và các phòng bạn đã có vẫn giữ nguyên. Chính app cưỡng chế giới hạn Control Room và máy. App MXterm trên điện thoại (iPhone, iPad) không được tính vào giới hạn 1 máy tính khác điều khiển Mac này. Chỉ máy tính khác chạy MXterm mới được tính; trình duyệt thì không. Hai giới hạn điều khiển từ xa chỉ từ chối thứ mới: máy tính đã ghép và pane đã chia sẻ vẫn giữ nguyên.

Truy cập từ xa còn một giới hạn Pro nữa: gói Free bật được mật khẩu truy cập kéo dài tối đa 8 giờ (Tạm thời), còn mật khẩu Thường trực, hoặc mật khẩu Tạm thời dài hơn 8 giờ (tối đa 7 ngày), cần Pro. Mật khẩu dài tối thiểu 6 ký tự. Xem Cài đặt.

Duyệt, sửa, tải lên và tải về file qua SFTP đều miễn phí, Token Meter cũng vậy.

Khi chạm giới hạn, một hộp thoại nói rõ giới hạn nào và cho chọn Mua MXterm Pro, Nhập mã giấy phép hoặc Để sau. Các gói có ở Bảng giá; cách kích hoạt mã xem ở Cài đặt.

Đóng cửa sổ MXterm Pro duy nhất là thoát hẳn app, trên mọi hệ điều hành. App không chạy ngầm: mọi terminal và agent ở mọi tab đều bị dừng. Thoát app làm mọi kết nối đang mở bị ngắt. MXterm Pro được thiết kế để lưu các lượt chia sẻ của bạn và khôi phục chúng ở lần mở tiếp theo, khi chính pane đó chạy lại; lượt chia sẻ nào không xác minh được sẽ bị bỏ, không bao giờ được mở rộng thêm.

Nếu bạn đã mở cửa sổ thứ hai thì đóng một trong hai không phải là thoát app. Cửa sổ còn terminal bên trong sẽ hỏi Đóng cửa sổ này? trước, và cho bạn chuyển các tab của nó sang cửa sổ kia thay vì kết thúc chúng. Chỉ khi đóng cửa sổ cuối cùng thì app mới thoát.

Khi app đang chạy, bấm vào biểu tượng của nó trên menu bar (khay hệ thống trên Windows) để đưa cửa sổ lên trước; menu của biểu tượng có Show MXterm Pro, Merge All Windows, Check for Updates… và Quit.

Lần mở app tiếp theo, các tab workspace được mở lại cùng bố cục pane, và mỗi pane khởi động lại trong thư mục của nó. Pane Claude Code mở lại đúng cuộc trò chuyện của nó theo id nếu app đã ghi nhớ, và bắt đầu cuộc trò chuyện mới nếu chưa. Pane Gemini CLI, OMP và Grok được chạy với --resume, pane Codex với codex resume, để bạn nối tiếp cuộc trò chuyện trước; các pane khác bắt đầu mới. Tab nào còn đang ở form tạo workspace sẽ không được khôi phục.

App cũng ghi nhớ, cứ khoảng 3 giây một lần, mỗi pane đang chạy gì. Với Claude Code và OMP, app giữ lại cuộc trò chuyện đang mở, nên pane mở lại đúng cuộc đó chứ không phải danh sách chọn hay phiên mới nhất trong thư mục. Nếu cuộc trò chuyện ấy không còn, Claude Code, OMP và Grok thử lại với --resume thuần ở hầu hết các shell, thay vì dừng ở một dấu nhắc trống. Nếu bạn tự chạy một agent trong pane terminal thường, pane sẽ quay lại chạy agent đó, được khôi phục theo cách tương tự, nhưng không có cờ Bypass Mode của nó. Trên Windows app không đọc được pane đang chạy gì, nên việc ghi nhớ này không diễn ra ở đó.