Cách cài đặt AgentKit (ak CLI) từ đầu cho Claude Code (2026)
Cài đặt AgentKit (ak CLI) cho Claude Code chỉ mất dưới 5 phút với 5 bước: (1) cài sẵn Claude Code, (2) cài binary ak bằng một dòng lệnh, (3) đăng nhập ak login để cấp quyền, (4) chạy ak kit init engineer --target claude-code --global để nạp kit, (5) gõ /ak: trong Claude Code. Lưu ý quan trọng: license key kích hoạt Desktop App, không kích hoạt CLI - CLI được cấp quyền qua đăng nhập tài khoản.
Toàn bộ lệnh trong bài lấy từ tài liệu chính thức agentkit.best/docs và docs.agentkit.best (kiểm 08/2026). CLI ak hiện ở kênh beta nên lệnh/flag có thể đổi - bạn nên đối chiếu lại lệnh mới nhất trên docs trước khi chạy.
AgentKit nào? ak CLI cho Claude Code, không phải OpenAI AgentKit
Trước khi copy bất kỳ lệnh nào, dừng lại 30 giây để chắc bạn đang cài đúng thứ. Từ khóa "agentkit" đang bị nhiều sản phẩm khác nhau chia nhau: OpenAI AgentKit (ra mắt 10/2025), BCG-X agentkit (starter-kit Next.js/FastAPI/LangChain), Google agents-cli, cùng vài trang trùng tên khác. Cài nhầm một trong số đó thì lệnh sẽ không bao giờ chạy được cho Claude Code.
Bài này nói về: bộ kit cho Claude Code tại agentkit.best, dùng CLI tên
ak. Đây là bản kế nhiệm của Claude Kit cũ (ck→ak). Nó biến Claude Code (và Codex, Copilot) thành một "đội dev + marketing AI" thông qua skills và agents. Nếu bạn đang tìm sản phẩm của OpenAI hay BCG, đây không phải nơi.
Chi tiết vụ đổi tên và vì sao ak thay thế ck, đọc thêm Claude Kit đổi tên thành AgentKit (ck→ak).
Chuẩn bị trước khi cài (prerequisites)
AgentKit chạy bên trên Claude Code, không thay thế nó. Bạn cần hai thứ trước khi bắt đầu:
- ① Claude Code đã cài và chạy được. Kiểm bằng
claude --version. Nếu báo lỗi không tìm thấy lệnh, cài Claude Code trước theo hướng dẫn cài đặt Claude Code (prerequisite). Claude Code cần Node 18+; bạn cũng cần một gói Claude (Pro, Max, hoặc API) để dùng model. - ② Tài khoản AgentKit. Bạn đăng nhập CLI bằng email hoặc API key. Để tải được kit (Engineer/Marketing) bạn cần entitlement gắn với tài khoản đó - tức là đã sở hữu kit.
Điểm hay dễ hiểu lầm: bản thân binary ak là native binary, không cần Node.js/Bun để chạy. Nhưng khi kit đích là Claude Code thì môi trường Claude Code vẫn cần Node 18+. Hai chuyện này tách biệt nhau.
Chưa có kit? Bạn vẫn cài được CLI và đăng nhập, nhưng lệnh
ak kit initsẽ báo thiếu entitlement. Nếu muốn dùng thật, hãy xem gói & lấy license AgentKit (giảm 20% qua link) - Engineer và Marketing kit đều là mua một lần, còn Bundle gộp cả hai.
Bước 1 - Cài ak CLI (macOS / Linux / Windows)
Installer tự nhận OS/kiến trúc, tải bản stable, verify SHA-256 rồi cài vào ~/.local/bin. Chọn đúng lệnh cho hệ điều hành của bạn:
macOS / Linux:
curl -fsSL https://agentkit.best/install.sh | shWindows (PowerShell):
irm https://agentkit.best/install.ps1 | iexNếu domain chính bị mạng công ty chặn, dùng domain phụ releases.agentkit.best/install.sh (hoặc .ps1). Vài biến môi trường tùy chọn hữu ích:
AK_INSTALL_DIR- đổi thư mục cài nếu bạn không muốn dùng mặc định.AK_CHANNEL=beta- cài kênh beta (mới nhất, có thể chưa ổn định).AK_VERSION=x.y.z- ghim một phiên bản cụ thể.
Cài xong, verify ngay bằng hai lệnh:
ak --version
ak doctorak --version in ra số phiên bản; ak doctor quét môi trường và báo PATH, quyền, xung đột - nếu tất cả xanh là bạn ổn. Mẹo nhỏ: nếu ak doctor báo PATH chưa đúng, đừng vội login vội cài kit; sửa PATH trước rồi mới đi tiếp, vì mọi lỗi phía sau thường bắt nguồn từ đây. Trên macOS/Linux, binary nằm ở ~/.local/bin/ak - bạn có thể chạy trực tiếp bằng đường dẫn đầy đủ để kiểm nhanh trước khi lo chuyện PATH.
Bước 2 - Đăng nhập & cấp quyền (ak login)
Đây là chỗ gây nhầm nhiều nhất, đọc kỹ.
License key KHÔNG kích hoạt CLI. License key chỉ dùng để kích hoạt AgentKit Desktop App. CLI
akđược cấp quyền (entitlement) qua đăng nhập tài khoản. Nếu bạn cứ đi tìm ô "nhập license key" trong terminal, bạn sẽ không bao giờ thấy - vì nó không tồn tại.
Đăng nhập trên máy cá nhân (mở trình duyệt hoặc nhập OTP qua email):
ak login --email [email protected]Trên CI hoặc môi trường không tương tác, dùng API key:
ak login --api-key ak_live_... --no-interactiveXác nhận bạn đã đăng nhập đúng tài khoản và xem quyền hiện có:
ak whoami
ak licensesak whoami cho biết bạn đang đăng nhập với tài khoản nào; ak licenses liệt kê các entitlement (kit) bạn được phép tải. Nếu ak licenses trống mà bạn chắc đã mua, kiểm lại xem có đang đăng nhập nhầm email không.
Bảo mật: đừng commit hay chia sẻ API key (nó có tiền tố ak_live_, dễ bị bot quét trên GitHub). Trên máy dùng chung, nhớ ak logout khi xong.
Bước 3 - Cài kit vào Claude Code (ak kit init)
Giờ mới đến phần nạp skills/agents vào Claude Code. Lệnh chuẩn cho Engineer Kit:
ak kit init engineer --target claude-code --globalĐổi engineer thành marketing nếu bạn cài Marketing Kit. Cờ --global cài cho mọi project; bỏ nó đi nếu chỉ muốn cài trong thư mục hiện tại.
Không cần cài hết mọi skill - bạn chọn lọc để giữ context gọn:
ak kit init engineer --target claude-code --global --skills ak-cook,ak-plan
ak kit init engineer --target claude-code --global --exclude-skills ak-deep-sweMuốn xem có những kit/skill nào trước khi cài:
ak kit list-kits
ak versionsChưa sở hữu Engineer/Marketing kit? Bước này cần entitlement. Xem Engineer Kit có gì để biết bộ này gồm những skill/workflow nào, hoặc nhận Engineer/Marketing kit — giảm 20%, còn $79.20/kit nếu bạn đã quyết.
Bước 4 - Dùng thử trong Claude Code (/ak:)
Mở Claude Code trong một project, gõ dấu / rồi ak: - bạn sẽ thấy các slash command mà kit vừa nạp gợi ý ra:
/ak:cook # implement một feature theo scope
/ak:plan # lập kế hoạch, chia phase
/ak:fix # sửa bug, lỗi test, CI
/ak:ask # hỏi nhanh về codebaseThử chạy /ak:cook với một tác vụ nhỏ thật (ví dụ thêm một endpoint) để xác nhận toàn bộ chuỗi cài đặt đã thông. Nếu Claude Code nhận lệnh và bắt đầu làm việc theo workflow của kit, nghĩa là bạn đã cài thành công. Nếu gõ /ak: mà không thấy command nào gợi ý, thường là kit chưa nạp đúng target - quay lại chạy ak kit init với đúng cờ --target claude-code, hoặc khởi động lại Claude Code để nó nạp lại danh sách command. Đến đây coi như bạn đã đi hết chuỗi verify đa lớp: ak --version (binary chạy), ak doctor (môi trường sạch), ak whoami (đã đăng nhập), ak licenses (có quyền), và cuối cùng /ak: hiện ra trong Claude Code (kit đã sống).
Chuyển từ Claude Kit cũ (ck → ak)
Nếu trước đây bạn dùng Claude Kit (ck), ak chính là bản kế nhiệm. Đừng để hai binary cùng tồn tại - ck cũ có thể chiếm PATH hoặc tạo shim xung đột. Sau khi cài ak, chạy:
ak doctor --check ck_shim_collisionLệnh này phát hiện xung đột shim còn sót từ ck. Gỡ binary ck cũ khỏi PATH nếu được cảnh báo. Tài liệu cũng đã chuyển từ docs.claudekit.cc sang docs.agentkit.best, nên đừng làm theo lệnh ck cũ nữa. Bối cảnh đầy đủ vụ đổi tên nằm ở bài Claude Kit đổi tên thành AgentKit.
Xử lý lỗi thường gặp (troubleshooting)
Đa số lỗi khi cài ak đều thuộc một trong các trường hợp dưới đây:
| Lỗi | Cách sửa |
|---|---|
ak: command not found (macOS/Linux) | Thư mục cài chưa vào PATH. Thêm ~/.local/bin vào PATH trong ~/.zshrc / ~/.bashrc, rồi mở terminal mới. |
Windows báo 'ak' is not recognized | Terminal đang mở từ trước không thấy PATH mới. Đóng và mở một cửa sổ terminal MỚI - đây là cách sửa số 1 trên Windows. |
| Installer bị Windows/SmartScreen chặn | Chạy lại lệnh từ domain tin cậy (agentkit.best hoặc releases.agentkit.best). Đừng tắt tính năng bảo mật để ép cài. |
| Checksum / signature verify fail | File tải bị hỏng hoặc mạng chèn giữa. Thử lại lệnh cài. Tuyệt đối không bỏ qua bước verify. |
ck cũ vẫn chạy thay vì ak | Gỡ binary ck khỏi PATH, chạy ak doctor --check ck_shim_collision để dọn xung đột. |
| Đăng nhập thất bại | API key dính khoảng trắng khi copy, hoặc OTP đã hết hạn. Copy lại key sạch, hoặc xin OTP mới rồi ak login lại. |
ak kit init báo thiếu quyền | Tài khoản chưa có entitlement cho kit đó. Kiểm bằng ak licenses; nếu trống, bạn cần sở hữu kit hoặc đăng nhập đúng tài khoản đã mua. |
Câu hỏi thường gặp (FAQ)
Cài ak CLI có cần Node.js không?
Không. Binary ak là native (macOS/Linux/Windows), chạy độc lập, không cần Node.js hay Bun. Chỉ có môi trường Claude Code - đích mà bạn nạp kit vào - mới cần Node 18+.
License key nhập ở đâu, và vì sao CLI không cần?
License key dùng để kích hoạt AgentKit Desktop App, không dùng cho CLI. CLI ak được cấp quyền qua đăng nhập tài khoản (ak login bằng email hoặc API key). Đây là điểm nhầm phổ biến nhất.
Cài trên Windows được không?
Được. Dùng PowerShell với lệnh irm https://agentkit.best/install.ps1 | iex. Nếu sau khi cài gõ ak báo "not recognized", chỉ cần mở một cửa sổ terminal mới.
Cần Claude Code Pro không?
Bạn cần một gói Claude bất kỳ dùng được Claude Code (Pro, Max, hoặc API theo token) để model chạy. AgentKit không thay thế gói này - nó chỉ thêm skills và agents lên trên Claude Code.
Gỡ ak thế nào?
Chạy ak uninstall. Trên máy dùng chung, nên ak logout trước để xóa phiên đăng nhập.
Một license cài được mấy máy?
Số máy cho mỗi license phụ thuộc điều khoản hiện hành của agentkit.best..
Kết luận & lấy license
Tóm lại 5 bước: cài Claude Code (prereq) → cài binary ak → ak login để cấp quyền → ak kit init engineer --target claude-code --global → gõ /ak: trong Claude Code. Nhớ cái bẫy lớn nhất: license = Desktop App, CLI = đăng nhập tài khoản. Vì CLI đang ở beta, hãy đối chiếu lệnh mới nhất trên docs trước khi chạy.
Muốn hiểu kỹ AgentKit đáng dùng tới đâu, đọc AgentKit là gì - review đầy đủ và cân nhắc chi phí qua bảng giá AgentKit có đáng mua.
Muốn Claude Code mạnh hơn ngay? Nếu bạn vừa cài xong CLI và thấy chuỗi /ak: hoạt động, bước tự nhiên tiếp theo là sở hữu kit để mở khóa đủ 108+ skills và 45 agents. Kit là mua một lần, kèm cập nhật trọn đời.