Hooks Claude Code cho phép bạn chạy các lệnh shell có tính xác định trên mọi sự kiện quan trọng trong vòng đời Claude Code: trước khi công cụ được dùng, sau khi công cụ được dùng, khi prompt được gửi, khi agent dừng lại hoặc khi thông báo được gửi. AgentsRoom là trung tâm chỉ huy trực quan cho phép bạn xem mọi hook kích hoạt theo thời gian thực, trên hàng chục agent Claude Code, trong hàng chục dự án.
Hooks là cách chính thức của Anthropic để thêm tự động hóa có tính xác định, guardrail, audit trail và hiệu ứng phụ tùy chỉnh vào Claude Code. AgentsRoom không thay thế hooks của bạn. Nó chạy CLI Claude Code thực, do đó mọi hook bạn cấu hình trong .claude/settings.json vẫn hoạt động chính xác như dự định. Điều AgentsRoom thêm vào là khả năng hiển thị: một dashboard trực tiếp nơi bạn có thể thấy mọi lần hook kích hoạt, theo từng agent, từng dự án, từng lần chạy.
Hooks Claude Code là các lệnh shell do người dùng định nghĩa mà Claude Code tự động thực thi tại các điểm cụ thể trong suốt phiên agent. Chúng được cấu hình trong .claude/settings.json (dùng chung, commit git) hoặc .claude/settings.local.json (cá nhân, gitignored), và cung cấp cho bạn quyền kiểm soát có tính xác định đối với hành vi của agent Claude Code. Nơi prompt có tính xác suất, hook là 100% có tính xác định: nó chạy mỗi khi sự kiện phù hợp xảy ra, không có ngoại lệ.
Hooks là câu trả lời của Anthropic cho nhu cầu về guardrail, tự động hóa, telemetry, audit logging và tích hợp tùy chỉnh. Bạn có thể sử dụng hooks Claude Code để tự động định dạng code sau mỗi lần chỉnh sửa, chặn các lệnh nguy hiểm trước khi chạy, ghi log mọi tool call vào file, gửi thông báo desktop khi agent đang chờ input, kích hoạt job CI khi phiên kết thúc, hoặc stream mọi prompt đến backend observability. Bất kỳ lệnh shell nào bạn có thể viết, bạn đều có thể kết nối với hook Claude Code.
Vì hooks nằm trong chính dự án (.claude/settings.json được commit git), chúng di chuyển cùng codebase của bạn. Mỗi developer trong nhóm, và mọi AI agent được tạo ra từ dự án đó, đều kế thừa cùng một mạng lưới an toàn. AgentsRoom tôn trọng mô hình này từ đầu đến cuối: ứng dụng desktop không viết lại hooks của bạn, nó chạy CLI Claude Code thực như một tiến trình con, tự động lấy cấu hình hook của bạn, giống như chạy claude code từ terminal.
Mỗi phiên agent Claude Code kích hoạt các event hook tại các điểm được xác định rõ ràng. Đây là ý nghĩa của từng event và những gì bạn có thể làm với nó.
Hook PreToolUse kích hoạt trước khi Claude Code chạy bất kỳ công cụ nào (Bash, Edit, Write, Read, Grep, v.v.). Đây là nơi hoàn hảo cho guardrail: chặn các lệnh nguy hiểm, yêu cầu xác nhận cho các thao tác phá hủy, áp dụng các quy tắc đặc thù dự án hoặc viết lại các tham số công cụ trước khi thực thi. Trả về mã thoát khác không từ hook để chặn hoàn toàn lời gọi công cụ. PreToolUse là hook Claude Code số 1 cho các nhóm chú trọng an toàn.
Hook PostToolUse kích hoạt ngay sau khi bất kỳ công cụ Claude Code nào hoàn thành. Đây là nơi bạn kết nối xử lý hậu kỳ tự động: chạy formatter (Prettier, Black, rustfmt) sau mỗi lần Edit, kích hoạt linter sau mỗi lần Write, cập nhật changelog khi file được sửa đổi, hoặc đẩy các event telemetry. PostToolUse là hook cốt lõi để biến Claude Code thành thành viên nhóm kỷ luật luôn để lại codebase sạch hơn.
Hook UserPromptSubmit kích hoạt mỗi khi có prompt mới được gửi đến agent Claude Code. Sử dụng để ghi log mọi prompt cho mục đích audit và tuân thủ, viết lại prompt theo thời gian thực (chèn ngữ cảnh, biên tập thông tin nhạy cảm), định tuyến yêu cầu đến các model khác nhau hoặc áp dụng quy ước đặt tên. Kết hợp với bảng điều khiển đa agent của AgentsRoom, UserPromptSubmit cung cấp cho bạn audit trail đầy đủ của mọi hướng dẫn gửi đến mọi agent Claude Code.
Hook Stop kích hoạt khi phiên agent Claude Code kết thúc, dù vì công việc đã xong hay vì bị hủy. Đây là nơi phù hợp để chạy các công việc dọn dẹp, đẩy tóm tắt cuối cùng đến hệ thống theo dõi, lưu trữ artifact hoặc thông báo cho người dùng rằng phiên đã kết thúc. AgentsRoom bổ sung hook Stop bằng hệ thống thông báo riêng, giúp bạn nhận thông báo từ cả hook tùy chỉnh và thông báo push desktop + mobile của AgentsRoom.
Hook Notification kích hoạt khi Claude Code gửi thông báo hệ thống — thường là khi agent đang chờ đầu vào từ người dùng hoặc đã hoàn thành một tác vụ chạy dài. Sử dụng để định tuyến thông báo đến Slack, Discord, Telegram, email hoặc bất kỳ webhook nào bạn muốn. AgentsRoom đã hiển thị thông báo Claude Code ngay trong bảng điều khiển đa agent và dưới dạng thông báo push trên điện thoại, nên hook Notification là nơi hoàn hảo để thêm tích hợp tùy chỉnh bên trên.
Hook SubagentStop kích hoạt khi subagent Claude Code hoàn thành công việc và trả quyền điều khiển về cho agent cha. Nếu bạn sử dụng subagents Claude Code được định nghĩa trong .claude/agents/*.md để ủy thác các tác vụ chuyên biệt, SubagentStop cho phép bạn ghi log những gì mỗi subagent đã làm, tổng hợp output của chúng hoặc kích hoạt bước tiếp theo. Trong AgentsRoom, các event SubagentStop xuất hiện trong timeline agent trực tiếp để bạn có thể thấy chính xác subagent nào đã chạy trong mỗi phiên Claude Code.
Hooks biến Claude Code từ AI ấn tượng thành agent coding cấp sản xuất mà toàn nhóm có thể tin tưởng.
Prompt có tính xác suất và có thể bị bỏ qua. Hooks Claude Code là các lệnh shell có tính xác định luôn chạy. Hook PreToolUse có thể chặn bất kỳ rm -rf, push --force hoặc migration phá hủy nào — bất kể agent diễn đạt lý do của nó như thế nào. Đây là tiêu chuẩn vàng cho các triển khai Claude Code quan trọng về an toàn.
Kết nối hooks Claude Code với formatter, linter, test runner, type checker và các script build. Mọi chỉnh sửa mà agent thực hiện đều kích hoạt các kiểm tra tương tự mà pipeline CI của bạn chạy — cục bộ, tức thì, tự động. Các agent Claude Code của bạn trở thành những người đóng góp kỷ luật không bao giờ quên chạy formatter.
Mọi prompt, mọi tool call, mọi lần bắt đầu và kết thúc phiên đều có thể được ghi log bởi hooks Claude Code. Kết hợp với timeline trực quan của AgentsRoom, bạn có được audit trail đầy đủ của mọi hành động của agent AI coding — cần thiết cho các nhóm nặng về tuân thủ, công ty chú trọng bảo mật và bất kỳ ai nghiêm túc về phát triển AI có thể quan sát.
Vì .claude/settings.json được commit git, một bộ hooks Claude Code áp dụng cùng quy ước cho mọi developer trong nhóm và mọi AI agent được tạo ra từ dự án. Thành viên nhóm mới kế thừa guardrail ngay khi họ clone repo. Nâng cấp hành vi của toàn đội AI coding bằng một pull request.
Hooks Claude Code tạo ra các event. AgentsRoom biến những event đó thành feed trực quan: mọi lần hook kích hoạt, mọi tool call, mọi thay đổi trạng thái, stream trực tiếp theo từng agent và từng dự án. Bạn không cần phải theo dõi log nữa — bạn xem đội Claude Code làm việc theo thời gian thực.
Không có hooks, chạy Claude Code có nghĩa là theo dõi mọi tool call. Với hooks, bạn ủy thác việc theo dõi cho code có tính xác định và giám sát ở mức ngoại lệ. AgentsRoom khuếch đại điều này: bạn thấy tất cả agent Claude Code được bảo vệ bằng hook cùng một lúc, và bạn chỉ can thiệp khi có điều gì đó yêu cầu sự chú ý của bạn.
AgentsRoom là trung tâm chỉ huy trực quan cho Claude Code và các CLI AI coding khác. Nó không fork Claude Code, không tái triển khai hooks, không đánh chặn tool call. Nó chạy CLI Claude Code thực như một tiến trình con bên trong terminal xterm.js đầy đủ, có nghĩa là mọi hook bạn định nghĩa trong .claude/settings.json hoặc .claude/settings.local.json chạy chính xác như Anthropic thiết kế — không có sự thỏa hiệp, không có bất ngờ, không có middleware ẩn.
Điều AgentsRoom thêm vào là quy mô và khả năng hiển thị. Bạn có thể chạy hàng chục agent Claude Code song song, trên hàng chục dự án, mỗi cái với cấu hình hook riêng, và thấy mọi lần hook kích hoạt trên một dashboard. Kết hợp với thông báo theo agent của AgentsRoom, ứng dụng mobile đồng hành và theo dõi trạng thái thời gian thực, hooks Claude Code trở thành lớp observability hạng nhất cho toàn bộ hoạt động AI coding.
AgentsRoom tạo các tiến trình claude CLI thực bên trong terminal xterm.js đầy đủ. Bất kỳ hook nào được cấu hình trong .claude/settings.json, .claude/settings.local.json hoặc cài đặt mức người dùng đều kích hoạt tự động, chính xác như khi bạn chạy Claude Code từ terminal. Không patch, không viết lại, không mất fidelity.
Chạy 10, 20, 50 agent Claude Code song song với hooks được bật. Bảng điều khiển đa agent của AgentsRoom hiển thị thông báo được kích hoạt bởi hook và thay đổi trạng thái cho mọi agent đồng thời. Guardrail PreToolUse, formatter PostToolUse và handler Stop của bạn đều hoạt động ở quy mô đội.
Mỗi dự án trong AgentsRoom có .claude/settings.json riêng và do đó cấu hình hook Claude Code riêng. Sidebar tổng hợp trạng thái trực tiếp trên các dự án để bạn có thể phát hiện hook nào đang kích hoạt ở đâu, agent nào đang bị chặn khi chờ input và hook Stop nào vừa hoàn thành lần chạy.
AgentsRoom đi kèm thông báo macOS native và thông báo push mobile mã hóa đầu cuối. Hook Notification, hook Stop và hook SubagentStop của Claude Code đều tạo ra tín hiệu mà AgentsRoom hiển thị trực tiếp trên desktop và điện thoại của bạn. Bạn có thể rời khỏi máy tính và vẫn biết khi hook nói với bạn phải quay lại.
Tải AgentsRoom, mở dự án có hooks .claude/settings.json, tạo agent Claude Code và xem mọi event hook stream vào dashboard theo thời gian thực.
Ứng dụng đồng hành: theo dõi agent khi đi đường
Hoạt động với Claude, Codex, OpenCode, Gemini CLI và Aider
Gửi lỗi và yêu cầu thẳng vào backlog công khai của bạn.