Bakit
Bakit

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

  1. Cài Node.js LTS
  2. Mua Bakit trên Polar
  3. Mở email Polar, kết nối GitHub và nhận lời mời
  4. Cài GitHub CLI (gh) và đăng nhập đúng tài khoản GitHub
  5. Cài BA-kit CLI, rồi cài Bakit
  6. 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.x10.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

  1. Mở email xác nhận từ Polar.sh có tiêu đề “Order confirmation”.
  2. Chọn “Access Purchase”.
  3. Trong mục “Github Repo Access Bakit”, chọn kết nối tài khoản GitHub của bạn.
  4. Đồng ý cho Polar kết nối GitHub khi trình duyệt hỏi.
  5. 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:

  1. GitHub.com
  2. HTTPS
  3. 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 keyCông cụCài gì
claude (mặc định)Claude CodeSkills, agents, hooks, templates — đầy đủ
codexCodex CLIChỉ skills
agyAntigravity IDEChỉ 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:/ba-start.
  • Codex:$ba-start.
  • Antigravity: yêu cầu đọc skill ba-start và 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 npmCài lại Node.js LTS ở Bước 1, rồi mở cửa sổ lệnh mới
Chưa cài GitHub CLICài gh theo Bước 4
Chưa đăng nhập GitHubChạy gh auth login theo Bước 5
Không có quyền truy cập BakitKiểm tra đã mua, kết nối GitHub và accept invitation
Không thể tải BakitKiểm tra mạng, chạy gh auth status, rồi thử lại
ba-kit command not foundChạ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

On this page