gstack là bộ 23 công cụ AI do Garry Tan — CEO của Y Combinator, quỹ đầu tư khởi nghiệp nổi tiếng nhất thế giới — tạo ra và dùng hàng ngày. Cài vào Claude Code, bạn sẽ có ngay các lệnh như /review, /qa, /office-hours, /browse, /ship… để Claude làm việc có cấu trúc thay vì phải gõ prompt dài lặp đi lặp lại.
Tài liệu này giải thích từ đầu: Claude Code là gì, Terminal là gì, Git là gì, Bun là gì — sau đó hướng dẫn cài từng bước một. Bạn chỉ cần copy và paste lệnh theo hướng dẫn.
Phần 1 — Hiểu 4 khái niệm trước khi cài
Bốn từ này sẽ xuất hiện xuyên suốt tài liệu. Đọc qua một lần để không bị bỡ ngỡ ở các bước sau.
| Thuật ngữ | Hiểu nôm na là... |
|---|---|
| Claude Code | Ứng dụng Claude dùng bằng dòng lệnh — khác với Claude.ai (website). Claude Code chạy trong Terminal, hiểu cả codebase, đọc file, chạy lệnh thay bạn. Phải cài riêng qua npm. |
| gstack | Bộ 23 "kịch bản làm việc" đóng gói sẵn cho Claude Code — giống như cài thêm 23 chuyên gia vào: người lo review code, người lo QA, người lo release, người lo docs… Bạn chỉ cần gọi đúng tên là họ vào làm. |
| slash command | Lệnh tắt bắt đầu bằng dấu / — thay vì gõ "hãy review toàn bộ code của tôi và tìm lỗi sản xuất", bạn chỉ cần gõ /review là gstack tự biết làm gì. |
| Terminal | Cửa sổ đen nơi bạn gõ lệnh trực tiếp với máy tính — trên Mac gọi là Terminal, trên Windows gọi là PowerShell hoặc Command Prompt. Đây là nơi bạn sẽ chạy mọi lệnh trong tài liệu này. |
| Git | Công cụ tải và quản lý code từ GitHub về máy — giống như trình tải file nhưng thông minh hơn, biết theo dõi thay đổi và đồng bộ. Cần có để tải gstack về. |
| Bun | Môi trường chạy JavaScript — giống Node.js nhưng nhanh hơn. gstack dùng Bun để chạy các tác vụ cài đặt của nó. |
Claude.ai là website chat như bình thường. Claude Code là công cụ dòng lệnh — nó có thể đọc toàn bộ dự án code, chạy lệnh, sửa file, commit Git… mạnh hơn nhiều nhưng cần cài thêm. gstack chỉ chạy trên Claude Code, không dùng được trên Claude.ai.
Phần 2 — Mở Terminal (cửa sổ gõ lệnh)
Tất cả lệnh trong tài liệu này đều chạy trong Terminal. Nếu bạn chưa biết mở, làm theo hướng dẫn phù hợp với máy của mình.
Mở Terminal trên Mac
Có 2 cách:
- Cách 1 (nhanh nhất): Nhấn ⌘ Command + Space để mở Spotlight, gõ Terminal, nhấn Enter.
- Cách 2: Vào Finder → Applications → Utilities → Terminal, double-click để mở.
Sau khi mở, bạn sẽ thấy một cửa sổ với nền tối/sáng và dấu nhắc lệnh kiểu tên-bạn@máy ~ %. Đây là nơi bạn sẽ gõ lệnh.
Mở PowerShell trên Windows
Dùng PowerShell (không phải Command Prompt thông thường):
- Cách 1 (nhanh nhất): Nhấn Windows + S, gõ PowerShell, click chuột phải vào "Windows PowerShell" → chọn "Run as administrator".
- Cách 2: Nhấn Windows + X → chọn "Windows PowerShell (Admin)".
Bạn sẽ thấy cửa sổ màu xanh/đen với dấu nhắc kiểu PS C:\Users\tên-bạn>.
Phải dùng PowerShell, không phải "Command Prompt" (cmd.exe). Hai cái trông giống nhau nhưng lệnh khác nhau. Nếu thấy cửa sổ đen với chữ C:\> là bạn đang dùng cmd, hãy đóng lại và mở PowerShell.
Trong các lệnh bên dưới, dấu ~ (dấu ngã) là ký hiệu tắt cho thư mục Home của bạn. Trên Mac là /Users/tên-bạn/, trên Windows là C:\Users\tên-bạn\. Bạn không cần gõ đường dẫn đầy đủ, cứ dùng ~ là máy tự hiểu.
Phần 3 — Cài các công cụ cần thiết
Trước khi cài gstack, bạn cần có 3 thứ: Claude Code, Git, và Bun. Kiểm tra lần lượt — cái nào đã có thì bỏ qua, cái nào chưa có thì cài theo hướng dẫn.
Claude Code — kiểm tra và cài nếu chưa có
Claude Code là ứng dụng dòng lệnh của Anthropic. Cách kiểm tra: Mở Terminal → copy lệnh bên dưới → dán vào → nhấn Enter. Nếu thấy số phiên bản là đã có, nếu thấy lỗi "not found" là chưa có.
Nếu thấy số phiên bản
- Ví dụ: 1.x.x — Claude Code đã có sẵn. Bỏ qua bước cài, chuyển sang kiểm tra Git.
Nếu thấy lỗi "not found"
- Claude Code chưa được cài. Xem hướng dẫn cài bên dưới.
- Cài Node.js LTS từ nodejs.org (chọn phiên bản LTS, bấm tải về và cài như app bình thường). Node.js là môi trường cần có để cài Claude Code.
- Sau khi cài xong Node.js, đóng Terminal và mở lại (để máy nhận diện Node.js mới cài).
- Chạy lệnh sau để cài Claude Code:
Lệnh npm install -g = cài toàn cục lên máy (global), không phải chỉ cho một dự án. Bạn sẽ gõ claude để dùng từ bất kỳ đâu.
Git — kiểm tra và cài nếu chưa có
Git là công cụ tải code từ GitHub về máy. Trên Mac thường đã có sẵn; Windows cần cài thêm.
Cách kiểm tra: Mở Terminal (xem Phần 2 nếu chưa biết mở) → copy lệnh bên dưới → dán vào Terminal → nhấn Enter. Máy sẽ tự trả lời.
Thấy "git version 2.x.x"
- Git đã có. Bỏ qua, chuyển sang cài Bun.
Thấy lỗi hoặc không thấy gì
- Git chưa cài. Làm theo hướng dẫn bên dưới.
- macOS: Vào git-scm.com/download/mac và cài theo hướng dẫn. Hoặc nếu Mac hỏi "cài Xcode Command Line Tools?" khi bạn gõ git, cứ bấm Install là xong.
- Windows: Vào git-scm.com/download/win, tải và cài như app bình thường. Trong quá trình cài, cứ giữ mặc định và bấm Next.
- Sau khi cài xong, đóng và mở lại Terminal, rồi chạy lại git --version để xác nhận.
Bun — môi trường chạy JavaScript
Bun là công cụ gstack dùng để cài đặt.
Cách kiểm tra: Mở Terminal → copy lệnh bên dưới → dán vào → nhấn Enter. Nếu thấy số phiên bản (ví dụ 1.2.3) là đã có. Nếu thấy "not found" hoặc lỗi là chưa có, cài theo hướng dẫn phía dưới.
- Vào bun.sh — trang web sẽ tự hiển thị lệnh cài phù hợp với máy bạn.
- Copy lệnh đó, dán vào Terminal, nhấn Enter và đợi cài xong (thường chỉ vài giây).
- Đóng và mở lại Terminal (bắt buộc, vì Bun cần reload để Terminal nhận diện).
- Gõ bun --version lần nữa — nếu thấy số phiên bản là thành công.
Nếu claude --version, git --version, bun --version đều trả về số phiên bản → bạn đã sẵn sàng cài gstack ở bước tiếp theo.
Phần 4 — Cài gstack
Đây là bước chính. Lệnh dưới đây sẽ tải gstack từ GitHub về máy và chạy setup tự động. Chọn hệ điều hành của bạn:
Copy toàn bộ lệnh sau rồi dán vào Terminal
Đây là một lệnh duy nhất (dù trông dài). Hãy copy tất cả, dán vào Terminal rồi nhấn Enter. Lệnh sẽ tự làm hết:
git clone ... ~/.claude/skills/gstack — tải gstack từ GitHub về thư mục ~/.claude/skills/gstack (thư mục ẩn nơi Claude Code lưu các skill).
&& — nghĩa là "và sau đó" — chỉ chạy lệnh tiếp theo nếu lệnh trước thành công.
cd ~/.claude/skills/gstack — di chuyển vào thư mục vừa tải về.
./setup — chạy script cài đặt của gstack (nó sẽ cài các phụ thuộc và kết nối với Claude Code).
Copy toàn bộ lệnh sau rồi dán vào PowerShell
Copy tất cả các dòng bên dưới (bấm nút Copy), dán vào PowerShell bằng cách click chuột phải (không dùng Ctrl+V), rồi nhấn Enter:
Nếu trong quá trình chạy setup bạn thấy lỗi về "phụ thuộc" hoặc "dependency", hãy cài thêm Node.js LTS từ nodejs.org, rồi chạy lại lệnh trên.
Trong PowerShell, không dùng Ctrl+V. Thay vào đó hãy click chuột phải vào cửa sổ — lệnh sẽ tự dán vào. Sau đó nhấn Enter.
Chờ setup chạy xong
Bạn sẽ thấy nhiều dòng text chạy qua — đó là lệnh đang tải và cài các thành phần. Không cần làm gì, chỉ cần chờ cho đến khi thấy dấu nhắc lệnh xuất hiện trở lại (dòng % hoặc > ở cuối).
Thường mất 30 giây đến 2 phút tùy tốc độ mạng.
Khởi động Claude Code trong Terminal
Claude Code không phải là app riêng — nó chạy ngay trong Terminal bằng lệnh claude. Làm theo 2 bước:
Bước 3a — Di chuyển vào thư mục dự án của bạn: gõ lệnh cd rồi kéo-thả thư mục dự án vào Terminal (hoặc gõ đường dẫn thủ công). Ví dụ:
Gõ lệnh claude để khởi động
Bước 3b: Sau khi đã vào đúng thư mục, gõ lệnh dưới rồi nhấn Enter. Claude Code sẽ khởi động ngay trong Terminal — bạn sẽ thấy giao diện tương tác xuất hiện, và đây là nơi bạn gõ các slash command:
Sau khi gõ claude và nhấn Enter, Terminal sẽ hiện ra giao diện chat của Claude Code — có thể hỏi bạn đăng nhập tài khoản Anthropic lần đầu. Sau đó bạn thấy ô nhập liệu, gõ /office-hours vào đó là xong. Đây không phải app riêng — tất cả đều trong Terminal.
gstack đã được cài vào ~/.claude/skills/gstack. Claude Code bây giờ đã có thêm 23 slash command mới. Sang phần tiếp theo để thử ngay.
Phần 5 — Thử 3 lệnh đầu tiên ngay sau khi cài
Bạn đã khởi động Claude Code trong Terminal (Bước 3b ở trên) và đang thấy giao diện chat của nó. Bây giờ gõ thử 3 lệnh sau — chúng gọi là "slash command" vì bắt đầu bằng dấu /. Gõ thẳng vào ô nhập liệu rồi nhấn Enter.
/office-hours — Mô tả bạn đang build gì
Đây là lệnh nên dùng đầu tiên khi mở Claude Code. Gõ lệnh này, Claude sẽ hỏi bạn đang làm gì, context là gì — để nó hiểu dự án trước khi làm việc. Giống như brief cho nhân viên trước khi giao việc.
Kết quả mong đợi: Claude sẽ hỏi bạn đang làm dự án gì, stack công nghệ là gì, mục tiêu hôm nay là gì. Trả lời tự nhiên như nói chuyện với đồng nghiệp.
/review — Soi lỗi sản xuất trong code
Lệnh này cho Claude đọc toàn bộ thay đổi hiện tại và tìm lỗi kiểu sẽ xảy ra khi chạy thực tế: edge case (trường hợp ngoại lệ), dữ liệu xấu, race condition (tranh chấp đồng thời), lỗ hổng bảo mật… Không phải soi lỗi chính tả hay format code.
/qa — Kiểm tra UI thực tế trên staging
Nếu bạn có một URL staging (link xem thử trước khi deploy), lệnh /qa cho Claude mở URL đó, click thực, đọc console thực, chụp screenshot thực — rồi báo lỗi. Không phải đoán mò.
Thay https://your-staging-url.com bằng URL thực của bạn:
Ngoài 3 lệnh trên, gstack còn có /browse (duyệt web), /ship (đóng gói release), /document-release (cập nhật docs tự động) và nhiều lệnh khác. Gõ / trong Claude Code để xem danh sách đầy đủ.
Phần 6 — Cập nhật và dùng cho cả team
Cập nhật gstack lên phiên bản mới
Khi gstack có bản mới, chỉ cần chạy lệnh này trong Terminal:
Chia sẻ gstack với cả team
Nếu bạn làm việc nhóm và muốn cả team dùng chung bộ lệnh này, gstack hỗ trợ cài vào repo dùng chung. Người mới clone repo về chạy setup một lần là có đủ lệnh — không cần giải thích thêm.
Chạy xong lệnh trên, bạn cần lưu thư mục .claude/skills/gstack vào kho code chung (Git repo) của team — giống như lưu file lên Google Drive chung vậy. Dùng 3 lệnh này theo thứ tự:
git add — chọn thư mục gstack để chuẩn bị lưu.
git commit -m "..." — lưu lại với một ghi chú (như đặt tên file trước khi save).
git push — đẩy lên kho code chung trên mạng (GitHub/GitLab) để đồng đội tải về. Sau đó đồng đội chỉ cần tải repo về là có gstack luôn, không cần cài lại.
Phần 7 — Lỗi thường gặp và cách xử lý
Bấm vào lỗi bạn đang gặp để xem cách xử lý.
Lỗi "bun: command not found" hoặc "bun không nhận"
Bun đã được cài nhưng Terminal chưa nhận ra đường dẫn. Làm theo thứ tự:
Bước 1: Đóng Terminal hoàn toàn (không chỉ cửa sổ) và mở lại. Đây là lý do phổ biến nhất.
Bước 2: Nếu vẫn lỗi, kiểm tra Bun có thực sự được cài chưa bằng cách mở lại trang bun.sh và chạy lại lệnh cài.
macOS: Nếu dùng Zsh (mặc định từ macOS Catalina trở lên), thêm dòng này vào cuối file ~/.zshrc:
Sau đó chạy source ~/.zshrc hoặc đóng và mở Terminal mới.
Lỗi "permission denied: ./setup"
File setup chưa có quyền chạy. Cấp thêm quyền rồi chạy lại:
Lệnh chmod +x = "cấp thêm quyền thực thi" cho file setup. Sau đó chạy lại là xong.
Claude Code không thấy /review, /qa, /office-hours
Thường có 2 nguyên nhân:
1. Chưa restart Claude Code. Đóng hoàn toàn Claude Code (không phải chỉ đóng cửa sổ chat) rồi mở lại. gstack chỉ được nhận diện khi Claude Code khởi động lại.
2. Clone sai vị trí. Kiểm tra gstack đã ở đúng chỗ chưa:
Nếu thấy danh sách file (SKILL.md, setup, …) là đúng chỗ. Nếu thấy lỗi "No such file or directory" là sai — chạy lại lệnh cài từ đầu.
3. Nếu vẫn không thấy: Chạy lại setup:
Windows: lỗi liên quan đến Node.js hoặc thiếu dependency
Windows thường cần Node.js ngoài Bun. Cài theo thứ tự:
Bước 1: Tải và cài Node.js LTS từ nodejs.org. Chọn phiên bản LTS (số chẵn, ổn định hơn). Cài như app bình thường.
Bước 2: Đóng và mở lại PowerShell.
Bước 3: Chạy lại lệnh cài gstack từ đầu.
Lỗi "git: command not found"
Git chưa được cài. Xem hướng dẫn cài Git ở Phần 3 bên trên.
macOS nhanh hơn: Chạy lệnh git --version, nếu Mac hiện hộp thoại "Install Developer Tools" → bấm Install là xong, không cần vào web.
Cài xong rồi nhưng /qa không mở được trình duyệt
Lệnh /qa cần thêm bộ cài đặt riêng cho trình duyệt. Chạy lệnh sau:
Sau đó restart Claude Code và thử lại.
Cài xong — bắt đầu ngay thôi!
Đừng nghĩ quá nhiều. Mở Claude Code, gõ /office-hours, mô tả bạn đang làm gì, rồi để gstack lo phần còn lại.
Xem repo gstack trên GitHub Theo dõi Cường Mê AI