# CHO CLAUDE ĐỌC: Bước 2. Cài Claude Code

> 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://trienkhaiclaude.truongminhkien.vn

## Việc cần làm

Cần Node.js LTS và gói Claude trả phí. Kèm cách sửa lỗi PowerShell chặn lệnh và lỗi phiên đăng nhập hết hạn.

Câu lệnh học viên dán vào Claude:

```
Tải gói https://trienkhaiclaude.truongminhkien.vn/cai-claude-code.zip, giải nén, đọc CHO-CLAUDE-DOC.md rồi kiểm tra Node.js, Claude Code và phiên đăng nhập trên máy 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://trienkhaiclaude.truongminhkien.vn)

Yêu cầu trước khi bắt đầu

- Đã xong [Bước 1: Cài Obsidian](https://trienkhaiobsidian.truongminhkien.vn/)
- Máy tính Windows, Mac, hoặc Linux
- **Node.js phiên bản 18 trở lên** (nếu chưa có, làm Bước 1 bên dưới)
- Có tài khoản Claude (đăng ký miễn phí tại [claude.ai](https://claude.ai) nếu chưa có)

## Các bước cài đặt

1

### Cài Node.js (bỏ qua nếu máy đã có)

Vào [nodejs.org](https://nodejs.org), tải bản **LTS** (bản ổn định lâu dài), cài như phần mềm bình thường (Next → Next → Install).

Kiểm tra đã cài thành công: mở Terminal (Mac/Linux) hoặc PowerShell (Windows), gõ:

node --version

Thấy hiện ra số phiên bản (ví dụ `v20.11.0`) là xong.

2

### Cài Claude Code

Trong cùng cửa sổ Terminal/PowerShell, gõ:

npm install -g @anthropic-ai/claude-code

Chờ vài phút để tải xong. Trên Windows, nếu PowerShell báo lỗi "chạy script bị chặn", dùng `npx.cmd` hoặc mở PowerShell bằng quyền Admin.

3

### Đăng nhập lần đầu

Gõ lệnh:

claude

Lần đầu chạy, Claude Code sẽ tự mở trình duyệt để bạn đăng nhập bằng tài khoản claude.ai. Đăng nhập xong, quay lại Terminal là dùng được.

4

### Kiểm tra đã cài đúng

claude --version

Thấy hiện số phiên bản là cài thành công.

5

### Cài thêm "Claude for Chrome" (khuyến nghị, không bắt buộc)

Đây là extension trình duyệt cho Claude AI tự xem/bấm/điền form ngay trên trang web bạn đang mở — dùng nhiều ở các bước sau (gắn tên miền, thao tác trên trang quản trị không có API). Vào [claude.ai](https://claude.ai), đăng nhập, tìm mục cài extension Chrome trong phần cài đặt tài khoản (Settings) — làm theo đúng hướng dẫn hiện ra ở đó. Lưu ý thật đã gặp: Claude for Chrome **không tự tải file lên được** (chọn ảnh/tài liệu từ máy) — việc đó bạn vẫn phải tự bấm, Claude chỉ làm tiếp các bước sau đó.

6

### Bắt đầu dùng

Tạo 1 thư mục dự án bất kỳ trên máy, mở Terminal tại đó, gõ `claude` để bắt đầu trò chuyện. Từ giờ, mọi bước tiếp theo trong hệ thống này, bạn chỉ cần **dán đúng link trang tiếp theo** và nói "đọc và làm theo trang này" — Claude sẽ tự đọc, tự hiểu, và tự thực hiện.

**Lưu ý:** nếu đây là lần đầu bạn dùng dòng lệnh (Terminal/PowerShell), đừng lo — chỉ cần copy đúng dòng lệnh màu tối ở trên, dán vào, bấm Enter. Không cần hiểu nó làm gì bên trong.

**1 nguyên tắc quan trọng cho MỌI bước cài đặt sau đây:** không có bước "kết nối Claude AI với công cụ X" nào cả — Claude Code chạy chung 1 Terminal/máy với bạn, nên bất kỳ công cụ dòng lệnh nào bạn cài xong (lark-cli, git, gh...) Claude AI **tự nhìn thấy và tự dùng được ngay**, không cần khai báo hay kết nối thêm gì.

Bước tiếp theo

Cài xong Claude AI, sang bước kế tiếp (không bắt buộc): cài môi trường làm việc trực quan hơn, thay vì chỉ gõ lệnh trong Terminal.

[Sang bước 3: Cài Antigravity IDE →](https://trienkhaiantigravity.truongminhkien.vn/)