Claude Kit đổi tên AgentKit: cách nâng cấp ck→ak an toàn (2026)

Mình (Jasmine) dùng Claude Kit với CLI ck cả năm nay, và vừa tự tay migrate máy làm việc lên ak. Bài này là quy trình mình đã chạy thật - có bước backup, có kịch bản khi lỗi, và những chỗ dễ vấp mà docs tiếng Anh nói khá mập mờ.

⚠️ AgentKit nào? Phân biệt với OpenAI AgentKit

Đọc trước khi tìm nhầm: Có hai thứ tên "AgentKit" hoàn toàn khác nhau. Bài này nói về AgentKit tại agentkit.best - chính là Claude Kit cũ đổi tên, CLI ak, bộ kit skills/agents cho Claude Code.

OpenAI cũng ra một sản phẩm tên AgentKit (bộ Agent Builder/ChatKit, ra mắt 06/10/2025) - đó là thứ khác hẳn, không liên quan gì tới Claude Kit hay đợt đổi tên ck→ak. Nếu bạn gõ "agentkit" lên Google và thấy kết quả của OpenAI, đừng hoang mang: bạn đang tìm sai. AgentKit mà chủ Claude Kit cần là bản kế nhiệm của ClaudeKit, sống ở domain agentkit.best và docs mới ở docs.agentkit.best. Cứ bám hai domain đó là chắc.

Claude Kit đổi tên AgentKit - có gì thay đổi?

Claude Kit đổi tên AgentKit là chuyện có thật (xem trang chính thức AgentKit), và đây là rename cộng nâng cấp, không phải một sản phẩm mới thay thế. Toàn bộ skills, agents, workflow bạn quen thuộc vẫn còn - chỉ khác nhãn và khác cách phân phối. Điều quan trọng nhất cần trấn an trước: kit bạn đã mua vẫn dùng được bình thường, license không bị vô hiệu, và bạn không phải mua lại. Nếu muốn xem toàn cảnh sản phẩm sau đổi tên, mình có bài AgentKit là gì - review đầy đủ đi sâu hơn.

Bốn thay đổi cốt lõi:

• Tên sản phẩm: ClaudeKit → AgentKit.
• CLI: ck → ak. Mọi lệnh quen thuộc đều có bản tương ứng (bảng ánh xạ ở dưới).
• Phân phối: bản npm claudekit-cli deprecated, thay bằng native binary cho macOS/Linux/Windows - không cần cài Node hay Bun nữa. Installer tự nhận OS/arch và cài vào ~/.local/bin.
• Scope mở rộng: trước chỉ phục vụ Claude Code, nay hỗ trợ Claude Code và Codex (theo lộ trình sẽ thêm Cursor/Grok/Gemini CLI).

Bảng "Trước → Sau" để bạn nắm nhanh:

Một lưu ý nhỏ để khỏi nhầm: Anthropic cũng đổi tên "Claude Code SDK" thành "Claude Agent SDK" (29/09/2025). Đó là chuyện khác hoàn toàn với ck→ak - đừng gộp hai đợt đổi tên này vào làm một.

Trước khi nâng cấp: backup cho chắc

Trước khi gõ bất kỳ lệnh migrate nào, hãy backup. Lệnh ak migrate có chụp snapshot state, nhưng như bạn sẽ thấy ở mục rollback bên dưới, file bị ghi đè thì không khôi phục lại được. Vì vậy một bản backup thủ công thư mục ~/.claude/ là mạng lưới an toàn thực sự - mất một phút, đổi lấy sự yên tâm.

Trên macOS/Linux:

# Backup toàn bộ cấu hình Claude Code + kit hiện tại
cp -r ~/.claude ~/.claude.backup-$(date +%Y%m%d)

# Ghi lại phiên bản ck đang chạy để đối chiếu sau
ck versions > ~/ck-versions-before-migrate.txt

# (tuỳ chọn) xem ck đang nằm ở đâu trên PATH
which -a ck

Trên Windows (PowerShell), copy thư mục tương ứng dưới %USERPROFILE%\.claude sang một thư mục backup có ghi ngày. Điều bạn cần giữ an toàn là: config, skills, agents và hooks cá nhân - tức mọi thứ bạn đã tinh chỉnh tay.

⚠️ Cảnh báo: Đừng bỏ qua bước này vì nghĩ "migrate có rollback rồi". Rollback chỉ gỡ được những file mới ghi; những file bị ghi đè trong quá trình migrate sẽ không quay lại được nếu bạn không có backup thủ công.

Các bước nâng cấp ck → ak (an toàn)

