Quản lý các plugin cho tổ chức của bạn (Manage plugins for your organization)

Các chợ plugin cho phép chủ sở hữu gói Team và Enterprise phân phối các plugin được chọn lọc đến mọi người trong tổ chức của họ. Bạn tạo một chợ, thêm plugin vào đó và kiểm soát chính xác những plugin nào mà các thành viên trong nhóm của bạn có thể xem và sử dụng. Các plugin bạn phân phối sẽ xuất hiện trong chat (trên web và tab Chat trong Claude Desktop), trong Claude Cowork, và trong các phiên Claude Code nơi các thành viên đăng nhập bằng cùng một tài khoản Claude.

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 các thị trường plugin.

Để tham khảo phiên bản của các điều khiển này, xemQuản lý các plugin cho tổ chức của bạntrong tài liệu Claude Code.

Tab “Inventory” liệt kê mọi kỹ năng và plugin mà tổ chức của bạn quản lý, bao gồm cả những cái mà người dùng tự tạo. Kỹ năng và plugin hiện nay đều xuất hiện trên cùng một trang, vì vậy bạn không cần phải chuyển đổi giữa các cài đặt.

Đối với mỗi mục, bảng hiển thị nguồn gốc, phiên bản, khả năng, đối tượng và số người đã sử dụng nó trong 30 ngày qua.

Để tìm một mục, hãy tìm kiếm theo tên hoặc sử dụng các bộ lọc:

Các kỹ năng mà tổ chức của bạn quản lý sẽ xuất hiện dướiThư viện tổ chức. Bạn quản lý các chợ plugin trongChợthẻ.

Để thực hiện một mục, hãy nhấp vào nút menu ở cuối hàng của nó. 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à nhóm.

Đối với các kỹ năng và plugin mà người dùng tạo, tab Kho lưu trữ hiển thị siêu dữ liệu và trạng thái chia sẻ. Nó không hiển thị các tệp tin.

Anthropic cung cấp các chợ tích hợp sẵn các plugin cho các chức năng khác nhau, chẳng hạn như pháp lý và tài chính. Một chợ Công việc Kiến thức được thêm vào tổ chức của bạn theo mặc định.

Để thêm một chợ do Anthropic xây dựng:

Để loại bỏ thị trường Công việc Kiến thức nếu nó không liên quan đến các nhóm của bạn:

Các thị trường do Anthropic xây dựng hiển thị tên có thể đọc được, như ‘Knowledge Work,’ thay vì slug kho lưu trữ cơ bản.

Ngoài các chợ do Anthropic xây dựng, bạn có thể tạo chợ riêng của mình. Có hai cách để thêm plugin vào một chợ mà bạn tạo:

Bạn có thể sử dụng cả hai phương pháp song song. Ví dụ, vận hành một thị trường được đồng bộ với GitHub cho các plugin cốt lõi của bạn và một thị trường thủ công riêng cho các công cụ tạm thời.

Nếu bạn tải lên một plugin có cù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 phiên bản cũ trước.

Đồng bộ hóa GitHub cho phép bạn quản lý các plugin như mã nguồn trong một kho lưu trữ. Khi bạn đẩy các thay đổi, bạn có thể kích hoạt đồng bộ để cập nhật thị trường của mình, bằng tay hoặc tự động.

Chuẩn bị kho lưu trữ của bạn

Bạn có thể kết nối một kho lưu trữ được lưu trữ trên github.com hoặc trên máy chủ GitHub Enterprise của tổ chức bạn. Trên github.com, kho lưu trữ của bạn phải đượcriêng tư hoặc nội bộ—kho công khai không được phép cho các chợ tổ chức. Để đồng bộ từ GitLab, xemThiết lập một chợ được đồng bộ với GitLab.

Các chợ được đồng bộ hóa với GitHub hỗ trợ một tập hợp hẹp hơn củanguồnnhập vàochợ.jsonhơn Claude Code. Đường dẫn tương đối đến các thư mục plugin bên trong kho lưu trữ thị trường (ví dụ,"nguồn": "./plugins/my-plugin") được hỗ trợ đầy đủ và là lựa chọn đơn giản nhất. Thegithub,url, vàgit-subdircác loại nguồn cũng được hỗ trợ. Thenpm,lưu trữ, vàlệnhCác loại nguồn không được hỗ trợ.

Nguồn plugin có thể là riêng tư trong ba trường hợp:

Mỗi nguồn khác được lấy mà không cần thông tin đăng nhập, vì vậy nó phải là một kho lưu trữ công khai trên github.com, gitlab.com hoặc bitbucket.org. Các nguồn trên bất kỳ máy chủ nào khác đều 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 thị trường và thay đổi nguồn của từng plugin thành đường dẫn tương đối (một git subtree hoặc một bước CI để cung cấp các tệp hoạt động tốt).

