Cách Dùng AgentKit Với Codex (Hướng Dẫn Từng Bước 2026)

- Lệnh và mốc giá dưới đây đã đối chiếu tài liệu chính thức (docs.agentkit.best, kênh beta) tại thời điểm viết 08/2026; kiểm tra docs live trước khi phụ thuộc, vì kênh beta đổi nhanh hơn bản GA.

Ba thứ tên "AgentKit"/"Codex" - đọc trước khi đi tiếp

Trước khi gõ lệnh nào, tách rõ ba cái tên hay bị gộp làm một. Nhầm ở đây là nhầm cả sản phẩm lẫn giá tiền, không chỉ nhầm chữ:

Đây là lý do search "agentkit hướng dẫn" hay "agentkit codex" ở cả VI lẫn EN hay trồi lên kết quả về Agent Builder của OpenAI - sai sản phẩm, sai giá, sai cách cài. Bài này chỉ nói về hàng thứ hai trong bảng trên: agentkit.best. Muốn đọc kỹ phần so sánh hai AgentKit để không mua nhầm, xem OpenAI AgentKit vs AgentKit (agentkit.best) - so sánh đầy đủ.

Cần gì trước khi bắt đầu

Checklist khoảng 5 phút trước khi cài, đọc hết rồi hẵng gõ lệnh đầu tiên:

• Codex CLI hoặc một gói ChatGPT có Codex đã cài sẵn và đăng nhập bằng tài khoản OpenAI của bạn.
• Một license AgentKit đã mua - Engineer $99 hoặc Bundle $149, không phải hàng free tier.
• Terminal mở sẵn trong đúng thư mục project bạn muốn cài kit vào.
• ~5 phút không bị gián đoạn.

Lưu ý quan trọng hay bị bỏ qua: đăng nhập AgentKit KHÔNG tự đăng nhập Codex, và ngược lại - đây là hai hệ thống auth tách biệt hoàn toàn, bạn sẽ đăng nhập hai lần cho hai thứ khác nhau, và sẽ cần đăng nhập lại riêng nếu đổi máy. Đừng để tới lúc chạy ak kit init rồi mới nhận ra Codex chưa đăng nhập, hoặc ngược lại - kiểm tra cả hai trước khi bắt đầu tiết kiệm được một vòng debug vô ích. Chưa cài Codex? Đọc cách cài Codex CLI trước khi quay lại đây. Chưa rõ Codex là gì và khác Claude Code ra sao? Xem OpenAI Codex là gì.

Bước 1 - Cài CLI ak

AgentKit chạy qua một binary CLI gốc tên ak - không cần Node, không cần Bun, không cần cài thêm runtime nào khác. Cài theo hệ điều hành:

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

# Windows (PowerShell)
irm https://agentkit.best/install.ps1 | iex

Installer tự nhận diện OS và kiến trúc máy, không cần bạn chọn tay. Cài xong, verify bằng hai lệnh:

ak --version
ak doctor --json

ak doctor --json in ra trạng thái cài đặt dạng JSON - dùng lệnh này bất cứ khi nào nghi ngờ install hỏng, kể cả ở các bước sau. Vì là native binary, cách cài này cũng chạy ổn trong môi trường sandbox/CI không có Node sẵn - một điểm khác biệt thật so với các kit dựng trên npm package.

Bước 2 - Đăng nhập và xác nhận license

Đăng nhập bằng email hoặc API key, tùy bạn thấy tiện hơn:

ak login --email [email protected]
# hoặc
ak login --api-key ak_live_...

Rồi xác nhận đúng account và đúng license đã mua trước khi cài bất cứ thứ gì - bước này nhiều người bỏ qua rồi mới phát hiện license chưa kích hoạt đúng, hoặc đang đăng nhập nhầm email so với email lúc checkout:

ak whoami
ak licenses

ak licenses liệt kê đúng kit bạn thực sự sở hữu (Engineer, Marketing, hoặc Bundle). Nếu danh sách trống dù bạn chắc chắn đã mua, quay lại email xác nhận đơn hàng hoặc trang tài khoản trên agentkit.best trước khi đi tiếp - đừng cài mò rồi mới hỏi vì sao báo lỗi thiếu quyền.

Bước 3 - Cài kit vào Codex

Đây là lệnh trung tâm của cả bài - cái mà chưa trang nào, VI hay EN, viết ra một cách đầy đủ:

ak kit init engineer --target codex

Mặc định lệnh cài theo project scope - kit chỉ có hiệu lực trong thư mục project hiện tại, không lan sang project khác. Muốn kit có sẵn ở MỌI project mà không phải cài lại từng lần, thêm cờ global:

ak kit init engineer --target codex --global

Trước khi ghi bất cứ file nào xuống đĩa, ak hiện một màn hình confirm/preview: tên kit, vị trí output, chế độ cài (project hay global), scope, và danh sách file sẽ được ghi. Đọc kỹ màn hình này trước khi gõ "y" - đây là lúc bạn biết chính xác kit sẽ đụng vào đâu, chứ không phải đoán mò sau khi cài xong rồi mới lục lại xem nó ghi gì.

