Khám phá và cài plugin qua marketplace

Plugin mở rộng Claude Code với skill, agent, hook, và MCP server. Marketplace plugin là các catalog giúp bạn khám phá và cài các extension này mà không cần tự xây dựng.

Muốn tạo và phân phối marketplace của riêng bạn? Xem hướng dẫn tạo plugin marketplace trong tài liệu gốc.

Marketplace hoạt động thế nào

Marketplace là một catalog các plugin do người khác tạo và chia sẻ. Dùng marketplace là quy trình hai bước:

1. Thêm marketplace: đăng ký catalog với Claude Code để duyệt xem có gì - chưa cài plugin nào.
2. Cài từng plugin: duyệt catalog và cài plugin bạn muốn.

Giống như thêm một app store: thêm store cho bạn quyền duyệt bộ sưu tập, nhưng bạn vẫn tự chọn app nào để tải.

Marketplace chính thức của Anthropic

Claude Code tự động thêm marketplace chính thức của Anthropic (claude-plugins-official) khi bạn khởi động. Nếu Claude Code không thêm được (ví dụ mạng bạn chặn tải), tự thêm bằng /plugin marketplace add anthropics/claude-plugins-official.

Duyệt danh mục bằng /plugin, vào tab Discover, hoặc xem tại claude.com/plugins.

/plugin install github@claude-plugins-official

/plugin mở panel tương tác trong CLI terminal. Nếu Claude báo /plugin không khả dụng trong môi trường này, dùng plugin browser trong Claude desktop app, hoặc khai báo plugin dưới enabledPlugins trong .claude/settings.json cho phiên cloud.

Ghi chú

Marketplace chính thức do Anthropic tuyển chọn, việc đưa vào là tuỳ quyết định của Anthropic. Form submit trong app thêm plugin vào community marketplace, không phải marketplace chính thức. Muốn phân phối độc lập, tạo marketplace riêng và chia sẻ với người dùng.

Marketplace chính thức gồm vài nhóm plugin:

Code intelligence

Plugin code intelligence bật tool LSP tích hợp sẵn của Claude Code, cho Claude khả năng nhảy đến định nghĩa, tìm reference, thấy lỗi kiểu ngay sau khi sửa - cùng công nghệ Language Server Protocol vận hành code intelligence của VS Code.

Cần cài binary language server trước khi dùng plugin tương ứng (plugin không tự cài):

Ngôn ngữ	Plugin	Binary cần có
C/C++	clangd-lsp	clangd
C#	csharp-lsp	csharp-ls
Go	gopls-lsp	gopls
Java	jdtls-lsp	jdtls
Python	pyright-lsp	pyright-langserver
Rust	rust-analyzer-lsp	rust-analyzer
TypeScript	typescript-lsp	typescript-language-server

(Còn hỗ trợ Kotlin, Lua, PHP, Swift - xem catalog đầy đủ trong /plugin.) Bạn cũng có thể tự tạo LSP plugin cho ngôn ngữ khác.

Sau khi cài và có binary, Claude nhận hai khả năng: chẩn đoán tự động (sau mỗi lần Claude sửa file, language server báo lỗi/cảnh báo ngay - không cần chạy compiler hay linter riêng) và điều hướng code (nhảy đến định nghĩa, tìm reference, xem type khi hover, liệt kê symbol…). Nhấn Ctrl+O khi Claude Code hiện chỉ báo kiểu Found 3 new diagnostic issues in 2 files để xem chi tiết.

Tích hợp bên ngoài

Các plugin đóng gói sẵn MCP server để kết nối Claude với dịch vụ ngoài không cần cấu hình thủ công: github, gitlab (source control); atlassian, asana, linear, notion (quản lý dự án); figma (thiết kế); vercel, firebase, supabase (hạ tầng); slack (giao tiếp); sentry (giám sát).

Review bảo mật tự động

Plugin security-guidance review mỗi thay đổi Claude tạo ra để tìm lỗ hổng phổ biến và hướng dẫn Claude sửa ngay trong phiên.

Workflow phát triển

