← Tất cả bài viết
05.10.2026

Anthropic đưa Mods vào Claude Code: Plugin chạy bên trong để thay đổi hành vi và giao diện

Anthropic đưa Mods vào Claude Code: Plugin chạy bên trong để thay đổi hành vi và giao diện
Nguyễn Ngọc Hải Nguyễn Ngọc Hải 12 phút đọc

Theo changelog chính thức, Claude Code phiên bản 2.1.287, phát hành ngày 01/10/2026, bổ sung Mods [2]. Tài liệu của Anthropic định nghĩa mod là một plugin làm thay đổi cách Claude Code hiển thị và hoạt động, gồm các hàm xử lý sự kiện viết bằng JavaScript hoặc TypeScript [1]. The New Stack, RuntimeWire, Post-Cutoff và NEOTEO đưa tin trong ngày 01 và 02/10/2026, chủ yếu dựa vào tài liệu này [9][10][11][12]. Bài này tóm tắt mods làm được gì, cách bắt đầu, và những điểm cần cân nhắc khi dùng trong môi trường doanh nghiệp.

Mod là gì và khác gì hook, skill, MCP

Mỗi khi có một sự kiện, chẳng hạn một tool call, một prompt được gửi đi, hay một phần giao diện sắp được vẽ, Claude Code gọi các hàm xử lý của mod. Hàm đó có thể quan sát sự kiện, sửa nó trước khi tiếp tục, hoặc tự trả lời thay cho Claude Code [1][7]. Điểm khác biệt chính so với các cơ chế quen thuộc là mod chạy bên trong tiến trình Claude Code, trong khi settings hook, skill và MCP server đều tác động từ bên ngoài [1].

ModSettings hookSkillMCP server
Bản chấtHàm trong plugin, chạy trong Claude CodeLệnh shell, HTTP request hoặc prompt chạy theo sự kiệnFile SKILL.md chứa hướng dẫn cho ClaudeTiến trình hoặc dịch vụ ngoài cung cấp công cụ
Có vẽ được giao diệnCóKhôngKhôngKhông
Viết bằngJavaScript hoặc TypeScriptScript và mục trong settings.jsonMarkdownNgôn ngữ bất kỳ
Nên chọn khiCần pane, thanh phía trên ô nhập, lệnh riêng, hoặc sửa sự kiệnCần chặn, cho phép hoặc ghi log bằng script có sẵnHay phải dán lại cùng một hướng dẫnClaude cần truy cập hệ thống bên ngoài

Bảng 1. Mod so với các cơ chế mở rộng khác (tóm tắt từ tài liệu chính thức [1]).

Mod làm được gì

Theo tài liệu, mod làm được những việc mà hook trong settings, skill hay MCP không làm được [1][6][7]:

  • Vẽ giao diện dùng được: một pane bên cạnh transcript hoặc một thanh phía trên ô nhập, có tab, nút bấm và ô nhập liệu [6].
  • Vẽ lại giao diện sẵn có: thay hoặc làm lại kiểu hiển thị của một dòng tool call, spinner hay hộp thoại Claude dùng để hỏi người dùng [6]. Riêng hộp thoại xin quyền thực thi (permission prompt) thì mod không sửa được [1][6].
  • Chen vào tool call hoặc yêu cầu gửi lên mô hình: giữ một tool call lại để hỏi người dùng, trả lời thay mà không chạy công cụ, hoặc chuyển một yêu cầu sang mô hình khác [1][7].
  • Thêm lệnh /command chạy hàm của mod ngay, không cần một lượt trả lời của Claude [1].
  • Chia sẻ dữ liệu giữa các hook trong cùng một mod. Ví dụ một hook đếm tool call và một hook hiển thị số đếm cạnh spinner [1].

Một mod hoàn chỉnh có thể rất nhỏ. Ví dụ trong tài liệu gồm ba file (plugin.json, hooks.json, register.js) và chỉ vài chục dòng mã để đếm tool call, hiển thị số đếm cạnh spinner và thêm lệnh /tally [3].