Để biết chi tiết về cấu trúc và định dạng của plugin, xemtham chiếu tệp khai báo plugin.

Tài nguyên bổ sung:

Kết nối kho lưu trữ

Mã thông báo GitHub cá nhân của bạn được xác minh để xác nhận rằng bạn có quyền truy cập, sau đó Cowork sử dụng mã thông báo cài đặt Ứng dụng GitHub của nó cho các hoạt động đồng bộ.

Không thấy kho của bạn?Hãy chắc chắn rằng ứng dụng Claude GitHub đã được cài đặt trong kho lưu trữ đó.

Cách đồng bộ hoạt động

Một đồng bộ ban đầu sẽ chạy tự động khi bạn kết nối một kho lưu trữ. Trong quy trình tạo GitHub, bạn cũng có thể tắt “Đồng bộ tự động,” vốn được bật theo mặc định. Khi bật, một lần đồng bộ sẽ chạy khi một yêu cầu kéo được gộp vào nhánh mà thị trường theo dõi, hoặc khi ai đó đẩy trực tiếp vào 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 lưu trữ đó 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 việc cài đặt Ứng dụng GitHub Claude. Nếu không có quyền quản trị, trang sẽ hiển thị “Không thể truy cập kho lưu trữ. Đảm bảo kho lưu trữ tồn tại và Ứng dụng GitHub Claude đã được cài đặt,” ngay cả khi Ứng dụng đã được cài đặt đúng cách và cập nhật thủ công vẫn hoạt động.

Ứng dụng Claude GitHubWebhooks (Đọc & Ghi)quyền cũng phải được phê duyệt trên cài đặt. Trên các cài đặt được tạo trước khi quyền này được giới thiệu, GitHub hiển thị một lời nhắc “Claude đang yêu cầu quyền cập nhật” mà một quản trị viên kho lưu trữ hoặc tổ chức cần phê duyệt.

Khi được bật, đồng bộ tự động cho một kho lưu trữ GitHub sẽ chạy khi một pull request bao gồm nâng cấp phiên bản plugin được hợp nhất vào nhánh mặc định của kho lưu trữ. Việc đẩy trực tiếp lên nhánh mặc định sẽ 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 “Đồng bộ lại” trên marketplace.

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ộ lần cuối. Nếu không có gì thay đổi, quá trình đồng bộ sẽ bị bỏ qua. Nếu có thay đổi, Cowork sẽ đọc manifest, xác thực từng plugin, và thay thế tất cả các plugin trong marketplace bằng trạng thái hiện tại của kho. Quá trình đồng bộ có thể mất tới 30 phút tùy thuộc vào số lượng plugin.

Bạn có thể đồng bộ một thị trường tổ chức từ một kho lưu trữ trên gitlab.com hoặc trên một phiên bản GitLab tự quản lý. Để biết loại nguồn plugin được hỗ trợ và những nguồn nào có thể là riêng tư, xemChuẩn bị kho lưu trữ của bạnở trên.

Trước khi bạn bắt đầu

Bước 1: Thêm một cấu hình GitLab

Để thêm một cấu hình GitLab:

Bạn có thể chạy lại bài kiểm tra bất cứ lúc nào từ menu cấu hình vớiKiểm tra kết nối. Tên máy chủ không thể thay đổi sau này. Nếu nó thay đổi, xóa cấu hình và thêm một cấu hình mới.

Bước 2: Thêm chợ

Để thêm thị trường:

Claude đọc nhánh mặc định của dự án và xác thực tệp marketplace trước khi tạo marketplace, tệp này được đặt tên theo đường dẫn của dự án.

Bước 3: Đồng bộ tự động

VớiĐồng bộ tự độngvào, 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 webhook trên dự án GitLab. Nếu token của bạn có thể quản lý webhook (xemTrước khi bạn bắt đầu), Claude tạo webhook cho bạn và không còn gì khác để làm.

Bạn có thể quayĐồng bộ tự độngbật hoặc tắt sau từ menu của thị trường. Bật nó sẽ thiết lập webhook theo cùng một cách.

Bước 4: Nếu Claude không thể tạo webhook

Nếu token không thể quản lý webhooks, Claude sẽ hiển thị mộtHoàn tất thiết lập webhook trong GitLabtin nhắn trên màn hình với mộtURL Webhookvà một mã thông báo. Mã thông báo chỉ hiển thị một lần, vì vậy hãy hoàn thành bước này trước khi đóng tin nhắn.

Nếu bạn làm mất token, hãy mởCấu hình webhookTừ thực đơn của chợ, nhấp vào “Gỡ webhook,” sau đó “Kích hoạt webhook” để nhận một cái mới. Mã token cũ sẽ ngừng hoạt động.

