# CHO CLAUDE ĐỌC: Bước 3. Cài Antigravity IDE (không bắt buộc)

> Tài liệu này viết cho Claude Code của học viên. Người học chỉ cần dán câu lệnh bên dưới vào Claude, Claude đọc file này rồi làm.
> Thuộc hệ thống triển khai AI 20 bước của Trương Minh Kiên. Trang bước này: https://trienkhaiantigravity.truongminhkien.vn

## Việc cần làm

Trình soạn mã có AI, mở đúng thư mục vault để làm việc song song với Claude.

Câu lệnh học viên dán vào Claude:

```
Tải gói https://trienkhaiantigravity.truongminhkien.vn/cai-antigravity.zip, giải nén, đọc CHO-CLAUDE-DOC.md rồi hướng dẫn tôi cài Antigravity IDE và mở đúng thư mục vault Obsidian của tôi
```

## Luật khi làm

1. Đọc hết file này, kể cả phần bẫy, trước khi chạy lệnh nào.
2. Việc cần mật khẩu, mã OTP, token hay thanh toán thì dừng lại để học viên tự làm, không nhập hộ.
3. Không xoá dữ liệu, bản ghi DNS hay file cũ của học viên. Chỉ thêm.
4. Khoá bí mật chỉ nằm trong `.env` (đã có trong `.gitignore`), không ghi vào mã, wiki hay kết quả.
5. Xong mỗi bước thì kiểm tra thật (chạy thử, đọc lại) rồi mới báo xong.
6. Gói này chạy trên máy của học viên, không phải máy người soạn. Mọi đường dẫn tính từ thư mục giải nén hoặc thư mục vault của học viên; hỏi học viên nếu cần. Skill nào nhắc tới file `output/...` hay trang `wiki/...` mà vault học viên chưa có thì đó chỉ là nguồn tham khảo của người soạn: bỏ qua, dùng nội dung ngay trong skill. Riêng `wiki/concepts/bo-mau-thuong-hieu.md`: nếu chưa có, chép từ `mau/bo-mau-thuong-hieu.md` trong gói rồi hỏi học viên để điền.

## Skill trong gói

- (gói này không kèm skill riêng)

Cách cài skill: chép từng thư mục trong `.claude/skills/` của gói vào `.claude/skills/` của vault Obsidian (bước 1). Tên thư mục phải trùng tên skill, file chính tên `SKILL.md`.



## Hướng dẫn chi tiết và các bẫy đã gặp

