AWE Model (bản beta 0.3.1)

Trợ lý AI dựng đồ nội thất trong SketchUp của Trường Thiết Kế và Công Nghệ AWE. Bạn nói bằng tiếng Việt, Claude dựng hình trong SketchUp, bóc tách ván, phụ kiện và xuất hồ sơ bản vẽ.

Bạn cần có

SketchUp 2021 trở lên, Windows hoặc macOS, đã mở ít nhất một lần. Xuất hồ sơ bản vẽ PDF cần bản SketchUp Pro (có LayOut); các bản khác vẫn dựng hình và bóc tách được.
Tài khoản Claude trả phí (gói Pro trở lên) để dùng Claude Code. Chi phí AI tính vào gói Claude của bạn.
Kết nối mạng và mã kích hoạt AWE Model: miễn phí, nhận ở awe.edu.vn/plugin-sketchup-ai bằng họ tên và số điện thoại, mã hiện ngay (bước 3).

Bước 1. Chạy bộ cài

Giải nén cả tệp zip, rồi:

Windows: bấm đúp cai-dat-windows.cmd. Windows hỏi "Windows protected your PC" thì bấm More info > Run anyway.
macOS: bấm chuột phải vào cai-dat-mac.command, chọn Open, rồi Open lần nữa.

Bộ cài tự làm lần lượt, việc nào máy đã có thì bỏ qua:

Cài extension AWE Model vào mọi bản SketchUp trên máy.
Cài ứng dụng Claude (bản cho máy tính, có tab Code).
Cài Claude Code.
Cài plugin AWE cho Claude (kết nối Claude với SketchUp). Plugin được chép vào máy (Windows: %LOCALAPPDATA%\AWE Model, macOS: ~/Library/Application Support/AWE Model), nên sau đó xoá thư mục giải nén cũng không sao.
Mở trình duyệt để bạn đăng nhập tài khoản Claude, nếu máy chưa đăng nhập.

Cửa sổ báo CÀI XONG là được. Có dòng "Chưa xong" thì chụp màn hình gửi giảng viên AWE. Muốn cập nhật bản mới thì chạy bộ cài của bản mới, không cần gỡ bản cũ.

Bước 2. Kiểm trong SketchUp

Mở (hoặc mở lại) SketchUp. SketchUp hỏi về extension chưa xác minh thì chọn cho phép nạp.
Bấm icon AWE (vòm trắng trên nền xanh) trên thanh công cụ, hoặc Extensions > AWE Model > Giới thiệu, cài đặt và bản quyền. Hộp thoại AWE Model hiện tình trạng: kết nối SketchUp, Claude Code, plugin AWE đều "Đã cài" / "Đang mở" là xong.
Chỉ có tệp .rbz (không có cả gói zip)? Cài .rbz bằng Extension Manager > Install Extension, rồi bấm Cài Claude và kết nối trong hộp thoại này: bộ cài chạy y như bước 1.

Bước 3. Nhận mã và kích hoạt

Vào awe.edu.vn/plugin-sketchup-ai (hoặc bấm Nhận mã miễn phí trong hộp thoại AWE Model), để lại họ tên, số điện thoại. Mã dạng XXXXX-XXXXX-XXXXX-XXXXX hiện ngay trên trang.
Dán mã vào ô Mã kích hoạt trong hộp thoại AWE Model rồi bấm Kích hoạt. Hoặc gửi cho Claude: "kích hoạt AWE Model bằng mã ABCDE-...".

Bước 4. Dùng

Mở SketchUp có extension AWE Model, mở hoặc tạo một model.
Mở ứng dụng Claude, chọn tab Code, chọn một thư mục làm việc (vd thư mục dự án). Hoặc mở PowerShell / Terminal, gõ claude.
Gõ yêu cầu bằng tiếng Việt, ví dụ:

Bạn gõ	Claude làm
Dựng tủ áo 2 cánh 1200x600x2200, 3 đợt, cánh vân sồi	Dựng tủ trong SketchUp, tự chụp lại để kiểm, báo kích thước và các giả định
Cao lên 2400, thêm 1 đợt	Sửa đúng tủ vừa dựng (hoặc tủ đang chọn), giữ nguyên vị trí
Thêm đèn LED âm dưới các đợt	Phay rãnh trên đợt và đặt thanh nhôm LED đúng quy chuẩn
Bóc tách ván và phụ kiện tủ này	Bảng ván (mã, kích thước, cạnh dán, gia công), tổng m² ván, bản lề, ray, chốt đợt
Xuất hồ sơ bản vẽ	Tệp PDF A3 và tệp LayOut: mặt đứng, mặt bằng, mặt cắt có hatch, chi tiết, bảng bóc tách
Dùng khung tên này cho hồ sơ (kéo thả tệp .dxf, ảnh hoặc PDF khung tên)	Cài khung tên của bạn thay khung tên AWE, gửi ảnh xem trước để bạn duyệt. Các hồ sơ sau đều dùng khung tên đó
Chủ đầu tư là anh Hùng, công trình nhà phố Quận 7	Điền vào khung tên của hồ sơ dự án này; tên bản vẽ, tỷ lệ, ký hiệu, ngày tự điền theo từng tờ

Có thể kéo thả ảnh mẫu vào cửa sổ Claude rồi nói "dựng theo ảnh này". Mỗi lần dựng hoặc sửa là một bước Undo trong SketchUp (Ctrl+Z).

Hồ sơ được lưu trong thư mục AWE Model - Ho so cạnh tệp .skp của bạn (model chưa lưu thì trong thư mục Documents). Mở tệp ho_so.layout bằng LayOut để chỉnh tiếp.

Khung tên của riêng bạn

