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

Dựa trên màn hình đã kiểm chứng với Claude Code 2.1.288~2.1.291

1. Chuẩn bị

Kết nối các Mac của lập trình viên vào một máy chủ công ty.

• Máy chủ công ty: đặt máy chủ ứng dụng web (WAS) và cơ sở dữ liệu trên máy chủ nội bộ. Console web đặt sau HTTPS proxy của công ty, còn kết nối Agent (/ws/agent · /agent/) chỉ mở trong mạng nội bộ (VPN). Đăng nhập web bắt buộc ID · mật khẩu kèm OTP.
• Mỗi Mac: tmux và Claude Code. Phải chạy Claude Code bên trong cửa sổ tmux thì mới nhập · phê duyệt được từ web.
• Cài Agent: chạy dòng lệnh do quản trị viên tạo bằng Quản lý › Host › “Thêm host” trên web trong terminal của Mac lập trình viên (trong mạng nội bộ). Mã đăng ký chỉ dùng được một lần, trong vòng 15 phút.

# Dạng lệnh mà “Thêm host” tạo ra (địa chỉ · mã là giá trị hiện trên màn hình)
curl -fsSL <địa chỉ máy chủ>/agent/install.sh | bash -s -- --code XXXX-XXXX

Script cài đặt sẽ xác minh tệp chạy, đăng ký, cho thường trú bằng launchd, gắn hook của Claude Code và cuối cùng kiểm tra lại. Từ đó về sau, Agent được cập nhật bằng “Cập nhật ngay” trên web.

2. Xem phiên

Danh sách phiên hiển thị các phiên của mọi Mac theo thứ tự trạng thái.

Nhấn vào phiên để mở hội thoại. Hội thoại · lệnh gọi công cụ · kết quả được thêm vào theo thời gian thực, đúng thứ tự như trên terminal; nếu đang cuộn lên đọc, vị trí đang đọc được giữ nguyên dù có tin nhắn mới (nhấn nút “Tin nhắn mới” để xuống cuối).

3. Phê duyệt · câu hỏi

• Yêu cầu quyền: “Cho phép” · “Luôn cho phép lệnh này” · “Từ chối”. “Luôn cho phép” chỉ lưu đúng quy tắc mà Claude đề xuất (thường chỉ là lệnh đó). Nếu thấy phiền vì bị hỏi ở mỗi lệnh, hãy đổi chế độ quyền sang “Tự động”.
• Câu hỏi của Claude: chọn đáp án trên thẻ câu hỏi (một hoặc nhiều) hoặc tự nhập rồi nhấn “Gửi câu trả lời”. Nếu có nhiều câu hỏi, phải trả lời hết mới gửi được.
• Hộp thoại tương tự cũng đồng thời hiện trên terminal, và bên nào trả lời trước sẽ được áp dụng.
• Hộp thoại xác nhận chỉ hiện trên terminal (ví dụ: “Background work is running” khi /exit, “Switch model?” khi đổi mô hình) cũng hiện thành thẻ “Đang hỏi trong terminal” và có thể chọn từ web.
• Các yêu cầu đang chờ được gom vào cột thông báo (trên điện thoại là tab “Thông báo”).

4. Prompt · tệp · dừng

• Viết vào ô nhập rồi gửi (⌘/Ctrl+Enter). Văn bản dài cũng được gửi nguyên vẹn, và ô nhập chỉ được xóa sau khi nhận được xác nhận đã gửi.
• Tệp kéo thả hoặc dán vào ô nhập sẽ được tải lên uploads/ trong thư mục phiên và @đường-dẫn được chèn vào ô nhập. Cũng có thể dùng nút đính kèm để chọn thư mục rồi tải lên.
• “Dừng” tương đương với Esc trên terminal. Các lệnh như /compact · /clear được gửi bằng nút nhanh.

5. Phiên mới · tiếp tục

1. Trong “Phiên mới”, chọn Mac (host) · tài khoản · mô hình · effort · thư mục dự án · chế độ quyền. Chỉ có thể mở thư mục nằm trong các thư mục được phép trên Mac đó.
2. “Hội thoại mới” hoặc “Tiếp tục” (chọn hội thoại đã kết thúc). Danh sách được đọc từ đĩa của Mac đó, nên cả hội thoại của những thư mục chỉ dùng trên terminal cũng hiện ra (mục trên cùng là hội thoại gần nhất, giống claude --continue). Tiếp tục sẽ mở với chế độ quyền · effort mà hội thoại đó đã dùng.
3. Khi mở tiếp bằng tài khoản khác với tài khoản lưu hội thoại, tệp hội thoại được sao chép sang tài khoản đó để làm tiếp (tệp của tài khoản gốc vẫn giữ nguyên).

