# claude-code-templates: cài kho agent, skill, MCP cho Claude Code — hướng dẫn cài đặt và dùng

> claude-code-templates là kho danh mục mở các thành phần cho Claude Code (skill, agent, slash command, hook, MCP, settings, mod…) kèm công cụ dòng lệnh để cài chúng. Bạn chạy bằng npx, không cần cài toàn cục. Cài khá dễ: chỉ một lệnh, nhưng cần đã có Claude Code và terminal.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-07 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/claude-code-templates-kho-skill-agent-mcp-cho-claude-code-2

**claude-code-templates** là một kho danh mục mã nguồn mở, gom hơn 1.980 thành phần cho Claude Code vào một chỗ, kèm công cụ dòng lệnh (CLI) để cài từng thành phần chỉ bằng một lệnh. Hiện repo có khoảng 33.400 sao và khoảng 3.900 fork trên GitHub, giấy phép MIT.

Claude Code được tuỳ biến bằng nhiều file nhỏ: skill, subagent, lệnh gạch chéo (slash command), hook, máy chủ MCP và file cài đặt. Tự viết từng file rất mất công, còn chép từ nơi này sang nơi khác thì dễ đặt sai thư mục hoặc ghi đè cấu hình đang dùng. Repo này giải quyết đúng chuyện đó: bạn chọn thành phần, chạy một lệnh, CLI tự ghi file vào đúng vị trí và gộp với cấu hình hiện có thay vì ghi đè.

Bạn nên đọc bài này nếu đang dùng (hoặc sắp dùng) Claude Code và muốn có sẵn các bộ công cụ do cộng đồng làm: người làm kinh doanh muốn thử tự động hoá, nhân viên văn phòng muốn có skill xử lý tài liệu, lập trình viên mới muốn có agent review code hay sinh test. Điểm đáng giá nhất là bạn không phải cài gì toàn cục: chạy thẳng bằng `npx`, xem trước thành phần trên web rồi mới quyết định cài.

```repo
- repo | davila7/claude-code-templates
- kind | CLI
- desc | Kho mở hơn 1.980 skill, agent, lệnh, hook, MCP cho Claude Code, cài bằng một lệnh npx, tự ghi file đúng chỗ và gộp cấu hình có sẵn.
- stars | 33k
- lang | Python
- license | MIT
```

## claude-code-templates làm được gì

Trước hết là một **danh mục có thể tìm kiếm** tại aitmpl.com. Mỗi thành phần có trang riêng, cho bạn xem trước mọi file nó sẽ ghi vào máy. Nhờ vậy bạn biết rõ mình đang cài gì, chứ không cài mù.

Danh mục hiện gồm các loại chính:

- **Skill** (918 mục): khả năng dùng lại được, ví dụ xử lý PDF, thiết kế giao diện, review code. Lợi ích: Claude biết cách làm một việc theo quy trình có sẵn.
- **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. Lợi ích: giao việc cho đúng chuyên gia thay vì một trợ lý chung chung.
- **Command** (288 mục): lệnh gạch chéo như `/generate-tests`, `/optimize-bundle-size`, `/security-audit`. Lợi ích: gõ một lệnh ngắn thay cho một prompt dài.
- **MCP** (119 mục): kết nối dịch vụ ngoài như GitHub, PostgreSQL, Stripe, Supabase, Sentry.
- **Settings** (80 mục): cấu hình Claude Code như timeout, quyền, thanh trạng thái.
- **Hook** (63 mục): kích hoạt tự động, ví dụ ép commit theo chuẩn hoặc chặn push thẳng.
- **Mod** (50 mục): plugin thay đổi giao diện và hành vi của chính Claude Code, như che bí mật, bảo vệ đường dẫn.
- **Loop** (18 mục): quy trình tự chạy có mục tiêu, chu kỳ và điều kiện dừng.
- Ngoài ra còn Template (14), Sandbox (11, chỉ để tham khảo) và Plugin (1).

Tính năng đáng chú ý khác là **cài cả bộ trong một lệnh**: bạn có thể ghép agent, command và MCP vào cùng một câu lệnh. Mỗi trang thành phần trên web cũng hiện sẵn lệnh cài chính xác, nên bạn chỉ cần sao chép.