Đây là phần chính. Quy trình mình chạy gồm sáu bước, làm tuần tự. Lưu ý quan trọng: ak migrate là lưới an toàn dùng một lần để đưa cấu hình cũ sang bản mới, không phải flow update thường ngày - chạy xong một lần là xong.

Bước 1 - Cài ak (native binary). Installer tự nhận OS/arch, tải bản stable, verify SHA-256 rồi cài vào ~/.local/bin:

curl -fsSL https://agentkit.best/install.sh | sh

Nếu bạn muốn hiểu từng tuỳ chọn cài đặt (đường dẫn, PATH, cài trên Windows), xem chi tiết ở bài cách cài đặt ak CLI chi tiết. Còn nếu máy chưa có Claude Code, làm theo bài cài đặt Claude Code trước.

Bước 2 - Xác thực lại. Đây là chỗ nhiều người bất ngờ: ck cũ xác thực bằng GitHub PAT, còn ak dùng email OTP hoặc API key. Chạy đăng nhập theo hướng dẫn của CLI và nhập mã OTP gửi về email, hoặc dán API key nếu bạn dùng cách đó.

Bước 3 - Preview migration (read-only). Bước này không ghi gì, chỉ cho bạn xem sẽ thay đổi những gì. Luôn chạy preview trước:

ak migrate --from=ck

Đọc kỹ output: nó liệt kê skills, agents, config sẽ được mang sang. Nếu thấy thiếu thứ gì quan trọng, dừng lại kiểm tra chứ đừng apply vội.

Bước 4 - Apply. Khi đã hài lòng với preview, chạy bản thật:

ak migrate --from=ck --dry-run=false --yes --no-interactive

Bước 5 - Verify. Kiểm tra mọi thứ còn đủ:

ak doctor # kiểm tra tình trạng cài đặt tổng thể
ak skills # đối chiếu skills còn đủ so với trước
ak agents # đối chiếu agents

So số lượng skills/agents với file ck-versions-before-migrate.txt bạn đã lưu ở bước backup. Nếu con số khớp và ak doctor không báo lỗi, bạn đã migrate thành công.

Bước 6 - Dọn ck cũ. Đây là cái bẫy dễ vấp nhất: nếu ck cũ vẫn còn trên PATH, gõ ck sẽ tiếp tục chạy script ClaudeKit cũ dù bạn đã cài ak. Kiểm tra rồi gỡ:

which -a ck # xem ck cũ còn nằm ở đâu
npm uninstall -g claudekit-cli # gỡ bản npm deprecated

Muốn tận dụng lúc đang nâng cấp? Nếu bạn migrate rồi thấy mình chỉ đang dùng Engineer Kit, đây là dịp hợp lý để cân nhắc thêm Marketing Kit hoặc lên Bundle - xem gói AgentKit (giảm 20% qua link) để so nhanh (chi tiết trung thực ở phần dưới, không hard-sell).

Bảng ánh xạ lệnh ck → ak

Tin tốt cho cơ bắp ngón tay của bạn: cấu trúc lệnh gần như giữ nguyên, chỉ đổi ck thành ak. Đây là bảng đối chiếu những lệnh hay dùng nhất:

Ngoài lệnh CLI, namespace của skill cũng đổi tiền tố: ck: → ak:. Nghĩa là slash command hay skill từng gọi dạng ck:something giờ gọi bằng ak:something.

Nếu lỗi: cách rollback

Nếu sau khi apply mà có gì đó hỏng, AgentKit có sẵn lệnh rollback:

ak migrate rollback

Lệnh này gỡ những file mới ghi trong quá trình migrate (đã được snapshot ngay trước khi ghi). Nó cứu được đa số trường hợp. Nhưng đây là điểm cần trung thực mà docs nói khá kín:

Giới hạn thật của rollback: Lệnh chỉ hoàn tác file mới tạo. Những file đã bị ghi đè trong lúc migrate KHÔNG khôi phục được bằng ak migrate rollback. Đó chính là lý do bước backup thủ công ở trên là bắt buộc, không phải khuyến nghị cho vui.

Nên khi thực sự kẹt - rollback không đủ, cấu hình vẫn sai - hãy quay về bản backup thủ công: xoá thư mục ~/.claude hiện tại và khôi phục từ ~/.claude.backup-YYYYMMDD bạn đã tạo. Đây là lý do mình nhấn mạnh backup ngay từ đầu: nó là đường lùi cuối cùng luôn hoạt động.

Breaking changes & điều dễ vấp

Đây là danh sách trung thực những chỗ dễ khiến bạn "ơ sao lạ vậy" sau migrate. Biết trước thì không hoảng:

• Xác thực đổi kiểu: từ GitHub PAT sang email OTP / API key. Nếu login cũ không còn tác dụng, đó là do thiết kế - đăng nhập lại theo cách mới.
• Generated hooks không migrate mặc định: các hook được sinh tự động (session, subagent, usage context) không được mang sang mặc định, và đăng ký cũ bị dọn. Nếu bạn phụ thuộc vào hook nào, kiểm tra và thiết lập lại sau migrate.
• Bẫy PATH với ck cũ: như đã nói ở Bước 6 - ck còn trên PATH sẽ chạy script ClaudeKit cũ. Luôn which -a ck và gỡ claudekit-cli.
• Namespace đổi: tiền tố ck: → ak: cho slash command và skill. Script hay ghi chú cá nhân gọi ck: cần cập nhật.

Không có cái nào trong số này là lỗi - chúng là hệ quả tự nhiên của việc đổi tên và chuyển sang native binary. Nhưng vì docs EN không gom chúng lại một chỗ, nhiều người vấp từng cái một. Giờ bạn có cả danh sách.

Đã đổi tên rồi - có nên nâng cấp gói không?

Câu trả lời thẳng: bạn không bắt buộc phải trả thêm đồng nào chỉ vì đổi tên. Rename là miễn phí cho chủ kit hiện tại, và kit bạn mua có lifetime updates - cứ migrate rồi dùng tiếp như cũ. Việc "nâng cấp gói" chỉ đáng cân nhắc nếu bạn thực sự cần thêm năng lực, không phải vì sợ bị bỏ lại phía sau.

Vài hướng nâng cấp hợp lý, tuỳ nhu cầu:

• Chỉ có Engineer Kit ($99) và muốn làm cả marketing? Thêm Marketing Kit ($99), hoặc mua thẳng Bundle ($149) cả hai kit sẽ rẻ hơn mua lẻ.
• Quản lý license/kit/statusline gọn hơn? Desktop App giá $19/năm (early access, năm đầu) làm "control center": kích hoạt license, quản lý kit/skill, và có statusline builder. Gói App kèm cả 2 kit là $99/năm (ưu đãi 100 người đầu).

Trước khi quyết, đọc bảng giá AgentKit chi tiết để cân đối đúng nhu cầu, và bài review Desktop App nếu bạn tò mò control center. Muốn xem trực tiếp các gói và ưu đãi hiện hành? Nâng cấp lên Bundle — còn $149 (từ $198) hoặc so sánh tại trang chính thức.

Câu hỏi thường gặp (FAQ)

Claude Kit và AgentKit có phải là một?

Đúng. AgentKit là Claude Kit đổi tên và nâng cấp. CLI đổi từ ck sang ak, cách phân phối chuyển từ npm sang native binary, nhưng đây là cùng một dòng sản phẩm kế nhiệm - không phải hai thứ tách biệt.

Tôi có mất skills hay config khi nâng cấp không?

Không, nếu bạn làm đúng quy trình. Lệnh ak migrate --from=ck mang skills, agents và config cũ sang. Chỉ cần backup ~/.claude/ trước, chạy preview để xem trước, apply, rồi ak doctor/ak skills/ak agents để đối chiếu.

Tôi có cần mua lại kit không?

Không. Đổi tên miễn phí cho chủ kit hiện tại và kit có lifetime updates. License của bạn vẫn hiệu lực; migrate rồi dùng tiếp bình thường.

ck còn dùng được không?

Bản ck cũ vẫn chạy nếu còn trên PATH, nhưng nó là bản deprecated và sẽ không được cập nhật. Nên gỡ (npm uninstall -g claudekit-cli) sau khi migrate để tránh vô tình chạy nhầm script cũ.

AgentKit này có phải OpenAI AgentKit không?

Không. Đây là AgentKit tại agentkit.best (Claude Kit cũ, CLI ak, cho Claude Code/Codex). OpenAI AgentKit (Agent Builder/ChatKit, ra mắt 06/10/2025) là sản phẩm hoàn toàn khác, không liên quan.

Nâng cấp có cần internet hoặc đăng nhập lại không?

Có. Cài native binary cần tải qua mạng, và ak dùng cơ chế xác thực mới (email OTP / API key) nên bạn sẽ đăng nhập lại - GitHub PAT cũ không còn dùng.

Kết luận & bước tiếp theo

Tóm lại ba bước cốt lõi: (1) backup ~/.claude/, (2) chạy ak migrate --from=ck preview rồi apply, (3) verify bằng ak doctor và dọn ck cũ khỏi PATH. Làm đúng thứ tự thì migrate ck→ak gọn và an toàn - dữ liệu còn nguyên, kit vẫn dùng được. Cần chi tiết cài đặt, xem cách cài đặt ak CLI; muốn hiểu toàn bộ sản phẩm sau đổi tên, đọc AgentKit là gì.