Cài đặt Bakit Solo Pro

Solo Pro là sản phẩm private. Sau khi mua, quyền tải được gắn với tài khoản GitHub bạn kết nối trên Polar. Làm lần lượt từng bước dưới đây; thường mất khoảng 10–15 phút.

Mỗi khối lệnh: copy một lệnh, dán vào cửa sổ lệnh, rồi nhấn Enter. Nếu chưa quen gõ lệnh, không sao — chỉ cần không gõ toàn bộ hướng dẫn một lúc.

Trước khi bắt đầu: mở nơi để gõ lệnh

• Windows: nhấn Start → gõ PowerShell → mở Windows PowerShell.
• macOS: mở ứng dụng Terminal.
• Linux: mở ứng dụng Terminal.

Tổng quan

1. Cài Node.js LTS
2. Mua Solo Pro và kết nối GitHub qua Polar
3. Accept lời mời vào repo Solo Pro
4. Cài GitHub CLI (gh), đăng nhập và kiểm tra quyền
5. Cài BA-kit CLI và Solo Pro

---

Bước 1: Cài Node.js LTS

Vào trang tải Node.js chính thức, chọn bản LTS, tải installer phù hợp rồi mở file vừa tải để cài. Giữ các lựa chọn mặc định.

Sau đó đóng và mở lại PowerShell hoặc Terminal, rồi chạy từng lệnh:

node --version
npm --version

Mỗi lệnh hiện một số phiên bản, ví dụ v22.x.x và 10.x.x, nghĩa là đã xong. Solo Pro cần Node.js 18 trở lên.

Bước 2: Mua Solo Pro và kết nối GitHub

1. Mua Solo Pro trên Polar.sh.
2. Mở email xác nhận từ Polar.
3. Chọn “Access Purchase”, rồi kết nối tài khoản GitHub bạn muốn dùng.
4. Đồng ý cho Polar kết nối GitHub khi trình duyệt hỏi.

Bạn cần có tài khoản GitHub trước bước này. Nếu chưa có, tạo tại github.com.

Bước 3: Accept lời mời GitHub

GitHub sẽ gửi email mời bạn vào repo bakit-org/ba-kit-solo-pro. Mở email và chọn “Accept invitation”.

Nếu không thấy email, kiểm tra Spam/Junk và đảm bảo bạn đã đăng nhập đúng tài khoản GitHub vừa kết nối với Polar.

Bước 4: Cài GitHub CLI (gh)

Chọn đúng hệ điều hành của bạn.

Windows

Trong PowerShell, chạy:

winget install GitHub.CLI

Nếu không có 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 đã có Homebrew, có thể dùng:

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à làm theo các lệnh trên trang đó.

Đóng, mở lại cửa sổ lệnh, rồi chạy:

gh --version

Thấy gh version nghĩa là cài thành công.

Bước 5: Đăng nhập GitHub và kiểm tra quyền

gh auth login

Khi được hỏi, chọn:

1. GitHub.com
2. HTTPS
3. Login with a web browser

Trình duyệt sẽ mở. Dán mã từ PowerShell/Terminal vào trình duyệt, đăng nhập đúng tài khoản GitHub đã kết nối với Polar, rồi xác nhận.

Quay lại cửa sổ lệnh và kiểm tra:

gh auth status
gh repo view bakit-org/ba-kit-solo-pro --json name,viewerPermission

Lệnh đầu cần hiện Logged in to github.com as với đúng tên tài khoản. Lệnh sau cần hiện ba-kit-solo-pro và quyền truy cập. Nếu không, kiểm tra lại Bước 2 và Bước 3.

Bước 6: Cài BA-kit CLI

npm install -g @bakit-org/cli

Bước 7: Cài Solo Pro

ba-kit install

CLI chỉ hiển thị các sản phẩm tài khoản GitHub của bạn được phép dùng. Nếu có nhiều lựa chọn, chọn Solo Pro. Không có flag --product.

Mặc định CLI cài cho Claude Code. Để cài cho nhiều runtime:

ba-kit install --runtime claude,codex,agy

Bước 8: Kiểm tra và bắt đầu dùng

ba-kit doctor
ba-kit version

Nếu 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-start và bắt đầu intake.

Cập nhật hoặc gỡ cài đặt

Để cập nhật:

ba-kit update

CLI tự phát hiện các runtime đã cài, nhóm theo sản phẩm và hỏi xác nhận trước khi cập nhật.

Để gỡ Solo Pro:

ba-kit uninstall

Dùng ba-kit uninstall --runtime <key> nếu chỉ muốn gỡ khỏi một runtime.

Nếu gặp lỗi

Xem thêm: Xử lý lỗi.