(Bản đầy đủ có hình và nút bấm: https://trienkhaiantigravity.truongminhkien.vn)

Yêu cầu trước khi bắt đầu

- Đã xong [Bước 2: Cài Claude AI](https://trienkhaiclaude.truongminhkien.vn/)

## Các bước cài đặt

1

### Tải và cài Antigravity IDE

Tải bộ cài dành cho máy của bạn, cài như phần mềm bình thường.

2

### Mở đúng thư mục vault Obsidian

Mở Antigravity IDE, chọn "Open Folder", trỏ tới đúng thư mục vault đã tạo ở [Bước 1](https://trienkhaiobsidian.truongminhkien.vn/) (hoặc bất kỳ thư mục dự án nào bạn đang làm việc) — IDE sẽ hiện toàn bộ file trong đó ở khung bên trái.

3

### Trò chuyện với Claude AI ngay trong IDE

Có 1 khung chat riêng để nói chuyện với Claude AI — mọi việc trước đây phải gõ lệnh `claude` trong Terminal giờ làm được ngay tại đây, kèm xem trực tiếp file nào đang được sửa, xem trước (preview) trang web/kết quả ngay khi AI vừa làm xong.

**Không bắt buộc:** nếu bạn đã quen làm việc qua Terminal (cửa sổ dòng lệnh) ở Bước 2, có thể bỏ qua bước này và đi thẳng tới [Bước 4](https://trienkhailark.truongminhkien.vn/) — hai cách đều dùng chung 1 Claude AI, chỉ khác giao diện.

Bước tiếp theo

Đã có môi trường làm việc, sang bước kế tiếp: kết nối Lark — nơi lưu dữ liệu của toàn hệ thống.

[Sang bước 4: Cài Lark →](https://trienkhailark.truongminhkien.vn/)

## Mở rộng (cập nhật 14/10/2026): Antigravity CLI và tận dụng gói Google AI

### Antigravity CLI (`agy`)
Từ 18/6/2026 tài khoản Google AI Pro, Ultra không đăng nhập được Gemini CLI (báo "Authentication consent could not be obtained"); dùng **Antigravity CLI**. Cài: học viên tự dán `irm https://antigravity.google/cli/install.ps1 | iex` vào PowerShell, mở cửa sổ mới gõ `agy`. Đã cài ứng dụng Antigravity thì dùng chung đăng nhập.

Claude gọi: `agy -p "<lệnh>" --model gemini-3.1-pro-high --print-timeout 180s` (chạy trong thư mục bộ não). Mô hình có sẵn: gemini-3.8-flash, gemini-3.1-pro, cả claude-opus-5-5, claude-sonnet-5-5 chạy bằng hạn mức Google. Luật: Gemini chỉ đọc và trả lời, không tạo hay sửa file; Claude kiểm lại mọi số liệu, trích dẫn với nguồn gốc; bản cuối do Claude viết; chỉ đáng giao khi đầu vào rất dài mà câu trả lời ngắn.

Bẫy: PowerShell chặn `.ps1` thì gọi bản `.cmd`; `--mode plan` ghi vào artifact thay vì in ra; màn hình chào không nhận phím mũi tên trong terminal của ứng dụng Claude (không cần qua, `agy -p` chạy luôn); ô cho Google thu dữ liệu để trống.

### Tận dụng gói Google AI
Flow, Veo (cảnh minh hoạ, xem bước 21), Flow Music (nhạc nền thương mại), Gemini Notebook (xem bước 13), Colab GPU. Sổ Colab mẫu chỉnh ảnh cưới trong thư mục `mo-rong-google-ai/`: thả ảnh vào Drive `XUONG-ANH-COLAB/vao/<album>`, chép `xuong_anh.py` vào `XUONG-ANH-COLAB/`, mở sổ trong Colab, chọn GPU, Chạy tất cả. Bẫy cài trên Python 3.13: `basicsr` phải tải tệp nguồn, vá `setup.py` và `functional_tensor` TRƯỚC khi import, cài `--no-build-isolation` (sổ đã làm sẵn). Ảnh khách chỉ xử lý trong Drive và Colab của chính bạn, không tạo link công khai.
<!-- them skill 19/10 -->
**Không dùng Colab thì chạy trên máy** (thêm 19/10): thư mục `mo-rong-google-ai/xuong-anh-tren-may/` là bộ cài xưởng ảnh chạy ngay trên máy (Windows `CAI-DAT-WINDOWS.bat`, Mac `CAI-DAT-MAC.command`), kèm skill `chinh-anh-cuoi`: phục hồi mặt (GFPGAN), tăng nét và phóng to 2 lần (Real-ESRGAN), làm mịn da mà giữ đúng người, 4 chất màu (studio kem, Hàn Quốc, phim ấm, sang trọng). Cần Python 3.10 đến 3.13, trống 2 đến 6 GB. Máy có card NVIDIA 3 đến 6 giây một ảnh; máy không card rời 1 đến 3 phút một ảnh, album lớn thì dùng sổ Colab. Đọc `DOC-TRUOC-KHI-CAI.md` và `chinh-anh-cuoi/GIAY-PHEP.md` (bộ AI tải từ GitHub chính chủ, giấy phép cho chỉnh ảnh lấy tiền). Luôn giữ ảnh gốc, ảnh khách không đưa lên mạng.