6. Mô hình · effort · chế độ quyền

• Đổi bằng nút “Mô hình · effort” ở đầu phiên. Mặc định chỉ áp dụng cho phiên này; bật “Lưu làm mặc định cho phiên mới” thì giá trị mặc định của tài khoản đó cũng thay đổi.
• Nếu đổi mô hình giữa chừng hội thoại, ở tin nhắn tiếp theo toàn bộ hội thoại sẽ được mô hình mới đọc lại nên sẽ chậm hơn và tốn thêm token.
• Chế độ quyền: Mặc định (luôn hỏi) · Tự chấp nhận chỉnh sửa · Lập kế hoạch · Tự động (chỉ hỏi những gì có vẻ nguy hiểm) · Cho phép tất cả (chỉ trong thư mục đáng tin cậy).

7. Chuyển phiên

Menu phiên › “Chuyển sang host khác”. Chỉ chuyển được phiên đã kết thúc trên Mac ban đầu.

• Chỉ chuyển hội thoại, hoặc chuyển cả thư mục làm việc. Thư mục làm việc được đóng gói (trừ các thư mục có thể tạo lại như node_modules · target), đi qua máy chủ rồi giải nén vào thư mục trống trên Mac nhận.
• Theo dõi các bước (xuất → đóng gói → tải lên → nhận → giải nén → mở tiếp) qua thanh tiến trình. Quá trình vẫn tiếp tục khi đóng web, và khi quay lại sẽ thấy tiến trình.
• Mặc định, mã nguồn được đồng bộ bằng git. Cửa sổ chuyển phiên so sánh và hiển thị trạng thái git của hai Mac.

8. Trình duyệt tệp

• Mở thư mục phiên bằng nút “Tệp” ở đầu phiên. Hỗ trợ tab · xem song song · xem trước markdown · xem trước ảnh.
• Để chỉnh sửa, mở khóa, sửa rồi nhấn ⌘+S. Nếu trong lúc đó Claude đã sửa cùng tệp, hệ thống sẽ báo xung đột.
• Có thể đổi tên · nhân bản · xóa. Xóa chỉ là chuyển vào Thùng rác, và không ghi vào .git · .claude.
• Đổi Cài đặt › Trình duyệt này › “Mở trình duyệt tệp” sang “Trong cửa sổ mới” thì “Tệp” sẽ mở trong một cửa sổ riêng, giúp vừa xem hội thoại vừa xem tệp.

9. Tác vụ · mức sử dụng

• Tác vụ: xem các tác tử chạy nền và workflow đang chạy trên mọi phiên, cùng những cái đã kết thúc trong 24 giờ qua.
• Mức sử dụng: chọn khoảng thời gian · tài khoản · host để so sánh chi phí ước tính · yêu cầu · token đầu ra · tỷ lệ trúng cache với kỳ trước. Có hạn mức tài khoản (5 giờ · tuần · tuần theo mô hình) và dự báo theo tốc độ hiện tại, biểu đồ cột theo mô hình mỗi ngày, xếp hạng theo dự án · phiên, bản đồ nhiệt thứ × giờ.
• Chi phí là ước tính quy đổi theo đơn giá API, không phải phí thuê bao.

10. Quản lý · cài đặt

• Host: trạng thái kết nối · phiên bản · chỉ số, “Thêm host” · hủy đăng ký, “Cập nhật ngay” cho Agent.
• Tài khoản · Mức sử dụng: trạng thái đăng nhập tài khoản Claude · Ollama trên từng Mac, đăng nhập · đăng xuất từ web.
• Mô hình: bật · tắt các mô hình được dùng, mô hình mặc định theo từng loại.
• Sao lưu: Agent tải lịch sử hội thoại của từng Mac lên máy chủ công ty mỗi 10 phút. Dung lượng kho lưu trữ máy chủ · dung lượng đĩa còn trống, trạng thái sao lưu theo host và “Sao lưu ngay”, tìm hội thoại đã sao lưu và “Khôi phục” (quản trị viên). Hội thoại đã khôi phục được mở bằng Phiên mới › Tiếp tục.
• Cài đặt: cài đặt máy chủ như giới hạn xem trước tệp · thời gian lưu giữ (quản trị viên), và cài đặt của trình duyệt này như giao diện · trình soạn thảo.

