07 — Hướng Dẫn Cài Đặt Công Cụ

Author

Duy NHM

⏱️ Thời lượng: 60 phút (đọc + thực hành)
🎯 Mục tiêu: Cài đặt xong tất cả công cụ cần thiết, clone repo BMAD-METHOD, chạy được bmad-help, join Discord, và link GitHub Classroom. Đến buổi 1 bạn chỉ cần mở máy và bắt đầu.

0. Tổng Quan Công Cụ

Công cụ	Mục đích	Miễn phí?
Node.js	Chạy code JavaScript trên máy	✅
Git	Quản lý version code	✅
GitHub	Lưu code online + GitHub Classroom	✅
Antigravity	Code editor + AI Agent tích hợp	✅ (free tier)
AI Agent Code Extensions/Terminal (tuỳ chọn)	Các AI Agent chạy editor hoặc terminal như Claude Code, Codex (OpenAI), OpenCode	✅ (free tier)
Supabase	Database + Auth + API miễn phí	✅ (free tier)

graph LR
    A["📝 Antigravity<br/>(code editor)"] --> B["🤖 AI Agent<br/>(AI Code)"]
    B --> C["💾 Git<br/>(lưu version)"]
    C --> D["☁️ GitHub<br/>(lưu online)"]
    D --> E["🚀 Vercel<br/>(deploy app)"]
    
    F["🗄️ Supabase<br/>(database)"] --> A

1. Cài Node.js

Node.js cho phép chạy JavaScript trên máy tính (không chỉ trong trình duyệt).

macOS

# Cách 1: Dùng Homebrew (khuyến nghị)
brew install node

# Cách 2: Download trực tiếp
# Vào https://nodejs.org → Download LTS → Cài bình thường

Windows

Vào https://nodejs.org
Bấm nút Download LTS (Long Term Support — phiên bản ổn định)
Chạy file .msi → Next → Next → Install
Quan trọng: Tick ✅ “Add to PATH” khi được hỏi

Kiểm tra đã cài thành công

Mở Terminal (macOS) hoặc Command Prompt/PowerShell (Windows):

node --version
# Kết quả mong đợi: v20.x.x hoặc v22.x.x

npm --version
# Kết quả mong đợi: 10.x.x

✅ Thấy số version → thành công! ❌ Thấy “command not found” → xem phần Troubleshooting.

2. Cài Git

macOS

# Git thường đã có sẵn. Kiểm tra:
git --version

# Nếu chưa có, cài qua Homebrew:
brew install git

Windows

Vào https://git-scm.com/downloads
Download bản Windows → Cài
Quan trọng: Chọn “Git from the command line and also from 3rd-party software” khi được hỏi

Cấu hình Git (bắt buộc — làm 1 lần)

git config --global user.name "Tên bạn"
git config --global user.email "email@example.com"

⚠️ Email phải trùng với email GitHub bạn sẽ tạo ở bước 3!

3. Tạo Tài Khoản GitHub

Vào https://github.com → Sign up
Nhập username, email, password
Xác nhận email
Hoàn thành!

Trang Profile của bạn

┌─────────────────────────────────────────────┐
│  👤 your-username                            │
│  ─────────────────────────────────────────── │
│  📊 0 repositories  │  0 followers           │
│  ─────────────────────────────────────────── │
│  📁 Repositories:                            │
│     (trống — bạn sẽ có repo sau buổi 1)     │
└─────────────────────────────────────────────┘

Thiết lập SSH key (khuyến nghị)

SSH key giúp bạn push code không cần nhập mật khẩu mỗi lần thực hiện:

# 1. Tạo SSH key
ssh-keygen -t ed25519 -C "email@example.com"
# Bấm Enter 3 lần (chấp nhận mặc định)

# 2. Copy key
# macOS:
cat ~/.ssh/id_ed25519.pub | pbcopy

# Windows (PowerShell):
Get-Content ~/.ssh/id_ed25519.pub | Set-Clipboard

Vào GitHub → Settings → SSH and GPG keys → New SSH key
Paste key → Save

Kiểm tra

ssh -T git@github.com
# Kết quả mong đợi: "Hi your-username! You've successfully authenticated..."

4. Cài Antigravity

Antigravity là code editor (giống VS Code) với AI Agent tích hợp sẵn — đây là công cụ chính của khoá học.

Vào https://antigravity.google
Download → Cài đặt
Mở Antigravity → đăng nhập (có thể dùng GitHub account)

Giao diện Antigravity