CLI còn có ba công cụ chạy trên máy: theo dõi phiên làm việc và số liệu sử dụng (`--analytics`), đọc và tìm lại các cuộc trò chuyện (`--chats`), và chẩn đoán cài đặt Claude Code (`--health-check`). README cho biết hai trang giao diện chỉ lắng nghe ở `127.0.0.1`, tức chỉ máy bạn truy cập được, vì chúng hiển thị lịch sử hội thoại.

Cuối cùng, README nói mọi pull request đều được kiểm tra bằng trình xác thực plugin của Claude Code và quét bằng NVIDIA SkillSpector. Đây là một lớp kiểm soát, nhưng mình sẽ nói thêm ở phần cuối bài về việc vẫn nên tự xem trước.

## Cần chuẩn bị gì

README không có mục yêu cầu hệ thống riêng. Những gì suy ra được từ tư liệu:

- **Claude Code**: các thành phần này dành cho Claude Code, nên bạn cần đã dùng được nó.
- **npx**: README nói chạy bằng `npx`, không cần cài toàn cục. Gói npm tên là `claude-code-templates`. README chưa ghi phiên bản Node.js tối thiểu, bạn xem thêm ở `package.json` trong repo nếu cần. Thông thường `npx` đi kèm npm khi bạn cài Node.js.
- **Phiên bản Claude Code riêng cho vài loại**: README ghi mod cần Claude Code 2.1.287 trở lên, plugin qua marketplace cần 2.1.288 trở lên.
- **API key**: cài thành phần thông thường README không nói cần key. Repo có file `.env.example` với các biến như `GITHUB_TOKEN`, `SUPABASE_URL`, `SENTRY_DSN`…, nhưng đây là cấu hình cho phía phát triển dự án; README không nói bạn phải điền khi chỉ dùng CLI. Riêng các MCP (như GitHub, PostgreSQL) thường cần thông tin đăng nhập của chính dịch vụ đó, hãy đọc trang thành phần tương ứng.
- **Phần cứng**: README không nhắc GPU hay cấu hình đặc biệt.
- **Hệ điều hành**: README không nói rõ. Lệnh `npx` chạy được trên Windows, macOS, Linux nếu có Node.js, nhưng README chưa khẳng định hỗ trợ từng hệ.

## Cài đặt từng bước

```steps
- Mở terminal | Vào thư mục dự án bạn muốn dùng Claude Code
- Duyệt danh mục | Chạy npx để chọn thành phần theo kiểu tương tác
- Cài một thành phần | Dùng cờ --skill, --agent, --command, --mcp… kèm tên
- Cài cả bộ | Ghép nhiều cờ vào một lệnh
- Mở Claude Code | Dùng thành phần vừa cài
```

### Mở terminal đúng chỗ

README không nói cụ thể nên ghi vào thư mục nào. Gợi ý của mình (không phải của README): mở terminal ngay trong thư mục dự án bạn định làm việc với Claude Code. Trên Windows, bạn có thể mở PowerShell hoặc Terminal; trên macOS/Linux mở Terminal. Bạn không cần clone repo về máy.

### Duyệt danh mục và cài tương tác

Cách dễ nhất cho người mới. Lệnh này mở giao diện để bạn chọn:

```bash
npx claude-code-templates@latest
```

`npx` tải và chạy công cụ tức thì, `@latest` để luôn lấy bản mới nhất. Lần đầu có thể mất vài giây để tải. Nếu muốn tìm từ terminal, dùng:

```bash
npx claude-code-templates@latest --search "code review"
```

### Cài một thành phần

Mỗi loại có một cờ riêng. Ví dụ đúng theo README:

```bash
npx claude-code-templates@latest --skill creative-design/frontend-design
```

Phần sau cờ là `nhóm/tên`. Các ví dụ khác cho từng loại:

```bash
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 cần gõ. Tên thành phần bạn không cần nhớ: mở trang thành phần trên aitmpl.com, lệnh chính xác đã có sẵn ở đó. Mặc định CLI hỏi xác nhận; thêm `--yes` để bỏ qua bước hỏi.

### Cài cả một bộ bằng một lệnh

```bash
npx claude-code-templates@latest \
  --agent development-team/frontend-developer \
  --command testing/generate-tests \
  --mcp integration/github-integration
