Hướng dẫn Cài đặt Claude Kit: Tối ưu hóa Quy trình làm việc với Claude Code

Bài viết này giới thiệu bản chất của Claude Kit và hướng dẫn các bước cài đặt kỹ thuật để tích hợp vào dự án của bạn.

1. Định vị Claude Kit

Trước khi cài đặt, cần hiểu rõ hai nguyên tắc cốt lõi:

  • Là công cụ mở rộng (Extension): Claude Kit không thay thế Claude Code. Nó là một bộ khung (framework) cung cấp các quy trình (workflows), tác nhân (agents) và kỹ năng (skills) chuyên sâu để Claude Code hoạt động hiệu quả hơn trong môi trường sản xuất.
  • Yêu cầu kỹ năng CLI: Claude Kit hoạt động hoàn toàn trên giao diện dòng lệnh (CLI). Để sử dụng thành thạo, người dùng bắt buộc phải có kiến thức cơ bản về thao tác với terminal.

2. Tại sao cần Claude Kit? (Góc độ kỹ thuật)

Bản chất của mọi mô hình ngôn ngữ lớn (LLM) hoạt động theo cơ chế: Input + Dữ liệu/Thuật toán ➡️ Output.

Chất lượng đầu ra không phụ thuộc vào "phép màu" mà phụ thuộc vào cách mô hình nội suy và xử lý thông tin. Claude Kit can thiệp vào quá trình này bằng cách:

  • Cung cấp Context chuẩn: Thay vì để Claude tự đoán, Claude Kit cung cấp cấu trúc dự án và quy tắc code rõ ràng.
  • Định hướng tư duy (Chain of Thought): Thông qua các Agents chuyên biệt (như Planner, Debugger), Claude Kit ép buộc mô hình tuân theo quy trình logic: Lên kế hoạch ➡️ Thực thi ➡️ Kiểm thử ➡️ Review, thay vì viết code ngay lập tức.

3. Các bước cài đặt

Yêu cầu tiên quyết (Prerequisites)

Đảm bảo hệ thống của bạn đã cài đặt:

  • Node.js: Phiên bản v18 trở lên.
  • Git: Để quản lý mã nguồn.
  • Claude Code CLI: Đã cài đặt và đăng nhập (yêu cầu gói Pro/Max của Anthropic).
  • Gemini API Key: Optional - Dùng cho các Task phân tích hình ảnh. Newbie nên bỏ qua!

Bước 1: Cài đặt ClaudeKit CLI

Chạy lệnh sau trong terminal để cài đặt công cụ quản lý:

npm install -g claudekit-cli

Kiểm tra cài đặt thành công:

ck --version

Bước 2: Khởi tạo trong dự án

Di chuyển vào thư mục dự án của bạn và chạy lệnh khởi tạo:

cd ten-du-an-cua-ban
ck init --kit engineer

Lệnh này sẽ tạo thư mục .claude/ chứa toàn bộ cấu hình Agents, Commands và Skills.

Bước 3: Cấu hình Môi trường

Newbie thì cứ skip bước này. Chọn NO!

Để kích hoạt khả năng xử lý hình ảnh (Vision), bạn cần cấu hình Gemini API Key. Sao chép file .claude/.env.example thành .claude/.env và nhập key của bạn vào biến GEMINI_API_KEY.

Bước 4: Kích hoạt và Đồng bộ

Khởi động Claude Code:

claude

Quan trọng: Lệnh đầu tiên cần chạy là /docs:init. Lệnh này giúp Claude Kit quét toàn bộ codebase, tạo tài liệu kỹ thuật và hiểu rõ kiến trúc dự án trước khi bắt đầu làm việc.

4. Các lệnh cơ bản để bắt đầu

Sau khi cài đặt, bạn có thể sử dụng các slash commands sau để tương tác:

  • /plan: Lên kế hoạch chi tiết cho tính năng mới.
  • /cook: Thực thi viết code dựa trên kế hoạch.
  • /fix: Phân tích và sửa lỗi (bug).
  • /git:cm: Tạo commit message theo chuẩn convention.

Related Articles