Hướng dẫn cài đặt 3DAgent

Trước khi cài

Không cần quyền quản trị (admin): 3DAgent cài riêng cho tài khoản Windows đang dùng.

1Tải bộ cài

1. Mở đường link tải do SSPACE gửi, tải file 3DAgent-Setup-0.1.0.exe (khoảng 22 MB).
2. Nếu trình duyệt báo "tệp này không thường được tải xuống" hoặc chặn tệp:
   • Microsoft Edge: rê chuột vào tệp trong danh sách tải xuống, bấm dấu …, chọn Giữ lại (Keep). Nếu hỏi tiếp, bấm Hiện thêm (Show more) rồi Vẫn giữ (Keep anyway).
   • Google Chrome: trong danh sách tải xuống, bấm Giữ lại (Keep), hoặc bấm vào dòng cảnh báo rồi chọn Tải xuống tệp không an toàn.
3. Mở thư mục Tải xuống (Downloads), kiểm tra đúng tên file và dung lượng khoảng 22 MB.

Nếu SSPACE chép bộ cài qua USB hoặc thư mục mạng nội bộ, bỏ qua bước này. Thường sẽ không gặp cảnh báo ở Bước 2.

2Mở bộ cài và vượt màn hình SmartScreen

1. Bấm đúp vào 3DAgent-Setup-0.1.0.exe.
2. Windows hiện khung xanh "Windows đã bảo vệ PC của bạn" (Windows protected your PC). Chỉ có nút Không chạy là bình thường.
3. Bấm dòng chữ Thông tin thêm (More info) ngay dưới đoạn thông báo.
4. Kiểm tra dòng Ứng dụng (App) ghi đúng 3DAgent-Setup-0.1.0.exe. Dòng Nhà phát hành ghi "Không xác định" (Unknown publisher) là đúng với bản này.
5. Bấm Vẫn chạy (Run anyway).

Minh hoạ: bấm vào hai chỗ có viền vàng, theo thứ tự Thông tin thêm rồi Vẫn chạy.

Cảnh báo này xuất hiện vì bộ cài chưa được ký số, không phải vì phát hiện virus. Bản có chữ ký số SSPACE sẽ phát hành sau.

Không thấy nút Vẫn chạy, hoặc Windows báo đã chặn hẳn ứng dụng: xem mục Khi gặp sự cố (Smart App Control).

3Cài đặt

1. Chọn ngôn ngữ: để Tiếng Việt, bấm OK.
2. Nếu hiện thông báo "Không tìm thấy SOLIDWORKS trên máy này": bấm Không, cài SOLIDWORKS trước rồi chạy lại bộ cài. Chỉ bấm Có khi SSPACE hướng dẫn.
3. Chọn bộ não AI: trang này chỉ hiện những mục máy chưa có.
   • Dùng tài khoản Claude → để nguyên dấu tích Cài Claude Code.
   • Dùng tài khoản ChatGPT → tích thêm Cài Codex CLI.
   • Có cả hai tài khoản thì tích cả hai.
4. Bấm Tiếp (Next), rồi Cài đặt (Install).
5. Chờ cài xong. Bước tải Claude Code / Codex từ máy chủ của Anthropic / OpenAI mất vài phút, thanh tiến độ có thể đứng yên một lúc. Đừng tắt bộ cài trong lúc này.

Mất mạng khi đang tải Claude Code / Codex vẫn cài được 3DAgent. Cài lại phần AI sau bằng menu Start › 3DAgent › 3DAgent - Đăng nhập Claude Code (hoặc Đăng nhập ChatGPT (Codex)): cửa sổ sẽ hỏi cài trước khi đăng nhập.

4Đăng nhập

Trang cuối của bộ cài có sẵn các ô đăng nhập. Để nguyên dấu tích rồi bấm Hoàn tất (Finish). Mỗi ô mở một cửa sổ đen; nếu không thấy, tìm nó trên thanh tác vụ.

Tài khoản 3DAgent (ô "Đăng nhập tài khoản lớp học ngay")

1. Gõ email SSPACE cấp, nhấn Enter.
2. Gõ mật khẩu, nhấn Enter. Mật khẩu không hiện ký tự nào khi gõ, đó là bình thường.
3. Nếu đang dùng mật khẩu tạm, cửa sổ yêu cầu đặt mật khẩu mới: từ 8 ký tự, có cả chữ và số, gõ hai lần.
4. Thấy dòng "Đã đăng nhập … 3DAgent đã kích hoạt trên máy này" thì nhấn Enter để đóng.

Tài khoản Claude (ô "Đăng nhập tài khoản Claude")

1. Trình duyệt mở trang đăng nhập của Anthropic. Đăng nhập tài khoản Claude Pro / Max, bấm Authorize (Cho phép).
2. Quay lại cửa sổ đen, thấy "Claude Code: ĐÃ ĐĂNG NHẬP" là xong.

Tài khoản ChatGPT (ô "Đăng nhập tài khoản ChatGPT")

1. Trình duyệt mở trang đăng nhập của OpenAI. Đăng nhập tài khoản ChatGPT, bấm Tiếp tục.
2. Trình duyệt chuyển về trang báo đăng nhập thành công; cửa sổ đen hiện "Codex CLI: ĐÃ ĐĂNG NHẬP".
3. Nếu trang báo cần "bật tính năng đăng nhập bằng mã thiết bị": bấm Hủy. Không cần bật tính năng đó. Mở đường link dài https://auth.openai.com/... in trong cửa sổ đen rồi đăng nhập lại.

Bỏ qua ô nào cũng được: đăng nhập lại bất cứ lúc nào từ menu Start › 3DAgent ("3DAgent - Đăng nhập tài khoản", "Đăng nhập Claude Code", "Đăng nhập ChatGPT (Codex)").

5Kiểm tra 3DAgent đã chạy

1. Khi bộ cài báo "Đã cài xong", thoát hẳn app AI đang mở (Claude Desktop, Codex…): bấm chuột phải vào biểu tượng của nó gần đồng hồ, chọn Quit / Thoát. Chỉ đóng cửa sổ là chưa đủ.
2. Mở lại app AI và gõ: Kiểm tra trạng thái 3DAgent. AI trả lời tài khoản đang hoạt động và phiên bản SOLIDWORKS là đã kết nối.
3. Lần đầu trên máy này, gõ tiếp: Thiết lập SOLIDWORKS cho 3DAgent (chỉ làm một lần).
4. Thử một việc nhỏ, ví dụ: Vẽ cho tôi bu lông M8x20 DIN 912.

Cài app AI mới sau khi cài 3DAgent (ví dụ Claude Desktop): chạy Start › 3DAgent › 3DAgent - Kết nối lại với app AI, rồi thoát hẳn và mở lại app đó.

Khi gặp sự cố

Vẫn không cài được: chụp màn hình lỗi và gửi SSPACE, kèm phiên bản Windows và SOLIDWORKS đang dùng.