Plugin Claude Code là gì và có mất phí không?
Tìm hiểu plugin Claude Code nằm ở đâu, cách cài đặt và chi phí thực tế: cơ chế plugin không mất phí, nhưng token sẽ tăng theo nội dung đưa vào context.
Plugin Claude Code là gì
Plugin Claude Code là một thư mục chứa các thành phần mà Claude Code tải và quản lý như một đơn vị duy nhất. Các thành phần chính gồm skill, agent, hook, MCP server, LSP server và background monitor. Plugin cũng có thể chứa command, output style, theme, workflow và một thư mục bin/ chứa các executable. Khi cài đặt plugin, tất cả thành phần của plugin được thêm cùng lúc dưới một tên duy nhất. Khi tắt plugin, các thành phần đó cũng được gỡ theo cùng cách.
Plugin hầu như không cấp cho agent khả năng nào mà agent chưa có. Bạn có thể tự viết skill, agent, hook và MCP server trong thư mục .claude/. Ngoại lệ là language server dùng cho code intelligence và mod, vì Claude Code chỉ tải chúng từ plugin. Với các thành phần còn lại, plugin chỉ là lớp đóng gói: giúp version các thành phần đó, phân phối cho 15 người và cập nhật sau này mà không cần yêu cầu mọi người tự sao chép file. Đó là toàn bộ ý tưởng. Phần lớn nhầm lẫn về plugin xuất phát từ việc kỳ vọng plugin là một loại capability mới.
Manifest tùy chọn tại .claude-plugin/plugin.json đặt tên cho plugin. Tên đó trở thành một namespace. Một skill trong plugin có tên commit-commands được gọi bằng /commit-commands:commit. Vì vậy, hai plugin có thể cùng cung cấp một skill tên commit mà không plugin này shadow plugin kia. Plugin agent cũng được giới hạn theo cách tương tự trong danh sách @-mention, dưới tên plugin-name:agent-name.
Plugin, skill, MCP server hoặc rules file
Bốn thuật ngữ này thường được dùng như thể chúng cạnh tranh với nhau. Thực tế không phải vậy, và cần phân biệt rõ một lần.
- Skill là một đơn vị instruction mà Claude tải khi task yêu cầu. Xem skill của Agent thực sự là gì.
- MCP server là một process riêng, cung cấp tools cho agent qua một protocol. Thường đây là một network service do bạn tự chạy.
- Rules file như
CLAUDE.mdlà context của project. File này được đọc khi session bắt đầu và áp dụng cho mọi thứ. - Plugin là một directory chứa skills, agents, hooks, MCP servers hoặc các component khác mà Claude Code cài đặt và tải như một đơn vị. Manifest tùy chọn của plugin đặt tên cho plugin và có thể bổ sung version, description cùng metadata khác. Distribution không phải là một phần của plugin. Marketplace là một catalog riêng, liệt kê các plugin và nơi lấy từng plugin.
Vì vậy, câu hỏi mà plugin giải quyết không phải là “agent có thể làm gì”. Câu hỏi là “làm thế nào để phân phối plugin cho team và cập nhật plugin vào tháng sau”. Nếu bạn đang chọn giữa ba loại đầu tiên, phần so sánh skill, MCP server và rules file trình bày chi tiết quyết định này. Nếu bạn quan tâm đến phần MCP, chạy MCP server của riêng bạn trên VPS trình bày phần hosting.
Nơi plugin được lưu và nội dung bên trong
Hầu hết plugin trên marketplace được sao chép vào cache cục bộ tại ~/.claude/plugins/cache, với một thư mục riêng cho từng phiên bản đã cài đặt. Plugin dùng relative path trong marketplace được thêm từ một local path sẽ được load tại chỗ, còn plugin lấy source từ command ở link mode sẽ được load qua các link trỏ đến thư mục source. Khi bạn cập nhật hoặc gỡ cài đặt một plugin đã sao chép, thư mục của phiên bản cũ được đánh dấu là orphaned và bị xóa sau khoảng hai tuần. Vì vậy, session đã load phiên bản cũ vẫn tiếp tục hoạt động thay vì fail giữa chừng. Việc dọn dẹp chỉ chạy khi còn ít nhất một plugin installation được ghi nhận. Sau khi bạn gỡ plugin cuối cùng, các thư mục orphaned vẫn còn cho đến khi bạn cài plugin khác.
Vì path của plugin đã sao chép thay đổi sau mỗi lần cập nhật, plugin không được hardcode vị trí của chính nó. Hooks và MCP config bên trong plugin dùng ${CLAUDE_PLUGIN_ROOT}; giá trị này trỏ đến thư mục cài đặt hiện tại. State cần được giữ lại sau khi cập nhật phải nằm trong ${CLAUDE_PLUGIN_DATA}; giá trị này trỏ đến một thư mục ổn định bên dưới ~/.claude/plugins/data/.
Với plugin đã sao chép, chỉ thư mục riêng của plugin được sao chép vào cache. Ngoại lệ là các symlink target nằm ở nơi khác trong cùng marketplace; các target này được sao chép vào đúng vị trí. Một script đọc path bên ngoài plugin root, chẳng hạn ../shared-utils, sẽ hoạt động khi bạn phát triển bằng local path nhưng fail khi plugin được sao chép vào cache, vì các file đó chưa từng được sao chép. Component path được khai báo theo cách đó trong plugin.json sẽ fail sớm hơn: Claude Code từ chối mọi component path thoát khỏi plugin root, kể cả trong lúc phát triển, với lỗi path escapes plugin directory.
Cấu trúc thư mục như sau.
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/Chỉ plugin.json nằm bên trong .claude-plugin/. Mọi thứ khác nằm tại plugin root. Đặt skills/ hoặc hooks/ bên trong .claude-plugin/ là lý do phổ biến nhất khiến plugin cài đặt thành công nhưng sau đó hoàn toàn không làm gì: Claude Code tìm các thư mục đó tại root nhưng không thấy, rồi load một plugin không có component.
Manifest rất ngắn.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Cách cài đặt plugin Claude Code
Cài đặt gồm 2 bước, và bước đầu tiên không cài gì cả. Bạn thêm một marketplace, tức catalog chứa các plugin, rồi cài từng plugin từ đó. Marketplace chính thức của Anthropic, claude-plugins-official, được đăng ký tự động lần đầu bạn khởi động Claude Code ở chế độ tương tác, trừ khi managed policy hoặc CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL chặn thao tác này. Các marketplace khác bạn phải tự thêm.
/plugin marketplace add anthropics/claude-plugins-official
/plugin install commit-commands@claude-plugins-officialTên marketplace lấy từ file catalog bên trong repository, không lấy từ đường dẫn repository. Vì vậy, hãy đọc tên marketplace tại tab Marketplaces của /plugin trước khi nhập lệnh cài đặt. Marketplace claude-code-plugins cũ trong anthropics/claude-code đã deprecated; hãy dùng claude-plugins-official cho các lần cài đặt mới. Các plugin hiện có từ marketplace cũ đó sẽ cập nhật từ repository chính thức, nên bạn không cần cài lại commit-commands chỉ để đổi marketplace.
Sau khi cài đặt, hãy đọc dòng tóm tắt. Plugin is now active. nghĩa là các thành phần đã được load trong session này. Run /reload-plugins to apply. nghĩa là chúng chưa được activate trong lúc cài đặt; panel sẽ đóng và Claude Code sẽ tự thực hiện reload cho bạn. Nếu reload cảnh báo rằng nó sẽ đọc lại conversation, plugin sẽ được giữ ở trạng thái pending và bạn chạy lại bằng /reload-plugins --force. Sau đó xác nhận plugin thực sự đã có mặt: /plugin hiển thị plugin trong tab Installed, nhập / sẽ liệt kê các skill của plugin dưới dạng /plugin-name:skill-name, còn mọi thành phần load thất bại sẽ xuất hiện trong tab Errors cùng với lý do.
Khi cài đặt, bạn phải chọn scope. Scope quyết định ai nhận được plugin. User scope áp dụng cho bạn trong mọi project. Project scope ghi plugin vào .claude/settings.json của repository dưới enabledPlugins, nhờ đó bật plugin cho tất cả những người clone repository. Plugin không được tải xuống cho họ: mỗi collaborator vẫn phải cài plugin một lần trên máy của mình, chẳng hạn bằng claude plugin install name@marketplace --scope project, trừ khi entry của plugin trong marketplace là relative path hoặc một seed directory đã chứa plugin đó. Local scope chỉ áp dụng cho bạn trong repository này.
Với script, Dockerfile hoặc bất kỳ session nào không có interactive panel, hãy dùng dạng shell. Dạng này cài plugin vào user scope, trừ khi bạn truyền --scope. Trên máy chưa có ai mở interactive session, marketplace chính thức chưa được đăng ký, nên bạn phải thêm marketplace trước.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install chạy bên ngoài session. Vì vậy, session đang mở sẽ không thấy plugin mới cho đến khi bạn chạy /reload-plugins hoặc bắt đầu session mới.
Cách quản lý các plugin hiện có giống nhau ở cả hai nơi. /plugin list in ra danh sách những gì đã cài đặt và chấp nhận --enabled hoặc --disabled. /plugin disable name@marketplace tắt plugin mà không gỡ plugin, /plugin enable bật lại plugin, còn /plugin uninstall gỡ plugin. Các dạng slash command sẽ mở plugin panel để áp dụng thay đổi. Vì vậy, trong script bạn nên dùng các lệnh shell tương đương claude plugin ....
Để cung cấp một marketplace cho cả team, hãy thêm marketplace đó vào .claude/settings.json của project, hoặc chạy claude plugin marketplace add your-org/claude-plugins --scope project một lần rồi commit file mà lệnh này tạo ra. Claude Code sẽ đăng ký marketplace cho từng thành viên sau khi họ trust thư mục repository.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}Trong lúc xây dựng plugin của riêng bạn, hãy bỏ qua marketplace. claude --plugin-dir ./my-plugin load một directory trong session đó, /reload-plugins nhận các chỉnh sửa của bạn mà không cần restart, còn claude plugin validate ./my-plugin kiểm tra manifest, frontmatter của skill và agent, cũng như hooks/hooks.json trước khi người khác sử dụng plugin. Marketplace cũng không bắt buộc để chia sẻ plugin: bạn có thể gửi cho người khác folder hoặc .zip của folder đó để họ load bằng --plugin-dir, nhưng họ sẽ không nhận được update nào cho đến khi bạn gửi bản sao mới.
Một plugin của Claude Code tốn bao nhiêu?
Cơ chế này miễn phí. Tính đến tháng 11 năm 2026, bạn không phải trả phí để thêm marketplace, cài đặt plugin hoặc để plugin ở trạng thái bật. Marketplace chính thức và marketplace cộng đồng là các git repository công khai, còn plugin là một thư mục chứa các tệp văn bản.
Thứ plugin tiêu tốn là token. Token là đơn vị mà gói subscription hoặc hóa đơn API của bạn thực sự đo lường. Plugin sử dụng loại nào trong hai loại đó phụ thuộc vào cách bạn thanh toán cho công cụ ngay từ đầu. Chi phí Claude Code trên từng gói trình bày các cấp subscription cùng với mức giá API tính theo token. Chi phí này phát sinh theo ba cách khác nhau và mỗi cách có cơ chế riêng.
Chi phí context cố định. Mỗi plugin được bật sẽ đưa tên và mô tả của các skill, agent và command mà Claude có thể tự gọi vào context của bạn. Phần này được đọc lại ở mỗi lượt của session, bất kể có thành phần nào thực sự chạy hay không. Không phải thành phần nào cũng tốn token: hook được harness chạy và không thêm gì vào context của model. Trước khi cài đặt, màn hình chi tiết /plugin hiển thị phần Will install, liệt kê các command, skill, agent, hook, MCP và LSP server mà bạn sắp thêm. Với plugin trong marketplace chính thức của Anthropic, màn hình này còn hiển thị phần Context cost với các ước tính Every turn và When invoked, miễn là bạn mở plugin bằng tên trong marketplace hoặc từ tab Marketplaces, thay vì từ danh sách Discover. Hãy đọc cả hai phần. Plugin từ marketplace của bạn hoặc marketplace bên thứ ba không có phần Context cost. Tuy nhiên, bạn không phải tự ước tính: claude plugin details name trong shell sẽ in ra số token Always-on và bảng phân rã theo từng thành phần cho bất kỳ plugin nào đã được load, kể cả plugin được truyền bằng --plugin-dir. Vì vậy, bạn có thể clone repository và chạy claude --plugin-dir ./that-plugin plugin details that-plugin trước khi cài đặt. Con số này không bao gồm MCP server. Plugin tích hợp MCP server thường nặng nhất vì các định nghĩa tool có kích thước lớn. Tuy nhiên, trên các model hỗ trợ MCP tool search, những định nghĩa này sẽ chỉ được tải khi cần dùng tool. Chạy /context trong session đã bật plugin rồi đọc dòng MCP tools để xem chúng thêm bao nhiêu.
Chi phí khi gọi. Khi chạy skill của plugin, các instruction của skill được nối vào conversation. Vì vậy, bạn chỉ trả token cho phần nội dung của skill khi skill được sử dụng. Tuy nhiên, phần nội dung này là phần rẻ nhất. Những gì skill yêu cầu agent thực hiện có thể tốn nhiều hơn: phương pháp Depth Tree của skill unlazy tiêu tốn gần như toàn bộ token cho các lượt xử lý bổ sung mà nó buộc agent thực hiện trước khi được phép đánh dấu task là hoàn tất, chứ không phải cho file bạn đã cài. Agent hoạt động khác. Subagent chạy conversation riêng với system prompt và cache riêng, bắt đầu mà không có cache hit. Vì vậy, plugin có workflow tạo ra agent thường tốn nhiều hơn đáng kể so với mức ước tính context.
Chi phí cache. Việc bật hoặc tắt plugin giữa session có thể buộc request tiếp theo xử lý lại toàn bộ conversation. Skill, command, agent, hook, monitor và theme không làm điều này: nội dung chúng thêm vào được nối sau history hiện có, nên request tiếp theo chỉ trả cho nội dung mới và vẫn đọc toàn bộ phần trước từ cache. Ngoại lệ là plugin cung cấp MCP server và plugin code intelligence, trong đó language server cung cấp tool LSP cho Claude. Với MCP, điều này phụ thuộc vào tool search: nếu tool được trì hoãn, cache vẫn được giữ; nếu tool được tải vào prompt prefix, request tiếp theo sẽ đọc lại toàn bộ conversation dưới dạng uncached input. Đó chính là lý do /reload-plugins cảnh báo và từ chối khi thay đổi MCP tool hoặc tool LSP có thể làm hỏng cache, cho đến khi bạn truyền --force.
Bạn có thể theo dõi việc này thay vì đoán. Mỗi API response đều báo cáo cache_read_input_tokens và cache_creation_input_tokens. Một statusline tùy chỉnh hiển thị mức sử dụng token theo thời gian thực sẽ đưa cả hai giá trị ra trước mắt bạn. Một session hoạt động bình thường sẽ đọc nhiều hơn lượng token nó tạo ra. Nếu lượng token tạo ra vẫn cao qua nhiều lượt liên tiếp, nghĩa là có thành phần nào đó trong prefix đang thay đổi ở mỗi lượt. Để xem tổng quan về những gì đang chiếm chỗ trong window, hãy xem cách quản lý context window của Claude Code và ý nghĩa thực sự của các số đếm token đó.
Một việc dọn dẹp nhỏ có thể giúp giảm chi phí đáng kể. Tab Installed nhóm các plugin được cài từ marketplace nhưng bạn chưa sử dụng trong ít nhất 14 ngày và 10 session dưới header Not used recently, đồng thời hiển thị dòng Last used trong màn hình chi tiết. Header này không tính các plugin managed và plugin trong seed directory, cũng như plugin có theme, output style, monitor hoặc workflow. LSP server được tính là đã sử dụng khi cung cấp diagnostic hoặc trả lời yêu cầu điều hướng code. Khi đã cấu hình strictKnownMarketplaces, cả header lẫn dòng Last used: đều không xuất hiện. Những plugin đó vẫn làm tăng thời gian startup và context trong mọi session. Hãy disable hoặc uninstall chúng. Cách tiết kiệm hơn là chọn lọc trước khi cài đặt: những skill nào của Matt Pocock đáng cài đặt phân tích bộ sưu tập gồm 27 skill và tách ra một số ít skill cần cho developer làm việc một mình khỏi những skill chỉ thực sự hữu ích trong team.
Plugin chạy với quyền của bạn
Tài liệu riêng của Anthropic nói rất rõ: plugin bạn cài có thể thực thi mã tùy ý trên máy của bạn với quyền của user hiện tại. Đây không phải giả định trên lý thuyết. Hook của plugin chạy shell command khi có các sự kiện trong session, bao gồm trước và sau mỗi lần gọi tool. Thư mục bin/ của plugin được thêm vào PATH của Bash tool trong thời gian plugin đang bật. Các stdio MCP server của plugin là những process do plugin khởi chạy, còn mod chạy JavaScript ngay bên trong Claude Code. Hook, monitor, server process và mod process chạy bên ngoài sandbox của Claude Code; các quy tắc cấp quyền của Claude Code vẫn áp dụng cho những lần gọi tool mà Claude thực hiện.
Trên laptop, rủi ro này bị giới hạn bởi những gì desktop user của bạn có thể truy cập. Trên server thì thường không như vậy. Account chạy agent thường có SSH key, deploy token, cloud CLI session và quyền truy cập Docker socket. Vì vậy, “mã tùy ý chạy với quyền của user” thực tế có nghĩa là toàn bộ máy. Nếu Claude Code chạy trên VPS, hãy đọc cách chạy Claude Code an toàn trên VPS trước khi cài bất kỳ thứ gì, và đọc cách giữ credential ngoài tầm với của agent trước khi cài plugin giao tiếp với external service. Các harness khác cũng gặp cùng giới hạn trên cùng một máy thuê. Vì vậy, các plugin DeepSeek Harness đáng cài chủ yếu cung cấp giới hạn chi phí, quy tắc cấp quyền cho tool và quét injection, thay vì thêm capability mới.
Một số biện pháp bảo vệ vẫn tồn tại, và bạn nên biết rõ từng loại. Plugin ở phạm vi project lấy từ repository thay vì từ bạn, nên chỉ được load sau khi bạn tin cậy workspace; MCP server của plugin vẫn cần được phê duyệt riêng cho từng server, còn background monitor hoàn toàn không được load. Agent do plugin cung cấp không được phép khai báo hook, MCP server hoặc permission mode. Khi marketplace plugin được copy vào cache, các symlink trỏ ra ngoài marketplace sẽ bị bỏ qua. Vì vậy, plugin đã copy không thể thông qua các symlink đó để lấy file tùy ý trên host.
Không điều gì trong số đó thay thế cho việc đọc nội dung bạn cài. Kiểm tra danh sách Will install, ưu tiên những plugin có source mà bạn có thể mở và đọc, giữ plugin của team trong marketplace repository do bạn kiểm soát, và chạy claude plugin validate trên mọi thứ bạn tự viết. Nội dung bạn đã review cũng có thể thay đổi về sau: auto-update được bật mặc định cho marketplace chính thức của Anthropic, ngoại trừ knowledge-work-plugins và first-party-plugins, còn marketplace bên thứ ba được thêm theo source thì mặc định tắt auto-update. Khi được bật, Claude Code sẽ cập nhật file của plugin ở chế độ nền.
FAQ
Plugin Claude Code có tốn thêm tiền không?
Không. Hệ thống plugin không thu phí, cũng không thu phí khi thêm marketplace hoặc cài plugin. Chi phí là lượng token được sử dụng, tính vào plan hoặc khoản chi API của bạn như mọi context khác. Plugin thêm context cố định vào mỗi lượt, thêm context khi một skill hoặc agent của plugin được gọi, và có thể buộc một lượt không dùng cache nhưng tốn nhiều chi phí nếu plugin cung cấp MCP server có các tool được nạp vào prompt prefix. Với plugin trong marketplace chính thức của Anthropic, giao diện chi tiết /plugin hiển thị ước tính Context cost trước khi bạn cài; với các plugin khác, claude plugin details name in chi phí token luôn bật sau khi plugin được cài hoặc được nạp bằng --plugin-dir.
Plugin khác skill như thế nào?
Skill là một đơn vị chỉ dẫn. Plugin là một package có thể chứa skill, agent, hook, MCP server, LSP server và monitor, cùng với tên, thường có version và thường có marketplace để cài đặt, dù cũng có thể được chia sẻ dưới dạng thư mục hoặc .zip mà mọi người nạp bằng --plugin-dir. Viết một skill độc lập trong .claude/ khi skill đó chỉ dành cho bạn và project này. Một skill đơn mục đích như Ponytail, hướng agent đến thay đổi nhỏ nhất nhưng vẫn hoạt động là trường hợp rõ ràng nhất: một file với một rule duy nhất, cho đến khi team của bạn cũng cần dùng nó. Hãy chuyển skill đó thành plugin khi người khác cần dùng và nó cần được cập nhật theo thời gian. Skill trong plugin có namespace riêng, nên skill bên trong plugin được gọi bằng /plugin-name:skill-name thay vì /skill-name.
Plugin đã cài nhưng skill không xuất hiện. Lỗi ở đâu?
Trước tiên hãy kiểm tra phần tóm tắt cài đặt. Nếu phần này ghi Run /reload-plugins to apply., Claude Code sẽ chạy thao tác reload đó khi panel đóng. Nếu reload cảnh báo rằng conversation sẽ được đọc lại, hãy chạy lại bằng /reload-plugins --force. Nếu plugin đã được nạp nhưng không hiển thị gì, mở /plugin và đọc tab Errors. Lỗi cấu trúc thường gặp nhất là đặt skills/, agents/ hoặc hooks/ bên trong .claude-plugin/, trong khi Claude Code không tìm các thành phần đó ở đó. Hãy nhớ rằng skill trong plugin có namespace riêng, nên khi nhập /, bạn cần tìm /plugin-name:skill-name. Nếu đây là plugin của người khác và plugin được nạp mà không báo lỗi, hãy mở khung chi tiết của plugin tại tab Installed: plugin không liệt kê skill nào ở đó thì không có skill để cung cấp. Nếu tab Errors cho biết plugin chưa được cache, thư mục cài đặt của plugin đã bị thiếu. Hãy cài lại từ shell bằng claude plugin install name@marketplace rồi chạy /reload-plugins.
Có thể cài plugin mà không dùng panel tương tác không?
Có. Dùng lệnh shell claude plugin install name@marketplace. Lệnh này cài plugin ở user scope, trừ khi bạn truyền --scope project hoặc --scope local. Lệnh hoạt động trong script, image và các môi trường non-interactive không có panel /plugin. Vì lệnh chạy bên ngoài session, session đang mở cần /reload-plugins trước khi plugin có hiệu lực. Trong session không có terminal tương tác, thay đổi đối với MCP server của plugin sẽ có hiệu lực ở session tiếp theo.
Cài plugin từ một marketplace tôi tìm thấy trên GitHub có an toàn không?
Hãy xem việc này tương đương với chạy install script của repository đó bằng tài khoản của bạn, vì bản chất gần như vậy. Plugin có thể chạy lệnh shell thông qua hook, thêm executable vào PATH của Bash tool và khởi động MCP server, tất cả bằng quyền của user hiện tại. Anthropic không kiểm soát hoặc xác minh nội dung plugin của bên thứ ba. Hãy cài từ những nguồn mà bạn có thể đọc, kiểm tra danh sách Will install trước khi xác nhận, và thận trọng hơn trên server so với laptop, vì tài khoản trên server thường có các key và token đáng giá để kẻ tấn công đánh cắp.