Ghi chú thực chiến: chạy lệnh này lần đầu, màn hình confirm liệt kê rất rõ ràng - tên kit Engineer, đích ghi vào .agents/skills, scope project, và một danh sách file cụ thể sẽ được tạo. Không có gì ẩn phía sau; bấm đồng ý là biết chắc kit sẽ chạm vào những file nào.

Chưa mua kit? Cần một license Engineer hoặc Bundle trước khi lệnh trên chạy được. Kiểm tra giá và ưu đãi hiện tại trên trang bán rồi quay lại bước này.

Mua AgentKit Engineer Kit →

Bước 4 - Chạy skill đầu tiên với $ak:cook

Skill chỉ được Codex nhận diện sau khi bạn mở một phiên Codex mới trong đúng project vừa cài - Codex cần reload để quét lại skill discovery. Đừng chạy tiếp trong phiên cũ đang mở rồi thắc mắc sao gõ lệnh mà không thấy gì xảy ra.

Trong phiên mới, gọi skill bằng cú pháp $ak: của Codex:

$ak:cook Thêm một health-check endpoint

Thay task mẫu bằng việc thật của bạn - đây chỉ là ví dụ minh họa để bạn thấy cú pháp gọi, không phải công thức cố định. Điểm cần nhớ nằm ở khác biệt cú pháp giữa hai runtime: Codex dùng $ak:, còn Claude Code dùng /ak: - cùng một kit, cùng bộ skill, chỉ khác ký tự gọi theo từng nơi nó chạy. Đừng gõ nhầm /ak:cook trong Codex rồi tưởng kit không hoạt động; đó gần như luôn là lỗi cú pháp, không phải lỗi cài đặt.

Ghi chú thực chiến: chạy $ak:cook trong phiên Codex mới, skill được nhận diện ngay không cần cấu hình thêm - đúng như tài liệu mô tả về việc discovery cần một session mới sau khi cài.

AgentKit chạy trong Codex khác Claude Code ở đâu

Đây là phần thông tin thật sự mới - không trang nào khác hiện có viết ra chi tiết này. AgentKit không chạy y hệt trên mọi runtime, và Codex có vài giới hạn cụ thể so với Claude Code, được khai báo rõ trong tài liệu runtime-adapter (docs.agentkit.best/en/beta/concepts/runtime-adapters, truy cập 08/2026):

Nói ngắn gọn: skill, rule và agent dispatch chạy được đầy đủ trong Codex - đó là cách bạn gọi $ak:cook và mọi thứ diễn ra. Hook thì chỉ một phần, còn kit commands (các lệnh dạng slash riêng ngoài skill) và status line thì Codex không có. Nếu một workflow trong kit dựa nhiều vào kit commands hoặc hook nằm ngoài nhóm được hỗ trợ, kỳ vọng phần đó không chạy trên Codex dù vẫn chạy tốt trên Claude Code - đây không phải bug, là cách adapter khai báo rõ ràng trước khi bạn cài, không phải phát hiện ra sau khi dùng.

Nếu bạn quen Claude Code trước rồi mới sang Codex, đừng ngạc nhiên khi vài thứ "biến mất" - chúng chưa từng được hỗ trợ ở Codex chứ không phải bị hỏng trong quá trình cài của bạn.

Ví dụ thực tế: nếu workflow bạn quen dùng trên Claude Code có bước gọi qua kit command hoặc dựa vào một hook nằm ngoài nhóm được hỗ trợ, đừng ngạc nhiên khi bước đó im lặng không chạy trên Codex trong khi phần skill chính ($ak:cook và các skill khác) vẫn hoạt động bình thường. Cách chắc chắn nhất là chạy thử ngay sau khi cài, đừng giả định hành vi giống hệt Claude Code chỉ vì cùng một kit.

Codex miễn phí, AgentKit trả phí - ranh giới thật

Nói thẳng ngay từ đầu: bạn không trả tiền để "dùng được Codex". Codex CLI, Codex cloud, và cả goal mode /goal đều free hoặc đã nằm trong gói ChatGPT bạn trả (Free/Go/Plus/Pro/Business). AgentKit là lớp bộ skill/agent/workflow dựng sẵn bạn cài thêm lên trên cùng một "động cơ" Codex miễn phí đó - bạn trả tiền để không phải tự viết skill từ đầu, không phải trả tiền để mở khóa tính năng nào của Codex.