11. Trên điện thoại · máy tính

Điện thoại: trong Safari, chọn “Thêm vào Màn hình chính” để mở như một ứng dụng, rồi chuyển qua lại bằng thanh tab bên dưới (Phiên · Thông báo · Tác vụ · Mức sử dụng · Quản lý). Với phê duyệt · câu hỏi, nhấn “Trả lời trong phiên” ở tab Thông báo để đi thẳng tới phiên.

Máy tính: danh sách phiên · hội thoại · thông báo hiển thị cạnh nhau thành ba cột. Hai cột bên có thể thu gọn thành dải tóm tắt · dải biểu tượng (trình duyệt này ghi nhớ), và trình duyệt tệp mở hai tệp cạnh nhau. Kéo thả tệp vào vùng hội thoại sẽ tải lên ngay.

12. Terminal web

Mở shell trên Mac của lập trình viên (Quản lý › Host › “Terminal”) và màn hình tmux thật của phiên claude (Menu phiên › “Xem bằng terminal”) ngay trên web. Vì đây là shell chạy với quyền của người dùng trên Mac đó, nên có các điều kiện sau.

• Phải bật trực tiếp trên Mac đó — không thể bật từ web. Khi tắt, các terminal đang mở cũng bị đóng.
• Chỉ dành cho quản trị viên, và mỗi lần mở đều xác nhận OTP thêm một lần. Mở · đóng · thời gian · số byte được ghi vào nhật ký kiểm toán, nhưng nội dung phím gõ thì không. Tự đóng sau 30 phút không có thao tác nhập.
• Trên máy tính, terminal mở trong một cửa sổ riêng (Cài đặt › Trình duyệt này › “Mở terminal web”). Dù đóng hay tải lại cửa sổ console, terminal vẫn giữ nguyên.
• Dùng con lăn · vuốt · PgUp/PgDn · Shift+PageUp để xem đầu ra cũ, nhấn phím bất kỳ để trở về màn hình ban đầu. Kéo chọn là sao chép ngay; ⌘+K xóa cả màn hình và đầu ra cũ, ⌘+L chỉ xóa màn hình.
• Số dòng đầu ra cũ được ghi nhớ đặt tại Cài đặt › “Terminal web › Số dòng lịch sử” (mặc định 10.000 dòng).

# Trong terminal của Mac đó — bật · tắt · trạng thái
~/.ssemtong/bin/ssemtong-agent terminal on
~/.ssemtong/bin/ssemtong-agent terminal off
~/.ssemtong/bin/ssemtong-agent terminal status

13. Danh sách prompt

• Mục “Prompt” ở cột bên phải (trên điện thoại là tab “Thông báo”) chỉ hiện những gì người dùng đã nhập trong phiên đó, mới nhất trước — số thứ tự · thời điểm · ba dòng đầu, nhấn vào để xem toàn bộ.
• Nhấn nút ↳ để chuyển tới prompt đó trong hội thoại và làm nổi bật nó trong chốc lát. Trong lúc đọc từ đó, dù có đầu ra mới màn hình cũng không bị kéo xuống dưới; dùng nút “Xuống cuối” để quay lại.
• Khi chọn một prompt cũ chưa được tải lên màn hình, phần hội thoại trước và sau nó sẽ được tải từ máy chủ rồi chuyển tới, và có thể đọc tiếp bằng “Tải phần hội thoại tiếp theo”.

14. Ngôn ngữ

Console web hỗ trợ tiếng Hàn · English · 日本語 · 简体中文 · Français · Español · Bahasa Indonesia · Tiếng Việt · ភាសាខ្មែរ · العربية. Chọn bằng nút 🌐 phía trên (ở màn hình đăng nhập thì ở phía dưới) hoặc tại Cài đặt › Trình duyệt này › “Ngôn ngữ”. Ban đầu sẽ theo ngôn ngữ của trình duyệt, và ngôn ngữ đã chọn được trình duyệt đó ghi nhớ. Một số thông báo do máy chủ · Agent gửi vẫn hiển thị bằng tiếng Hàn.