• commit-commands: workflow git - commit, push, tạo PR
• pr-review-toolkit: agent chuyên review pull request
• agent-sdk-dev: công cụ xây dựng với Claude Agent SDK
• plugin-dev: bộ công cụ tạo plugin của riêng bạn

Output style

• explanatory-output-style: giải thích giáo dục về lựa chọn triển khai
• learning-output-style: chế độ học tương tác

Community marketplace

Marketplace cộng đồng tại anthropics/claude-plugins-community chứa plugin bên thứ ba đã qua xác thực tự động và sàng lọc an toàn của Anthropic. Mỗi plugin được pin vào một commit SHA cụ thể trong catalog. Khác marketplace chính thức, bạn phải thêm thủ công:

/plugin marketplace add anthropics/claude-plugins-community

/plugin install <tên-plugin>@claude-community

Thử nghiệm: thêm marketplace demo

Anthropic cũng duy trì một marketplace demo (claude-code-plugins) với các plugin ví dụ minh hoạ hệ thống plugin. Cần thêm thủ công:

1. Thêm marketplace:

   /plugin marketplace add anthropics/claude-code

2. Duyệt plugin khả dụng: chạy /plugin để mở plugin manager - giao diện có bốn tab (Tab/Shift+Tab để chuyển): Discover (duyệt plugin từ mọi marketplace), Installed (quản lý plugin đã cài), Marketplaces (thêm/xoá/cập nhật marketplace), Errors (lỗi khi load).

3. Cài một plugin: chọn plugin để xem chi tiết - bao gồm ước tính Context cost (số token thêm vào context mỗi lượt), ngày Last updated, và mục Will install liệt kê command, agent, skill, hook, MCP/LSP server plugin sẽ thêm. Chọn phạm vi cài:

   • User scope: cho riêng bạn, mọi project
   • Project scope: cho mọi người cộng tác trên repository này
   • Local scope: cho riêng bạn, chỉ repository này

   /plugin install commit-commands@claude-code-plugins

4. Dùng plugin mới: sau khi cài, chạy /reload-plugins để kích hoạt. Skill của plugin được namespace theo tên plugin, ví dụ commit-commands cung cấp /commit-commands:commit.

Thêm marketplace

Dùng /plugin marketplace add để thêm marketplace từ nhiều nguồn khác nhau.

Mẹo

Có thể dùng /plugin market thay cho /plugin marketplace, và rm thay cho remove.

• GitHub repository: dạng owner/repo, ví dụ anthropics/claude-code
• Git URL: bất kỳ URL git repository nào, gồm GitLab, Bitbucket, server tự host
• Đường dẫn local: thư mục hoặc đường dẫn trực tiếp đến file marketplace.json
• URL từ xa: URL trực tiếp đến file marketplace.json được hosted

Với git URL host khác GitHub, luôn kèm https:// và đuôi .git (để Claude Code clone thay vì hiểu nhầm là link trực tiếp):

/plugin marketplace add https://gitlab.com/company/plugins.git

Thêm nhánh/tag cụ thể bằng #:

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

Cài plugin

/plugin install plugin-name@marketplace-name

Lệnh mở chi tiết plugin đó, nơi bạn chọn phạm vi cài (user/project/local) - giống hệt khi chạy /plugin, vào tab Discover, nhấn Enter trên một plugin. Không cần bước tương tác, dùng lệnh shell claude plugin install (mặc định cài user scope trừ khi truyền --scope).

Bạn cũng có thể thấy plugin phạm vi managed - do quản trị viên cài qua managed settings, không sửa được.

Sau khi cài, /reload-plugins để kích hoạt trong phiên hiện tại.

Chú ý

Đảm bảo bạn tin tưởng một plugin trước khi cài. Anthropic không kiểm soát MCP server, file, hay phần mềm nào khác đi kèm trong plugin và không thể xác nhận chúng hoạt động đúng như mô tả. Kiểm tra trang chủ của mỗi plugin trước khi cài.

Quản lý plugin đã cài

/plugin → tab Installed để xem, bật/tắt, hoặc gỡ plugin. Danh sách nhóm theo phạm vi, ưu tiên hiện vấn đề trước (plugin lỗi load hoặc thiếu dependency lên đầu), rồi đến plugin bạn đã đánh dấu yêu thích, plugin đã tắt gấp lại ở cuối.