Khi chợ ứng dụng của bạn có các plugin, bạn sẽ kiểm soát cách chúng được phân phối bằng cách sử dụng các tùy chọn cài đặt. Đối với mỗi plugin, bạn có thể thiết lập một trong bốn tùy chọn:

Các thành viên duyệt các plugin có sẵn trênKhám pháthẻ trongTùy chỉnh > Plugin. Các plugin bạn đặt là “Cài đặt mặc định” hoặc “Bắt buộc” sẽ tự động xuất hiện trong danh sách của họ. Các plugin bạn đặt là “Có sẵn để cài đặt” sẽ hiển thị trênKhám pháđể các thành viên tự thêm mình.

Các 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 ngăn chặn các thay đổi xung đột đối với công cụ dùng chung.

Quản trị viên doanh nghiệp có thể ghi đè tùy chọn cài đặt plugin trên toàn tổ chức cho các nhóm cụ thể. Ví dụ, bạn có thể tự động cài đặt plugin cho nhóm Kỹ thuật, cho phép nhóm Pháp lý cài đặt theo ý mình, và ẩn nó khỏi tất cả những người khác.

Mỗi plugin trong thị trường của bạn có một tùy chọn cài đặt trên toàn tổ chức (Mặc định đã cài đặt, Có thể cài đặt, Bắt buộc hoặc Không khả dụng). Theo mặc định, mỗi nhóm sẽ kế thừa cài đặt trên toàn tổ chức đó.

Khi bạn thiết lập ghi đè ở cấp nhóm cho một plugin, nó sẽ thay thế cài đặt toàn tổ chức cho các thành viên của nhóm đó. Thứ tự ưu tiên là: cài đặt nhóm, sau đó cài đặt toàn tổ chức, rồi đến mặc định thị trường.

Cả nhóm được tạo thủ công và nhóm được cung cấp SCIM từ nhà cung cấp danh tính của bạn đều xuất hiện trong bộ chọn nhóm và hoạt động theo cùng một cách.

Nếu một thành viên thuộc về hai hoặc nhiều nhóm với các cài đặt khác nhau cho cùng một plugin, thìdễ dãi nhấtcài đặt áp dụng. Thứ tự từ mức cho phép nhiều nhất đến ít nhất là: Bắt buộc > Cài đặt mặc định > Có sẵn để cài đặt > Không có sẵn.

Ví dụ, nếu Nhóm A đặt một plugin là “Không khả dụng” và Nhóm B đặt nó là “Cài đặt mặc định”, một thành viên trong cả hai nhóm sẽ được cài đặt plugin theo mặc định.

Nếu một nhóm bị xóa (ví dụ, bị xóa khỏi nhà cung cấp danh tính của bạn), ghi đè vẫn tồn tại trong giao diện quản trị nhưng được đánh dấu là mồ côi. Nó không có tác dụng đối với các thành viên (vì không ai thuộc nhóm đã bị xóa) và không được tính vào huy hiệu truy cập tùy chỉnh. Bạn có thể xóa các ghi đè mồ côi từ cài đặt ‘Truy cập nhóm…’ của plugin.

Đúng. Các ghi đè ở cấp nhóm vẫn tồn tại khi bạn đồng bộ lại thị trường 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 thị trường.

Để cập nhật một plugin, hãy tải lên một tệp ZIP mới với 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ậyhợp phápsẽ luôn thay thếhợp pháp.

Để gỡ bỏ một plugin, hãy xóa nó khỏi thị trường của bạn trongCài đặt tổ chức > Plugin & kỹ năngdưới tab “Hàng tồn kho”.

Đẩy các thay đổi của bạn lên kho lưu trữ đã kết nối, sau đó đi đếnCài đặt tổ chức > Plugin & kỹ năngvà nhấp vào tab “Marketplaces”, tìm marketplace của bạn, và nhấp “Cập nhật” để kích hoạt đồng bộ. Mỗi lần đồng bộ sẽ thay thế tất cả các plugin bằng trạng thái hiện tại của kho. Nếu chủ sở hữu đã bật “Đồng bộ tự động” cho marketplace, một lần đồng bộ cũng sẽ chạy mỗi khi một pull request với phiên bản plugin được nâng cấp được hợp nhất vào nhánh mặc định của kho.

Đối với các chợ được đồng bộ với GitLab, xemThiết lập một chợ được đồng bộ với GitLab.

Để gỡ bỏ một plugin, hãy xóa nó khỏi kho lưu trữ và kích hoạt đồng bộ.

Tên plugin phải sử dụngcác từ viết thường ngăn cách bằng dấu gạch ngang(ví dụ,công cụ triển khai, khôngCông cụ triển khai). Các tên thị trường sau đây đã được đặt trước và không thể sử dụng:

Các tên giả mạo các chợ chính thức của Anthropic cũng bị chặn.

