claude-code-templates: cài skill, agent, hook cho Claude Code bằng một lệnh — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về davila7/claude-code-templates — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: claude-code-templates: cài kho agent, skill, MCP cho Claude Code — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
claude-code-templates là một kho mở gồm hơn 1.980 thành phần cho Claude Code (skill, agent, slash command, hook, MCP, setting, mod) kèm công cụ dòng lệnh để cài chúng. Bạn chỉ cần chạy một lệnh npx, chọn thành phần, công cụ sẽ ghi file đúng chỗ và gộp vào cấu hình cũ thay vì ghi đè. Cài khá dễ nếu bạn đã dùng Claude Code và có sẵn terminal.
Claude Code Templates là một kho mở chứa hơn 1.980 "linh kiện" cho Claude Code: skill, subagent, slash command, hook, MCP server, setting và mod. Đi kèm là một công cụ dòng lệnh (CLI) giúp bạn cài từng linh kiện chỉ bằng một lệnh, không phải tự copy file vào đúng thư mục.
Claude Code được cấu hình bằng nhiều file nhỏ. Nếu tự làm, bạn phải biết file nào nằm ở đâu và sửa sao cho không đè lên cấu hình đang có. Repo này lo việc đó: bạn tìm trên trang aitmpl.com, xem trước các file sẽ được ghi, rồi chạy lệnh. Repo hiện có khoảng 33.447 sao và 3.933 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.
Ai nên dùng? Người đã cài Claude Code và muốn nó làm được nhiều việc hơn mà không tự viết từ đầu: lập trình viên mới, người làm văn phòng muốn có sẵn bộ lệnh dựng sẵn, hay bất kỳ ai muốn thử nhanh một agent hoặc skill có sẵn. Điểm đáng giá nhất là: cài bằng npx, không cần cài toàn cục, và có thể gộp nhiều thành phần vào một lệnh duy nhất.
davila7/claude-code-templates
Kho mở hơn 1.980 skill, agent, lệnh, hook, MCP cho Claude Code, cài bằng một lệnh npx, không cần cài toàn cục.
I.Claude Code Templates làm được gì
Dưới đây là những việc chính, theo cách dùng thực tế.
Một danh mục để tìm và chọn. Trang aitmpl.com cho bạn tìm kiếm, xem trước mọi file mà một thành phần sẽ ghi vào máy, rồi ghép nhiều thành phần thành một lệnh cài. Bạn biết trước nó sẽ làm gì trước khi cài.
Nhiều loại linh kiện. Theo README, danh mục gồm:
- Skill (918): khả năng dùng lại được, ví dụ xử lý PDF, thiết kế giao diện, review code.
- Agent (422): subagent chuyên một mảng, như kiểm toán bảo mật, lập trình frontend, kiến trúc cơ sở dữ liệu.
- Command (288): slash command tự đặt, như
/generate-tests,/optimize-bundle-size,/security-audit. - MCP (119): kết nối dịch vụ ngoài như GitHub, PostgreSQL, Stripe, Supabase, Sentry.
- Setting (80): cấu hình như timeout, quyền, status line.
- Hook (63): tự động hoá theo sự kiện, ví dụ ép commit đúng chuẩn, chặn push thẳng.
- Mod (50): thay đổi giao diện và hành vi của chính Claude Code, như che thông tin bí mật hay bảo vệ đường dẫn.
- Loop (18): quy trình tự chạy có mục tiêu, chu kỳ và điều kiện dừng.
- Template (14), Sandbox (11), Plugin (1).
Con số trên là theo README, có thể thay đổi khi kho được cập nhật.
Ghi file đúng chỗ, gộp thay vì ghi đè. Đây là lợi ích lớn nhất với người mới: bạn không cần nhớ cấu trúc thư mục của Claude Code, và cấu hình cũ không bị mất.
Có kiểm tra chất lượng. README nói mỗi pull request đều được chạy qua công cụ kiểm tra plugin của Claude Code và quét bằng NVIDIA SkillSpector. Đây là một lớp kiểm tra, không phải lời đảm bảo tuyệt đối.
Ba công cụ cục bộ. CLI còn có --analytics (theo dõi phiên làm việc, mở ở localhost:3333), --chats (đọc và tìm lại các cuộc hội thoại, localhost:9876) và --health-check (chẩn đoán cài đặt Claude Code và dự án).
II.Cần chuẩn bị gì
README chỉ ghi rõ một số điều. Đây là những gì có trong tư liệu:
- Công cụ chạy bằng
npx, nên máy bạn cần có Node.js (đi kèmnpx). README chưa ghi số phiên bản Node tối thiểu; bạn xem thêm ở filepackage.jsontrong repo. - Phải có Claude Code. Một số loại cần bản mới: mod cần Claude Code 2.1.287 trở lên, plugin qua marketplace cần 2.1.288 trở lên.
- README không yêu cầu GPU hay tài khoản riêng cho CLI. Về hệ điều hành, README không nói gì cụ thể.
- Repo có file
.env.examplevới các biến nhưRAPIDAPI_KEY,SERPAPI_KEY,GITHUB_TOKEN,SUPABASE_URL… Các biến này liên quan tới phần phát triển repo và một số thành phần; README không nói bạn phải điền chúng để dùng CLI. Một MCP riêng lẻ có thể cần key của dịch vụ đó, bạn xem trang của thành phần để biết.
Mỗi MCP kết nối tới dịch vụ ngoài (GitHub, cơ sở dữ liệu, thanh toán…) có thể cần token hoặc chuỗi kết nối. Đừng dán key vào chỗ công khai, và đọc kỹ các file mà thành phần sẽ ghi trước khi đồng ý cài.
III.Cài đặt từng bước
Vì dùng npx, bạn không phải clone repo hay cài gì toàn cục.
- Mở terminalVào thư mục dự án mà bạn dùng Claude Code
- Chạy chế độ tương tácDuyệt danh mục và chọn thành phần
- Hoặc cài thẳng một thành phầnDùng cờ --skill, --agent, --command, --mcp…
- Ghép nhiều thành phầnMột lệnh cài cả một bộ
- Tìm từ terminalDùng --search để tìm theo từ khoá
A.Mở terminal đúng chỗ
Mở terminal (PowerShell trên Windows, Terminal trên macOS) rồi cd vào thư mục dự án bạn đang dùng với Claude Code. README không nói rõ phạm vi cài đặt, nên đây là thói quen an toàn: chạy lệnh ở đúng dự án cần dùng.
B.Duyệt và cài tương tác
Cách dễ nhất cho người mới là chạy lệnh không kèm tham số:
npx claude-code-templates@latest@latest bảo npx lấy bản mới nhất. Công cụ sẽ hiện danh mục để bạn chọn và xác nhận.
C.Cài một thành phần
Nếu đã biết tên, dùng cờ tương ứng. Ví dụ cài một skill:
npx claude-code-templates@latest --skill creative-design/frontend-designTên có dạng nhóm/tên-thành-phần. Mỗi trang thành phần trên aitmpl.com hiển thị đúng lệnh cài, bạn chỉ việc copy. Thêm --yes nếu muốn bỏ qua bước hỏi xác nhận.
Mỗi loại có một cờ riêng, README đưa ví dụ như sau:
npx claude-code-templates@latest --skill creative-design/frontend-design
npx claude-code-templates@latest --agent development-tools/code-reviewer
npx claude-code-templates@latest --command performance/optimize-bundle-size
npx claude-code-templates@latest --mcp database/postgresql-integration
npx claude-code-templates@latest --setting mcp/mcp-timeouts
npx claude-code-templates@latest --hook git/conventional-commits
npx claude-code-templates@latest --mod security/secret-redactor # Claude Code 2.1.287+
npx claude-code-templates@latest --loop engineering/docs-sweep-loop # also installs the components the loop uses
npx claude-code-templates@latest --plugin productivity/champion-kit # via the aitmpl marketplace, Claude Code 2.1.288+Phần sau dấu # là ghi chú, không phải một phần của lệnh. Nếu bạn gõ tay, đừng chép phần ghi chú cũng được.
D.Cài cả một bộ trong một lệnh
Bạn có thể nối nhiều cờ để cài một "stack":
npx claude-code-templates@latest \
--agent development-team/frontend-developer \
--command testing/generate-tests \
--mcp integration/github-integrationDấu \ cuối dòng là cách xuống dòng trong bash. Trên PowerShell, bạn nên gõ tất cả trên một dòng để tránh lỗi.
E.Tìm thành phần từ terminal
npx claude-code-templates@latest --search "code review"Lệnh này tìm theo từ khoá, hữu ích khi bạn chưa biết tên chính xác.
IV.Kiểm tra đã chạy được chưa
README không mô tả chi tiết màn hình kết quả, nên mình chỉ nêu những cách kiểm tra có căn cứ:
- Lệnh chạy xong không báo lỗi, và công cụ cho biết đã ghi các file.
- Chạy chẩn đoán có sẵn:
npx claude-code-templates@latest --health-checkLệnh này kiểm tra cài đặt Claude Code và cấu hình dự án.
- Mở Claude Code trong cùng thư mục. Nếu bạn cài một command như
generate-tests, hãy thử gõ/generate-tests. Với agent hoặc skill, bạn xem chúng có xuất hiện trong Claude Code không. - Muốn xem mỗi phạm vi đang cài gì, README gợi ý dùng mod stack viewer: cài bằng
--mod ui/stack-viewer, rồi gõ/stacktrong Claude Code.
V.Dùng vào việc thật
Các tình huống dưới đây dùng đúng những thành phần có tên trong README.
A.Lập trình viên mới muốn có người review code
Bạn vừa viết xong một chức năng và chưa có đồng nghiệp xem giúp. Cài agent review code:
npx claude-code-templates@latest --agent development-tools/code-reviewerSau đó mở Claude Code trong dự án và nhờ nó xem lại đoạn code bạn vừa sửa. Bạn có thêm một "người đọc thứ hai" chuyên về review, thay vì chỉ hỏi chung chung.
Đừng tự viết cấu hình từ đầu khi đã có người làm sẵn và cho bạn xem trước từng file.
Ông T
B.Nhóm nhỏ muốn commit gọn gàng, không đẩy nhầm lên nhánh chính
Một nhóm hai ba người hay commit lộn xộn. Cài hook:
npx claude-code-templates@latest --hook git/conventional-commitsREADME mô tả nhóm hook này để ép commit theo chuẩn và chặn push thẳng. Kết quả là lịch sử commit rõ ràng hơn mà bạn không phải nhắc nhau.
C.Làm việc với cơ sở dữ liệu hoặc GitHub qua Claude Code
Bạn muốn Claude Code đọc được dữ liệu hoặc thao tác trên kho mã. Cài MCP tương ứng:
npx claude-code-templates@latest --mcp database/postgresql-integrationBạn cũng có thể kết hợp với agent và command trong một lệnh như ở phần cài bộ. Lưu ý MCP có thể cần thông tin kết nối của dịch vụ, nên hãy xem trang thành phần để biết cần điền gì.
D.Tăng an toàn khi để Claude Code làm việc
Nếu bạn lo Claude vô tình in ra thông tin nhạy cảm, README có mod che thông tin bí mật:
npx claude-code-templates@latest --mod security/secret-redactorMod này cần Claude Code từ 2.1.287 trở lên. Đây là một lớp hỗ trợ, bạn vẫn nên tự giữ key ở nơi an toàn.
VI.Lỗi hay gặp và cách xử lý
Lệnh npx không nhận ra. Máy chưa có Node.js, hoặc terminal chưa nhận đường dẫn sau khi cài. Cài Node.js, đóng và mở lại terminal, rồi chạy lại. Nếu vẫn lỗi, xem file package.json trong repo để biết yêu cầu phiên bản.
Cờ lệnh báo đã bị gỡ. Từ bản 1.31.0, một số cờ cũ như --plugins, --agents, --sandbox, --studio… đã bị xoá. README nói khi chạy chúng, công cụ sẽ in ra cách thay thế. Hãy làm theo gợi ý đó, hoặc xem CHANGELOG trong repo.
Cài mod hoặc plugin không hiệu lực. Mod cần Claude Code 2.1.287+ và plugin cần 2.1.288+. Cập nhật Claude Code rồi cài lại.
Không thấy thành phần trong Claude Code. Có thể bạn cài ở một thư mục khác với thư mục đang mở Claude Code. Hãy chạy lệnh cài ngay trong thư mục dự án, thoát và mở lại Claude Code, rồi dùng --health-check để kiểm tra.
Trang cục bộ không mở được ở thiết bị khác. Hai trang --analytics và --chats chỉ lắng nghe trên 127.0.0.1 vì chúng chứa lịch sử hội thoại của bạn. Muốn mở trang đọc chat từ máy khác, README hướng dẫn chuyển tiếp cổng qua SSH: ssh -L 9876:localhost:9876 <host>. Đừng tìm cách mở cổng ra công khai.
VII.Có nên dùng không
Điểm mạnh. Cài nhanh bằng npx, không cần cài toàn cục. Danh mục lớn, có xem trước file, gộp cấu hình thay vì ghi đè, và có bước kiểm tra tự động cho mỗi đóng góp. Giấy phép MIT, repo còn hoạt động. Nó đặc biệt hợp với người mới vì cho bạn bắt đầu từ thứ đã có sẵn.
Giới hạn. Đây là kho tổng hợp, nên chất lượng từng thành phần không đồng đều; một phần đến từ các nguồn bên ngoài, mỗi nguồn giữ giấy phép riêng. Bạn vẫn nên đọc nội dung trước khi cài, nhất là hook và MCP vì chúng có thể chạy lệnh hoặc chạm vào dữ liệu thật. Một số thành phần cần Claude Code bản mới. README cũng chưa nói rõ về hệ điều hành hay phiên bản Node tối thiểu.
Khi nào nên chọn cách khác. Nếu bạn chỉ cần một skill duy nhất và đã biết nguồn của nó, tự lấy từ repo gốc có thể gọn hơn. Nếu bạn cần cấu hình rất riêng cho công ty, hãy dùng thành phần ở đây làm mẫu rồi tự chỉnh. Còn nếu bạn mới làm quen với Claude Code, đây là chỗ khởi đầu hợp lý để khám phá những gì nó làm được.
Câu hỏi thường gặp
claude-code-templates có miễn phí không?
Repo dùng giấy phép MIT và README không nhắc tới phí cho CLI hay danh mục. Tuy nhiên bạn vẫn cần dùng Claude Code, và một số MCP kết nối tới dịch vụ bên ngoài có thể có điều kiện riêng. Về chi phí cụ thể của các dịch vụ đó, tư liệu chưa có thông tin.
Có cần cài đặt toàn cục không?
Không. README ghi công cụ chạy bằng npx, không cần cài toàn cục. Bạn chỉ cần chạy lệnh npx claude-code-templates@latest trong terminal, thêm --yes nếu muốn bỏ qua bước xác nhận.
Có cần GPU hoặc cấu hình máy mạnh không?
README không nhắc tới yêu cầu GPU hay phần cứng nào cho CLI. Công cụ chủ yếu ghi file cấu hình vào máy bạn nên nhu cầu có vẻ nhẹ, nhưng tư liệu chưa nói rõ.
Chạy được trên Windows không?
README chưa nêu hệ điều hành được hỗ trợ. Công cụ chạy qua npx nên về nguyên tắc cần Node.js. Khi gõ lệnh nhiều dòng, trên PowerShell bạn nên viết trên một dòng thay vì dùng dấu gạch chéo ngược.
Dữ liệu hội thoại của tôi có an toàn không?
README cho biết hai trang cục bộ --analytics và --chats chỉ lắng nghe trên 127.0.0.1 vì chúng phục vụ lịch sử hội thoại của bạn. Muốn xem từ thiết bị khác, README hướng dẫn chuyển tiếp cổng qua SSH. Còn các thành phần cài thêm, bạn nên tự đọc nội dung trước khi cài.
Khác gì với việc tự viết skill hay agent cho Claude Code?
Tự viết thì bạn phải biết file nào đặt ở đâu và tự tránh ghi đè cấu hình cũ. Repo này cung cấp sẵn danh mục, cho xem trước các file sẽ ghi, rồi CLI ghi đúng chỗ và gộp vào cấu hình hiện có. Bạn vẫn có thể chỉnh sửa lại sau khi cài.
Làm sao tìm được thành phần phù hợp?
Có hai cách. Duyệt và tìm trên trang aitmpl.com, nơi mỗi thành phần hiển thị đúng lệnh cài. Hoặc tìm ngay trong terminal bằng lệnh npx claude-code-templates@latest --search kèm từ khoá, ví dụ code review.


