Plugins & Marketplace — Lớp phân phối: biến năng lực thành tài sản đội nhóm

Bốn bài trước, bạn đã học cách trang bị cho một agent: bộ nhớ (CLAUDE.md), chuyên môn (Skills), kiểm soát (Hooks), phân công (Subagents). Nhưng có một vấn đề tổ chức: nếu mỗi người trong đội tự viết lại skill, tự cấu hình lại subagent, tự dựng lại hook — thì năng lực AI vẫn nằm rải rác trong đầu từng cá nhân.

Plugins giải quyết điều đó. Khi một năng lực đã được chuẩn hóa, nó được đóng gói thành plugin để chia sẻ cho cả đội — cài bằng một lệnh. Đây là bước biến AI từ "kỹ năng cá nhân" thành tài sản vận hành của tổ chức.

Plugin là gì

Plugin là một thư mục tự chứa (self-contained) đóng gói nhiều thành phần để mở rộng Claude Code: skills, agents (subagents), hooks, MCP servers, cùng slash commands, LSP servers, monitors... — tất cả cài bằng một lệnh (Claude Docs — Plugins reference; Anthropic — Claude Code plugins).

Điểm cần hiểu đúng: plugin không phải là một tính năng mới. Nó chỉ đóng gói và phân phối những thành phần đã có (skills/agents/hooks/MCP) thành một đơn vị được version hóa, cài một lệnh. Hãy nghĩ về nó như "các gói npm cho năng lực của agent".

plugin.json và cấu trúc thư mục

Manifest của plugin nằm ở .claude-plugin/plugin.json. Đáng chú ý: manifest là tùy chọn — nếu bỏ, Claude Code sẽ tự dò các thành phần ở vị trí mặc định và lấy tên từ thư mục. Trường bắt buộc duy nhất là name (dạng kebab-case) (Claude Docs — Plugins reference):

{
  "name": "deployment-tools",
  "version": "1.2.0",
  "description": "Bộ công cụ tự động hóa triển khai",
  "author": { "name": "Dev Team" }
}

Cấu trúc thư mục chuẩn — lưu ý các thành phần đặt ở gốc plugin, KHÔNG nằm trong .claude-plugin/:

my-plugin/
├── .claude-plugin/plugin.json   ← CHỈ manifest ở đây
├── skills/<ten>/SKILL.md
├── commands/*.md
├── agents/*.md
├── hooks/hooks.json
├── .mcp.json
└── scripts/

Có các biến đường dẫn hữu ích: ${CLAUDE_PLUGIN_ROOT} (thư mục cài, đổi mỗi lần update), ${CLAUDE_PLUGIN_DATA} (dữ liệu bền, sống qua update), và ${CLAUDE_PROJECT_DIR}.

Marketplace: chợ ứng dụng cho plugin

Marketplace là một catalog plugin (file .claude-plugin/marketplace.json). Quy trình dùng gồm hai bước, ví như "thêm một app store rồi tải app" (Claude Docs — Discover plugins):

1. Thêm marketplace: /plugin marketplace add anthropics/claude-plugins-official (dạng owner/repo trên GitHub, hoặc git URL / đường dẫn local).
2. Cài plugin: chọn plugin trong marketplace để cài.

Anthropic có sẵn marketplace chính thức claude-plugins-official, tự động khả dụng cho mọi người dùng; xem catalog tại claude.com/plugins. Ngoài ra có marketplace cộng đồng anthropics/claude-plugins-community.

Các lệnh CLI thường dùng: claude plugin init | install | uninstall | enable | disable | update | list | details. Ví dụ cài theo phạm vi dự án:

claude plugin install formatter@my-marketplace --scope project

Marketplace chính thức gồm nhiều nhóm đáng chú ý (github.com/anthropics/claude-plugins-official): code intelligence (LSP cho Python/TypeScript/Rust...), external integrations (MCP dựng sẵn cho GitHub, GitLab, Notion, Figma, Vercel, Supabase, Slack, Sentry...), security-guidance (tự review lỗ hổng), và dev workflows (commit-commands, pr-review-toolkit, plugin-dev...).

Ví dụ tối giản

Một plugin cài được có thể chỉ gồm hai thứ: một plugin.json với name + description, và một skills/foo/SKILL.md. Từ nền tảng đó, bạn thêm dần subagent, hook, MCP server khi cần — tất cả gói trong một thư mục version hóa.

Quản trị plugin cho tổ chức (Team/Enterprise)

Đây là nơi Plugins tỏa sáng cho doanh nghiệp. Chủ sở hữu gói Team/Enterprise có thể tạo marketplace nội bộ và phân phối plugin đã duyệt cho toàn tổ chức, kiểm soát chính xác thành viên thấy và dùng plugin nào (Anthropic Support — Manage plugins for your organization).

Về kỹ thuật, admin khai báo extraKnownMarketplaces và enabledPlugins trong .claude/settings.json (dự án) hoặc managed settings, cùng các tùy chọn như autoUpdate, strictKnownMarketplaces, blockedMarketplaces. Với phạm vi managed, cấu hình là read-only với người dùng — nghĩa là một chuẩn bắt buộc cấp công ty.

Ý nghĩa thực tiễn: thay vì "mỗi người dùng AI một kiểu", tổ chức có thể chuẩn hóa bộ skill chuẩn + bộ agent chuẩn + bộ hook chuẩn + bộ MCP chuẩn và đẩy xuống mọi máy qua marketplace nội bộ.

Bảo mật — supply chain của agent

Plugin và marketplace là thành phần được tin cậy ở mức cao: chúng chạy code tùy ý với quyền của người dùng. Do đó nguyên tắc số một là chỉ cài từ nguồn tin cậy (Claude Docs — Plugins reference). Đây là bài toán "supply chain security" quen thuộc: một plugin độc hại có thể chứa hook xóa file hay MCP server rò rỉ dữ liệu.

Vài lỗi kỹ thuật hay gặp khi tự viết plugin: đặt thành phần nhầm vào .claude-plugin/ (phải để ở gốc); quên dùng ${CLAUDE_PLUGIN_ROOT} khiến MCP/hook không tìm thấy file; quên chmod +x cho script hook.

Tóm tắt & bước tiếp theo

Plugins là lớp phân phối: đóng gói skills + subagents + hooks + MCP + commands thành một đơn vị cài một lệnh, chia sẻ qua marketplace, và cho phép tổ chức chuẩn hóa + quản trị năng lực AI ở quy mô đội nhóm. Bản thân plugin không thêm năng lực mới — nó nhân bản năng lực đã có ra toàn đội.

Trong danh sách thành phần mà plugin đóng gói, có một cái ta chưa mổ xẻ kỹ: MCP servers — lớp kết nối Claude với công cụ và dữ liệu bên ngoài. Đó là Bài 6, mảnh ghép cuối trước khi ta ghép tất cả lại.

Nguồn tham khảo

• Anthropic — Customize Claude Code with plugins: https://www.anthropic.com/news/claude-code-plugins
• Claude Docs — Plugins reference: https://code.claude.com/docs/en/plugins-reference
• Claude Docs — Discover and install plugins through marketplaces: https://code.claude.com/docs/en/discover-plugins
• Claude Docs — Create and distribute a plugin marketplace: https://code.claude.com/docs/en/plugin-marketplaces
• Anthropic Support — Manage plugins for your organization: https://support.claude.com/en/articles/13837433-manage-plugins-for-your-organization
• GitHub — anthropics/claude-plugins-official: https://github.com/anthropics/claude-plugins-official

Bài 5/7 trong chuỗi "Bộ công cụ phát triển Agent với Claude". Nội dung diễn giải lại từ tài liệu gốc của Anthropic. Trước ← Bài 4: Subagents · Tiếp theo → Bài 6: MCP Servers.