claude-plugins-official: kho plugin chính thức 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ề anthropics/claude-plugins-official — 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-plugins-official: kho plugin chính thức cho Claude Code — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
claude-plugins-official là kho (marketplace) plugin chính thức của Anthropic dành cho Claude Code. Qua kho này bạn cài thêm slash command, agent, skill hoặc MCP server bằng lệnh /plugin install. Cài rất nhanh vì không cần tải code về tay, nhưng bạn phải tự cân nhắc mức tin cậy của từng plugin.
Repo này là kho plugin chính thức của Anthropic cho Claude Code. Nói đơn giản: nó giống một «cửa hàng ứng dụng» nhỏ nằm ngay trong Claude Code. Bạn mở danh sách, chọn plugin, gõ một dòng lệnh là cài xong. Mỗi plugin có thể mang theo slash command, agent, skill hoặc cấu hình MCP server để Claude làm được thêm việc.
Ai nên quan tâm? Bất kỳ ai đã dùng Claude Code và muốn nó làm nhiều hơn mặc định: nhân viên văn phòng muốn có sẵn các bộ lệnh dùng lại, lập trình viên mới muốn xem plugin chuẩn viết ra sao, hay người muốn nối Claude với kênh chat. Repo hiện có khoảng 47.095 sao và khoảng 4.887 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong vài tháng gần đây.
Điểm đáng giá nhất là tính «chính chủ»: thư mục plugins chứa plugin do chính đội Anthropic làm, và có sẵn một plugin mẫu (example-plugin) để bạn học cách tự viết. Bài này mình hướng dẫn cách dùng kho, không đi sâu vào từng plugin riêng lẻ, vì mỗi plugin có trang hướng dẫn riêng.
anthropics/claude-plugins-official
Kho plugin chính thức do Anthropic quản lý cho Claude Code: duyệt và cài thêm lệnh, agent, skill, MCP server chỉ bằng một dòng lệnh /plugin.
I.Kho plugin này làm được gì
Repo không phải một công cụ đơn lẻ. Nó là nơi chứa và liệt kê nhiều plugin. Những thứ bạn nhận được:
- Cài plugin bằng một lệnh. Bạn gõ
/plugin installkèm tên plugin và tên kho, không phải tải file hay chép thư mục thủ công. Với người mới, đây là chỗ tiết kiệm công nhất. - Duyệt trong giao diện. Mục
/plugin > Discovercho bạn xem plugin có sẵn mà không cần nhớ tên. Hợp với người chưa biết mình cần gì. - Plugin do Anthropic làm (thư mục
plugins). Đây là nhóm plugin nội bộ, được Anthropic duy trì. Mỗi thư mục trong đó được kiểm tra mỗi khi có pull request, nên chất lượng ổn định hơn so với plugin lạ trên mạng. - Plugin bên thứ ba và plugin kênh chat (thư mục
external_plugins). Gồm các plugin của bên ngoài được thêm trước khi việc nộp bài chuyển sang trang riêng, cùng các plugin kênh của Anthropic: Discord, fakechat, iMessage và Telegram. - Plugin mẫu để học. README chỉ bạn xem
plugins/example-pluginnhư bản tham chiếu. Nếu bạn muốn tự làm plugin, đây là chỗ bắt đầu. - Gói skill. Nếu một repo khác có sẵn các file
SKILL.mdnhưng chưa có manifest plugin, kho cho phép khai báo trực tiếp danh sách skill (chế độstrict: false). Phần này chủ yếu dành cho người làm kho. - Cơ chế đổi tên an toàn. Tên plugin là «slug» không được đổi. Nếu buộc phải đổi, có bảng
renamesđể máy người dùng tự chuyển sang tên mới.
Một điều cần biết về hướng đi của kho: README cho biết mọi plugin giờ được nộp qua trang quản lý của Claude, và file marketplace.json sẽ dần thu gọn về chỉ còn plugin của Anthropic. Pull request gửi vào repo này không được theo dõi.
II.Cần chuẩn bị gì
Tư liệu của repo nói khá ít, nên mình chỉ liệt kê những gì có thật:
- Claude Code. Đây là điều kiện chính. Kho này là marketplace dành cho Claude Code, và lệnh cài chạy trong Claude Code.
- Quyền chạy lệnh
/plugin. Đây là lệnh của hệ thống plugin trong Claude Code.
Những thứ README chưa ghi: hệ điều hành cụ thể, phiên bản Node hay Python, yêu cầu phần cứng, tài khoản hay API key. Ngôn ngữ chính của repo là Python, nhưng bạn không cần cài Python chỉ để cài plugin từ kho theo README. Một số plugin riêng lẻ có thể cần thêm thứ khác (ví dụ MCP server cần key). Khi đó hãy xem trang chủ hoặc README của chính plugin đó.
Nếu bạn chưa có Claude Code, README của repo này không hướng dẫn cài. Hãy xem tài liệu chính thức tại trang https://code.claude.com/docs/en/plugins, là trang chủ dự án mà tác giả ghi.
Trước khi cài bất kỳ plugin nào, hãy đọc kỹ cảnh báo của chính repo: Anthropic không kiểm soát được MCP server, file hay phần mềm đi kèm plugin, cũng không đảm bảo chúng chạy đúng ý hoặc không bị thay đổi về sau. Chỉ cài plugin bạn tin tưởng và xem trang chủ của plugin đó trước.
III.Cài đặt từng bước
Vì đây là kho chứ không phải một chương trình, «cài đặt» ở đây nghĩa là cài một plugin từ kho vào Claude Code của bạn. Bạn không cần clone repo về máy.
- Mở Claude CodeKhởi động Claude Code như bình thường
- Duyệt pluginDùng /plugin rồi chọn Discover để xem danh sách
- Chọn tên pluginGhi lại tên (slug) của plugin bạn muốn
- Chạy lệnh cài/plugin install tên-plugin@claude-plugins-official
- Đọc hướng dẫn của pluginXem README/trang chủ plugin để biết cách dùng
A.Mở Claude Code
Các lệnh bắt đầu bằng dấu / được gõ bên trong Claude Code, vào ô nhập chat của nó. Chúng không phải lệnh của PowerShell hay Terminal thông thường. Đây là chỗ người mới hay nhầm: nếu gõ /plugin thẳng vào cửa sổ dòng lệnh bình thường thì sẽ không chạy.
README không hướng dẫn cách mở hay cài Claude Code, nên bước này bạn làm theo tài liệu chính thức của Claude Code.
B.Duyệt plugin trong Discover
Nếu chưa biết cần plugin nào, bạn dùng giao diện duyệt. README ghi cách làm là mở /plugin rồi vào mục Discover:
/plugin > DiscoverBạn sẽ thấy danh sách plugin có sẵn. Hãy đọc mô tả từng cái, và nhớ tên của plugin bạn chọn.
C.Cài bằng một dòng lệnh
Khi đã biết tên, bạn chạy lệnh cài. Dưới đây là đúng cú pháp trong README:
/plugin install {plugin-name}@claude-plugins-officialPhần {plugin-name} là chỗ bạn thay bằng tên plugin thật, và bạn bỏ luôn cặp ngoặc nhọn. Phần @claude-plugins-official là tên kho này, báo cho Claude Code biết lấy plugin từ đâu. Đừng sửa phần đó.
Ví dụ về cách điền (chỉ minh hoạ cú pháp, ten-plugin-cua-ban là tên giả): /plugin install ten-plugin-cua-ban@claude-plugins-official. Tên thật bạn lấy từ danh sách Discover.
D.Đọc hướng dẫn riêng của plugin
Mỗi plugin có cấu trúc riêng: có thể kèm lệnh gạch chéo, agent, skill hoặc MCP server. README của kho chỉ nói cấu trúc chung, không nói từng plugin dùng thế nào. Vì vậy sau khi cài, hãy mở trang chủ hoặc README của plugin để biết lệnh nào mới xuất hiện và có cần điền thông tin gì không.
Cấu trúc chung của một plugin theo README:
plugin-name/
├── .claude-plugin/
│ └── plugin.json # Plugin metadata (required)
├── .mcp.json # MCP server configuration (optional)
├── commands/ # Slash commands (optional)
├── agents/ # Agent definitions (optional)
├── skills/ # Skill definitions (optional)
└── README.md # DocumentationIV.Kiểm tra đã chạy được chưa
README của repo không mô tả màn hình hay thông báo cụ thể khi cài thành công, nên mình không bịa ra kết quả mong đợi. Bạn có thể tự kiểm tra theo cách an toàn sau:
- Lệnh
/plugin install ...chạy xong mà không báo lỗi (ví dụ không có lỗiplugin-not-found). - Mở lại
/pluginđể xem plugin đã xuất hiện chưa. Nếu giao diện có phần liệt kê plugin đã cài, bạn sẽ thấy nó ở đó. - Làm theo ví dụ trong README của plugin vừa cài. Nếu plugin có thêm slash command, thử gõ
/để xem lệnh mới có hiện ra không.
Nếu bước 2 và 3 không thấy gì, quay lại phần lỗi hay gặp bên dưới.
V.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 xoay quanh những việc kho thật sự hỗ trợ. Mình không mô tả tính năng của từng plugin cụ thể, vì tư liệu không nêu.
Kho này không bắt bạn học thêm công cụ mới. Nó chỉ cho Claude Code thêm đồ nghề, bằng một dòng lệnh.
Ông T
A.Người mới tò mò, muốn xem Claude Code mở rộng được gì
Bạn là nhân viên văn phòng vừa dùng Claude Code được vài hôm. Bạn chưa biết nên cài gì. Cách làm: mở Claude Code, gõ /plugin, vào Discover, đọc từng mô tả. Chọn một plugin có phần mô tả khớp việc của bạn, rồi cài bằng /plugin install {plugin-name}@claude-plugins-official.
Kết quả bạn nhận được là Claude Code có thêm khả năng mà plugin đó mang theo (lệnh, agent hoặc skill). Bạn thử từng cái một, đừng cài hàng loạt cùng lúc, để biết cái nào có ích.
B.Lập trình viên muốn tự viết plugin cho công ty
Bạn là dev muốn đóng gói quy trình của nhóm thành plugin. README chỉ thẳng chỗ học: xem plugins/example-plugin làm bản tham chiếu. Cách làm: tạo thư mục plugin theo đúng cấu trúc ở trên, bắt buộc phải có .claude-plugin/plugin.json, còn commands/, agents/, skills/, .mcp.json thì tuỳ chọn.
Kết quả là một plugin có cấu trúc chuẩn. Muốn hiểu sâu hơn về cách viết, hãy đọc tài liệu chính thức về plugin của Claude Code. README kho này không giải thích chi tiết từng trường trong plugin.json.
C.Người muốn Claude liên lạc qua kênh chat
Thư mục external_plugins có các plugin kênh của Anthropic: Discord, fakechat, iMessage và Telegram. Nếu bạn muốn nối Claude Code với một kênh như vậy, hãy tìm đúng plugin trong Discover và đọc README của nó để biết cần thiết lập gì.
Tư liệu của repo không nói các plugin này cần token hay quyền gì, nên mình không đoán. Nguyên tắc an toàn: khi một plugin đòi quyền truy cập tài khoản chat, hãy đọc kỹ nó sẽ làm gì trước khi đồng ý.
D.Người làm kho nội bộ muốn gom skill sẵn có
Giả sử đội bạn đã có một repo chứa nhiều file SKILL.md nhưng chưa có manifest plugin. README mô tả cách khai báo gói skill trong marketplace với strict: false và danh sách skills. Mỗi đường dẫn trỏ tới thư mục có SKILL.md:
{
"name": "example-bundle",
"description": "Brief description of the bundled skills.",
"author": { "name": "Author Name" },
"category": "development",
"source": {
"source": "git-subdir",
"url": "https://github.com/example-org/sdk.git",
"path": "packages/agent-skills",
"ref": "main",
"sha": "<commit sha>"
},
"strict": false,
"skills": [
"./skill-a",
"./skill-b",
"./skill-c"
],
"homepage": "https://github.com/example-org/sdk"
}Đường dẫn trong skills tính từ source.path, có thể sâu hơn một cấp (ví dụ ./libA/skill-1) để chọn một phần skill từ nhiều thư mục. Đây là ví dụ mẫu của README, bạn thay bằng thông tin repo của mình. Lưu ý: README nói file marketplace.json của kho này đang được thu gọn, nên nếu bạn muốn phát hành plugin công khai, hãy nộp qua trang quản lý của Claude thay vì gửi pull request.
VI.Lỗi hay gặp và cách xử lý
A.Gõ /plugin mà không có gì xảy ra
Có thể bạn đang gõ vào terminal thường thay vì bên trong Claude Code. Hãy mở Claude Code trước, rồi gõ lệnh vào khung chat của nó. Nếu vẫn không nhận lệnh, kiểm tra Claude Code của bạn có phải bản hỗ trợ hệ thống plugin không. README chưa nêu số phiên bản tối thiểu nên bạn xem tài liệu chính thức.
B.Lệnh cài báo lỗi plugin-not-found
Đây là lỗi README có nhắc tới: nó xảy ra khi tên plugin (slug) không còn đúng, ví dụ plugin đã bị đổi tên. Cũng có thể bạn gõ sai tên hoặc quên bỏ cặp ngoặc nhọn quanh {plugin-name}. Cách xử lý an toàn: mở lại /plugin > Discover, chép đúng tên đang hiển thị rồi cài lại.
C.Plugin cài rồi nhưng chưa dùng được
Một số plugin kèm MCP server hoặc cần thiết lập thêm, và README kho không liệt kê yêu cầu của từng cái. Hãy mở trang chủ hoặc README của chính plugin đó để xem có cần điền thông tin gì không. Nếu plugin đòi key hay mã truy cập, chỉ nhập khi bạn chắc về nguồn gốc của nó, và đừng dán key vào nơi công khai.
D.Muốn đóng góp plugin nhưng pull request không được xử lý
README ghi rõ pull request vào repo này không được theo dõi. Nếu bạn là tác giả plugin bên thứ ba, hãy nộp và quản lý plugin qua trang quản lý do README chỉ ra (claude.ai/directory/manage). Đừng mất công mở pull request.
E.Tin tưởng nhầm plugin lạ
Đây không hẳn là lỗi kỹ thuật, nhưng là rủi ro dễ xảy ra nhất. Plugin có thể mang theo MCP server hoặc phần mềm khác. Trước khi cài hoặc cập nhật, hãy đọc trang chủ của plugin, ưu tiên plugin trong thư mục plugins do Anthropic duy trì, và cẩn trọng hơn với plugin bên thứ ba.
VII.Có nên dùng không
Điểm mạnh. Cài plugin gọn, một dòng lệnh. Có nguồn chính thức từ Anthropic, giấy phép Apache-2.0 cho repo, và có plugin mẫu để học cách tự làm. Cấu trúc plugin chuẩn (lệnh, agent, skill, MCP) cho bạn một khuôn rõ ràng khi muốn đóng gói quy trình của mình.
Giới hạn. README của repo mang tính tham khảo cho người làm plugin hơn là hướng dẫn dùng từng plugin. Nó không nói yêu cầu hệ điều hành, phiên bản hay chi phí. Phần danh sách bên thứ ba đang được thu gọn, nên thứ bạn tìm có thể nằm ở nơi khác. Anthropic cũng nói thẳng là không đảm bảo plugin chạy đúng ý hay không thay đổi về sau.
Khi nào nên chọn cách khác. Nếu bạn không dùng Claude Code thì kho này không có nhiều giá trị với bạn. Nếu bạn cần một công cụ giải quyết đúng một việc, hãy tìm repo riêng cho việc đó. Còn nếu bạn dùng Claude Code hằng ngày và muốn mở rộng nó một cách có kiểm soát, đây là nơi nên ghé đầu tiên: mở Discover, đọc kỹ, và cài từng plugin một.
Câu hỏi thường gặp
claude-plugins-official là gì?
Đây là kho (marketplace) plugin chính thức của Anthropic cho Claude Code. Thư mục plugins chứa plugin do Anthropic phát triển, còn external_plugins chứa plugin bên thứ ba cũ và các plugin kênh như Discord, fakechat, iMessage, Telegram.
Cài plugin từ kho này như thế nào?
Bên trong Claude Code, bạn gõ /plugin install {plugin-name}@claude-plugins-official, thay {plugin-name} bằng tên plugin thật. Hoặc mở /plugin rồi vào Discover để duyệt và chọn.
Kho này có miễn phí không?
Repo dùng giấy phép Apache-2.0. Tuy vậy README nói mỗi plugin có file giấy phép riêng, nên bạn cần xem từng plugin. Chi phí khi dùng Claude Code hoặc dịch vụ đi kèm plugin thì tư liệu chưa có thông tin.
Có cần GPU hay cấu hình máy mạnh không?
README không nêu yêu cầu phần cứng. Với việc cài plugin qua lệnh /plugin, tư liệu không đề cập GPU. Plugin riêng lẻ có thể có yêu cầu khác, hãy xem trang của từng plugin.
Chạy được trên Windows không?
README chưa ghi hệ điều hành nào được hỗ trợ hay không. Bạn xem tài liệu chính thức của Claude Code và README của plugin bạn định cài để biết chắc.
Plugin có an toàn không?
README cảnh báo rõ: hãy chắc chắn bạn tin plugin trước khi cài, cập nhật hay dùng. Anthropic không kiểm soát được MCP server, file hay phần mềm đi kèm plugin và không thể xác nhận chúng sẽ chạy đúng hoặc không thay đổi. Hãy đọc trang chủ của từng plugin.
Tôi muốn đưa plugin của mình lên kho thì làm sao?
README hướng dẫn nộp và quản lý plugin tại claude.ai/directory/manage, nơi plugin được phục vụ trên nhiều sản phẩm Claude. Pull request gửi vào repo này không được theo dõi.