┌─────────────────────────────────────────────────────┐
│  📁 Explorer     │  📝 Code Editor                   │
│  (cây thư mục)   │  (viết code ở đây)                │
│                   │                                   │
│  my-project/      │  <h1>Hello World</h1>             │
│  ├── index.html   │  <p>Ứng dụng đầu tiên</p>        │
│  ├── style.css    │                                   │
│  └── app.js       │                                   │
│                   ├───────────────────────────────────│
│                   │  💬 AI Chat (Cmd/Ctrl + L)        │
│                   │  "Thêm dark mode toggle..."       │
│                   │  🤖 "Tôi sẽ thêm nút toggle..."  │
└─────────────────────────────────────────────────────┘

Phím tắt quan trọng:

Phím tắt	Chức năng
`Cmd/Ctrl + L`	Mở AI chat panel
`Cmd/Ctrl + K`	AI edit inline (chọn code → hỏi AI sửa)
`Cmd/Ctrl + J`	Mở terminal
`Cmd/Ctrl + Shift + P`	Command palette

5. Claude Code (tuỳ chọn)

Claude Code là AI Agent chạy trong terminal — mạnh mẽ hơn Antigravity chat vì có thể tự chạy lệnh, tạo file, debug.

Cài đặt

# Cài Claude Code CLI
npm install -g @anthropic-ai/claude-code

# Kiểm tra
claude --version

Sử dụng cơ bản

# Mở thư mục dự án
cd my-project

# Gọi Claude Code
claude

# Trong chat Claude Code:
> "Tạo file index.html với form đăng ký có tên và email"
# → Claude Code tự tạo file, viết code

💡 Antigravity hay Claude Code? Khoá học hướng dẫn cả hai. Antigravity dễ hơn cho người mới (có giao diện đồ hoạ). Claude Code mạnh hơn cho ai đã quen terminal.

6. Clone BMAD-METHOD

BMAD-METHOD là repo chứa tất cả skill, workflow, template mà khoá học sử dụng.

# Clone repo
git clone https://github.com/bmad-code-org/BMAD-METHOD.git

# Vào thư mục
cd BMAD-METHOD

# Xem cấu trúc
ls -la

Cấu trúc thư mục BMAD

BMAD-METHOD/
├── README.md                    ← Giới thiệu
├── _bmad/                       ← Config + template
│   └── bmm/
│       └── config.yaml          ← Cấu hình dự án
├── .agents/                     
│   └── skills/                  ← 🎯 TẤT CẢ SKILL Ở ĐÂY
│       ├── bmad-help/
│       │   └── SKILL.md
│       ├── bmad-brainstorming/
│       │   └── SKILL.md
│       ├── bmad-create-prd/
│       │   ├── SKILL.md
│       │   └── steps/
│       │       ├── step-01-*.md
│       │       └── step-02-*.md
│       └── ... (60+ skill khác)

💡 Bạn không cần đọc hết 60+ skill. Khoá học chỉ dùng 16 skill — mentor sẽ hướng dẫn cụ thể từng buổi.

7. Chạy `bmad-help` Lần Đầu

Đây là cách kiểm tra BMAD hoạt động trên máy bạn:

Trong Antigravity

Mở thư mục BMAD-METHOD hoặc dự án đã setup
Cmd/Ctrl + L mở AI chat
Gõ: “chạy bmad-help”
AI sẽ tìm skill, chào bạn, và hỏi bạn cần gì

Trong Claude Code

cd my-project
claude
> "bmad-help"

Kết quả mong đợi

🤖 Chào dz! Tôi là BMAD Helper. Bạn đang ở giai đoạn nào
   của dự án? Tôi có thể giúp bạn:
   - Bắt đầu dự án mới → khuyến nghị: bmad-product-brief
   - Đang có PRD → khuyến nghị: bmad-create-epics-and-stories
   - Đang code → khuyến nghị: bmad-dev-story
   ...

✅ Thấy BMAD chào bạn → Cài đặt thành công! 🎉 ❌ Không thấy → xem phần Troubleshooting.

8. Join Discord Server

Discord là nơi hỏi đáp giữa các buổi học.

Download Discord: https://discord.com → tạo tài khoản nếu chưa có
Join server khoá học: Mentor sẽ gửi link invite qua email đăng ký
Chọn role: Vào channel #chọn-role → react emoji theo nhóm:
- 🅰️ Dev Junior–Mid
- 🅱️ Founder / Indie Hacker
- 🅲️ PM / Designer / Nhân viên nghiệp vụ

Các kênh quan trọng

