# claude-plugins-official: kho plugin chính thức cho Claude Code — hướng dẫn cài đặt và dùng

> claude-plugins-official là kho plugin chính thức của Anthropic dành cho Claude Code, nơi chứa các plugin do Anthropic phát triển và một số plugin bên thứ ba. Bạn dùng nó để thêm lệnh, agent, skill hoặc MCP server vào Claude Code bằng lệnh /plugin install. Cài không khó, chỉ cần đã có Claude Code và gõ lệnh trong đó.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-15 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/claude-plugins-official-kho-plugin-chinh-thuc-claude-code-2

**claude-plugins-official** là kho plugin chính thức của Anthropic dành cho Claude Code. Nó đóng vai trò một "cửa hàng ứng dụng" (marketplace): bạn chọn plugin trong đó, gõ một lệnh, và Claude Code có thêm khả năng mới. Hiện repo có khoảng 47.095 sao và 4.887 fork, giấy phép Apache-2.0.

Vấn đề repo giải quyết khá đơn giản. Claude Code tự nó đã làm được nhiều việc, nhưng mỗi người cần một bộ công cụ riêng: thêm lệnh gạch chéo, thêm agent chuyên việc, thêm skill, hay nối với dịch vụ bên ngoài qua MCP. Thay vì tự đi tìm và ghép từng thứ, bạn lấy chúng từ một nơi có tên tuổi rõ ràng.

Bài này hợp với người đã dùng (hoặc sắp dùng) Claude Code và muốn mở rộng nó: dân văn phòng thích tự động hoá, chủ shop nhỏ muốn trợ lý làm được nhiều việc hơn, và lập trình viên mới. Điểm đáng giá nhất là cách cài rất ngắn, một dòng lệnh. Điểm cần nhớ là bạn phải tự cân nhắc mức độ tin cậy của từng plugin trước khi cài.

```repo
- repo | anthropics/claude-plugins-official
- kind | Plugin
- desc | Kho (marketplace) plugin chính thức do Anthropic quản lý cho Claude Code: cài thêm lệnh, agent, skill và MCP server chỉ bằng một dòng /plugin install.
- stars | 47k
- lang | Python
- license | Apache-2.0
```

## claude-plugins-official làm được gì

Repo này không phải một công cụ đơn lẻ. Nó là danh mục plugin kèm mã nguồn của các plugin do Anthropic làm. Các phần chính:

### Thư mục plugin do Anthropic phát triển

Thư mục `/plugins` chứa các plugin do chính đội ngũ Anthropic làm và duy trì. Lợi ích thực tế: đây là nhóm có nguồn gốc rõ nhất, và theo README, mọi thư mục trong đó đều được kiểm tra trên từng pull request. Nếu bạn lo về độ tin cậy, nên bắt đầu từ nhóm này.

### Thư mục plugin bên ngoài và plugin kênh chat

Thư mục `/external_plugins` chứa các plugin của bên thứ ba được thêm vào trước khi việc nộp plugin chuyển sang trang quản lý riêng. Ở đây còn có các plugin "kênh" của Anthropic: Discord, fakechat, iMessage và Telegram. README chỉ nêu tên bốn plugin này, chưa mô tả chi tiết cách dùng, nên bạn đọc README của từng plugin trong thư mục để biết thêm.

### Cài bằng một lệnh hoặc duyệt trong giao diện

Bạn có thể cài trực tiếp bằng `/plugin install` hoặc mở `/plugin` rồi vào mục Discover để duyệt. Người ngại gõ lệnh sẽ thấy cách duyệt dễ hơn.

### Một plugin có thể gồm nhiều loại thành phần

Theo README, mỗi plugin có thể gồm: metadata (bắt buộc), cấu hình MCP server, các lệnh gạch chéo, các định nghĩa agent và các skill. Nghĩa là một lần cài có thể mang về cả một bộ công cụ chứ không chỉ một thứ lẻ.

### Plugin mẫu để học làm plugin

Nếu bạn muốn tự viết plugin, README chỉ tới `/plugins/example-plugin` làm bản tham khảo chuẩn.

