Cài đặt Bakit
Hướng dẫn cài Bakit cho BA không chuyên kỹ thuật, từ mua quyền đến bắt đầu dùng.
Cài đặt Bakit
Bakit là sản phẩm private. Bạn cần mua quyền, liên kết đúng tài khoản GitHub, rồi cài bằng vài lệnh copy-paste. Toàn bộ quá trình thường mất khoảng 10–15 phút.
Nếu chưa quen gõ lệnh, cứ làm từng lệnh một: copy một lệnh, dán vào cửa sổ lệnh, rồi nhấn Enter. Cần trợ giúp thêm, xem Xử lý lỗi.
Trước khi bắt đầu: mở nơi để gõ lệnh
- Windows: nhấn nút Start → gõ PowerShell → mở ứng dụng Windows PowerShell.
- macOS: mở ứng dụng Terminal.
- Linux: mở ứng dụng Terminal.
Giữ cửa sổ này mở trong suốt hướng dẫn. Những khối có nền đen bên dưới là lệnh để bạn copy.
Tổng quan
- Cài Node.js LTS
- Mua Bakit trên Polar
- Mở email Polar, kết nối GitHub và nhận lời mời
- Cài GitHub CLI (
gh) và đăng nhập đúng tài khoản GitHub - Cài BA-kit CLI, rồi cài Bakit
- Kiểm tra và bắt đầu dùng
Bước 1: Cài Node.js LTS
Node.js giúp máy chạy lệnh cài Bakit. Vào trang tải Node.js chính thức, chọn bản LTS, tải installer đúng hệ điều hành rồi mở file vừa tải để cài. Cứ giữ các lựa chọn mặc định của installer.
Sau khi cài xong, đóng và mở lại PowerShell hoặc Terminal. Gõ lần lượt:
node --version
npm --version
Nếu mỗi lệnh hiện một số phiên bản, ví dụ v22.x.x và 10.x.x, là xong. Bakit cần Node.js 18 trở lên.
Bước 2: Mua Bakit
Vào trang mua Bakit, điền email và thanh toán.
Bạn cần có tài khoản GitHub để nhận quyền tải Bakit. Nếu chưa có, tạo tại github.com. Xem Bảng giá để biết chi tiết sản phẩm.
Bước 3: Nhận quyền GitHub từ Polar
- Mở email xác nhận từ Polar.sh có tiêu đề “Order confirmation”.
- Chọn “Access Purchase”.
- Trong mục “Github Repo Access Bakit”, chọn kết nối tài khoản GitHub của bạn.
- Đồng ý cho Polar kết nối GitHub khi trình duyệt hỏi.
- Mở email mời từ GitHub và chọn “Accept invitation” để vào repo Bakit.
Không thấy lời mời? Kiểm tra Spam/Junk hoặc mở trang lời mời Bakit khi đã đăng nhập GitHub đúng tài khoản.
Bước 4: Cài GitHub CLI (gh)
GitHub CLI giúp máy xác nhận quyền tải repo private. Chọn đúng hệ điều hành của bạn.
Windows
Trong PowerShell, copy lệnh sau, dán và nhấn Enter:
winget install GitHub.CLI
Nếu Windows không nhận lệnh winget, tải installer từ trang GitHub CLI chính thức, mở file tải về và cài theo lựa chọn mặc định.
macOS
Tải và cài installer từ trang GitHub CLI chính thức. Nếu bạn đã dùng Homebrew, cũng có thể chạy:
brew install gh
Linux
Mở hướng dẫn cài GitHub CLI chính thức, chọn bản phân phối Linux của bạn và copy từng lệnh được hướng dẫn vào Terminal.
Sau khi cài, đóng rồi mở lại cửa sổ lệnh và kiểm tra:
gh --version
Thấy dòng bắt đầu bằng gh version nghĩa là đã cài thành công.
Bước 5: Đăng nhập GitHub và kiểm tra quyền
Trong PowerShell hoặc Terminal, chạy:
gh auth login
Khi được hỏi, chọn lần lượt:
- GitHub.com
- HTTPS
- Login with a web browser
Trình duyệt sẽ mở. Nhập hoặc dán mã mà cửa sổ lệnh hiển thị, sau đó đăng nhập đúng tài khoản GitHub đã kết nối ở Bước 3 và xác nhận.
Quay lại cửa sổ lệnh, kiểm tra danh tính và quyền Bakit:
gh auth status
gh repo view bakit-org/bakit --json name,viewerPermission
Lệnh đầu cần hiện Logged in to github.com as kèm tên tài khoản. Lệnh sau cần hiện tên repo bakit và một quyền truy cập. Nếu báo không tìm thấy repo hoặc không có quyền, quay lại Bước 3 để kiểm tra lời mời GitHub.
Bước 6: Cài BA-kit CLI
npm install -g @bakit-org/cli
Để các lệnh ba-kit trong các bước tiếp theo hoạt động, hãy dùng cách cài ở trên.
Bước 7: Cài Bakit
ba-kit install
CLI sẽ kiểm tra các sản phẩm mà tài khoản GitHub của bạn được phép dùng. Nếu thấy danh sách, chọn Bakit. Lệnh sẽ tải và cài phiên bản mới nhất, sau đó cho biết số skills, agents và templates đã cài.
Mặc định Bakit cài cho Claude Code. Nếu dùng nhiều runtime, chạy:
ba-kit install --runtime claude,codex,agy
| Runtime key | Công cụ | Cài gì |
|---|---|---|
claude (mặc định) | Claude Code | Skills, agents, hooks, templates — đầy đủ |
codex | Codex CLI | Chỉ skills |
agy | Antigravity IDE | Chỉ skills |
Bước 8: Kiểm tra và bắt đầu dùng
ba-kit doctor
ba-kit version
Nếu lệnh doctor không báo lỗi nghiêm trọng và version hiện phiên bản CLI, việc cài đặt đã hoàn tất. Mở runtime trong workspace của bạn:
- Claude Code: gõ
/ba-start. - Codex: gõ
$ba-start. - Antigravity: yêu cầu đọc skill
ba-startvà bắt đầu intake.
Nếu thấy menu hoặc câu hỏi intake hiện ra, Bakit đã sẵn sàng.
Cập nhật hoặc gỡ cài đặt
Để cập nhật phiên bản mới:
ba-kit update
CLI sẽ kiểm tra phiên bản mới, hiển thị changelog và giữ các file bạn đã tùy chỉnh. Nếu đã cài nhiều runtime, lệnh sẽ phát hiện và cập nhật tất cả.
Để gỡ Bakit khỏi máy:
ba-kit uninstall
Dùng --runtime codex,agy nếu chỉ muốn gỡ khỏi các runtime đó. Xem thêm: Cập nhật Bakit.
Nếu gặp lỗi
| Vấn đề | Cách xử lý |
|---|---|
Không thấy node hoặc npm | Cài lại Node.js LTS ở Bước 1, rồi mở cửa sổ lệnh mới |
| Chưa cài GitHub CLI | Cài gh theo Bước 4 |
| Chưa đăng nhập GitHub | Chạy gh auth login theo Bước 5 |
| Không có quyền truy cập Bakit | Kiểm tra đã mua, kết nối GitHub và accept invitation |
| Không thể tải Bakit | Kiểm tra mạng, chạy gh auth status, rồi thử lại |
ba-kit command not found | Chạy lại npm install -g @bakit-org/cli |
Xem thêm: Xử lý lỗi.
Cài cho doanh nghiệp
Nếu cần cài cho nhiều máy trong tổ chức, xem Cài đặt cho doanh nghiệp.
Tiếp theo
- Cách Bakit hoạt động — lifecycle, thư mục output
- Hướng dẫn từng bước — flow thực tế từ intake đến package
- Danh sách skills — tất cả skills BA-kit