Mod trong Claude Code là những hàm bạn tự viết để thay đổi chính cách Claude Code hoạt động: nó hiển thị gì trên màn hình, đưa gì vào prompt (câu lệnh gửi cho AI) và gọi công cụ nào. Về bản chất, mod là một plugin có thêm một tệp TypeScript chứa các hàm đó, và Claude Code sẽ chạy hàm của bạn ngay trước khi tự làm việc của mình. Bài này tôi giải thích lại nội dung video của Anthropic bằng tiếng Việt, rồi bàn xem doanh nghiệp vừa và nhỏ ở Việt Nam có thể hiểu và tận dụng nó thế nào.
Nguồn: video Mods in Claude Code: change how Claude Code works của kênh Claude (kênh chính thức của Anthropic). Tôi không dịch nguyên văn mà diễn giải theo cách dễ hiểu cho người không làm lập trình.
Mod trong Claude Code là gì và khác plugin thường ở đâu?
Mod là một plugin có thêm khả năng can thiệp vào các sự kiện bên trong Claude Code. Theo video, bạn có thể đổi thứ nó hiển thị, đổi nội dung đi vào prompt, đổi các lệnh công cụ nó gọi, thậm chí thêm giao diện, skill và command của riêng mình.
Người trình bày trong video là Lydia, một nhân sự của Anthropic. Bạn ấy giới thiệu ba mod mình tự làm:
- Bảng phân tích context trực tiếp: hiện ngay phía trên ô nhập prompt, cho thấy context (lượng thông tin AI đang giữ trong cuộc trò chuyện) đang gồm những gì.
- Khung bên cạnh liệt kê agent: hiện tất cả agent trong dự án, không chỉ những agent đang chạy, và chỉ cần một cú nhấp để khởi chạy agent bất kỳ.
- Ẩn địa chỉ email cho đến khi rê chuột vào: hữu ích khi quay màn hình mà không muốn lộ email.
Nếu bạn chưa quen công cụ này, hãy đọc trước bài Claude Code là gì? Cài đặt và cách dùng cho người mới bắt đầu để nắm nền tảng.
Một mod được cấu trúc như thế nào?
Một mod là một plugin bình thường, chỉ thêm đúng một khoá mới. Video nói rõ: vẫn là plugin.json và hooks.json như plugin thông thường, khác biệt duy nhất là trong hooks.json có thêm khoá modules. Khoá này trỏ tới một tệp TypeScript, và tệp đó chính là mod thật sự.
Bên trong tệp, bạn viết các hàm và đăng ký chúng vào một sự kiện. Claude Code có vài chục sự kiện nội bộ, ví dụ: gọi công cụ (tool call), kiểm tra quyền (permission check), hiển thị tin nhắn (render) và gửi prompt. Khi sự kiện xảy ra, hàm của bạn chạy trước khi Claude Code làm phần việc gốc.
Ba thứ mà mọi hàm mod đều nhận
Video so sánh cách này với middleware (lớp xử lý nằm giữa) trong Express, một thư viện web quen thuộc của giới lập trình. Hàm của bạn luôn nhận đúng ba giá trị:
| Giá trị | Vai trò | Hiểu nôm na |
|---|---|---|
Đối tượng $ | Cầu nối tới Claude Code: vẽ giao diện, gọi mô hình, đọc tệp | Bộ điều khiển từ xa |
| Event (sự kiện) | Dữ liệu gốc của việc đang xảy ra; bạn có thể sửa trước khi chuyển đi | Tờ phiếu đang chạy qua tay bạn |
next | Chuyển dữ liệu đi tiếp để Claude Code xử lý | Nút «duyệt, chuyển bước sau» |
Điểm mấu chốt nằm ở next. Bạn truyền gì vào next, Claude Code làm đúng như vậy; nếu bạn đổi một lệnh rồi chuyển đi, lệnh đã đổi sẽ chạy. Còn nếu bạn không gọi next mà tự trả về một kết quả, nghĩa là bạn đang tự xử lý sự kiện đó và Claude Code nhận câu trả lời của bạn thay vì làm việc của nó.
Làm sao nạp mod vào Claude Code?
Có hai cách, tuỳ bạn dùng bản nào. Với bản chạy dòng lệnh, bạn khởi động Claude Code kèm cờ chỉ thư mục plugin (video nhắc đến cờ «plugin dir» — hãy xem tài liệu chính thức để lấy đúng cú pháp trước khi gõ). Với ứng dụng desktop, cờ này không hoạt động, nên bạn thêm thư mục chứa mod vào tệp cài đặt toàn cục (global settings).
Thư mục được theo dõi liên tục (watch), nên mỗi lần bạn lưu tệp mod, phiên làm việc đang mở sẽ nhận thay đổi ngay mà không cần khởi động lại. Điều này giúp thử nghiệm rất nhanh.
Ví dụ trong video: mod ẩn email hoạt động ra sao?
Mod ẩn email đăng ký hàm vào sự kiện render, tức lúc câu trả lời sắp hiện lên màn hình. Dữ liệu của sự kiện là đoạn văn bản câu trả lời. Với mỗi địa chỉ email tìm thấy, mod dùng đối tượng $ tạo một khối nhỏ chỉ hiện chữ khi rê chuột vào, rồi trả về phiên bản đó thay vì gọi next. Kết quả là Claude Code hiển thị bản của người viết mod.
Chi tiết đáng chú ý nhất: khi nhờ Claude soạn tin nhắn gửi cho người đó, nó vẫn dùng đúng địa chỉ email thật. Lý do là render chỉ đổi thứ hiển thị trên màn hình, còn mô hình chưa từng nhìn thấy bản đã che. Nghĩa là bạn đổi được «lớp vỏ» mà không làm hỏng dữ liệu bên dưới.
Lưu ý của tôi: theo cách video mô tả, đây là việc che trên màn hình để quay video hoặc chia sẻ màn hình. Nó không phải cơ chế bảo mật dữ liệu. Nếu doanh nghiệp cần chặn AI tiếp cận thông tin nhạy cảm, đó là bài toán phân quyền và cấu hình khác, không nên trông cậy vào mod hiển thị.
Mod có an toàn không?
Video cho biết mod chỉ thấy những sự kiện Claude Code mở ra và chạy trong sandbox riêng (môi trường cách ly), nên mọi tương tác đều đi qua đối tượng $. Tuy vậy, tôi vẫn khuyên bạn đọc kỹ mod của người khác trước khi cài, giống mọi plugin. Chi tiết về mức bảo vệ cụ thể, hãy kiểm tra tài liệu chính thức vì tôi không có thêm thông tin ngoài video.
Doanh nghiệp vừa và nhỏ ở Việt Nam dùng ý tưởng mod thế nào?
Dù là người không viết code, bạn vẫn nên hiểu mod vì nó cho thấy hướng đi: công cụ AI đang trở thành nền tảng có thể tuỳ biến theo quy trình riêng. Dưới đây là các kịch bản minh hoạ do tôi đề xuất dựa trên khả năng được nêu trong video; đây là gợi ý, chưa phải mod có sẵn.
- Quay video đào tạo nội bộ: một cửa hàng muốn quay màn hình hướng dẫn nhân viên dùng AI để soạn tin trả lời khách. Mod kiểu «hover để hiện» có thể che email hoặc số điện thoại khách trên màn hình, đỡ phải làm mờ khi dựng video.
- Theo dõi context: bảng phân tích context giúp người dùng thấy AI đang «nhớ» những gì. Với nhóm kỹ thuật nhỏ trong công ty, điều này giúp hiểu vì sao hạn mức hay hết nhanh. Bạn có thể tham khảo thêm bài mẹo dùng Claude Code.
- Nhìn toàn bộ agent của dự án: nếu xưởng hay công ty dịch vụ đã dựng nhiều agent cho từng việc (đối soát, soạn báo cáo, trả lời khách), khung bên cạnh liệt kê và khởi chạy bằng một cú nhấp sẽ tiện cho người quản lý. Nếu muốn hiểu khái niệm này, xem AI agent là gì.
- Chuẩn hoá cách làm cho cả đội: vì mod là plugin, video cho biết bạn có thể đặt nó trong một marketplace repo để người khác cài như plugin bình thường. Công ty có thể giữ một bộ mod chung để mọi người dùng cùng một «bộ đồ nghề».
Nên hiểu mod ở mức nào nếu bạn không biết lập trình?
Bạn không cần tự viết mod. Hãy nắm ba điều: mod chèn vào sự kiện của Claude Code, next quyết định Claude Code làm gì tiếp, và một mod chỉ là plugin có thêm khoá modules. Khi cần, bạn có thể nhờ chính Claude Code hoặc một người làm kỹ thuật viết giúp, miễn là bạn mô tả được rõ mình muốn thay đổi điều gì.
| Câu hỏi | Câu trả lời ngắn |
|---|---|
| Mod là gì? | Plugin có thêm hàm can thiệp sự kiện của Claude Code |
| Khai báo ở đâu? | Khoá modules trong hooks.json, trỏ tới tệp TypeScript |
| Muốn chặn hoặc thay hành vi? | Không gọi next, tự trả kết quả |
| Muốn giữ hành vi gốc nhưng sửa dữ liệu? | Sửa event rồi gọi next |
| Chia sẻ thế nào? | Đưa lên marketplace repo như plugin |
Tóm tắt và bước tiếp theo
Mod trong Claude Code cho phép bạn đổi cách Claude Code hiển thị, xử lý prompt và gọi công cụ bằng các hàm chạy trước hành vi gốc. Nó gồm ba thành phần: đối tượng $, event và next. Ví dụ ẩn email trong video cho thấy bạn có thể đổi cái hiển thị mà không động tới dữ liệu thật.
Bước tiếp theo tôi gợi ý: xem video gốc một lần, ghi ra giấy một việc lặp lại trong công ty mà bạn muốn công cụ AI làm khác đi, rồi đọc tài liệu chính thức trên claude.com để kiểm tra mod đã dùng được với phiên bản của bạn chưa. Nếu bạn đang cân nhắc công cụ lập trình bằng AI, bài so sánh Claude Code và Cursor, Codex, Copilot sẽ giúp bạn chọn.
Xem thêm
Câu hỏi thường gặp
›Mod trong Claude Code là gì?
Mod là plugin có thêm hàm TypeScript chạy trong Claude Code, can thiệp vào các sự kiện như hiển thị tin nhắn, gửi prompt hay gọi công cụ. Nó dùng cùng plugin.json và hooks.json, chỉ thêm khoá modules.
›Mod trong Claude Code khác plugin thường thế nào?
Về cấu trúc gần như giống nhau, khác ở chỗ hooks.json có thêm khoá modules trỏ tới tệp TypeScript. Tệp này chứa hàm chạy trước khi Claude Code xử lý sự kiện.
›Cần biết lập trình mới dùng được mod không?
Để tự viết mod thì cần biết TypeScript hoặc nhờ người làm kỹ thuật, kể cả nhờ Claude Code. Để dùng mod người khác chia sẻ thì cài như plugin thông thường.
›Mod ẩn email có làm AI không thấy email thật không?
Không. Theo video, render chỉ đổi phần hiển thị trên màn hình, mô hình chưa từng thấy bản đã che nên vẫn dùng email thật. Đây là che hiển thị, không phải bảo mật dữ liệu.
›Mod có dùng được trên ứng dụng desktop của Claude Code không?
Có, nhưng cờ chỉ thư mục plugin không hoạt động trên desktop. Video hướng dẫn thêm thư mục chứa mod vào tệp cài đặt toàn cục thay thế.
Tác giả
Chuyên gia chuyển đổi số · Đại diện 5F Edu
Hơn 8 năm triển khai và tư vấn chuyển đổi số cho doanh nghiệp vừa và nhỏ: chuẩn hoá quy trình, xây phần mềm quản lý bằng AppSheet và web app, tự động hoá bằng N8N. Người làm kênh YouTube Nghiện AppSheet.