Giá trên theo trang giá tại thời điểm viết (08/2026); trang hay chạy ưu đãi -20% qua link ref (Engineer còn khoảng $79.20) - kiểm tra lại banner khuyến mãi trước khi trả tiền, đừng tin một số cố định vì ưu đãi có thể đổi. Có money-back guarantee nhưng trang không công bố thời hạn cụ thể - xác nhận điều khoản chính xác ở checkout thay vì đoán "14 ngày" hay "30 ngày". Muốn nắm toàn cảnh sản phẩm và tính ROI theo giờ công trước khi mua, đọc review AgentKit đầy đủ hoặc bảng giá chi tiết ở AgentKit giá có đáng mua - hai bài đó đào sâu phần định giá, bài này chỉ nêu ranh giới free/trả phí đủ để bạn quyết định trước khi cài.

Xử lý sự cố

• Nghi ngờ cài lỗi: chạy ak doctor --json, đọc phần lỗi trong JSON trả về trước khi cài lại từ đầu.
• Muốn biết kit/skill đang ở phiên bản nào: ak versions để so với bản mới nhất, hữu ích khi nghi ngờ kit đã lỗi thời.
• $ak:cook không được Codex nhận diện: gần như luôn là do chưa mở phiên Codex mới trong đúng thư mục project đã cài kit - đóng phiên cũ, mở lại đúng thư mục, thử lại.
• Cài project scope nhưng cần dùng ở project khác: đó là hành vi đúng, không phải lỗi - project scope chỉ có hiệu lực đúng nơi bạn cài; chạy lại lệnh với --global nếu muốn dùng ở mọi nơi.
• Không chắc license còn hiệu lực: ak whoami + ak licenses để xác nhận lại account và kit đang sở hữu.
• Màn hình confirm hiện thứ bạn không ngờ tới (sai scope, sai đích cài): hủy ngay tại đó, kiểm tra lại xem có định thêm --global hay không rồi chạy lại - hủy một preview luôn rẻ hơn phải dọn file lỡ ghi sai chỗ.

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

AgentKit có miễn phí khi dùng với Codex không?

Không. Codex (CLI/cloud/ChatGPT) miễn phí hoặc đã nằm trong gói bạn trả. AgentKit là kit trả phí cài thêm lên trên - Engineer $99, Bundle $149, giá như nhau cho mọi target kể cả Codex.

Khác gì giữa /ak: và $ak:?

Cùng một kit, cùng bộ skill, chỉ khác cú pháp gọi theo runtime. Claude Code dùng /ak:cook; Codex dùng $ak:cook. Gõ nhầm ký tự là lý do phổ biến nhất khiến skill "không chạy".

Cần cài cả Claude Code không, hay chỉ Codex là đủ?

Chỉ Codex là đủ. ak kit init engineer --target codex cài độc lập cho Codex, không bắt buộc phải có Claude Code cài song song.

Đây có phải AgentKit của OpenAI không?

Không. AgentKit trong bài này là agentkit.best, sản phẩm bên thứ ba, chạy qua CLI ak. OpenAI AgentKit là Agent Builder/ChatKit của chính OpenAI - sản phẩm khác hoàn toàn, chỉ trùng tên.

Giá AgentKit cho Codex có khác giá cho Claude Code không?

Không khác. Cùng một license, cùng mức giá ($99 mỗi kit hoặc $149 Bundle) áp dụng cho mọi --target bạn cài - Codex không bị tính giá riêng hay cao hơn.

Một license có dùng chung được cho cả Claude Code và Codex không?

Chưa có xác nhận công khai rằng một license cho phép cài không giới hạn số target cùng lúc - license được quản lý theo thiết bị kích hoạt, còn --target chỉ là tham số chọn nơi cài. Nếu định chạy song song cả hai runtime trên cùng một license, xác nhận giới hạn kích hoạt tại checkout trước khi giả định thay vì tự suy đoán.

Tôi chưa cài Codex, có cài AgentKit trước được không?

Không nên. ak kit init … --target codex chỉ cài skill vào thư mục Codex đọc được (.agents/skills); nếu chưa có Codex, kit cài xong cũng chưa có gì để chạy nó. Cài Codex trước theo hướng dẫn cài Codex CLI, đăng nhập xong rồi mới quay lại các bước ở trên.

Màn hình confirm có cho hủy trước khi ghi file không?

Có - đó là mục đích của nó. ak kit init hiện tên kit, vị trí output, chế độ cài, scope, và danh sách file trước khi ghi bất cứ gì; bạn có thể hủy ngay tại đó nếu thấy scope hoặc đích cài sai, thay vì phát hiện ra sau khi đã ghi xong.

Kết luận

Toàn bộ đường đi thật gói gọn trong bốn bước: cài ak, ak login, ak kit init engineer --target codex, mở phiên Codex mới rồi gọi $ak:cook. Codex vẫn miễn phí hoặc đã nằm trong gói ChatGPT bạn trả; AgentKit là khoản trả thêm cho bộ skill/agent dựng sẵn, không phải phí để "mở khóa" Codex. Đáng mua nếu bạn đã dùng Codex hằng ngày và không muốn tự viết skill từ đầu; chưa cần vội nếu bạn mới bắt đầu làm quen Codex trần.