Nguyên nhân phổ biến: tệp vượt quá 200 MB, không phải là tệp ZIP hợp lệ, hoặc cửa hàng đã đạt giới hạn 1000 plugin. Kiểm tra kích thước và định dạng tệp, và xóa các plugin không sử dụng nếu bạn đã đầy hạn mức. Nếu quét kỹ năng và plugin được bật, một plugin cũng có thể bị từ chối vì nó bị đánh dấu có nội dung độc hại. Xem lại lý do, sửa vấn đề và tải lại plugin.

Kiểm tra tùy chọn cài đặt plugin trong cài đặt chợ của bạn. Nếu nó được đặt thànhKhông có sẵn, các thành viên sẽ không nhìn thấy nó. Cũng xác nhận rằng Cowork và Skills đều được kích hoạt cho tổ chức của bạn.

Các thay đổi sẽ có hiệu lực trong phiên làm việc tiếp theo của từng thành viên hoặc khi plugin được làm mới. Trong Claude Code, người dùng sẽ nhận được thay đổi vào lần tiếp theo khi 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ợ ứng dụng của bạn.

Một hoặc nhiều plugin trong kho của bạn có khả năng được định dạng không đúng. 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 yêu cầu về cấu trúc plugin, xemtham chiếu tệp khai báo plugin.

Một hoặc nhiều mục plugin trong của bạnchợ.jsonsử dụng mộtnguồnchỉ ra bên ngoài kho được kết nối (mộtgithub,url, hoặcgit-subdirnguồn), và đồng bộ tổ chức không thể lấy nó. Một nguồn riêng tư chỉ hoạt động trong ba trường hợp: một kho lưu trữ github.com chia sẻ chủ sở hữu kho lưu trữ marketplace của bạn, một kho lưu trữ trên máy chủ GitHub Enterprise của tổ chức bạn với GitHub Enterprise App của bạn được cài đặt trên đó, hoặc một nguồn url hoặc git-subdir trên cùng máy chủ GitLab với kho lưu trữ marketplace của bạn (trên gitlab.com, cũng dưới cùng nhóm cấp cao nhất hoặc không gian tên người dùng).

Đối với bất kỳ nguồn riêng tư nào khác, hãy di chuyển các thư mục plugin vào kho lưu trữ thị trường và thay đổi từng mụcnguồntới một đường dẫn tương đối (ví dụ,"./plugins/my-plugin"), sau đó nhấn đẩy và đồng bộ lại. Ngoài ra, tải lên các plugin bị ảnh hưởng từng cái một thông quaCài đặt tổ chức > Plugin & kỹ năngNhấp vào “Thêm,” “Tải lên một plugin,” sau đó chọn “Thêm vào một thị trường hiện có.” Các plugin được tải lên thông qua menu Tùy chỉnh của chính 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 của bạn, mặc dù các thành viên có thể chia sẻ plugin với đồng nghiệp hoặc nhóm cụ thể nếu chức năng chia sẻ được bật.

Hãy chắc chắn rằng Ứng dụng GitHub Claude đã được cài đặt trong kho lưu trữ đó. 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 việc đồng bộ thực sự sử dụng token cài đặt của Ứng dụng GitHub.

Nếu việc cập nhật thủ công hoạt động nhưng bật ‘Đồng bộ hóa tự động’ hiển thị ‘Không thể truy cập kho lưu trữ. Đảm bảo rằng kho lưu trữ tồn tại và ứng dụng Claude GitHub đã được cài đặt,’ có hai nguyên nhân có thể xảy ra:

Nếu bạn thấy thông báo này khi thêm một marketplace trong GitLab, hãy chắc chắn rằng bạn đã thêm cấu hình GitLab trước. XemBước 1: Thêm một cấu hình GitLabdướiThiết lập một chợ được đồng bộ với GitLab.

Đảm bảo rằng tên máy chủ của URL khớp hoàn toàn với tên máy chủ GitLab đã được cấu hình.

Kiểm tra xem chế độ hiển thị của dự án là riêng tư hay nội bộ. Các dự án công khai trên gitlab.com không thể được sử dụng làm thị trường của tổ chức.

Xác nhận rằng phiên bản có thể truy cập được từ internet công cộng qua HTTPS và rằng địa chỉ IP đi ra của Anthropic được phép qua tường lửa của bạn. “Không thể thiết lập kết nối an toàn” thường có nghĩa là chứng chỉ CA bị thiếu hoặc sai.

Mã thông báo đã hết hạn, bị thu hồi, hoặc thiếu phạm vi hoặc vai trò được liệt kê trongTrước khi bạn bắt đầumục dướiThiết lập một chợ được đồng bộ với GitLab. Tạo một token mới và dán nó vào cấu hình (Chỉnh sửa > Mã truy cập).