### Hỗ trợ gói skill

README mô tả cách khai báo một "skill-bundle": khi một repo khác có sẵn các file `SKILL.md` nhưng không có file manifest, kho có thể khai báo trực tiếp các skill đó. Phần này chủ yếu dành cho người làm plugin, người dùng thường không cần để ý.

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

Tư liệu repo nói rất ít về yêu cầu hệ thống, nên mình chỉ ghi những gì có căn cứ:

- **Claude Code**: bạn cần có Claude Code vì kho này hoạt động qua hệ thống plugin của nó. README không hướng dẫn cài Claude Code, bạn xem tài liệu chính thức tại https://code.claude.com/docs/en/plugins.
- **Hệ điều hành, phiên bản Node/Python, phần cứng**: README chưa ghi. Yêu cầu cụ thể (nếu có) nằm trong README của từng plugin.
- **Tài khoản, API key**: README của kho chưa nói. Mỗi plugin có thể cần thông tin riêng, đặc biệt các plugin nối dịch vụ ngoài. Hãy đọc trang chủ của plugin đó.

```note
Anthropic cảnh báo rõ trong README: hãy chắc chắn bạn tin tưởng plugin trước khi cài, cập nhật hay dùng. Anthropic không kiểm soát các MCP server, file hay phần mềm đi kèm plugin, và không thể đảm bảo chúng chạy đúng ý hoặc không thay đổi về sau.
```

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

```steps
- Mở Claude Code | Vào phiên làm việc của Claude Code trong terminal
- Duyệt plugin | Gõ /plugin rồi chọn Discover để xem danh sách
- Chọn plugin | Đọc mô tả và trang chủ của plugin bạn quan tâm
- Cài plugin | Gõ /plugin install {tên-plugin}@claude-plugins-official
- Dùng thử | Gọi lệnh hoặc skill mà plugin cung cấp
```

### Mở Claude Code

Kho này không cần tải về bằng tay. Bạn chỉ cần đang ở trong một phiên Claude Code. Các lệnh bắt đầu bằng dấu gạch chéo là lệnh gõ **bên trong Claude Code**, không phải gõ vào terminal thường. Đây là chỗ người mới hay nhầm: nếu gõ `/plugin` ngay ở PowerShell hay Terminal bình thường thì sẽ không chạy.

README chưa ghi cách cài Claude Code. Bạn xem hướng dẫn tại tài liệu chính thức ở trang chủ dự án.

### Duyệt danh sách plugin

Trong Claude Code, bạn gõ:

```bash
/plugin
```

Sau đó vào mục Discover để xem các plugin có sẵn. README viết cách này là `/plugin > Discover`. Bạn đọc mô tả từng plugin, ghi lại tên chính xác của cái muốn cài.

### Cài plugin

Lệnh cài theo đúng README:

```bash
/plugin install {plugin-name}@claude-plugins-official
```

Bạn thay `{plugin-name}` bằng tên plugin thật, bỏ luôn cặp ngoặc nhọn. Phần `@claude-plugins-official` là tên kho, cho Claude Code biết lấy plugin từ đâu. Tên plugin phải khớp từng chữ, vì README nhấn mạnh tên (`name`) là mã định danh cố định. Nếu gõ sai tên, bạn sẽ gặp lỗi không tìm thấy plugin.

### Xem README của plugin vừa cài

Mỗi plugin theo cấu trúc chuẩn có file README riêng. Sau khi cài, hãy đọc README đó để biết plugin đưa vào những lệnh, agent hay skill nào, và có cần cấu hình thêm gì không. Kho chung chỉ giúp cài, còn cách dùng cụ thể do từng plugin quyết định.

### Nếu bạn muốn xem mã nguồn trước khi cài

Đây là bước tuỳ chọn, rất nên làm với người cẩn thận. Bạn có thể tải kho về để đọc:

```bash
git clone https://github.com/anthropics/claude-plugins-official.git
cd claude-plugins-official
```

Lệnh đầu tải bản sao của kho về máy. Lệnh thứ hai đi vào thư mục vừa tải. Bạn cần cài Git trước. Trong đó, `plugins/` và `external_plugins/` là nơi chứa từng plugin, còn `.claude-plugin/` chứa danh mục khai báo.

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

