Bài 8.216 phút · 5 thẻ · 8 bài tập · 1 nhiệm vụ

Plugins và marketplace

Cài bộ công cụ như một khối: plugin là gì, marketplace là danh mục, cài và chọn scope, chi phí ngữ cảnh, và xem xét trước khi tin.

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 add kèm nguồn: owner/repo trê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 file marketplace.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-official

Lệ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:

Terminal
claude plugin install commit-commands@claude-plugins-official --scope local

Khi 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 details cho biết con số: commit-commands thê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:

  1. claude plugin marketplace list: marketplace đến từ đâu.
  2. Đọc trang chi tiết trong /plugin.
  3. Đọc mã nguồn: hooks/hooks.json (mỗi hook chạy lệnh gì), .mcp.json, thư mục bin/.
  4. Liệt kê thành phần mà không cần cài:
    Terminal
    claude --plugin-dir <thư mục plugin> plugin details <tên>
    Lệnh này in "Component inventory" và chi phí token. Chúng tôi chạy nó với 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.

Luyện tập bài 8.2

5 thẻ ghi nhớ, 8 bài tập chấm ngay trên trang, 1 nhiệm vụ làm trên máy.

Bắt đầu luyện tập

Tra cứu liên quan

Gõ để tìm trong tra cứu, mẫu cấu hình và bài học. Không dấu cũng được.