Chợ plugin (plugin marketplace) cho phép chủ sở hữu gói Team và Enterprise phân phối các plugin đã được tuyển chọn cho mọi người trong tổ chức. Bạn tạo một chợ plugin, thêm plugin vào đó và kiểm soát chính xác những plugin mà thành viên trong nhóm có thể thấy và sử dụng. Các plugin bạn phân phối xuất hiện trong trò chuyện (trên web và tab Chat trong Claude Desktop), trong Claude Cowork và trong các phiên Claude Code nơi thành viên đăng nhập bằng cùng một tài khoản Claude.
Chủ sở hữu và Chủ sở hữu chính của gói Team và Enterprise có thể quản lý plugin của tổ chức trong Cài đặt tổ chức > Plugins & skills (Organization settings > Plugins & skills). Trên gói Enterprise, các thành viên có vai trò tùy chỉnh bao gồm quyền quản lý thư viện của tổ chức cũng có thể làm việc này.
Yêu cầu: Cả Cowork và Skills đều phải được bật cho tổ chức của bạn trước khi bạn có thể sử dụng chợ plugin.
Để xem phiên bản tham khảo của các tùy chọn kiểm soát này, hãy xem Quản lý plugin cho tổ chức của bạn trong tài liệu Claude Code.
Ghi chú: Tắt Skills cho tổ chức cũng sẽ dừng việc đồng bộ skills và plugin sang Claude Code, đồng thời xóa những skill và plugin đã được đồng bộ ở đó. Tắt Cowork không ảnh hưởng đến việc đồng bộ sang Claude Code. Để giữ skills và plugin trong Claude nhưng chỉ dừng việc đồng bộ, hãy đặt syncClaudeAiSkills và syncClaudeAiPlugins thành false trong cài đặt được quản lý của Claude Code. Tìm hiểu thêm về thiết lập quản trị Claude Code.
Ghi chú: Chợ plugin là cách chủ sở hữu phân phối plugin cho tổ chức. Người dùng cũng có thể chia sẻ plugin mình tạo với những đồng nghiệp hoặc nhóm cụ thể, hoặc gửi plugin để xuất bản vào thư viện của tổ chức. Việc chia sẻ và xuất bản được kiểm soát bằng các cài đặt trong Cài đặt tổ chức > Plugins & skills ở tab “Policy” (Chính sách), và các plugin được gửi lên sẽ được xem xét tại tab “Requests” (Yêu cầu). Tìm hiểu thêm về sử dụng plugin trong Claude và cho phép người dùng xuất bản skills và plugin vào tổ chức của bạn.
Xem những gì có trong tổ chức của bạn
Tab “Inventory” (Danh mục) liệt kê mọi skill và plugin mà tổ chức của bạn quản lý, bao gồm cả những skill và plugin người dùng tự tạo cho mình. Skills và plugin giờ đây nằm trên cùng một trang, nên bạn không cần chuyển qua lại giữa các cài đặt.
Với mỗi mục, bảng hiển thị nguồn, phiên bản, khả năng, đối tượng sử dụng và số người đã dùng mục đó trong 30 ngày qua.
Để tìm một mục, hãy tìm kiếm theo tên hoặc dùng bộ lọc:
-
Source (Nguồn): Tổ chức của bạn, Thư viện tổ chức hoặc một chợ plugin cụ thể
-
Audience (Đối tượng): Ai có thể sử dụng mục đó
-
Type (Loại): Skills hoặc plugin
Các skill do tổ chức của bạn quản lý xuất hiện trong Organization library (Thư viện tổ chức). Bạn quản lý chợ plugin trong tab Marketplaces.
Để thao tác với một mục, hãy nhấp vào nút menu ở cuối dòng của mục đó. Bạn có thể xem chi tiết và tệp, xem lịch sử phiên bản, và thay đổi quyền truy cập mặc định và quyền truy cập theo nhóm.
Đối với skills và plugin do người dùng tạo, tab Inventory hiển thị siêu dữ liệu và trạng thái chia sẻ. Tab này không hiển thị bản thân các tệp.
Sử dụng chợ plugin do Anthropic xây dựng
Anthropic cung cấp các chợ plugin có sẵn cho những chức năng khác nhau, như pháp lý và tài chính. Chợ Knowledge Work được thêm vào tổ chức của bạn theo mặc định.
Để thêm một chợ plugin do Anthropic xây dựng:
-
Đi tới Cài đặt tổ chức > Plugins & skills và nhấp vào tab “Marketplaces”.
-
Nhấp vào “Add” (Thêm), rồi chọn “Add marketplace” (Thêm chợ plugin).
-
Chọn “Browse Anthropic sources” (Duyệt nguồn của Anthropic).
-
Nhấp vào “Add” trên từng chợ bạn muốn hiển thị cho mọi người trong tổ chức.
Để xóa chợ Knowledge Work nếu không phù hợp với các nhóm của bạn:
-
Đi tới Cài đặt tổ chức > Plugins & skills và nhấp vào tab “Marketplaces”.
-
Tìm Knowledge Work.
-
Nhấp vào nút menu ở góc trên bên phải.
-
Chọn “Remove” (Xóa).
Các chợ plugin do Anthropic xây dựng hiển thị tên dễ đọc, như “Knowledge Work,” thay vì slug của kho lưu trữ bên dưới.
Tạo chợ plugin của riêng bạn
Ngoài các chợ plugin do Anthropic xây dựng, bạn có thể tạo chợ của riêng mình. Có hai cách để thêm plugin vào chợ do bạn tạo:
-
Tải lên thủ công: Tải lên từng tệp ZIP plugin thông qua giao diện quản trị. Phù hợp nhất để lặp lại nhanh, cho các công cụ dùng một lần hoặc cho những nhóm không lưu plugin trong kho Git.
-
Đồng bộ kho lưu trữ: Kết nối một kho GitHub hoặc GitLab riêng tư và Claude sẽ đồng bộ plugin từ đó. Phù hợp nhất khi nhiều nhà phát triển cùng cộng tác trên plugin hoặc khi bạn muốn cập nhật có kiểm soát phiên bản.
Bạn có thể dùng song song cả hai cách. Ví dụ: chạy một chợ đồng bộ với GitHub cho các plugin cốt lõi và một chợ thủ công riêng cho các công cụ tùy biến.
Thiết lập chợ plugin thủ công
-
Nhấp vào “Add,” rồi chọn “Upload a plugin” (Tải lên plugin).
-
Nếu đây là lần đầu bạn thiết lập chợ plugin, “Upload to a new marketplace” (Tải lên chợ mới) sẽ được chọn sẵn. Bạn có thể chọn “Add to an existing marketplace” (Thêm vào chợ hiện có) khi tải lên plugin sau này.
-
Nhập tên cho chợ plugin của bạn.
-
Kéo tệp vào, hoặc nhấp vào lời nhắc tải lên và chọn tệp. Tệp phải là tệp .zip hợp lệ có dung lượng dưới 200 MB.
-
Lặp lại cho từng plugin bạn muốn thêm.
-
Nhấp vào “Upload” để thêm plugin vào chợ mới.
Nếu bạn tải lên một plugin trùng tên với plugin hiện có, nó sẽ tự động ghi đè phiên bản trước. Bạn không cần xóa plugin cũ trước.
Thiết lập chợ plugin đồng bộ với GitHub
Đồng bộ GitHub cho phép bạn quản lý plugin dưới dạng mã trong một kho lưu trữ. Khi bạn đẩy thay đổi, bạn có thể kích hoạt đồng bộ để cập nhật chợ plugin, thủ công hoặc tự động.
Chuẩn bị kho lưu trữ
Bạn có thể kết nối một kho lưu trữ trên github.com hoặc trên máy chủ GitHub Enterprise của tổ chức. Trên github.com, kho lưu trữ của bạn phải ở chế độ private hoặc internal—kho công khai không được phép dùng cho chợ plugin của tổ chức. Để đồng bộ từ GitLab, hãy xem Thiết lập chợ plugin đồng bộ với GitLab.
Chợ plugin đồng bộ với GitHub hỗ trợ ít loại source trong marketplace.json hơn so với Claude Code. Đường dẫn tương đối đến các thư mục plugin bên trong kho của chợ (ví dụ: "source": "./plugins/my-plugin") được hỗ trợ đầy đủ và là lựa chọn đơn giản nhất. Các loại nguồn github, url và git-subdir cũng được hỗ trợ. Các loại nguồn npm, archive và command không được hỗ trợ.
Nguồn plugin có thể ở chế độ riêng tư trong ba trường hợp:
-
Nguồn trên github.com có cùng chủ sở hữu với kho của chợ plugin, được đồng bộ tổ chức tải về thông qua Claude GitHub App.
-
Nguồn trên máy chủ GitHub Enterprise của tổ chức, với GitHub Enterprise App của tổ chức đã được cài đặt trên kho đó.
-
Nguồn url hoặc git-subdir trên cùng máy chủ GitLab với kho của chợ plugin. Trên gitlab.com, nguồn cũng phải nằm trong cùng nhóm cấp cao nhất hoặc không gian tên người dùng với kho của chợ plugin.
Mọi nguồn khác đều được tải về mà không dùng thông tin xác thực, vì vậy phải là kho công khai trên github.com, gitlab.com hoặc bitbucket.org. Nguồn trên bất kỳ máy chủ nào khác sẽ bị từ chối.
Nếu mã plugin của bạn nằm trong một kho riêng tư không đáp ứng các tiêu chí trên, hãy sao chép các thư mục plugin đó vào kho của chợ plugin và đổi nguồn của từng plugin thành đường dẫn tương đối (git subtree hoặc một bước CI sao chép tệp vào kho đều hoạt động tốt).
Để biết chi tiết về cấu trúc và định dạng plugin, hãy xem tài liệu tham khảo manifest của plugin.
Tài nguyên bổ sung:
Kết nối kho lưu trữ
-
Đảm bảo cả Cowork và Skills đều đã được bật cho tổ chức của bạn.
-
Đi tới Cài đặt tổ chức > Plugins & skills và nhấp vào tab “Marketplaces”.
-
Nhấp vào “Add plugins” (Thêm plugin), rồi chọn “Sync from GitHub” (Đồng bộ từ GitHub).
-
Nhập kho lưu trữ theo định dạng
owner/repo(ví dụ:acme-corp/claude-plugins).
Token GitHub cá nhân của bạn sẽ được xác minh để xác nhận bạn có quyền truy cập, sau đó Cowork dùng token cài đặt GitHub App của mình cho các thao tác đồng bộ.
Không thấy kho của bạn? Hãy đảm bảo Claude GitHub App đã được cài đặt trong kho đó.
Cách đồng bộ hoạt động
Lần đồng bộ đầu tiên sẽ tự động chạy khi bạn kết nối một kho lưu trữ. Trong quy trình tạo bằng GitHub, bạn cũng có thể tắt “Sync automatically” (Đồng bộ tự động), tùy chọn này được bật theo mặc định. Khi bật, việc đồng bộ sẽ chạy khi một pull request được hợp nhất vào nhánh mà chợ plugin theo dõi, hoặc khi có người đẩy trực tiếp lên nhánh đó.
Người bật hoặc tắt đồng bộ tự động phải có quyền truy cập cấp quản trị vào kho đó trên GitHub. Điều này được kiểm tra thông qua kết nối GitHub cá nhân của họ, tách biệt với bản cài đặt Claude GitHub App. Nếu không có quyền quản trị, trang sẽ hiển thị “Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed” (Không thể truy cập kho. Hãy đảm bảo kho tồn tại và Claude GitHub App đã được cài đặt), ngay cả khi App đã được cài đặt đúng và cập nhật thủ công vẫn hoạt động.
Quyền Webhooks (Read & Write) của Claude GitHub App cũng phải được phê duyệt trên bản cài đặt. Với các bản cài đặt được tạo trước khi quyền này ra đời, GitHub sẽ hiển thị lời nhắc “Claude is requesting updated permissions” (Claude đang yêu cầu cập nhật quyền) mà quản trị viên kho hoặc tổ chức cần phê duyệt.
Sau khi được bật, đồng bộ tự động cho kho GitHub sẽ chạy khi một pull request có tăng phiên bản plugin được hợp nhất vào nhánh mặc định của kho. Việc đẩy trực tiếp lên nhánh mặc định không kích hoạt đồng bộ. Bạn luôn có thể kích hoạt đồng bộ thủ công bằng cách nhấp vào “Re-sync” (Đồng bộ lại) trên chợ plugin.
Trong quá trình đồng bộ, Cowork so sánh commit mới nhất trong kho của bạn với commit được đồng bộ gần nhất. Nếu không có gì thay đổi, việc đồng bộ sẽ được bỏ qua. Nếu có thay đổi, Cowork đọc manifest, xác thực từng plugin và thay thế tất cả plugin trong chợ bằng trạng thái hiện tại của kho. Việc đồng bộ có thể mất tới 30 phút tùy theo số lượng plugin.
Quan trọng: Nếu đồng bộ thất bại, thành viên vẫn giữ phiên bản được đồng bộ gần nhất của từng plugin. Hãy kiểm tra thông báo lỗi, sửa kho và đồng bộ lại.
Thiết lập chợ plugin đồng bộ với GitLab
Bạn có thể đồng bộ chợ plugin của tổ chức từ một kho trên gitlab.com hoặc trên một phiên bản GitLab tự quản lý. Để biết các loại nguồn plugin được hỗ trợ và những nguồn nào có thể ở chế độ riêng tư, hãy xem Chuẩn bị kho lưu trữ ở trên.
Hỗ trợ GitLab đang ở giai đoạn beta và chỉ áp dụng cho việc đồng bộ chợ plugin. Claude Code on the web hiện chưa hỗ trợ kho GitLab.
Trước khi bắt đầu
-
Vai trò. Bạn cần có vai trò Chủ sở hữu hoặc Chủ sở hữu chính để thêm cấu hình GitLab.
-
Chế độ hiển thị của dự án. Trên gitlab.com, dự án của chợ plugin phải ở chế độ private hoặc internal. Trên phiên bản tự quản lý, chế độ hiển thị nào cũng được.
-
Token truy cập. Tạo một token truy cập GitLab để Claude đọc dự án của chợ plugin và mọi dự án nguồn plugin trên cùng máy chủ. Token truy cập cá nhân, nhóm và dự án đều hoạt động được. Người dùng của token cần có ít nhất vai trò Reporter trên các dự án đó.
-
Token cũ (theo phạm vi): ít nhất phạm vi
read_api. -
Token truy cập cá nhân chi tiết (fine-grained): các quyền Project: Read, Branch: Read và Repository: Read.
-
Tùy chọn, để thiết lập webhook tự động (bước 3): vai trò Maintainer trên dự án của chợ plugin cùng với phạm vi
api(token cũ) hoặc quyền Webhook: Create and Delete (token chi tiết). Nếu không có các quyền này, bạn sẽ thêm webhook thủ công một lần (bước 4).
-
-
Chỉ áp dụng cho phiên bản tự quản lý.
-
Tên máy chủ của phiên bản phải phân giải được thành địa chỉ IP công khai, và phiên bản phải chấp nhận kết nối HTTPS từ các địa chỉ IP gửi đi của Anthropic.
-
Nếu chứng chỉ TLS được cấp bởi một tổ chức phát hành chứng chỉ (CA) riêng, hãy chuẩn bị sẵn chứng chỉ CA (PEM).
-
Các lần gửi webhook để đồng bộ tự động đi từ phiên bản của bạn đến api.anthropic.com, vì vậy phiên bản phải có thể gửi yêu cầu HTTPS ra ngoài đến máy chủ đó.
-
Bước 1: Thêm cấu hình GitLab
Để thêm cấu hình GitLab:
-
Đi tới Cài đặt tổ chức > Claude Code.
-
Trong mục Self-hosted infrastructure (Hạ tầng tự lưu trữ), tìm GitLab và nhấp vào “Add configuration” (Thêm cấu hình).
-
Nhập tên hiển thị, tên máy chủ (gitlab.com, hoặc tên máy chủ của phiên bản như gitlab.example.com), token truy cập và, đối với phiên bản tự quản lý dùng CA riêng, chứng chỉ CA.
-
Nhấp vào “Add configuration.” Claude sẽ chạy kiểm tra kết nối ngay lập tức và hiển thị kết quả trong hộp thoại GitLab connection test (Kiểm tra kết nối GitLab).
-
(Tùy chọn) Để kiểm tra xem token có thể đọc dự án của chợ plugin hay không, hãy nhập đường dẫn dự án (ví dụ:
platform/claude-plugins) trong Project path (Đường dẫn dự án) và nhấp vào “Test sync access” (Kiểm tra quyền đồng bộ).
Bạn có thể chạy lại bài kiểm tra bất cứ lúc nào từ menu của cấu hình bằng Test connection (Kiểm tra kết nối). Tên máy chủ không thể thay đổi về sau. Nếu tên máy chủ thay đổi, hãy xóa cấu hình và thêm cấu hình mới.
Bước 2: Thêm chợ plugin
Để thêm chợ plugin:
-
Đi tới Cài đặt tổ chức > Plugins & skills và nhấp vào tab “Marketplaces”.
-
Nhấp vào “Add,” rồi chọn “Sync from GitLab” (Đồng bộ từ GitLab).
-
Trong GitLab repository URL (URL kho GitLab), nhập URL HTTPS của dự án, ví dụ
https://gitlab.example.com/platform/claude-plugins. Các dự án trong nhóm con lồng nhau đều hoạt động. -
Giữ Sync automatically ở trạng thái bật nếu bạn muốn các lần đẩy kích hoạt đồng bộ (xem Bước 3).
-
Chọn Default access (Quyền truy cập mặc định) cho các plugin trong chợ.
-
Nhấp vào “Create” (Tạo).
Claude đọc nhánh mặc định của dự án và xác thực tệp marketplace trước khi tạo chợ plugin, chợ này được đặt tên theo đường dẫn dự án.
Bước 3: Đồng bộ tự động
Khi bật Sync automatically, mỗi lần đẩy lên nhánh mặc định của dự án sẽ kích hoạt đồng bộ thông qua một webhook trên dự án GitLab. Nếu token của bạn có thể quản lý webhook (xem Trước khi bắt đầu), Claude sẽ tạo webhook cho bạn và bạn không cần làm gì thêm.
Bạn có thể bật hoặc tắt Sync automatically sau này từ menu của chợ plugin. Bật tùy chọn này sẽ thiết lập webhook theo cùng cách.
Bước 4: Nếu Claude không thể tạo webhook
Nếu token không thể quản lý webhook, Claude sẽ hiển thị thông báo Finish webhook setup in GitLab (Hoàn tất thiết lập webhook trong GitLab) trên màn hình kèm Webhook URL và một token. Token chỉ được hiển thị một lần, vì vậy hãy hoàn tất bước này trước khi đóng thông báo.
-
Trong dự án GitLab của bạn, mở Settings > Webhooks và thêm webhook mới với URL từ thông báo.
-
Dán token vào trường tương ứng.
-
Nếu thông báo hiển thị Secret token, hãy dán token đó vào trường Secret token của GitLab.
-
Nếu thông báo hiển thị Signing token (gitlab.com và các phiên bản tự quản lý từ 19.1 trở lên), hãy chọn “Generate signing token” trong GitLab và thay giá trị được tạo bằng giá trị từ Claude.
-
-
Bật Push events và lưu.
-
(Tùy chọn) Dùng Test > Push events trên webhook mới trong GitLab và xác nhận kết quả trả về HTTP 200.
Nếu bạn làm mất token, hãy mở Configure webhook (Cấu hình webhook) từ menu của chợ plugin, nhấp vào “Remove webhook” (Xóa webhook), rồi “Enable webhook” (Bật webhook) để nhận token mới. Token cũ sẽ ngừng hoạt động.
Chọn giữa tải lên thủ công và đồng bộ kho lưu trữ
|
Tình huống |
Cách tiếp cận được khuyến nghị |
|
Plugin được duy trì trong hệ thống quản lý phiên bản với CI/CD |
Đồng bộ GitHub hoặc GitLab |
|
Nhiều nhà phát triển cộng tác trên plugin |
Đồng bộ GitHub hoặc GitLab |
|
Bạn muốn cập nhật được lan truyền tự động |
Đồng bộ GitHub hoặc GitLab |
|
Tạo nguyên mẫu nhanh hoặc công cụ dùng một lần |
Tải lên thủ công |
|
Plugin do các nhóm không chuyên về kỹ thuật xây dựng |
Tải lên thủ công |
|
Môi trường không có quyền truy cập GitHub hoặc GitLab |
Tải lên thủ công |
|
Kiểm thử plugin trước khi thêm vào kho được đồng bộ |
Tải lên thủ công |
Kiểm soát việc phân phối plugin
Khi chợ plugin đã có plugin, bạn kiểm soát cách phân phối chúng bằng tùy chọn cài đặt. Với mỗi plugin, bạn có thể đặt một trong bốn tùy chọn:
|
Tùy chọn |
Chức năng |
Thành viên nhìn thấy gì |
|
Installed by default (Cài đặt theo mặc định) |
Cài đặt sẵn plugin cho tất cả thành viên trong tổ chức |
Plugin xuất hiện trong danh sách của họ mà không cần thao tác gì. Thành viên có thể tắt plugin nếu muốn. |
|
Available to install (Có sẵn để cài đặt) |
Được liệt kê trên tab Discover (Khám phá) |
Người dùng thấy plugin trên tab Discover và có thể tự thêm. |
|
Not available (Không khả dụng) |
Ẩn hoàn toàn |
Người dùng không thể thấy hoặc thêm plugin. Hữu ích khi chuẩn bị triển khai hoặc ngừng sử dụng plugin. |
|
Required (Bắt buộc) |
Cài đặt sẵn plugin cho tất cả thành viên trong tổ chức mà không có tùy chọn gỡ bỏ |
Plugin xuất hiện trong danh sách của họ mà không cần thao tác gì, được đánh dấu “This plugin is required by your organization.” (Plugin này là bắt buộc theo yêu cầu của tổ chức bạn.) Người dùng không thể tắt hoặc gỡ bỏ plugin. Plugin cũng luôn được bật trong các phiên Claude Code có đồng bộ plugin từ tài khoản của thành viên. |
Quan trọng: Các plugin được đặt là “Installed by default” hoặc “Required” cũng được cài đặt trong Claude Code cho những người dùng đăng nhập bằng tài khoản Claude. Trong Claude Code, các hook, sub-agent và máy chủ MCP của plugin chạy trên máy tính của người dùng, và plugin “Required” không thể bị vô hiệu hóa ở đó. Hãy xem xét các hook của plugin trước khi đặt plugin là “Required.” Tìm hiểu thêm về plugin được đồng bộ trong tài liệu Claude Code.
Đặt tùy chọn
-
Trong Cài đặt tổ chức > Plugins & skills, nhấp vào tab “Inventory”.
-
Tìm plugin và nhấp vào nút menu ở cuối dòng của plugin đó.
-
Nhấp vào “Default access” (Quyền truy cập mặc định), rồi chọn một tùy chọn trong mục Install (Cài đặt).
-
Thay đổi có hiệu lực vào phiên làm việc tiếp theo của mỗi thành viên hoặc khi plugin được làm mới.
Trải nghiệm của thành viên
Thành viên duyệt các plugin có sẵn trên tab Discover trong Customize > Plugins (Tùy chỉnh > Plugin). Các plugin bạn đặt là “Installed by default” hoặc “Required” sẽ tự động xuất hiện trong danh sách của họ. Các plugin bạn đặt là “Available to install” sẽ hiển thị trên Discover để thành viên tự thêm.
Thành viên không thể chỉnh sửa các plugin do tổ chức quản lý, điều này giúp tránh các thay đổi xung đột đối với công cụ dùng chung.
Tùy chỉnh quyền truy cập plugin theo nhóm
Quản trị viên gói Enterprise có thể ghi đè tùy chọn cài đặt áp dụng toàn tổ chức của một plugin cho các nhóm cụ thể. Ví dụ: bạn có thể tự động cài đặt một plugin cho nhóm Engineering, cho phép nhóm Legal tự cài đặt và ẩn plugin với mọi người khác.
Quyền truy cập plugin theo nhóm có sẵn trên gói Enterprise. Bạn đặt quyền này trên cùng trang Cài đặt tổ chức > Plugins & skills, trang này yêu cầu vai trò Chủ sở hữu hoặc vai trò tùy chỉnh có quyền quản lý thư viện của tổ chức.
Cách hoạt động của ghi đè theo nhóm
Mỗi plugin trong chợ của bạn có một tùy chọn cài đặt áp dụng toàn tổ chức (Installed by default, Available to install, Required hoặc Not available). Theo mặc định, mọi nhóm đều kế thừa cài đặt toàn tổ chức đó.
Khi bạn đặt một giá trị ghi đè cấp nhóm cho một plugin, giá trị đó sẽ thay thế cài đặt toàn tổ chức đối với thành viên của nhóm. Thứ tự áp dụng là: cài đặt nhóm, sau đó cài đặt toàn tổ chức, rồi đến mặc định của chợ plugin.
Đặt quyền truy cập plugin cho một nhóm
-
Trong Cài đặt tổ chức > Plugins & skills, nhấp vào tab “Inventory”.
-
Tìm plugin bạn muốn tùy chỉnh và nhấp vào nút menu ở cuối dòng của plugin đó.
-
Nhấp vào “Group access…” (Quyền truy cập theo nhóm…).
-
Nhấp vào “Add groups” (Thêm nhóm) bên cạnh Install targeting (Đối tượng cài đặt).
-
Chọn nhóm và chọn một trong các tùy chọn cài đặt được liệt kê ở trên.
Cả nhóm được tạo thủ công và nhóm được cấp phát qua SCIM từ nhà cung cấp danh tính đều xuất hiện trong bộ chọn nhóm và hoạt động theo cùng một cách.
Điều gì xảy ra khi một thành viên thuộc nhiều nhóm
Nếu một thành viên thuộc từ hai nhóm trở lên với các cài đặt khác nhau cho cùng một plugin, cài đặt rộng rãi nhất sẽ được áp dụng. Thứ tự từ rộng rãi nhất đến hạn chế nhất là: Required > Installed by default > Available to install > Not available.
Ví dụ: nếu Nhóm A đặt một plugin là “Not available” và Nhóm B đặt là “Installed by default,” thành viên thuộc cả hai nhóm sẽ được cài đặt plugin theo mặc định.
Ghi chú: Điều này khác với cách áp dụng giới hạn chi tiêu theo nhóm. Giới hạn chi tiêu áp dụng giá trị nhóm cao hơn hoặc thấp hơn tùy theo cài đặt Multi-group spend limit (Giới hạn chi tiêu cho nhiều nhóm) của bạn. Quyền truy cập plugin áp dụng giá trị rộng rãi nhất, vì nhóm ở đây nhằm mở quyền truy cập cho những nhóm cần một công cụ, chứ không đóng vai trò ranh giới bảo mật. Nếu bạn cần chặn hoàn toàn một plugin, hãy đặt tùy chọn toàn tổ chức của plugin đó là “Not available” và chỉ cấp quyền truy cập cho những nhóm cần có.
Điều gì xảy ra khi một nhóm bị xóa
Nếu một nhóm bị xóa (ví dụ: bị xóa khỏi nhà cung cấp danh tính), giá trị ghi đè vẫn còn trong giao diện quản trị nhưng được gắn cờ là mồ côi (orphaned). Giá trị này không ảnh hưởng đến thành viên nào (vì không ai thuộc một nhóm đã bị xóa) và không được tính vào huy hiệu quyền truy cập tùy chỉnh. Bạn có thể xóa các giá trị ghi đè mồ côi trong cài đặt “Group access…” của plugin.
Cài đặt nhóm có được giữ lại qua các lần đồng bộ lại chợ plugin không?
Có. Các giá trị ghi đè cấp nhóm được giữ lại khi bạn đồng bộ lại một chợ plugin được kết nối với GitHub hoặc GitLab. Chúng chỉ bị xóa nếu chính plugin bị xóa khỏi chợ.
Giới hạn những chợ plugin mà người dùng có thể thêm
Chủ sở hữu hoặc Chủ sở hữu chính có thể giới hạn những chợ plugin mà mọi người trong tổ chức có thể thêm, bằng danh sách cho phép, danh sách chặn hoặc cả hai. Bạn đặt các danh sách này trong cài đặt được quản lý của Claude Code, nhưng chúng cũng áp dụng trong Claude và Claude Cowork.
Để đặt danh sách cho phép hoặc danh sách chặn:
-
Đi tới Cài đặt tổ chức > Claude Code.
-
Tìm Managed settings (Cài đặt được quản lý).
-
Nhấp vào “Manage” (Quản lý).
-
Thêm strictKnownMarketplaces (danh sách cho phép), blockedMarketplaces (danh sách chặn) hoặc cả hai vào JSON.
-
Nhấp vào “Add settings” (Thêm cài đặt) hoặc “Update settings” (Cập nhật cài đặt).
Nhập tên tổ chức GitHub của bạn chính xác như GitHub hiển thị, vì việc so khớp danh sách cho phép có phân biệt chữ hoa chữ thường. Nếu một nguồn nằm trong cả hai danh sách, nguồn đó sẽ bị chặn.
Sau khi đặt danh sách, Claude sẽ kiểm tra chúng mỗi khi có người trong tổ chức thêm chợ plugin từ một kho Git trong Claude, Claude Desktop hoặc Cowork. Điều này bao gồm các chợ plugin người dùng tự thêm trong Customize và các chợ được thêm cho toàn tổ chức trong Cài đặt tổ chức > Plugins & skills. Claude từ chối mọi kho lưu trữ không được danh sách cho phép, ngoại trừ các chợ plugin do Anthropic xây dựng.
Lưu ý:
-
Hãy đặt danh sách trong Cài đặt tổ chức. Tệp managed-settings.json hoặc chính sách MDM được triển khai lên máy tính chỉ áp dụng cho Claude Code trên những máy tính đó.
-
Các chợ plugin hiện có không được kiểm tra lại. Các chợ được thêm trước khi bạn đặt danh sách vẫn được giữ cho đến khi có người xóa chúng.
-
Plugin được tải lên không được kiểm tra. Để ngăn người dùng tải lên tệp plugin, hãy tắt User-created skills (Skills do người dùng tạo) trong Cài đặt tổ chức > Plugins & skills ở tab “Policy”.
Để xem mọi loại nguồn mà danh sách chấp nhận, hãy xem Giới hạn những gì người dùng có thể cài đặt trong tài liệu Claude Code.
Cập nhật và gỡ bỏ plugin
Chợ plugin thủ công
Để cập nhật một plugin, hãy tải lên tệp ZIP mới có cùng tên plugin. Phiên bản mới sẽ tự động ghi đè phiên bản hiện có. Tên plugin là định danh duy nhất, vì vậy legal sẽ luôn thay thế legal.
Để gỡ bỏ một plugin, hãy xóa plugin đó khỏi chợ trong Cài đặt tổ chức > Plugins & skills ở tab “Inventory”.
Chợ plugin đồng bộ với GitHub
Đẩy các thay đổi lên kho đã kết nối, sau đó đi tới Cài đặt tổ chức > Plugins & skills, nhấp vào tab “Marketplaces”, tìm chợ plugin của bạn và nhấp vào “Update” (Cập nhật) để kích hoạt đồng bộ. Mỗi lần đồng bộ sẽ thay thế tất cả plugin bằng trạng thái hiện tại của kho. Nếu chủ sở hữu đã bật “Sync automatically” cho chợ plugin, việc đồng bộ cũng sẽ chạy mỗi khi một pull request có tăng phiên bản plugin được hợp nhất vào nhánh mặc định của kho.
Đối với chợ plugin đồng bộ với GitLab, hãy xem Thiết lập chợ plugin đồng bộ với GitLab.
Để gỡ bỏ một plugin, hãy xóa plugin đó khỏi kho và kích hoạt đồng bộ.
Giới hạn
|
Giới hạn |
Giá trị |
Ghi chú |
|
Dung lượng tối đa của tệp ZIP plugin (tải lên) |
200 MB |
Được áp dụng cả phía máy khách và phía máy chủ |
|
Số plugin tối đa mỗi chợ (thủ công) |
1000 |
Mỗi chợ plugin |
|
Số plugin tối đa mỗi chợ (đồng bộ GitHub hoặc GitLab) |
1000 |
Mỗi chợ plugin |
|
Độ dài tối đa của tên plugin |
64 ký tự |
Phải dùng các từ viết thường, nối với nhau bằng dấu gạch ngang |
|
Thời gian chờ đồng bộ |
30 phút |
Mỗi thao tác đồng bộ |
|
Chế độ hiển thị của kho được đồng bộ |
Chỉ private hoặc internal trên github.com và gitlab.com |
Được lưu trữ trên github.com, GitHub Enterprise Server, gitlab.com hoặc phiên bản GitLab tự quản lý. Các máy chủ GitLab (bao gồm gitlab.com) yêu cầu cấu hình GitLab trong Cài đặt tổ chức > Claude Code. |
Quy tắc đặt tên
Tên plugin phải dùng các từ viết thường nối với nhau bằng dấu gạch ngang (ví dụ: deployment-tools, không phải Deployment Tools). Các tên chợ plugin sau đây được dành riêng và không thể sử dụng:
-
claude-code-marketplace -
claude-code-plugins -
claude-plugins-official -
anthropic-marketplace -
anthropic-plugins -
agent-skills -
life-sciences
Các tên mạo danh chợ plugin chính thức của Anthropic cũng bị chặn.
Ghi chú: Tác giả plugin có thể đặt displayName để plugin hiển thị tên dễ đọc trong danh mục thay vì slug. Nếu tác giả không đặt, plugin sẽ hiển thị slug (ví dụ: deployment-tools).
Khắc phục sự cố
Tải lên bị từ chối
Nguyên nhân phổ biến: tệp vượt quá 200 MB, không phải tệp ZIP hợp lệ, hoặc chợ plugin đã đạt giới hạn 1000 plugin. Hãy kiểm tra dung lượng và định dạng tệp, và xóa các plugin không dùng đến nếu đã đạt giới hạn. Nếu tính năng quét skill và plugin đang bật, plugin cũng có thể bị từ chối vì bị gắn cờ chứa nội dung độc hại. Hãy xem lý do, khắc phục vấn đề và tải plugin lên lại.
Plugin không xuất hiện cho thành viên
Kiểm tra tùy chọn cài đặt của plugin trong cài đặt chợ plugin. Nếu được đặt là Not available, thành viên sẽ không thấy plugin. Đồng thời xác nhận rằng cả Cowork và Skills đều đã được bật cho tổ chức của bạn.
Plugin đã cập nhật nhưng chưa hiển thị với thành viên
Thay đổi có hiệu lực vào phiên làm việc tiếp theo của mỗi thành viên hoặc khi plugin được làm mới. Trong Claude Code, người dùng nhận được thay đổi vào lần tiếp theo họ khởi động Claude Code. Nếu bản cập nhật vẫn chưa hiển thị, hãy xác nhận việc tải lên đã thành công bằng cách kiểm tra phiên bản plugin trong chợ plugin.
Đồng bộ GitHub thất bại với lỗi nội dung
Có thể một hoặc nhiều plugin trong kho của bạn được định dạng sai. Hãy sửa lỗi định dạng, đẩy bản cập nhật lên GitHub và kích hoạt đồng bộ lại. Để biết các yêu cầu về cấu trúc plugin, hãy xem tài liệu tham khảo manifest của plugin.
Đồng bộ thất bại với lỗi “External plugin source type is not supported. Supported types: git-subdir, github, url” hoặc plugin bị bỏ qua với thông báo “Repository not found on gitlab.com. Check the URL and make sure the repository is public.”
Một hoặc nhiều mục plugin trong marketplace.json của bạn dùng source trỏ ra ngoài kho đã kết nối (nguồn github, url hoặc git-subdir), và đồng bộ tổ chức không thể tải về. Nguồn riêng tư chỉ hoạt động trong ba trường hợp: kho trên github.com có cùng chủ sở hữu với kho của chợ plugin, kho trên máy chủ GitHub Enterprise của tổ chức với GitHub Enterprise App đã được cài đặt trên đó, hoặc nguồn url hay git-subdir trên cùng máy chủ GitLab với kho của chợ plugin (trên gitlab.com, cũng phải thuộc cùng nhóm cấp cao nhất hoặc không gian tên người dùng).
Với bất kỳ nguồn riêng tư nào khác, hãy chuyển các thư mục plugin vào kho của chợ plugin và đổi source của từng mục thành đường dẫn tương đối (ví dụ: "./plugins/my-plugin"), rồi đẩy lên và đồng bộ lại. Ngoài ra, bạn có thể tải lên từng plugin bị ảnh hưởng qua Cài đặt tổ chức > Plugins & skills Nhấp vào “Add,” “Upload a plugin,” rồi chọn “Add to an existing marketplace.” Các plugin được tải lên qua menu Customize riêng của thành viên chỉ được cài đặt cho thành viên đó và không được phân phối cho tổ chức, mặc dù thành viên có thể chia sẻ plugin với những đồng nghiệp hoặc nhóm cụ thể nếu tính năng chia sẻ được bật.
Không thấy kho GitHub khi kết nối
Đảm bảo Claude GitHub App đã được cài đặt trong kho đó. Token GitHub cá nhân của bạn được kiểm tra trước để xác nhận quyền truy cập, nhưng bản thân việc đồng bộ sử dụng token cài đặt GitHub App.
Lỗi “Cannot access repository” khi bật “Sync automatically”
Nếu cập nhật thủ công hoạt động nhưng việc bật “Sync automatically” hiển thị “Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed,” có hai nguyên nhân có thể xảy ra:
-
Bạn không có quyền quản trị đối với kho. Bật đồng bộ tự động sẽ tạo một webhook, việc này yêu cầu quyền truy cập cấp quản trị vào kho thông qua kết nối GitHub cá nhân của bạn. Hãy nhờ quản trị viên kho bật nút gạt, hoặc yêu cầu nâng cấp quyền truy cập GitHub của bạn.
-
Quyền Webhooks của Claude GitHub App chưa được phê duyệt. Trên các bản cài đặt cũ, GitHub hiển thị lời nhắc “Claude is requesting updated permissions”. Quản trị viên kho hoặc tổ chức cần phê duyệt quyền Webhooks (Read & Write) trên bản cài đặt.
Lỗi “No GitLab instance is configured for your organization yet. Add one under Claude Code settings, then come back here” khi thêm chợ plugin
Nếu bạn thấy thông báo này khi thêm chợ plugin trong GitLab, hãy đảm bảo bạn đã thêm cấu hình GitLab trước. Xem Bước 1: Thêm cấu hình GitLab trong Thiết lập chợ plugin đồng bộ với GitLab.
Lỗi “This URL isn’t on a configured GitLab instance”
Đảm bảo tên máy chủ trong URL khớp chính xác với một tên máy chủ GitLab đã được cấu hình.
Thêm dự án gitlab.com thất bại với lỗi “Failed to create marketplace. Try again.”
Kiểm tra xem chế độ hiển thị của dự án có phải là private hoặc internal hay không. Các dự án gitlab.com công khai không thể được dùng làm chợ plugin của tổ chức.
Kiểm tra kết nối thất bại ở bước Reach host (ví dụ “The hostname couldn’t be resolved,” “The connection was refused,” hoặc “GitLab didn’t respond in time”), hoặc việc thêm chợ plugin trên phiên bản tự quản lý thất bại với lỗi chung chung
Xác nhận phiên bản có thể truy cập được từ internet công cộng qua HTTPS và các địa chỉ IP gửi đi của Anthropic được phép đi qua tường lửa của bạn. Lỗi “A secure connection couldn’t be established” thường có nghĩa là chứng chỉ CA bị thiếu hoặc không đúng.
Các lỗi bắt đầu bằng “Authentication to … failed” hoặc “Access denied”
Token đã hết hạn, bị thu hồi, hoặc thiếu một phạm vi hay vai trò được liệt kê trong phần Trước khi bắt đầu thuộc mục Thiết lập chợ plugin đồng bộ với GitLab. Hãy tạo token mới và dán vào cấu hình (Edit > Access token).
Hỗ trợ tư vấn, đào tạo và chuyển giao giải pháp AI cho cá nhân, doanh nghiệp và tổ chức.

Liên hệ qua Zalo