claude-code-templates: kho thành phần cho Claude Code — 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 danh mục mở kèm công cụ dòng lệnh, gom hơn 1.980 thành phần cho Claude Code: skill, agent, slash command, hook, MCP server, cấu hình. Bạn chỉ cần chạy một lệnh npx là file được ghi đúng chỗ, cấu hình cũ được gộp chứ không bị ghi đè. Cài khá dễ nếu máy đã có Node.js và Claude Code.
claude-code-templates là một danh mục mở, kèm công cụ dòng lệnh (CLI), gom hơn 1.980 thành phần làm sẵn cho Claude Code: skill, subagent, lệnh gạch chéo (slash command), hook, MCP server, cấu hình và nhiều thứ khác. Bạn không phải tự viết hay tự chép từng file cấu hình. Chọn thành phần cần dùng, chạy một lệnh, công cụ sẽ ghi file vào đúng thư mục.
Nếu bạn đã dùng Claude Code mà thấy mình cứ phải viết lại cùng một kiểu hướng dẫn ("hãy review code như thế này", "hãy viết test theo kiểu kia"), repo này dành cho bạn. Người làm kinh doanh, nhân viên văn phòng cũng dùng được, vì bạn có thể duyệt danh mục trên trang aitmpl.com, xem trước từng thành phần rồi copy đúng câu lệnh cài.
Điểm đáng giá nhất: công cụ biết gộp vào cấu hình sẵn có thay vì ghi đè. Ngoài ra, theo README, mọi pull request đều được kiểm bằng bộ kiểm tra plugin của Claude Code và quét bằng NVIDIA SkillSpector. Hiện repo có khoảng 33.400 sao và khoảng 3.900 fork, giấy phép MIT.
davila7/claude-code-templates
Danh mục 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 global.
I.claude-code-templates làm được gì
Claude Code được tuỳ biến qua các file nhỏ. Repo này gom chúng vào một chỗ và cho bạn cài nhanh. Các nhóm chính, theo README:
- Skill (918 mục)năng lực dùng lại được, ví dụ xử lý PDF, thiết kế giao diện, review code. Bạn cài một lần là Claude biết thêm một "kỹ năng".
- Agent (422 mục)subagent chuyên một lĩnh vực như kiểm toán bảo mật, lập trình frontend, kiến trúc cơ sở dữ liệu. Hợp khi bạn muốn giao việc cho một "chuyên gia" riêng.
- Command (288 mục)slash command tự tạo, như
/generate-tests,/optimize-bundle-size,/security-audit. Gõ một dòng là chạy cả quy trình. - MCP (119 mục)kết nối dịch vụ bên ngoài như GitHub, PostgreSQL, Stripe, Supabase, Sentry.
- Settings (80), Hook (63)cấu hình (timeout, quyền, thanh trạng thái) và các trigger tự động (ví dụ chuẩn hoá commit, chặn push thẳng).
- Mod (50)plugin thay đổi chính giao diện và hành vi của Claude Code, như che 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)cấu hình trọn dự án, bộ khởi chạy môi trường cô lập (chỉ để tham khảo) và plugin hoàn chỉnh.
Bên cạnh danh mục còn có ba công cụ chạy trên máy bạn: theo dõi phiên làm việc và mức sử dụng, đọc và tìm lại các cuộc hội thoại, và kiểm tra tình trạng cài đặt Claude Code. Phần này nói rõ ở các mục sau.
Lợi ích thực tế: bạn đỡ mất thời gian mày mò cấu trúc thư mục của Claude Code, và có thể ghép nhiều thành phần vào một lệnh cài duy nhất.
II.Cần chuẩn bị gì
README nói công cụ chạy bằng npx, không cần cài global. Vì vậy bạn cần máy có Node.js (npx đi kèm Node.js). README không ghi rõ phiên bản Node tối thiểu, bạn xem thêm trong package.json của repo nếu cần chắc chắn.
Bạn cũng cần đã cài Claude Code, vì mọi thành phần đều dành cho nó. Hai loại có yêu cầu phiên bản riêng:
- Mod (
--mod): Claude Code 2.1.287 trở lên. - Plugin (
--plugin, qua marketplace aitmpl): Claude Code 2.1.288 trở lên.
Về tài khoản và key: README không yêu cầu đăng ký tài khoản để dùng CLI. Một số MCP hay công cụ phụ trong repo có thể cần khoá dịch vụ riêng. File .env.example liệt kê các biến như GITHUB_TOKEN, SUPABASE_URL, SERPAPI_KEY..., nhưng tư liệu không nói rõ biến nào dành cho việc gì với người dùng thường. Với người chỉ cài thành phần về dùng, bạn chưa cần động tới file này.
README không nói về phần cứng hay GPU. Công cụ chỉ ghi file cấu hình, không chạy mô hình AI nào trên máy bạn.
III.Cài đặt từng bước
- Mở terminalMở terminal ở thư mục dự án mà bạn dùng Claude Code
- Duyệt danh mụcChạy npx để chọn thành phần theo kiểu hỏi đáp
- Cài một thành phầnDùng cờ --skill, --agent, --command, --mcp... kèm tên
- Cài cả bộGhép nhiều cờ trong một lệnh
- Tìm thành phầnDùng --search để tìm từ terminal
A.Mở terminal đúng chỗ
README không bắt cài gì trước, nhưng nên mở terminal ở thư mục dự án của bạn (nơi bạn chạy Claude Code). Trên Windows có thể dùng PowerShell, trên macOS/Linux dùng Terminal. Người mới hay vấp ở đây: mở terminal ở thư mục lung tung rồi tự hỏi sao không thấy file đâu.
Bạn không cần tải repo về. Nếu vẫn muốn xem mã nguồn hoặc đọc kỹ cấu trúc, có thể clone:
git clone https://github.com/davila7/claude-code-templates.git
cd claude-code-templatesĐể chỉ dùng công cụ, bỏ qua bước clone này.
B.Duyệt danh mục và cài tương tác
Đây là cách dễ nhất cho người mới. Lệnh dưới đây mở chế độ hỏi đáp để bạn chọn thành phần:
npx claude-code-templates@latestnpx tải và chạy công cụ tạm thời, @latest là lấy bản mới nhất. Lần đầu có thể mất một lúc vì phải tải về.
C.Cài một thành phần
Mỗi loại có một cờ riêng. README đưa ví dụ cho từng loại:
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 cờ có dạng nhóm/tên-thành-phần. Đừng tự đoán tên: mỗi trang thành phần trên aitmpl.com đều hiển thị đúng lệnh cài của nó, bạn chỉ cần copy. Chú thích sau dấu # chỉ là ghi chú trong README, bạn không cần gõ.
D.Cài cả một bộ trong một lệnh
Bạn có thể ghép nhiều thành phần. Dấu \ ở cuối dòng nghĩa là lệnh tiếp tục xuống dòng dưới (kiểu bash). Trên PowerShell bạn nên gõ toàn bộ trên một dòng cho an toàn.
npx claude-code-templates@latest \
--agent development-team/frontend-developer \
--command testing/generate-tests \
--mcp integration/github-integrationCông cụ sẽ hỏi xác nhận trước khi ghi. Thêm --yes nếu bạn muốn bỏ qua câu hỏi đó. Người mới nên để nguyên bước xác nhận để nhìn xem nó sắp ghi gì.
E.Tìm thành phần từ terminal
Chưa biết tên chính xác? Tìm theo từ khoá:
npx claude-code-templates@latest --search "code review"Các thành phần trong danh mục là file cấu hình và chỉ dẫn mà Claude Code sẽ đọc và làm theo, MCP còn có thể kết nối ra dịch vụ bên ngoài. Hãy xem trước nội dung trên trang thành phần (trang cho phép xem mọi file sẽ được ghi) trước khi cài, nhất là hook, mod và MCP. Key hay token của bạn không nên dán vào nơi bạn chưa hiểu rõ.
IV.Kiểm tra đã chạy được chưa
Có hai cách theo tư liệu.
Cách 1: sau khi cài một thành phần, mở lại Claude Code trong cùng thư mục và dùng thành phần đó. Ví dụ nếu bạn cài command testing/generate-tests, hãy thử gõ /generate-tests. README không mô tả chi tiết màn hình kết quả, nên mức độ "thấy gì" tuỳ thành phần bạn chọn.
Cách 2: dùng công cụ chẩn đoán đi kèm:
npx claude-code-templates@latest --health-checkLệnh này kiểm tra bản cài Claude Code và thiết lập dự án của bạn. Với mod, README gợi ý cài "stack viewer" rồi gõ /stack trong Claude Code để xem mỗi phạm vi (scope) đang cài những gì:
npx claude-code-templates@latest --mod ui/stack-viewerV.Dùng vào việc thật
A.Lập trình viên mới muốn code được review tử tế
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 và nhờ nó review thay đổi của bạn bằng agent vừa cài. Kết quả là bạn có một "người đọc thứ hai" với chỉ dẫn chuyên cho việc review, thay vì tự viết lại yêu cầu mỗi lần.
Đừng tự viết lại cùng một chỉ dẫn lần thứ mười, hãy cài sẵn một lần rồi dùng mãi.
Ông T
B.Người làm giao diện web cần ra bản thiết kế đẹp hơn
Bạn làm trang bán hàng cho shop và muốn Claude thiết kế giao diện có gu hơn. Cài skill thiết kế:
npx claude-code-templates@latest --skill creative-design/frontend-designSkill này nằm trong nhóm thiết kế sáng tạo của danh mục. Cài xong, khi bạn nhờ Claude dựng giao diện, nó có thêm chỉ dẫn chuyên về frontend để dựa vào.
C.Nhóm nhỏ cần bộ công cụ làm việc với GitHub và test
Bạn là dev trong nhóm vài người, muốn Claude vừa làm việc với GitHub vừa sinh test. Cài cả bộ trong một lệnh:
npx claude-code-templates@latest \
--agent development-team/frontend-developer \
--command testing/generate-tests \
--mcp integration/github-integrationBạn được một agent frontend, lệnh /generate-tests và kết nối GitHub. Cả nhóm có thể dùng chung một lệnh cài để môi trường giống nhau. Riêng phần MCP GitHub có thể yêu cầu xác thực, bạn xem hướng dẫn trên trang thành phần.
D.Người lo an toàn cho dữ liệu khi dùng AI
Bạn lo Claude vô tình đọc hay lộ thông tin nhạy cảm trong dự án. Danh mục có mod che bí mật (cần Claude Code 2.1.287 trở lên):
npx claude-code-templates@latest --mod security/secret-redactorBạn cũng có thể xem lại các cuộc hội thoại cũ bằng giao diện thân thiện với điện thoại:
npx claude-code-templates@latest --chatsGiao diện mở ở localhost:9876. Theo README, các bảng điều khiển chỉ 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 mở từ thiết bị khác, README hướng dẫn chuyển tiếp cổng qua SSH: ssh -L 9876:localhost:9876 <host>. Còn --analytics mở bảng theo dõi phiên làm việc và mức sử dụng ở localhost:3333.
VI.Lỗi hay gặp và cách xử lý
A.Báo không tìm thấy npx
Máy chưa có Node.js, hoặc terminal chưa nhận. Cài Node.js, đóng rồi mở lại terminal, sau đó chạy lại lệnh. README không ghi phiên bản cụ thể nên nếu lỗi vẫn còn, xem package.json trong repo.
B.Gõ cờ cũ nhưng không chạy
Từ bản 1.31.0, README cho biết nhiều cờ đã bị gỡ: --plugins, --skills-manager, --command-stats, --hook-stats, --mcp-stats, --agents, --chats-mobile, --teams, --2025, --studio, --sandbox, --tunnel, --create-agent, --list-agents, --update-agent, --remove-agent và --clone-session. Nếu bạn dùng theo một bài hướng dẫn cũ, lệnh sẽ in ra cái thay thế. Cứ làm theo gợi ý đó hoặc xem CHANGELOG.
C.Cài mod hoặc plugin mà không chạy
Có thể Claude Code của bạn cũ. Mod cần bản 2.1.287 trở lên, plugin cần 2.1.288 trở lên. Hãy cập nhật Claude Code rồi cài lại.
D.Không biết tên thành phần để gõ
Đừng đoán tên. Dùng --search "từ khoá" hoặc mở trang thành phần trên aitmpl.com, nơi có sẵn đúng lệnh cài. Gõ sai đường dẫn kiểu nhóm/tên là nguyên nhân dễ gặp nhất.
E.Cài xong mà không thấy tác dụng
Thành phần được ghi vào thư mục cấu hình của Claude Code. Hãy chắc rằng bạn chạy lệnh trong đúng thư mục dự án, rồi khởi động lại phiên Claude Code. Dùng --health-check để chẩn đoán thiết lập hiện tại.
VII.Có nên dùng không
Điểm mạnh: danh mục rất lớn, cài bằng một lệnh, không cần cài global, có chỗ xem trước từng file sẽ được ghi, và gộp vào cấu hình cũ thay vì ghi đè. Giấy phép MIT, repo vẫn được cập nhật trong những tháng gần đây. Có thêm công cụ chẩn đoán và xem lại hội thoại ngay trong cùng một CLI.
Giới hạn: hơn 1.980 thành phần nghĩa là chất lượng không đồng đều. README nêu các thành phần đến từ nhiều nguồn khác nhau và mỗi nguồn giữ giấy phép riêng. Việc quét bằng công cụ chỉ là một lớp kiểm tra, không thay cho việc bạn tự đọc. Tư liệu cũng chưa nói rõ phiên bản Node.js tối thiểu. Công cụ chỉ dùng cho Claude Code, không phải cho trợ lý AI khác.
Khi nào nên chọn cách khác: nếu bạn chỉ cần một skill duy nhất từ một repo cụ thể, tự chép file từ repo đó có thể gọn hơn. Nếu bạn cần một quy trình rất riêng của công ty, hãy lấy thành phần trong danh mục làm mẫu rồi sửa lại cho khớp.
Tóm lại: nếu đã dùng Claude Code, đây là nơi đáng ghé đầu tiên để tìm thứ có sẵn trước khi tự viết. Cứ cài từng thành phần một, đọc trước khi cài, rồi tăng dần.
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à chạy bằng npx, README không nhắc đến phí. Tuy nhiên bạn vẫn cần có Claude Code để dùng các thành phần, và tư liệu không nói về chi phí của Claude Code hay các dịch vụ bên ngoài như MCP.
Có cần GPU hay máy mạnh không?
Tư liệu không nhắc đến yêu cầu phần cứng. Công cụ chỉ ghi file cấu hình vào máy bạn nên không cần GPU để chạy chính nó.
Chạy được trên Windows không?
README không nêu riêng hệ điều hành nào. Công cụ chạy bằng npx nên cần Node.js. Trên Windows, bạn nên gõ lệnh nhiều cờ trên một dòng thay vì dùng dấu \ xuống dòng.
Cài thành phần có ghi đè cấu hình Claude Code cũ của tôi không?
Theo README, CLI ghi mỗi file vào đúng chỗ và gộp vào cấu hình hiện có thay vì ghi đè. Công cụ cũng hỏi xác nhận trước khi cài, trừ khi bạn thêm --yes.
Dữ liệu hội thoại của tôi có an toàn không?
README cho biết hai bảng điều khiển (--analytics và --chats) chỉ nghe trên 127.0.0.1, tức chỉ truy cập từ máy bạn, vì chúng phục vụ lịch sử hội thoại. Muốn xem từ thiết bị khác, README hướng dẫn chuyển tiếp cổng qua SSH.
Làm sao biết thành phần nào đáng tin?
README nói mọi pull request được kiểm bằng bộ kiểm tra plugin của Claude Code và quét bằng NVIDIA SkillSpector. Trang thành phần trên aitmpl.com cho bạn xem trước mọi file sẽ được ghi. Tư liệu không cam kết gì thêm, nên bạn vẫn nên tự đọc trước khi cài.
Khác gì tự viết skill hoặc agent cho Claude Code?
Tự viết thì bạn kiểm soát hoàn toàn nhưng tốn công. Repo này cung cấp sẵn hơn 1.980 thành phần để cài ngay và để làm mẫu sửa lại. Tư liệu không so sánh với công cụ cụ thể nào khác.


