🤖 Claude Code — Hướng dẫn cài đặt cho VS Code, Cursor & Antigravity
Hồi trước muốn dùng AI thì phải mở browser, copy code/text qua lại giữa ChatGPT và editor. Viết PRD thì tab này, review code thì tab kia, context bị m...
Mar 2026
✍️ **Tác giả:** Hana Ngọc Huyền
🗓️ **Ngày viết:** Tháng 3/2026
🎯 **Dành cho:** BA muốn bước vào con đường AI-augmented, bắt đầu từ công cụ nền tảng nhất
📚 **Series:** Bước đầu trở thành BA AI thực thụ — Bài 1/N
Nghe đến GitHub là nhiều bạn BA nghĩ ngay đến "mấy cái đó của dev, mình không cần đâu" 😅
Mình hiểu cảm giác đó — nhưng thật ra GitHub không chỉ là nơi lưu code. Với BA, GitHub là:
Nếu bạn muốn dùng Cursor AI, Claude, hay bất kỳ AI tool nào để hỗ trợ công việc BA → GitHub là nền tảng bạn cần có trước tiên. Không có repo thì AI "mù" bối cảnh dự án của bạn.
1. Khái niệm cơ bản (không cần nhớ hết, đọc hiểu là đủ)
2. Cài đặt và tạo tài khoản
3. Tạo repo đầu tiên cho BA
4. Cách dùng GitHub hàng ngày (không cần biết code)
5. Tại sao BA nên dùng GitHub thay vì Google Drive thuần túy
6. Tips & Tricks thực tế
💡 Không cần nhớ hết — chỉ cần hiểu đủ để làm việc. Gặp từ lạ thì tra lại bài này.
| | Git | GitHub |
| --------------------- | -------------------------------------------------- | -------------------------------------------- |
| Là gì? | Phần mềm quản lý version chạy trên máy bạn | Website/dịch vụ lưu trữ repo trên cloud |
| Cài ở đâu? | Máy tính của bạn | Không cần cài, vào web là dùng |
| Dùng như thế nào? | Dòng lệnh (terminal) hoặc qua app | Trình duyệt hoặc app GitHub Desktop |
| Bắt buộc không? | Cần nếu muốn sync tự động | Cần để lưu và share với người khác |
🎯 **Với BA non-tech:** Dùng **GitHub Desktop** (app có giao diện đẹp) là đủ, không cần nhớ dòng lệnh.
| Từ | Hiểu đơn giản là... |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| Repository (repo) | Một "thư mục dự án" trên GitHub — chứa tất cả file, docs, task |
| Commit | Hành động "lưu lại" thay đổi, kèm ghi chú "lưu cái gì" |
| Branch | Nhánh làm việc riêng — như tạo 1 bản copy để thử nghiệm mà không ảnh hưởng bản gốc |
| Main/Master | Nhánh chính — bản "chính thức" của tài liệu |
| Pull Request (PR) | Yêu cầu merge thay đổi vào nhánh chính — như "xin duyệt bản cập nhật" |
| Issue | Một task, bug, hoặc ghi chú cần theo dõi — giống ticket Jira |
| Markdown (.md) | Định dạng viết văn bản đơn giản — bạn đang đọc 1 file Markdown lúc này đấy! |
| Push | Đẩy thay đổi từ máy lên GitHub cloud |
| Pull | Kéo thay đổi từ GitHub cloud về máy |
| Clone | Tải nguyên 1 repo từ GitHub về máy để làm việc |
🖼️ **[Ảnh cần có: Sơ đồ minh họa flow: Local (máy bạn) → Commit → Push → GitHub Cloud, và ngược lại Pull]**
1. Tạo repo trên GitHub
↓
2. Clone về máy (hoặc edit thẳng trên web)
↓
3. Tạo/sửa file (.md, .txt, .json...)
↓
4. Commit: ghi chú "sửa gì" → lưu lại snapshot
↓
5. Push lên GitHub cloud
↓
6. Người khác Pull về → xem được thay đổi của bạn
🖼️ **[Ảnh cần có: Trang đăng ký GitHub với nút Sign Up nổi bật]**
💡 Gợi ý đặt username:
- Dùng tên thật hoặc tên công việc (vd: hana-ba-vng)
- Tránh username random khó nhớ vì sẽ share link repo cho team
GitHub Desktop là app có giao diện kéo thả, không cần gõ lệnh. BA non-tech nên dùng cái này.
🖼️ **[Ảnh cần có: Giao diện GitHub Desktop — sidebar trái là danh sách repo, giữa là list file thay đổi, phải là diff (so sánh trước/sau)]**
✅ Sau khi cài xong, GitHub Desktop tự nhận diện Git trên máy
Nếu chưa có Git, app sẽ hướng dẫn cài thêm
Nếu bạn dùng Cursor AI để làm việc với repo thì cần cài Git:
Windows: Tải tại [git-scm.com/download/win](https://git-scm.com/download/win) → cài Next Next Next là xong
Mac: Mở Terminal gõ:
git --version
# Nếu chưa có, Mac sẽ tự hỏi cài Xcode Command Line Tools → bấm Install
Kiểm tra cài thành công:
git --version
# Git version 2.x.x → ✅ OK
🖼️ **[Ảnh cần có: Terminal hiện "git version 2.x.x" sau khi cài thành công]**
Repository name: ba-workspace (hoặc tên dự án của bạn)
Description: Workspace của BA team — docs, task, notes
Visibility: Private (chỉ mình và team thấy)
hoặc Public (ai cũng thấy — chọn nếu muốn share rộng)
☑️ Add a README file ← tick vào cái này!
🖼️ **[Ảnh cần có: Form tạo repo mới trên GitHub — highlight các trường Repository name, Visibility (Private), và checkbox Add README]**
Sau khi tạo repo, tổ chức thư mục như này:
📁 ba-workspace/
├── 📄 README.md ← Giới thiệu repo, mục đích dùng
├── 📁 requirements/ ← PRD, BRD, user story
│ ├── PRD-feature-X.md
│ └── BRD-project-Y.md
├── 📁 meeting-notes/ ← Biên bản họp, MoM
│ └── 2026-03-04-kickoff.md
├── 📁 research/ ← Nghiên cứu thị trường, benchmark
├── 📁 tasks/ ← Task tracking, todo list
│ └── sprint-01.md
└── 📁 templates/ ← Template dùng lại: PRD, MoM, user story...
💡 **Tip:** File `.md` (Markdown) là "đặc sản" của GitHub — hiển thị đẹp trên web, AI tools đọc được tốt, và viết cũng không khó hơn Word là mấy.
Cách nhanh nhất để bắt đầu — không cần cài gì thêm:
🖼️ **[Ảnh cần có: Giao diện edit file trên GitHub web — highlight nút bút chì và form Commit changes phía dưới]**
✅ Mỗi lần commit = 1 snapshot
GitHub tự lưu toàn bộ lịch sử → bạn xem lại, khôi phục được bất kỳ version nào
🖼️ **[Ảnh cần có: Nút "Add file" → dropdown "Create new file" trên GitHub repo]**
Issues là tính năng cực kỳ hữu ích — như Jira nhưng nhẹ hơn, miễn phí và nằm ngay trong repo.
🖼️ **[Ảnh cần có: Form tạo Issue mới — highlight Title, Description có checklist, Labels, Assignees]**
## Checklist
- [x] Phỏng vấn stakeholder
- [x] Draft PRD v1
- [ ] Review với PM
- [ ] Sign-off từ Dev Lead
- [ ] Update Jira
Hiển thị như này trên GitHub:
✅ Phỏng vấn stakeholder
✅ Draft PRD v1
⬜ Review với PM
⬜ Sign-off từ Dev Lead
⬜ Update Jira
🖼️ **[Ảnh cần có: Issue với checklist hiển thị trên GitHub — các dòng đã tick hiện dấu ✅ màu xanh]**
Đây là siêu năng lực của GitHub so với Google Drive:
🖼️ **[Ảnh cần có: Trang Commits history — danh sách commit theo thứ tự thời gian, mỗi dòng có avatar, tên người commit, message, và thời gian]**
🖼️ **[Ảnh cần có: Trang xem diff của 1 commit — phần màu đỏ (xóa) và màu xanh (thêm) trong file .md]**
💡 Use case thực tế:
PM hỏi "Hồi trước anh em thống nhất gì về feature X vậy?"
→ Bạn vào Commits → tìm commit ngày đó → xem lại chính xác từng chữ đã thay đổi
Không còn "hình như hôm đó mình có sửa gì đó..." nữa 😌
Khi làm việc nhóm, tránh mọi người cùng sửa 1 file gây conflict:
Cách đơn giản nhất:
🖼️ **[Ảnh cần có: Tab Pull Requests trên GitHub — danh sách PR, mỗi PR có status (Open/Merged/Closed), người tạo, và số comments]**
💡 Với BA, dùng PR = "xin review tài liệu"
PM/Tech Lead comment trực tiếp vào từng dòng → dễ track feedback hơn email
| Tình huống | Google Drive | GitHub |
| ----------------------- | --------------------------- | ------------------------------------------------ |
| Lưu PRD | ✅ Được | ✅ Được |
| Xem ai sửa gì | ⚠️ Có nhưng khó tìm | ✅ Rõ ràng từng dòng, từng người |
| Khôi phục version cũ | ⚠️ Có nhưng hạn chế | ✅ Dễ dàng, không giới hạn |
| Track task | ❌ Phải dùng Sheet riêng | ✅ Issues ngay trong repo |
| AI tool đọc context | ❌ Phải upload tay | ✅ Cursor/AI tự đọc từ repo |
| Tìm kiếm nội dung | ⚠️ Search cơ bản | ✅ Search toàn bộ repo, kể cả nội dung file |
| Review tài liệu nhóm | ⚠️ Comment trên Doc | ✅ PR + comment từng dòng |
| Offline | ❌ Cần internet | ✅ Clone về máy → làm offline |
| Miễn phí | ✅ | ✅ (plan free đủ dùng) |
Khi bạn dùng Cursor AI với một repo GitHub:
❌ Không có repo: "Em ơi viết PRD cho tính năng login"
→ AI viết generic, phải sửa nhiều
✅ Có repo: "Em ơi viết PRD cho tính năng login, tham khảo file
requirements/PRD-feature-X.md để đúng format của team mình"
→ AI viết đúng format, đúng style, tiết kiệm 60-70% thời gian
Mỗi commit = 1 dấu vết. Sau 6 tháng làm việc:
❌ Tệ: "update", "fix", "sửa file"
✅ Tốt: "feat: thêm AC cho màn upload document"
"fix: sửa lỗi typo trong PRD v2.1"
"docs: cập nhật MoM họp ngày 04/03"
"chore: tổ chức lại cấu trúc thư mục requirements"
Format gợi ý: [loại]: [mô tả ngắn gọn]
| Loại | Dùng khi |
| --------- | ------------------------------------ |
| feat | Thêm tài liệu/nội dung mới |
| fix | Sửa lỗi, sai sót |
| docs | Cập nhật tài liệu có sẵn |
| chore | Dọn dẹp, tổ chức file |
| wip | Work in progress, chưa hoàn thành |
Markdown học 10 phút là dùng được:
# Tiêu đề lớn (H1)
## Tiêu đề vừa (H2)
### Tiêu đề nhỏ (H3)
**In đậm**
*In nghiêng*
~~Gạch ngang~~
- Bullet point
- Bullet point
1. Danh sách có số
2. Danh sách có số
- [ ] Todo chưa làm
- [x] Todo đã xong
> Blockquote — dùng cho note/warning
`inline code` hoặc
\```
code block
\```
| Cột 1 | Cột 2 |
|-------|-------|
| A | B |
🖼️ **[Ảnh cần có: Bên trái là raw Markdown, bên phải là preview hiển thị đẹp trên GitHub — đặt cạnh nhau để so sánh]**
GitHub có tính năng Projects (Kanban board miễn phí):
🖼️ **[Ảnh cần có: GitHub Projects board dạng Kanban — 3 cột Todo/In Progress/Done, có các card task trong từng cột]**
💡 Có thể link Issue vào card → khi đóng Issue thì card tự move sang Done
Hoàn toàn miễn phí, không cần Jira cho các task nhỏ!
Trên trang profile GitHub của bạn, có thể pin tối đa 6 repo để highlight:
Nếu đã quen rồi muốn nhanh hơn:
🖼️ **[Ảnh cần có: Nhấn dấu "." trên repo GitHub → màn hình chuyển sang github.dev với giao diện VS Code trên browser]**
Tình huống: PM thay đổi requirement lần thứ 5, bạn muốn so sánh với version ban đầu.
Workflow:
Viết PRD v1 → commit "feat: PRD v1 màn login"
↓
PM yêu cầu thay → sửa → commit "fix: cập nhật AC theo feedback PM 04/03"
↓
Dev hỏi lại → vào Commits → xem diff từng thay đổi → trả lời chính xác
⏱️ Tiết kiệm: Không còn mở 5 file PRD_v1_final_FINAL_ok.docx để so sánh nữa 😂
Tình huống: Sprint 3 có 12 task BA, cần biết đang ở đâu.
Workflow:
Tạo 12 Issues → label "sprint-3" → assign cho mình
↓
Kéo vào GitHub Projects board
↓
Mỗi ngày: move card, comment progress, close issue khi done
↓
Cuối sprint: nhìn board là biết làm được gì
Tình huống: BA mới join, cần hiểu context dự án trong 1 ngày.
Workflow:
Share link repo → BA mới đọc README.md (overview)
↓
Xem thư mục requirements/ → đọc PRD các feature
↓
Xem commit history → hiểu evolution của dự án
↓
Xem Issues → biết đang làm gì, còn gì pending
⏱️ Tiết kiệm: Không cần họp onboard 3 tiếng chỉ để giải thích context nữa
| Link | Mô tả |
| ------------------------------------------------------------------------------------- | ----------------------------- |
| [github.com](https://github.com) | Đăng ký tài khoản |
| [desktop.github.com](https://desktop.github.com) | Cài GitHub Desktop |
| [docs.github.com](https://docs.github.com/en/get-started) | Docs chính thức của GitHub |
| [www.markdownguide.org](https://www.markdownguide.org/cheat-sheet/) | Markdown cheatsheet |
| [git-scm.com](https://git-scm.com/downloads) | Cài Git |
| [github.com/features/project-management](https://github.com/features/project-management) | GitHub Projects (Kanban) |
SETUP BAN ĐẦU
□ Tạo tài khoản GitHub
□ Cài GitHub Desktop
□ Cài Git (nếu dùng Cursor/terminal)
□ Tạo repo đầu tiên (với README.md)
□ Tổ chức thư mục: requirements/, meeting-notes/, tasks/, templates/
HÀNG NGÀY
□ Sửa/thêm file → Commit với message có ý nghĩa
□ Tạo Issue cho task mới
□ Cập nhật checklist trong Issue khi có progress
□ Push lên GitHub
NÂNG CAO
□ Thử tạo Branch cho tài liệu mới
□ Tạo Pull Request → nhờ PM/peer review
□ Dùng GitHub Projects (Kanban) để track sprint
□ Thử nhấn "." trên repo → khám phá github.dev
Khi đã có GitHub, bạn sẵn sàng bước vào thế giới AI-augmented BA thực sự:
👉 [Đọc bài tiếp: Dùng Cursor MCP + Figma để đọc và edit design như một pro →](./bắt-đầu-vơi-cursor-mcp-figma.md)
Bài đó sẽ hướng dẫn bạn kết nối Cursor AI với Figma — đọc màn hình design, review UX, thậm chí chỉnh sửa Figma từ... Cursor. Không cần đụng tay vào Figma nếu không muốn 🎨🤖
💬 **Feedback / câu hỏi?**
Thả vào Slack `#ai-ba-lab` hoặc tạo Issue ngay trong repo này nhé!
Happy committing! 🐙✌️
Hồi trước muốn dùng AI thì phải mở browser, copy code/text qua lại giữa ChatGPT và editor. Viết PRD thì tab này, review code thì tab kia, context bị m...
Hồi trước BA ngồi xem Figma thì chỉ biết nhìn rồi mô tả lại bằng tay. Review màn hình thì copy text từng cái, check spec thì zoom zoom zoom từng layer...