Claude Code plugins: package skills, agents and hooks for your team, and their context cost

Bạn đã có vài skill hay, một subagent review code, hook tự format và một MCP server nội bộ. Giờ muốn cả team dùng y hệt, thì phải hướng dẫn từng người copy từng file vào đúng thư mục, rồi mỗi lần sửa lại nhắn nhau cập nhật. Plugin trong Claude Code giải quyết bài toán đóng gói này: gom skill, agent, hook, MCP server thành một khối, cài bằng một lệnh, cập nhật qua marketplace. Nhưng plugin cũng có cái giá về context và bảo mật mà nhiều người bỏ qua. Bài này giải thích cả hai mặt.

Plugin gồm những gì?

Một plugin là một thư mục, thường có manifest .claude-plugin/plugin.json đặt tên và phiên bản. Bên trong có thể chứa:

my-plugin/
├── .claude-plugin/plugin.json   # tên, version, mô tả
├── skills/review/SKILL.md       # chạy được bằng /my-plugin:review
├── agents/reviewer.md           # subagent để Claude giao việc
├── hooks/hooks.json             # lệnh chạy theo sự kiện (sau mỗi edit…)
└── .mcp.json                    # MCP server bật cùng plugin

Skill trong plugin được đặt namespace theo tên plugin (/my-plugin:review), nên không đụng tên với skill khác.

Cài plugin từ marketplace

Marketplace chỉ là một repo hoặc thư mục có file .claude-plugin/marketplace.json liệt kê plugin, giống một danh mục chứ không phải cửa hàng. Marketplace chính thức của Anthropic được thêm tự động ở lần chạy đầu.

/plugin                                   # mở giao diện, tab Discover
/plugin marketplace add owner/repo        # thêm marketplace bên thứ ba
/plugin install ten-plugin@ten-marketplace
claude plugin disable ten-plugin          # tắt mà không gỡ

Khi nào nên dùng plugin?

• Không cần plugin: một skill dùng riêng thì đặt vào ~/.claude/skills/ là đủ; một quy tắc cho repo thì để trong .claude/ của repo.
• Nên dùng plugin: khi muốn đóng gói nhiều thành phần thành một đơn vị, chia sẻ cho team, cài vào nhiều dự án hoặc phát hành theo phiên bản.
• Đang phát triển: không cần marketplace, nạp thẳng từ thư mục bằng claude --plugin-dir ./my-plugin.

Cái giá của mỗi plugin đang bật

Đây là phần hay bị quên. Plugin đã bật thì có mặt trong mọi phiên, kể cả phiên không dùng tới:

• Context: tên và mô tả của mọi skill, agent, command mà Claude tự gọi được nằm trong context ở mỗi lượt. Toàn văn chỉ nạp khi dùng, nhưng phần mô tả vẫn tốn token và chiếm chỗ.
• Tiến trình: MCP server của plugin chạy kèm mỗi phiên; hook kích hoạt theo sự kiện.
• Quyền: mọi thứ plugin chạy đều chạy với quyền của bạn.

Kiểm tra trước và sau khi cài: tab Marketplaces trong /plugin hiển thị ước tính Context cost cho plugin ở marketplace chính thức; tab Installed có nhóm "Not used recently" gợi ý plugin nên tắt.

Rủi ro và lưu ý

• Phân biệt nguồn: chỉ marketplace từ github.com/anthropics/ mới được mang tên chính thức (claude-plugins-official…). Mọi marketplace khác, kể cả của đồng nghiệp, là bên thứ ba.
• Đọc trước khi cài: xem hooks và script trong plugin; hook chạy tự động, không hỏi.
• Đừng sưu tầm: 20 plugin bật cùng lúc nghĩa là hàng trăm mô tả skill trong context, Claude dễ chọn nhầm.
• Phiên cloud (claude.ai/code) không nạp plugin trong settings local của bạn.

Áp dụng thế nào?

• Dev: Rà /plugin → Installed, tắt plugin không dùng tuần qua. Gom các skill cá nhân hay dùng thành một plugin riêng để mang sang máy khác.
• Tech Lead: Tạo marketplace nội bộ cho team: một plugin "chuẩn team" gồm skill review, hook format, MCP nội bộ; bật ở phạm vi Project. Doanh nghiệp có thể dùng managed settings để allowlist marketplace.
• PM: Đóng gói quy trình viết PRD, release note thành plugin để cả nhóm sản phẩm dùng chung một chuẩn.