README không mô tả màn hình "thành công" cụ thể, nên mình đưa ra cách kiểm tra hợp lý dựa trên những gì tư liệu nói:

1. Sau khi chạy `/plugin install ...`, Claude Code không báo lỗi như plugin-not-found.
2. Mở lại `/plugin` để xem plugin đã xuất hiện trong danh sách bạn đã cài hay chưa.
3. Thử gọi một lệnh, agent hoặc skill mà README của plugin đó nói là có. Nếu gọi được, coi như đã chạy.

Nếu báo lỗi không tìm thấy, kiểm tra lại tên plugin có đúng từng chữ không.

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

Vì kho chứa nhiều plugin khác nhau, các tình huống dưới đây là cách dùng chung của kho. Mình không nêu tên plugin cụ thể nào ngoài những cái README có nhắc.

### Dev mới muốn tìm công cụ hợp với dự án

Bạn vừa bắt đầu đi làm, sếp dùng Claude Code. Thay vì lên mạng tìm lung tung, bạn mở Claude Code, gõ `/plugin`, vào Discover và đọc danh sách. Chọn plugin có mô tả sát việc của bạn, rồi cài bằng `/plugin install {tên}@claude-plugins-official`. Kết quả: bạn có thêm lệnh hoặc skill mới trong vài chục giây, từ nguồn chính thức.

> Trước khi cài, hãy đọc mô tả và trang chủ của plugin. Một phút đọc có thể tránh cả buổi gỡ rối.
>
> — Ông T

### Người muốn nhắn tin với Claude qua ứng dụng chat

README cho biết trong `/external_plugins` có các plugin kênh của Anthropic cho Discord, fakechat, iMessage và Telegram. Nếu bạn quen trao đổi qua một trong các nền tảng đó, hãy mở thư mục tương ứng trong repo, đọc README của plugin, rồi cài theo cú pháp chuẩn. Phần cấu hình chi tiết (như token) mình không có trong tư liệu nên bạn làm theo hướng dẫn của chính plugin.

### Người tò mò muốn tự viết plugin cho đội mình

Bạn là dev trong một công ty nhỏ, muốn đóng gói quy trình nội bộ thành lệnh dùng chung. Hãy mở `/plugins/example-plugin` làm mẫu. Cấu trúc README mô tả gồm `.claude-plugin/plugin.json` (bắt buộc), và tuỳ chọn thêm `.mcp.json`, `commands/`, `agents/`, `skills/`. Bạn sao chép khung này, sửa thành nội dung của mình. Kết quả là một plugin theo đúng chuẩn mà Claude Code đọc được.

### Người đã có plugin riêng và muốn đưa lên danh mục

README nói rõ: plugin bên thứ ba nay nộp tại claude.ai/directory/manage, còn pull request vào repo này không được theo dõi. Vậy nếu bạn làm plugin hay, đừng mở pull request ở đây. Hãy dùng trang quản lý đó, và plugin được chấp nhận sẽ được phục vụ trên các sản phẩm Claude.

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

### Gõ lệnh /plugin vào terminal thường

Lệnh này chỉ có tác dụng bên trong Claude Code. Hãy mở Claude Code trước rồi mới gõ.

### Báo plugin-not-found

Thường do gõ sai tên. README nói tên plugin là mã định danh cố định và cài sai tên sẽ báo lỗi `plugin-not-found`. Hãy mở `/plugin > Discover` để sao chép đúng tên. Nếu plugin đã cài từ trước bằng tên cũ và vừa bị đổi tên, README cho biết kho có cơ chế tự chuyển sang tên mới ở lần đồng bộ kế tiếp.

### Quên giữ nguyên cặp ngoặc nhọn trong lệnh mẫu

Trong README, `{plugin-name}` chỉ là chỗ điền. Bạn thay cả cụm bằng tên plugin, ví dụ không còn dấu ngoặc nhọn. Phần `@claude-plugins-official` giữ nguyên.

