Plugin

Một thiết lập bạn tin tưởng sẽ đáng giá hơn nhiều khi cả team cùng dùng nó. Vấn đề là di chuyển nó đi. Bạn xây một thư mục .claude tuyệt vời với skill, subagent, và hook, rồi sao nữa? Mọi người copy-paste file qua lại giữa các máy và hy vọng chúng đồng bộ. Plugin khắc phục điều đó. Plugin là cách Claude Code đóng gói một thiết lập và chuyển nó từ người này sang người khác.

Có hai mặt của việc này, và ta sẽ đi qua cả hai. Đầu tiên là dùng các plugin người khác đã publish. Thứ hai là đóng gói plugin của riêng bạn một khi bạn đã xây được thứ gì đó đáng chia sẻ.

Plugin là gì

Plugin là một đơn vị cài đặt duy nhất. Nó gói gọn mọi thứ bạn vốn phải chia sẻ bằng tay: skill, subagent, hook, và cấu hình MCP server, cộng thêm những thứ ít gặp hơn như server language server protocol, trình giám sát chạy nền, theme, và một phần của settings.json. Một phiên bản, một lần cài.

Nơi plugin nằm quyết định cách bạn cài nó. Bên trong một phiên làm việc, bạn có thể cài trực tiếp một plugin theo tên:

/plugin install github@claude-plugins-official

Đây là những gì diễn ra: Claude Code cài nó và báo bạn chạy /reload-plugins để áp dụng thay đổi.

Thêm một marketplace cho team

Với một team, cách làm tốt hơn là thêm một marketplace riêng tư một lần. Marketplace là một nguồn dùng chung mà các plugin được resolve qua đó:

/plugin marketplace add your-org/claude-plugins

Đặt tên gì tùy bạn. Một khi đã thêm, mọi lần cài sau đó đều resolve qua nó. Bạn có được khả năng khám phá tập trung, theo dõi phiên bản, và cập nhật ở một nơi duy nhất, thay vì rải rác trên laptop của từng người.

Bạn có thể duyệt những gì khả dụng từ tab Discover. Nó liệt kê các plugin trên các marketplace của bạn để bạn tìm kiếm và chọn.

Đọc trước khi cài

Đây là phần quan trọng nhất. Một plugin chạy code trên máy của bạn, với quyền hạn của bạn. Các hook của nó kích hoạt trên mọi lệnh gọi tool khớp. Vậy nên nếu bạn cài một plugin vì skill của nó, bạn cũng nhận luôn các hook PreToolUse và Stop của nó, dù bạn có đọc chúng hay không.

Hãy nghĩ xem điều đó nghĩa là gì. Một plugin cộng đồng có thể mang theo một Stop hook gọi ra một endpoint mạng mỗi lần, và không có gì trong cấu hình của bạn cảnh báo bạn về điều đó. Đó không phải lý do để tránh plugin. Đó là lý do để nhìn trước khi hành động.

Trước khi cài, hãy kiểm tra chi tiết của plugin. Claude Code sẽ cho bạn biết nó sẽ cài gì và ước tính chi phí ngữ cảnh, kèm một cảnh báo thẳng thắn rằng Anthropic không kiểm soát những gì bên trong các plugin của bên thứ ba.

Có hai điều đáng biết về nguồn gốc của các plugin:

• Biểu mẫu nộp trong app đăng lên community marketplace sau khi trải qua review tự động của Anthropic.
• Marketplace chính thức được kiểm duyệt trên một quy trình riêng biệt.

Nhưng “đã được review” không đồng nghĩa với “đáng tin cậy”. Review tự động bắt được một số vấn đề, không phải tất cả. Vậy nên quy tắc vẫn giữ nguyên: chỉ cài plugin và thêm marketplace từ những nguồn bạn thực sự tin tưởng, và kiểm tra xem một plugin thực sự làm gì trước khi bật nó lên.