Kênh	Mục đích
`#thông-báo`	Mentor post thông báo chính thức
`#project-pick`	Đăng ký chọn đồ án (buổi 1)
`#warmup-help`	Hỏi về bài tập warm-up
`#project-help`	Hỏi về đồ án chính
`#bmad-troubleshoot`	Khi AI / BMAD gặp lỗi
`#wins`	Khoe thành quả! 🎉

⚠️ Cam kết mentor: Trả lời trong < 4 giờ (giờ hành chính). Quá 12h không ai trả lời → tag @mentor trực tiếp.

9. Link GitHub Classroom

Mentor sẽ gửi link GitHub Classroom assignment qua Discord hoặc email.

Các bước

Click link GitHub Classroom từ mentor
Accept assignment → GitHub tự tạo repo cá nhân cho bạn
Clone repo về máy:

git clone https://github.com/bmad-vibe-coding-2026/your-username-project.git
cd your-username-project

Mở bằng Antigravity:

antigravity .
# hoặc: Antigravity → File → Open Folder → chọn thư mục

Kiểm tra mentor có quyền xem:
- Vào repo trên GitHub → Settings → Collaborators
- Phải thấy tên mentor hoặc organization

⚠️ Làm bước này NGAY khi nhận link, không đợi đến buổi 1! Nếu có lỗi quyền truy cập, báo ngay trên #bmad-troubleshoot.

10. Troubleshooting — 5 Lỗi Phổ Biến Nhất

❌ Lỗi 1: `node: command not found`

Nguyên nhân: Node.js chưa được thêm vào PATH.

Fix: - macOS: Đóng Terminal, mở lại. Nếu vẫn lỗi → brew install node lại. - Windows: Mở lại installer → chọn “Repair” → đảm bảo tick “Add to PATH”.

❌ Lỗi 2: `git: command not found`

Nguyên nhân: Git chưa cài hoặc chưa vào PATH.

Fix: - macOS: Gõ xcode-select --install → cài Xcode Command Line Tools. - Windows: Tải lại từ https://git-scm.com và cài.

❌ Lỗi 3: `Permission denied (publickey)` khi push

Nguyên nhân: SSH key chưa setup đúng.

Fix: 1. Kiểm tra có key chưa: ls ~/.ssh/id_ed25519.pub 2. Nếu không có → chạy lại bước tạo SSH key ở phần 3 3. Đảm bảo đã thêm key vào GitHub Settings

Hoặc dùng HTTPS thay SSH:

git remote set-url origin https://github.com/username/repo.git

❌ Lỗi 4: Antigravity không tìm thấy BMAD skill

Nguyên nhân: Mở nhầm thư mục (skill nằm ở thư mục khác).

Fix: 1. Đảm bảo mở đúng thư mục dự án có chứa .agents/skills/ hoặc .claude/skills/ 2. Kiểm tra: ls .agents/skills/ có thấy folder bmad-help không

❌ Lỗi 5: `npm install` bị lỗi permission trên macOS

Fix:

# Không dùng sudo! Thay vào đó fix quyền npm:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

0. Tổng Quan Công Cụ

1. Cài Node.js

macOS

Windows

Kiểm tra đã cài thành công

2. Cài Git

macOS

Windows

Cấu hình Git (bắt buộc — làm 1 lần)

3. Tạo Tài Khoản GitHub

Trang Profile của bạn

Thiết lập SSH key (khuyến nghị)

Kiểm tra

4. Cài Antigravity

Giao diện Antigravity

5. Claude Code (tuỳ chọn)

Cài đặt

Sử dụng cơ bản

6. Clone BMAD-METHOD

Cấu trúc thư mục BMAD

7. Chạy bmad-help Lần Đầu

Trong Antigravity

Trong Claude Code

Kết quả mong đợi

8. Join Discord Server

Các kênh quan trọng

9. Link GitHub Classroom

Các bước

10. Troubleshooting — 5 Lỗi Phổ Biến Nhất

❌ Lỗi 1: node: command not found

❌ Lỗi 2: git: command not found

❌ Lỗi 3: Permission denied (publickey) khi push

❌ Lỗi 4: Antigravity không tìm thấy BMAD skill

❌ Lỗi 5: npm install bị lỗi permission trên macOS

✅ Checklist Trước Buổi 1

7. Chạy `bmad-help` Lần Đầu

❌ Lỗi 1: `node: command not found`

❌ Lỗi 2: `git: command not found`

❌ Lỗi 3: `Permission denied (publickey)` khi push

❌ Lỗi 5: `npm install` bị lỗi permission trên macOS