Từ danh sách: f để đánh dấu/bỏ đánh dấu yêu thích; gõ để lọc theo tên/mô tả; Enter để mở chi tiết và bật/tắt/gỡ.

Tab Installed cũng gom nhóm plugin bạn tự cài nhưng chưa dùng ít nhất hai tuần (qua ít nhất 10 phiên) dưới header Not used recently, giúp tìm plugin vẫn tốn context/startup dù không còn dùng.

Quản lý bằng lệnh trực tiếp:

/plugin list
/plugin disable plugin-name@marketplace-name
/plugin enable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

claude plugin install formatter@your-org --scope project

Áp dụng thay đổi plugin không cần restart

/reload-plugins

Claude Code load lại mọi plugin đang hoạt động, hiện số lượng plugin, skill, agent, hook, MCP server, LSP server. Số skill chỉ tính thư mục commands/, không tính skills/, nên tổng có thể hiện 0 skills dù skill của plugin vẫn được reload đúng.

Quản lý marketplace

Qua giao diện /plugin → tab Marketplaces: xem, thêm, cập nhật, xoá marketplace. Hoặc dùng lệnh:

/plugin marketplace list
/plugin marketplace update marketplace-name
/plugin marketplace remove marketplace-name

Chú ý

Xoá một marketplace sẽ gỡ mọi plugin bạn đã cài từ đó.

Cấu hình auto-update

Claude Code có thể tự cập nhật marketplace và plugin đã cài ở nền sau khi khởi động - kiểm tra sau khi phiên bắt đầu, delay ngẫu nhiên tối đa 10 phút, thông báo khi có plugin mới để bạn chạy /reload-plugins.

Bật/tắt auto-update cho từng marketplace: /plugin → Marketplaces → chọn marketplace → Enable/Disable auto-update. Marketplace chính thức của Anthropic bật auto-update mặc định; marketplace bên thứ ba và local development thì tắt mặc định.

Cấu hình marketplace cho team

Team admin thiết lập tự động cài marketplace cho project bằng cách thêm vào .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Khi thành viên team trust thư mục repository, Claude Code sẽ nhắc họ cài các marketplace và plugin này.

Bảo mật

Plugin và marketplace là thành phần rất được tin tưởng, có thể chạy code tuỳ ý trên máy bạn với quyền user của bạn. Chỉ cài plugin và thêm marketplace từ nguồn bạn tin tưởng. Tổ chức có thể giới hạn marketplace được phép thêm qua managed marketplace restrictions.

Xử lý sự cố

/plugin không nhận diện được: kiểm tra phiên bản bằng claude --version, cập nhật Claude Code (brew upgrade claude-code, npm install -g @anthropic-ai/claude-code@latest, hoặc chạy lại lệnh cài native), restart terminal.

Vấn đề thường gặp khác:

• Marketplace không load: kiểm tra URL truy cập được và .claude-plugin/marketplace.json tồn tại đúng chỗ
• Cài plugin thất bại: kiểm tra URL nguồn truy cập được, repository public hoặc bạn có quyền truy cập
• File không tìm thấy sau khi cài: plugin được copy vào cache, đường dẫn tham chiếu file ngoài thư mục plugin sẽ không hoạt động
• Skill của plugin không xuất hiện: xoá cache bằng rm -rf ~/.claude/plugins/cache, restart Claude Code, cài lại

Vấn đề code intelligence: kiểm tra binary có trong $PATH không; tắt plugin nếu language server (như rust-analyzer, pyright) chiếm nhiều bộ nhớ trên project lớn; diagnostic báo lỗi import sai trong monorepo thường do workspace chưa cấu hình đúng, không ảnh hưởng khả năng sửa code của Claude.

Bước tiếp theo

• Tạo plugin của riêng bạn: xây skill, agent, hook
• Tạo marketplace: phân phối plugin cho team hoặc cộng đồng

Nguồn

Dịch và biên soạn từ Discover and install prebuilt plugins through marketplaces.