```

Dấu `\` cuối dòng nghĩa là lệnh còn tiếp ở dòng dưới (kiểu bash). Nếu dùng PowerShell, dấu này không hoạt động: hãy gộp tất cả vào một dòng, cách nhau bằng dấu cách.

```note
Mỗi thành phần ghi file vào máy bạn, nhất là hook và MCP có thể chạy lệnh hoặc kết nối dịch vụ ngoài. Hãy xem trước danh sách file trên trang thành phần trước khi cài, và chỉ điền key của dịch vụ nào bạn thật sự dùng.
```

## Kiểm tra đã chạy được chưa

README không mô tả kết quả mong đợi chi tiết, nên mình đưa ra các cách kiểm tra hợp lý dựa trên những gì có trong tư liệu:

- **Chạy chẩn đoán**: README có lệnh để kiểm tra cài đặt Claude Code và thiết lập dự án.

```bash
npx claude-code-templates@latest --health-check
```

- **Mở Claude Code trong cùng thư mục** và thử gọi thành phần vừa cài. Ví dụ nếu cài lệnh `testing/generate-tests`, README cho biết nó xuất hiện dưới dạng lệnh gạch chéo `/generate-tests`.
- **Với mod**: README gợi ý dùng mod xem ngăn xếp (stack viewer) để xem mỗi phạm vi đang cài gì: cài bằng `--mod ui/stack-viewer`, rồi gõ `/stack` trong Claude Code.

Nếu CLI báo lỗi hoặc không thấy thành phần, xem phần lỗi thường gặp bên dưới.

## Dùng vào việc thật

### Chủ shop muốn có trợ lý review và kiểm thử cho website bán hàng

Bạn có một website nhỏ do thuê người làm, giờ tự chỉnh sửa với Claude Code. Cài bộ gồm agent frontend, lệnh sinh test và kết nối GitHub bằng lệnh cài cả bộ ở trên. Sau đó trong Claude Code, bạn gõ `/generate-tests` để nhờ nó viết bài kiểm thử cho phần vừa sửa. Kết quả: có thêm file test mà không phải tự viết, và bạn biết sửa xong có làm hỏng chỗ khác không.

> Đừng tự viết từng file cấu hình cho Claude Code: chọn thứ cộng đồng đã làm, xem trước, rồi cài bằng một lệnh.
>
> — Ông T

### Nhân viên văn phòng cần xử lý tài liệu

Bạn hay phải đọc và trích dữ liệu từ PDF. Danh mục có nhóm skill xử lý PDF (README nêu làm ví dụ). Dùng ô tìm kiếm trên aitmpl.com hoặc lệnh `--search` để tìm skill phù hợp, xem trang của nó, rồi cài bằng cờ `--skill`. Kết quả: Claude có quy trình sẵn để xử lý PDF, bạn chỉ cần nói yêu cầu bằng tiếng thường. Tên chính xác của skill bạn lấy từ trang thành phần, vì README không liệt kê hết.

### Lập trình viên mới muốn kiểm soát chất lượng commit

Bạn đang tập làm việc nhóm và hay quên quy ước viết commit. Cài hook `git/conventional-commits`:

```bash
npx claude-code-templates@latest --hook git/conventional-commits
```

Kết quả: tự động hoá việc theo chuẩn commit khi dùng Claude Code. Bạn cũng có thể thêm agent `development-tools/code-reviewer` để nhờ review code trước khi đẩy lên.

### Người cần bảo vệ thông tin nhạy cảm khi dùng Claude Code

Nếu thư mục dự án có file chứa khoá hay mật khẩu, bạn có thể cài mod che bí mật (cần Claude Code 2.1.287 trở lên):

```bash
npx claude-code-templates@latest --mod security/secret-redactor
```

Kết quả: thêm một lớp bảo vệ theo mô tả của mod. Hãy đọc kỹ trang mod để biết chính xác nó che những gì, đừng coi đó là bảo đảm tuyệt đối.

## Lỗi hay gặp và cách xử lý

**Lỗi không tìm thấy `npx` hoặc `npm`.** Máy bạn chưa cài Node.js. Cài Node.js từ trang chính thức, mở lại terminal rồi chạy lại. Phiên bản tối thiểu README không ghi, xem `package.json` trong repo.

**Lệnh nhiều dòng bị lỗi trên Windows.** Dấu `\` cuối dòng chỉ dùng được trong bash. Trong PowerShell, viết toàn bộ lệnh trên một dòng.

**Gõ cờ cũ nhưng bị báo đã bị xoá.** README nói nhiều cờ như `--plugins`, `--agents`, `--sandbox`, `--tunnel`, `--create-agent` đã bị gỡ ở bản 1.31.0. Khi chạy chúng, công cụ in ra cái thay thế. Nếu bạn làm theo hướng dẫn cũ trên mạng mà gặp lỗi này, hãy dùng các cờ trong bài này hoặc xem CHANGELOG.

**Cài mod hoặc plugin nhưng không chạy.** Hai loại này cần Claude Code từ 2.1.287 (mod) và 2.1.288 (plugin). Cập nhật Claude Code lên phiên bản mới hơn rồi thử lại.

**Thành phần cài rồi nhưng không thấy trong Claude Code.** Hãy chắc bạn mở Claude Code đúng thư mục bạn đã chạy lệnh cài, thử khởi động lại phiên làm việc, và chạy `--health-check` để xem chẩn đoán. Nếu vẫn lỗi, tìm trong mục Discussions hoặc tài liệu tại docs.aitmpl.com.

## Có nên dùng không

**Điểm mạnh.** Cài nhanh bằng một lệnh, không cần cài toàn cục. Danh mục lớn và có trang xem trước từng file. CLI gộp cấu hình có sẵn thay vì ghi đè. Giấy phép MIT, repo vẫn được cập nhật trong vài tháng gần đây. Mỗi pull request có kiểm tra bằng công cụ xác thực và quét bảo mật.

**Giới hạn.** Đây là một kho tổng hợp, nên chất lượng từng thành phần không đồng đều: nhiều mục đến từ các nguồn khác nhau (README liệt kê các nguồn và giấy phép gốc). Kiểm tra tự động không thay được việc bạn tự đọc nội dung trước khi cài, nhất là hook và MCP. README cũng chưa ghi yêu cầu Node.js hay danh sách hệ điều hành hỗ trợ. Và nếu bạn không dùng Claude Code, repo này không dành cho bạn.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần một skill duy nhất, có thể lấy thẳng từ repo nguồn của nó. Nếu bạn dùng công cụ AI khác, các thành phần này không áp dụng được. Còn nếu bạn mới bắt đầu, hãy thử cài một thành phần nhỏ trước, xem nó ghi gì vào máy, rồi mới cài cả bộ.

## 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 nói tới phí nào cho CLI. Tuy nhiên bạn vẫn cần dùng được Claude Code, và một số MCP kết nối tới dịch vụ ngoài có thể có chi phí riêng. Chuyện đó nằm ngoài tư liệu của repo.

### Có cần cài đặt toàn cục hay clone repo về không?

Không. README ghi rõ 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 kèm các cờ cần dùng.

### Có cần GPU hay máy mạnh không?

README không nhắc yêu cầu phần cứng nào. Đây là công cụ ghi file cấu hình, nên chưa có thông tin cho thấy cần GPU.

### Chạy trên Windows được không?

README không nêu rõ danh sách hệ điều hành hỗ trợ. Lệnh npx nói chung chạy được nếu có Node.js, nhưng chưa có khẳng định chính thức. Trên PowerShell, nhớ viết lệnh nhiều dòng thành một dòng.

### Dữ liệu và hội thoại của tôi có an toàn không?

README cho biết hai giao diện cục bộ (analytics và chats) chỉ lắng nghe ở 127.0.0.1, vì chúng phục vụ lịch sử hội thoại của bạn. Mỗi pull request vào kho còn được kiểm tra bằng trình xác thực plugin và NVIDIA SkillSpector. Dù vậy bạn nên tự xem trước file của từng thành phần trước khi cài.

### Nó khác gì việc tự viết skill hay agent cho Claude Code?

Repo cung cấp sẵn hơn 1.980 thành phần để tìm kiếm, xem trước và cài bằng một lệnh, và tự ghi file đúng chỗ, gộp với cấu hình hiện có. Tự viết cho bạn toàn quyền kiểm soát nhưng tốn công hơn. README chưa so sánh trực tiếp với công cụ khác.

### Một số cờ lệnh cũ không chạy, phải làm sao?

README cho biết nhiều cờ đã bị gỡ ở bản 1.31.0 (như --plugins, --agents, --sandbox). Khi chạy chúng, công cụ sẽ in ra cái thay thế. Chi tiết nằm trong CHANGELOG của repo.