Các thành phần chạy song song với của bạn

Một plugin không ghi đè cấu hình của bạn. Các thành phần của nó chạy song song với của bạn. Điều đó phần lớn là tốt, nhưng nó có những hệ quả bạn cần hiểu.

Hook chồng lên nhau (stack). Hook PreToolUse của một plugin và hook PreToolUse của riêng bạn đều kích hoạt trên mỗi lệnh gọi tool. Không cái nào thay thế cái nào. Đây chính xác là lý do vì sao bạn nên đọc chi tiết trước.

Skill, agent, và command được đặt namespace theo tên plugin, nên chúng không bao giờ xung đột với của bạn. Một plugin cũng có thể mang theo một file settings.json, nhưng chỉ một phần rất hẹp. Claude Code chỉ tôn trọng hai key từ file đó: key agent và key status line của subagent.

Key agent đó đáng để dừng lại xem xét. Đặt nó sẽ đưa một trong các subagent của plugin lên thành main thread, cùng với system prompt, giới hạn tool, và model của nó. Nói cách khác, việc bật một plugin có thể thay đổi hành vi mặc định của Claude Code. Đó là một trong những lý do chính để nhìn trước khi bạn bật nó lên.

Một khi plugin đã được cài, bạn có thể xem mọi thứ nó đã thêm vào, quản lý nó, và gỡ cài đặt nó từ plugin panel.

Đóng gói plugin của riêng bạn

Giờ tới mặt còn lại. Một khi bạn đã xây được một thư mục .claude hoạt động tốt, đừng để team bạn copy-paste nó qua lại giữa các máy. Hãy đóng gói nó lại.

Tin vui là bạn không cần tái cấu trúc gì cả. Một plugin dùng cùng cấu trúc .claude bạn đã quen dùng:

• Một thư mục cho mỗi skill.
• Một file markdown cho mỗi subagent, trong agents.
• hooks/hooks.json và .mcp.json, ở gốc plugin.

Cấu trúc thư mục làm hầu hết công việc. Claude Code khám phá các thành phần theo quy ước (convention).

Manifest

Bên trên cấu trúc đó, có một manifest tùy chọn. Nó nằm ở .claude-plugin/plugin.json và chứa tên, phiên bản, mô tả, và tác giả:

{
  "name": "svg-splitter-review",
  "version": "0.1.0",
  "description": "Reviews the SVG Splitter repo",
  "author": {
    "name": "Lewis Menelaws"
  }
}

Manifest là tùy chọn. Bỏ qua nó và Claude Code vẫn khám phá các thành phần của bạn theo quy ước thư mục. Nhưng vài chi tiết đáng biết:

• Name là field bắt buộc duy nhất. Nó đặt namespace cho skill của bạn thành company-name:skill-name, giúp chúng không xung đột với của bất kỳ ai khác.
• Đánh version nó như bất kỳ dependency nào khác. Đó là thứ giúp việc cập nhật và theo dõi phiên bản hoạt động xuyên suốt cả team.

Kết luận

Hai quy tắc đơn giản bao trùm phần lớn nội dung này:

• Khi dùng plugin, hãy đọc trước khi cài. Một plugin chạy code với quyền hạn của bạn, nên hãy xem hook, agent, và MCP server của nó trước.
• Khi xây một plugin, hãy đóng gói .claude của bạn ngay khi nó hoạt động tốt. Một manifest, một lần cài.

Đó là toàn bộ ý nghĩa: một đơn vị cài đặt duy nhất, và thiết lập bạn tin tưởng sẽ tới được với cả team.

Đây là bài giảng cuối cùng trong khóa. Làm bài quiz cuối khóa và nhận huy hiệu hoàn thành tại academy.claude.com/courses/claude-code-in-action/course-quiz.

Nguồn

Dịch từ bài giảng “Plugins”, khóa Claude Code in Action trên Claude Academy.