Một số tính năng có sẵn của Claude Code cũng đã được chuyển thành mod, chẳng hạn /diff và việc nạp AGENTS.md làm hướng dẫn dự án [1][10]. Mã nguồn của một số mod tích hợp này được công khai trong kho mã của Claude Code [1]. Changelog cũng ghi thêm mod tích hợp "You should know", một agent phụ theo dõi và nhắc những điều người dùng có thể bỏ sót, tắt theo mặc định [1][2].

Cách có một mod

Tài liệu nêu ba hướng [1][3]:

  1. Nhờ Claude viết. Mô tả điều mình muốn trong một phiên Claude Code. Claude dùng skill plugin-authoring có sẵn để viết mod vào thư mục riêng của phiên, rồi hỏi bạn có bật hot reload cho phiên đó không. Mod do Claude viết chỉ chạy trong phiên đã tạo ra nó; muốn dùng lâu dài cần chép ra thư mục riêng và nạp bằng --plugin-dir [3].
  2. Tự viết. Tài liệu có hướng dẫn từng bước, không cần Node.js, bundler hay bước build. Có thể kiểm tra mod bằng claude plugin validate và chạy test bằng claude plugin test [3].
  3. Cài từ marketplace. Mod được cài như một plugin, ví dụ /plugin install token-chart@your-org hoặc claude plugin install token-chart@your-org trong shell [1].

Anthropic cũng chia sẻ ba mod mẫu trong kho claude-code-playground, đều kèm README mô tả cách xây dựng và được chia sẻ nguyên trạng, không hỗ trợ [1]:

  • token-weather: vẽ "dự báo" mức đầy của cửa sổ ngữ cảnh phía trên ô nhập.
  • blast-radius: giữ lại lệnh shell rủi ro như rm -rf hay force push, hiển thị tác động và cho nút tiếp tục hoặc huỷ.
  • replay-theater: thêm lệnh /replay để xem lại từng bước chỉnh sửa file của lượt gần nhất.

Yêu cầu tối thiểu là Claude Code v2.1.287 trở lên (kiểm tra bằng claude --version) [1].

Bảo mật, quản trị và nơi mods chạy

Tài liệu nhấn mạnh rằng mod là mã chạy với quyền của người dùng và không có sandbox [1]. Khi đã nạp, mod có thể:

  • đọc và ghi file ở bất cứ đâu tài khoản người dùng truy cập được, chạy chương trình và gọi mạng;
  • đọc biến môi trường và file settings, nơi có thể chứa API key;
  • thấy mọi prompt và mọi tool call của phiên, và sửa chúng;
  • duyệt một tool call trước khi người dùng được hỏi;
  • gọi mô hình bằng gói hoặc API key của người dùng, tức là tiêu tốn hạn mức [1].

Nếu bật sandboxing, sandbox chỉ cô lập các lệnh Bash mà Claude chạy; tiến trình do mod khởi động nằm ngoài sandbox [1]. Vì vậy tài liệu khuyên chỉ cài mod từ tác giả và marketplace đáng tin, và gợi ý chạy claude plugin validate trên thư mục của mod để xem nó xử lý những sự kiện nào và gọi những API nào trước khi cài [1].

Cách tắt: tắt từng mod trong tab Installed của /plugin; tắt mọi mod đã cài cho một phiên bằng --safe-mode; hoặc đặt "disableAllHooks": true trong ~/.claude/settings.json để tắt ở mọi phiên (cách này tắt cả settings hook và status line tuỳ chỉnh của bạn) [1].

Dành cho tổ chức: quản trị viên điều khiển mods qua managed settings [4]. Trên máy có managed settings, hoặc với người dùng đăng nhập gói Team hoặc Enterprise, Claude Code nạp sẵn một "guard" tích hợp tên sec-default, chạy trước mọi mod do người dùng cài, để mod đó không đè được các quy tắc deny và các managed hook của tổ chức [4]. Một số tuỳ chọn đáng chú ý:

