# CHO CLAUDE ĐỌC: Bước 5. Cài GitHub (chỉ để cất mã, 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 của Trương Minh Kiên. Trang bước này: https://trienkhaigithub.truongminhkien.vn

## Việc cần làm

GitHub là nơi **cất mã và lịch sử sửa đổi**, giống một kho sao lưu cho các bộ công cụ bạn dựng. Từ 14/10/2026 hệ thống **không chạy việc tự động trên GitHub nữa**: máy đăng Facebook, gửi thư nuôi... chạy trên Cloudflare Workers (bước 6 và 14). Bước này **không bắt buộc**; bỏ qua vẫn làm được mọi bước khác.

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

```
Tải gói https://trienkhaigithub.truongminhkien.vn/cai-github.zip, giải nén, đọc CHO-CLAUDE-DOC.md rồi hướng dẫn tôi tạo tài khoản GitHub, cài GitHub CLI (gh) và tạo một kho riêng tư để cất mã
```

## 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 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 bao giờ** đưa lên GitHub.
5. **Không tạo nhiều kho liên tục** (xem bẫy 1). Mỗi lần chỉ tạo 1 kho, cách nhau ít nhất vài giờ.
6. Xong mỗi bước thì kiểm tra thật rồi mới báo xong.

## Skill trong gói

- (gói này không kèm skill riêng)

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

- Đã xong [Bước 2: Cài Claude AI](https://trienkhaiclaude.truongminhkien.vn/)
- Không cần biết lập trình, chỉ cần biết tạo tài khoản và thao tác web cơ bản

## Các bước

### 1. Tạo tài khoản GitHub

Vào [github.com](https://github.com), đăng ký miễn phí bằng email, bật xác thực 2 lớp (2FA) ngay. Cất mã khôi phục 2FA ở chỗ riêng ngoài máy.

### 2. Tạo 1 kho riêng tư (repository)

Bấm "New", đặt tên (ví dụ tên thương hiệu), chọn **Private**. Chỉ 1 kho cho lần đầu.

### 3. Cho Claude đưa mã lên để cất

Nói với Claude: *"Cài GitHub CLI, đăng nhập, rồi đưa thư mục [tên thư mục] lên kho riêng tư vừa tạo; kiểm tra .gitignore đã chặn .env và mọi file chứa khoá."* Việc này chỉ để sao lưu; máy tự động vẫn chạy trên Cloudflare.

## Bẫy đã gặp thật và cách gỡ

🔴 **1. Tạo nhiều kho liên tục là bị gắn cờ, cả tài khoản bị ẩn.** Gặp thật 29/9/2026: tạo khoảng 20 kho trong một buổi tối, ngay sau đó tài khoản bị hệ thống chống spam của GitHub gắn cờ: hồ sơ và mọi kho báo 404 với người ngoài, GitHub Actions dừng (máy đăng Facebook dừng hơn 2 tuần), hỗ trợ của GitHub trả lời rất chậm (hơn 2 tuần chưa gỡ). **Gỡ:** mỗi lần chỉ tạo 1 kho, giãn ra; đã bị gắn cờ thì gửi yêu cầu ở https://support.github.com (thư mới gửi tới support@githubsupport.com bị tự từ chối), không lập tài khoản mới để né.

🔴 **2. Đừng để việc kinh doanh chạy trên GitHub Actions.** Lịch của GitHub Actions là "best effort": đặt mỗi 30 phút nhưng thật ra chạy cách 1 đến 2 tiếng; tài khoản bị khoá là việc dừng hết. **Gỡ:** việc chạy theo lịch đặt trên Cloudflare Workers (bước 14 có máy mẫu chạy thật), đúng giờ và không phụ thuộc GitHub.

3. **Đưa nhầm khoá bí mật lên GitHub.** File `.env` hay file cấu hình chứa token bị đưa lên là lộ, kể cả kho riêng tư. **Gỡ:** kiểm `.gitignore` trước lần đưa đầu tiên; lỡ đưa lên thì đổi khoá ngay, không chỉ xoá file.

## Bước tiếp theo

Sang bước 6: đưa tên miền về Cloudflare, cũng là nơi chạy các máy tự động: https://trienkhaitenmien.truongminhkien.vn/