Tệp DXF là cách chính xác nhất: nét và chữ giữ đúng như bản gốc, kể cả chữ font .VnTime, VNI. Có tệp DWG thì mở bằng AutoCAD, chọn Save As, kiểu tệp AutoCAD DXF (*.dxf). Gửi được cả khung bản vẽ (viền + khung tên) hoặc riêng khung tên.
Ảnh hoặc PDF: Claude nhìn ảnh rồi vẽ lại, nên có thể lệch nhỏ; xem ảnh xem trước Claude gửi lại và nói chỗ cần sửa. Logo nên gửi kèm thành tệp ảnh riêng.
Khung tên lưu trong máy, dùng cho mọi hồ sơ sau. Muốn quay lại khung tên AWE, nói "dùng lại khung tên AWE".

Mã kích hoạt

Chưa kích hoạt thì Claude không chạy được lệnh SketchUp nào và sẽ gửi link nhận mã.
Mỗi số điện thoại một mã, mỗi mã dùng cho 1 máy. Đổi máy thì nhận lại mã bằng đúng số điện thoại đó rồi kích hoạt trên máy mới; mã cũ ngừng dùng.
Mất mã thì nhận lại bằng đúng số điện thoại đó: được mã mới, mã cũ ngừng dùng (kích hoạt lại các máy bằng mã mới).
Hỏi Claude "AWE Model đã kích hoạt chưa", hoặc xem trong hộp thoại AWE Model.
Kích hoạt một lần là xong, không thời hạn, không phải gia hạn. Chỉ cần mạng lúc kích hoạt; sau đó không có mạng vẫn dùng được.
Cập nhật bản mới: mở SketchUp có mạng thì AWE Model tự kiểm mỗi ngày và báo khi có bản mới; bấm Cập nhật (hoặc nút AWE Model trên thanh công cụ > Cập nhật), đợi cửa sổ cập nhật báo CẬP NHẬT XONG, thoát hẳn SketchUp rồi mở lại, trong Claude mở phiên mới. Mã đã kích hoạt vẫn giữ. Bản mới cũng luôn tải được ở awe.edu.vn/tai-awe-model.

Lỗi thường gặp

Hiện tượng	Cách xử lý
SketchUp báo AWE Model là extension chưa xác minh (unidentified), hoặc không thấy menu AWE Model	Bản beta chưa được ký. Khi SketchUp hỏi thì chọn cho phép nạp. Không thấy hỏi: vào Extension Manager, bấm biểu tượng bánh răng (Loading Policy), chọn Approve Unidentified Extensions, mở lại SketchUp.
Claude báo "Chưa kết nối được SketchUp"	Mở SketchUp trước. Vẫn lỗi thì vào Extensions > AWE Model > Mở lại kết nối Claude.
Xuất hồ sơ báo cần SketchUp Pro	Bản SketchUp của bạn không có LayOut. Vẫn lấy được bảng bóc tách: "bóc tách ván, xuất file Excel".
Claude không thấy công cụ SketchUp	Chạy lại bộ cài, rồi mở phiên Claude mới. Trong Claude gõ `/mcp` để xem awe-sketchup đã kết nối chưa.
macOS báo không mở được awe-sketchup-mcp	Chạy lại `cai-dat-mac.command` (bộ cài gỡ cờ cách ly của macOS).
Bộ cài báo chưa thấy SketchUp	Mở SketchUp một lần cho nó tạo thư mục cài đặt, đóng lại, rồi chạy lại bộ cài.
Claude báo "AWE Model chưa được phép chạy trên máy này"	Đọc lý do Claude báo: chưa kích hoạt thì nhận mã ở awe.edu.vn/plugin-sketchup-ai rồi kích hoạt (bước 3); mã đã dùng ở máy khác thì nhận mã mới bằng số điện thoại đó; không kiểm được license thì kiểm mạng và ngày giờ máy.

Giới hạn của bản beta

Chỉ sửa được đồ do AWE Model dựng ra, chưa sửa đồ bạn tự vẽ tay.
Hồ sơ bản vẽ đẹp nhất với tủ một dãy dựng bằng từng tấm ván (tủ áo, tủ giày, kệ, tủ bếp một dãy). Bếp chữ L, bàn, giường vẫn xuất được nhưng cần chỉnh nhãn trong LayOut.
Phụ kiện mặc định theo catalog Häfele và Cariny; kiểm lại mã trước khi đặt hàng.
Xuất hồ sơ mới thử trên SketchUp Pro 2023 cho Windows.
Khung tên DXF: đọc nét, chữ, block, thuộc tính; vùng tô (HATCH) và ảnh chèn trong DXF bị bỏ qua, logo gửi riêng thành tệp ảnh. Hồ sơ luôn ra khổ A3 ngang: khung bản vẽ khổ khác được co về A3.

Điều khoản

AWE Model do Trường Thiết Kế và Công Nghệ AWE phát hành miễn phí, cần mã kích hoạt nhận bằng số điện thoại (tư vấn viên AWE có thể liên hệ qua số đó); khi có mã còn hiệu lực, bạn được dùng cho học tập và công việc, kể cả thương mại. AWE Model chỉ gửi mã máy đã băm, tên máy, phiên bản và mã kích hoạt tới license.awe.vn, không gửi model của bạn. Không bán lại, không sửa rồi phát hành lại dưới tên khác. Phần mềm đang thử nghiệm, cung cấp nguyên trạng; luôn kiểm lại kích thước trước khi sản xuất. Chi tiết trong tệp DIEU-KHOAN.txt.

Góp ý và báo lỗi: gửi cho giảng viên AWE hướng dẫn bạn, kèm ảnh chụp màn hình và câu bạn đã gõ cho Claude. Trường Thiết Kế và Công Nghệ AWE - awe.edu.vn