### Plugin cài xong nhưng không thấy chạy như mong đợi

Anthropic nói họ không thể đảm bảo plugin chạy đúng ý hay không thay đổi về sau. Hãy đọc README và trang chủ của plugin đó, kiểm tra xem có bước cấu hình nào bạn chưa làm, và nếu cần thì gỡ plugin đi.

### Mở pull request hy vọng được thêm plugin

Pull request vào repo này không được theo dõi. Hãy nộp plugin qua trang quản lý mà README chỉ.

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

**Điểm mạnh.** Đây là nguồn chính thức nên dễ tin hơn việc tải plugin vô danh. Cài chỉ cần một dòng lệnh hoặc duyệt trong giao diện. Cấu trúc plugin được chuẩn hoá nên dễ học theo. Repo vẫn được cập nhật trong vài tháng gần đây, và có plugin mẫu cho người muốn tự làm.

**Giới hạn.** Kho này không tự làm việc gì thay bạn, nó chỉ là nơi phân phối. Chất lượng và độ an toàn phụ thuộc từng plugin. README cảnh báo thẳng rằng Anthropic không kiểm soát mọi thứ đi kèm plugin. Ngoài ra, danh mục đang thay đổi: plugin bên thứ ba chuyển sang nộp ở nơi khác, và file `marketplace.json` đang được thu gọn dần về plugin của Anthropic, nên danh sách bạn thấy có thể khác theo thời gian.

**Khi nên chọn cách khác.** Nếu bạn không dùng Claude Code thì kho này không dành cho bạn. Nếu bạn cần một plugin của bên thứ ba mới, hãy tìm ở nơi tác giả plugin hướng dẫn, vì kho này không còn là điểm nộp. Nếu việc bạn cần chỉ là một đoạn prompt đơn giản, không cần cài plugin làm gì.

Tóm lại: đã dùng Claude Code thì đây là nơi nên ghé đầu tiên khi muốn mở rộng, miễn là bạn đọc kỹ từng plugin trước khi cài.

## Câu hỏi thường gặp

### claude-plugins-official có miễn phí không?

Repo dùng giấy phép Apache-2.0, nên bạn xem và dùng mã nguồn được. Tư liệu chưa nói gì về chi phí của Claude Code hay từng plugin. Giấy phép riêng của mỗi plugin nằm trong chính plugin đó, README yêu cầu xem từng LICENSE.

### Cài plugin bằng lệnh nào?

Trong Claude Code, gõ /plugin install {plugin-name}@claude-plugins-official, thay phần trong ngoặc bằng tên plugin. Hoặc gõ /plugin rồi vào Discover để duyệt và chọn. Lệnh này gõ trong Claude Code, không phải terminal thường.

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

README chưa ghi yêu cầu phần cứng nào. Nếu một plugin cụ thể có yêu cầu riêng, thông tin đó nằm ở README hoặc trang chủ của plugin ấy.

### Cài plugin có an toàn không?

Anthropic khuyến cáo bạn phải tin tưởng plugin trước khi cài, cập nhật hay dùng. Họ không kiểm soát các MCP server, file hay phần mềm đi kèm và không thể đảm bảo chúng không thay đổi. Hãy đọc trang chủ của từng plugin trước.

### Tôi muốn nộp plugin của mình thì làm thế nào?

Theo README, plugin bên thứ ba được nộp và quản lý tại claude.ai/directory/manage. Đừng mở pull request vào repo này vì không ai theo dõi. Plugin được chấp nhận sẽ được phục vụ trên các sản phẩm Claude.

### Khác gì so với tự viết plugin từ đầu?

Repo là nơi phân phối và chứa các plugin dựng sẵn do Anthropic làm, cài bằng một lệnh. Nếu muốn tự viết, bạn vẫn có thể lấy /plugins/example-plugin làm mẫu tham khảo. Tư liệu chưa so sánh sâu hơn với công cụ khác.

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

Tư liệu của repo chưa nói rõ về hệ điều hành. Khả năng chạy phụ thuộc vào Claude Code và từng plugin, nên bạn xem tài liệu chính thức ở trang chủ dự án và README của plugin.