Mục tiêuThiết lập (theo tài liệu [4][5])
Không cho mod người dùng tự cài chạy, vẫn giữ settings hookTuỳ chọn allowManagedModsOnly của guard
Tắt toàn bộ mod và hook, kể cả của tổ chứcdisableAllHooks trong managed settings
Chặn nạp mod từ thư mục hoặc URLdisableSideloadFlags
Chỉ cho mod từ marketplace đã duyệtDanh sách marketplace cho phép, kết hợp disableSideloadFlags

Bảng 2. Một số cách tổ chức kiểm soát mods.

Tổ chức cũng có thể cài mod riêng của mình để kiểm tra các mod khác: mod đó nhận danh sách sự kiện và lệnh gọi API của từng mod sắp nạp và có thể từ chối nạp [4]. Tài liệu lưu ý một giới hạn: mod chạy trên một luồng worker chung; nếu worker hỏng ba lần mà không quy được cho một mod, Claude Code gỡ mọi mod không tích hợp, kể cả mod của tổ chức, cho đến khi chạy /reload-plugins hoặc mở phiên mới [8][4].

Nơi chạy: hook của mod chạy ở hầu hết môi trường, nhưng phần giao diện do mod vẽ chỉ hiển thị ở terminal và tab Code của Desktop [1].

Một lưu ý nữa là tính năng còn mới. Changelog v2.1.288 (02/10/2026) đã có nhiều bản sửa lỗi liên quan đến mods, chẳng hạn một thành phần Client lỗi không còn làm hỏng mọi thứ mod vẽ xung quanh [2].

Nhìn cho tỉnh táo

Thông tin do Anthropic công bố:

  • Định nghĩa, khả năng, yêu cầu phiên bản, cách cài, cách quản trị và các cảnh báo bảo mật đều nằm trong tài liệu và changelog chính thức [1][2][3][4][5].
  • Tài liệu cũng tự nêu rõ giới hạn: mod không có sandbox, chạy với quyền người dùng, và không sửa được permission prompt [1].

Nguồn bên ngoài:

  • The New Stack, RuntimeWire, Post-Cutoff và NEOTEO đưa tin chủ yếu dựa trên tài liệu của Anthropic, nên không phải đánh giá độc lập về bảo mật [9][10][11][12].
  • Tôi chưa tìm thấy phân tích bảo mật độc lập nào về cơ chế mods tính đến ngày 05/10/2026.
  • Hai issue GitHub là báo cáo của người dùng, chưa phải xác nhận của Anthropic: một người báo mod bị tắt từ xa trên v2.1.288 dù docs ghi bật mặc định (03/10/2026) [13], và một người báo phần giao diện do mod vẽ không hiển thị trong VS Code extension (04/10/2026) [14]. Docs xác nhận điểm thứ hai [1]; chính tài liệu khắc phục sự cố cũng có thông báo "Anthropic đã tắt mod từ xa" [8].

Ba điểm không nên đọc lệch:

  1. "Bật mặc định" không đảm bảo tài khoản nào cũng dùng được ngay; việc triển khai có thể theo từng giai đoạn [8][13].
  2. Mod không phải tính năng "an toàn vì do Anthropic cung cấp"; mod do bên thứ ba viết có đầy đủ quyền như người dùng [1].
  3. Bài này chưa thử chạy mod thật; mọi mô tả dựa trên tài liệu.

Ý nghĩa với chúng ta

