Cài đặt Bakit Solo Basic
Hướng dẫn cài Solo Basic miễn phí cho BA không chuyên kỹ thuật.
Cài đặt Bakit Solo Basic
Solo Basic là sản phẩm miễn phí, công khai. Bạn không cần mua, không cần GitHub CLI và không cần đăng nhập GitHub để cài.
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.
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.
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 và mở file vừa tải để cài. Giữ các lựa chọn mặc định.
Sau khi cài, đóng và mở lại PowerShell hoặc Terminal. Chạy từng lệnh:
node --version
npm --version
Nếu cả hai lệnh hiện số phiên bản, ví dụ v22.x.x và 10.x.x, bạn đã sẵn sàng. Solo Basic cần Node.js 18 trở lên.
Lưu ý riêng cho Windows
Windows cần thêm Git for Windows. Tải tại git-scm.com/download/win, mở installer và giữ lựa chọn mặc định. Sau khi cài, hãy đóng rồi mở lại PowerShell.
Trên macOS/Linux, nếu CLI báo thiếu một công cụ hệ thống, hãy làm theo lệnh mà CLI hiển thị hoặc xem Xử lý lỗi.
Bước 2: Cài BA-kit CLI
Trong PowerShell hoặc Terminal, chạy:
npm install -g @bakit-org/cli
Bước 3: Cài Solo Basic
ba-kit install
Không cần đăng nhập GitHub: CLI sẽ tự chọn BA-kit Solo Basic. Mặc định lệnh này cài cho Claude Code.
Để chọn nhiều runtime:
ba-kit install --runtime claude,codex,agy
| Runtime key | Công cụ | Phạm vi cài |
|---|---|---|
claude | Claude Code | 5 skills, core và templates |
codex | Codex CLI | 5 skills |
agy | Antigravity IDE | 5 skills |
Bước 4: 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 đã xong. Mở runtime trong workspace dự án:
- Claude Code:
/ba-start - Codex:
$ba-start - Antigravity: yêu cầu đọc skill
ba-startvà bắt đầu intake
Cập nhật và gỡ cài đặt
ba-kit update
ba-kit uninstall
update và uninstall tự phát hiện các runtime đã cài. Dùng --runtime codex,agy khi chỉ muốn gỡ runtime cụ thể.
Nâng cấp lên Solo Pro hoặc Bakit
CLI không ghi đè sản phẩm khác trên cùng runtime. Sau khi bạn có quyền truy cập Solo Pro hoặc Bakit, trước hết gỡ Solo Basic khỏi runtime đang dùng:
ba-kit uninstall --runtime claude
Sau đó làm theo hướng dẫn cài Solo Pro hoặc Bakit. Hai sản phẩm này sẽ hướng dẫn riêng bước kết nối và đăng nhập GitHub. Solo Basic không cần bước đó.
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ở PowerShell/Terminal mới |
| Windows báo thiếu Git | Cài Git for Windows theo phần lưu ý ở Bước 1 |
ba-kit command not found | Chạy lại npm install -g @bakit-org/cli |
| Runtime đã có sản phẩm khác | Gỡ sản phẩm cũ trên runtime đó rồi cài lại |
Xem thêm: Xử lý lỗi.