Sau bảy cấp, todo-api có cả một bộ công cụ: skill /add-endpoint và pr-review, subagent reviewer, tester, debugger, các hook kiểm cú pháp và chặn .env, cấu hình GitHub MCP. Nhưng tất cả nằm rải rác trong .claude/ của một repo. Sang repo thứ hai thì sao? Chép tay từng file, rồi mỗi lần sửa lại chép tiếp? Bài này giới thiệu plugin, cách đóng gói và cài những thứ đó như một khối, bắt đầu từ phía người dùng: cài, chọn phạm vi, tính chi phí, và quyết định có nên tin hay không. Bài 8.3 sẽ tự làm plugin.
Plugin là gì
Một plugin là một thư mục chứa những thứ bạn đã biết:
- Skill (cấp 3), chạy dạng
/<plugin>:<skill>, ví dụ/commit-commands:commit; - Subagent (cấp 4);
- Hook (cấp 6);
- MCP server (cấp 5).
Thường có thêm một file manifest .claude-plugin/plugin.json đặt tên cho plugin, có thể kèm phiên bản và mô tả.
Docs nói rõ: những thứ trên đều dùng được không cần plugin. Dùng plugin khi bạn muốn đóng gói nhiều thứ thành một khối, cài ở nhiều dự án, chia sẻ cho team, hoặc phát hành có phiên bản. Một skill lẻ cho riêng bạn thì cứ để trong ~/.claude/skills/.
Marketplace: danh mục, không phải cửa hàng
Plugin thường đến từ một marketplace: một repo hay thư mục có file .claude-plugin/marketplace.json liệt kê các plugin và nơi lấy từng cái. Đó là danh mục, không phải nơi lưu trữ. Bạn cài theo tên dạng plugin@marketplace.
- Lần đầu mở phiên tương tác, Claude Code tự thêm marketplace chính thức
claude-plugins-official. - Thêm marketplace khác bằng
/plugin marketplace addkèm nguồn:owner/repotrên GitHub (thêm#v1.2.0để ghim một phiên bản), một URL git, một thư mục cục bộ (bắt đầu bằng./), hoặc URL tới filemarketplace.json. - Thêm và cài trong một lệnh:
/plugin install deploy-helper --marketplace your-org/plugins.
Marketplace chia ba hạng: chính thức, cộng đồng (như claude-community) và bên thứ ba (mọi thứ còn lại, kể cả của đồng nghiệp hay công ty bạn). Tên chính thức và cộng đồng chỉ được chấp nhận khi marketplace lấy từ github.com/anthropics/, nên không ai mạo danh được. Nhưng hạng của marketplace chỉ cho biết ai giữ danh mục, không nói gì về từng plugin trong đó.
Cài một plugin
Trong phiên:
/plugin install commit-commands@claude-plugins-officialLệnh này chưa cài ngay. Nó mở trang chi tiết để bạn xem trước:
- Will install: plugin thêm những skill, agent, hook, MCP server nào.
- Context cost (với plugin chính thức): bao nhiêu token thêm vào mỗi lượt, và bao nhiêu khi skill được gọi.
Rồi bạn chọn phạm vi (mục sau) và cài. Gõ / để thấy các skill mới dạng /commit-commands:commit. Gõ /plugin không kèm tên thì mở tab Discover để duyệt.
Từ shell, không cần mở phiên, ví dụ trong script cài đặt máy mới:
claude plugin install commit-commands@claude-plugins-official --scope localKhi thử trong todo-api, lệnh in "Successfully installed plugin … (scope: local)", ghi enabledPlugins vào .claude/settings.local.json, và claude plugin list hiện plugin với "Scope: local".
Chọn phạm vi
| Scope | Bật cho | Ghi vào |
|---|---|---|
| user | Bạn, mọi dự án | ~/.claude/settings.json |
| project | Mọi người trong repo | .claude/settings.json (commit) |
| local | Bạn, chỉ repo này | .claude/settings.local.json |
Một chi tiết hay bị hiểu nhầm: scope project ghi vào file được commit, nên plugin được bật cho cả team, nhưng không tự tải về máy họ. Mỗi người vẫn chạy claude plugin install … --scope project một lần trên máy mình. Cùng một plugin đặt ở nhiều scope thì local thắng project, project thắng user.
Cái giá và lòng tin
Một plugin đã bật có mặt trong mọi phiên, kể cả khi bạn không dùng tới nó:
- Ngữ cảnh: tên và mô tả của skill, agent mà Claude tự gọi được nằm trong ngữ cảnh ở mọi lượt. Lệnh
plugin detailscho biết con số:commit-commandsthêm khoảng 105 token mỗi phiên, và vài trăm token mỗi khi một skill được gọi. - Tiến trình: MCP server của plugin chạy cùng phiên, hook của nó chạy theo sự kiện.
- Quyền: docs nói thẳng, plugin chạy code tùy ý với quyền của bạn. Quan trọng hơn, luật quyền và sandbox chỉ áp cho lần gọi công cụ của Claude. Hook và server của plugin tự chạy ngoài những lớp đó.
Vì vậy, xem xét trước khi cài, bất kể marketplace nào:
claude plugin marketplace list: marketplace đến từ đâu.- Đọc trang chi tiết trong
/plugin. - Đọc mã nguồn:
hooks/hooks.json(mỗi hook chạy lệnh gì),.mcp.json, thư mụcbin/. - Liệt kê thành phần mà không cần cài:Lệnh này in "Component inventory" và chi phí token. Chúng tôi chạy nó vớiTerminal
claude --plugin-dir <thư mục plugin> plugin details <tên>commit-commands: 3 skill, 0 hook, 0 MCP server. Một plugin đơn giản, ít rủi ro.
Còn một điều: tự cập nhật có thể đổi những file bạn đã xem. Mặc định bật cho marketplace chính thức, tắt cho marketplace khác.
Quản lý plugin
/plugin, tab Installed: bật/tắt (phím Space), cập nhật, gỡ.- Từ shell:
claude plugin disable,enable,uninstall,update, kèm--scope. - Tắt thay vì gỡ khi chỉ muốn bớt chi phí ngữ cảnh một thời gian.
- Có bản mới thì Claude Code báo; chạy
/reload-pluginsđể dùng ngay. - Gỡ một marketplace là gỡ mọi plugin cài từ nó, và Claude Code liệt kê chúng trước khi hỏi xác nhận.
Plugin cũng đi được lên CI: action GitHub ở bài 8.1 nhận plugin_marketplaces và plugins, rồi chạy skill bằng prompt: "/plugin:skill". Bài cuối, 8.3, ghép mọi thứ: đóng gói bộ công cụ của todo-api thành một plugin, đặt vào một marketplace của team, và cài nó ở một repo khác chỉ bằng một lệnh.