Các gợi ý dưới đây là góc nhìn chung, team cần đối chiếu với quy trình và chính sách thực tế của VNPAY.

  • Coi mod như phần mềm cài vào máy, không phải "cấu hình". Mod đọc được biến môi trường, file settings, mọi prompt và tool call, và có thể gọi mạng [1]. Với môi trường fintech, nên xin ý kiến bộ phận an toàn thông tin trước khi cho phép cài mod từ nguồn ngoài.
  • Kiểm soát nguồn mod. Nếu phải triển khai cho nhiều người, các tuỳ chọn như allowManagedModsOnly hay danh sách marketplace cho phép cho thấy cách giới hạn nguồn mod [4]. Cần có người chịu trách nhiệm duyệt mod trước khi đưa vào danh sách cho phép.
  • Truy vết và kiểm toán. Policy mod của tổ chức có thể ghi lại từng tool call và từng file mà mod khác ghi [4]. Đây là hướng tham khảo cho yêu cầu auditability, nhưng cần đánh giá thêm vì chính mod kiểm toán cũng có thể bị gỡ khi worker hỏng [4].
  • Chi phí và hạn mức. Một mod có thể gọi mô hình bằng gói hoặc API key của người dùng [1]. Nếu dùng gói chung của team, nên theo dõi mức tiêu thụ và thống nhất ai được cài mod gọi mô hình.
  • Dùng thử trên phạm vi nhỏ. Nếu muốn thử các mod mẫu như blast-radius (giữ lệnh rủi ro lại để xác nhận), hãy thử trong thư mục không chứa dữ liệu nhạy cảm và chạy claude plugin validate trước [1].
  • Phạm vi áp dụng. Mods dành cho Claude Code, một công cụ dòng lệnh thiên về lập trình. Với các thành viên chỉ dùng Claude trên web hoặc ứng dụng, tính năng này chưa liên quan trực tiếp.

References

  1. Anthropic — Mods overview, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/overview (Accessed: 05/10/2026).
  2. Anthropic — Claude Code changelog (v2.1.287 ngày 01/10/2026, v2.1.288 ngày 02/10/2026). Available at: https://code.claude.com/docs/en/changelog (Accessed: 05/10/2026).
  3. Anthropic — Create a mod, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/create (Accessed: 05/10/2026).
  4. Anthropic — Manage mods for your organization, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/admin (Accessed: 05/10/2026).
  5. Anthropic — Mods reference, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/reference (Accessed: 05/10/2026).
  6. Anthropic — Draw in the interface with a mod, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/interface (Accessed: 05/10/2026).
  7. Anthropic — React to events with a mod, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/events (Accessed: 05/10/2026).
  8. Anthropic — Troubleshoot a mod, Claude Code Docs. Available at: https://code.claude.com/docs/en/plugins/mods/troubleshoot (Accessed: 05/10/2026).
  9. Sawers, P. — Anthropic's mods let you change Claude Code's look and behavior, The New Stack (02/10/2026). Available at: https://thenewstack.io/anthropic-claude-code-mods-plugins/ (Accessed: 05/10/2026).
  10. Merket, R. — Anthropic lets Claude Code mods rewrite prompts and approve tool permissions, RuntimeWire (01/10/2026). Available at: https://runtimewire.com/article/anthropic-claude-code-mods-typescript-permissions (Accessed: 05/10/2026).
  11. Post-Cutoff — Anthropic launches mods for Claude Code: TypeScript plugins that change its behavior, interface and tool calls (01/10/2026). Available at: https://postcutoff.com/e/2026-10-01-claude-code-mods/ (Accessed: 05/10/2026).
  12. NEOTEO — Claude Code mods offer deeper customization options (02/10/2026). Available at: https://www.neoteo.com/en/anthropic-launched-claude-code-mods-for-deeper-customization (Accessed: 05/10/2026).
  13. GitHub, anthropics/claude-code — Issue #99130: Mods off remotely on 2.1.288 despite docs saying on by default since 2.1.287 (03/10/2026, báo cáo của người dùng, chưa có phản hồi). Available at: https://github.com/anthropics/claude-code/issues/99130 (Accessed: 05/10/2026).
  14. GitHub, anthropics/claude-code — Issue #99423: VS Code extension: mods do not draw status line / toast / panes (04/10/2026, báo cáo của người dùng). Available at: https://github.com/anthropics/claude-code/issues/99423 (Accessed: 05/10/2026).
  15. Anthropic — mod mẫu token-weather, blast-radius, replay-theater (link lấy từ [1], chưa mở trực tiếp). Available at: https://github.com/anthropics/claude-code-playground/tree/main/claude-code/mods (Accessed: 05/10/2026).
  16. Anthropic — mã nguồn mod tích hợp (link lấy từ [1], chưa mở trực tiếp). Available at: https://github.com/anthropics/claude-code/tree/main/mods (Accessed: 05/10/2026).