Claude Code Hooks

Claude Code Hooks, ที่แสดงผล.

Claude Code hooks ช่วยให้คุณสามารถรันคำสั่ง shell ที่กำหนดได้ในทุกเหตุการณ์สำคัญในวงจรชีวิตของ Claude Code: ก่อนที่จะใช้เครื่องมือ, หลังจากใช้เครื่องมือ, เมื่อมีการส่ง prompt, เมื่อ agent หยุด, หรือเมื่อมีการส่งการแจ้งเตือน AgentsRoom คือศูนย์คำสั่งภาพที่ช่วยให้คุณดูทุกการเรียก hook แบบเรียลไทม์, ในหลาย Claude Code agents, ในหลายโปรเจกต์.

Hooks คือวิธีการอย่างเป็นทางการของ Anthropic ในการเพิ่มการทำงานอัตโนมัติที่กำหนดได้, guardrails, audit trails และผลข้างเคียงที่กำหนดเองให้กับ Claude Code. AgentsRoom ไม่ได้แทนที่ hooks ของคุณ มันรัน Claude Code CLI ที่แท้จริง, ดังนั้นทุก hook ที่คุณกำหนดใน .claude/settings.json ยังคงทำงานตามที่ตั้งใจไว้ สิ่งที่ AgentsRoom เพิ่มคือการมองเห็น: แดชบอร์ดสดที่คุณสามารถเห็นทุกการกระตุ้น hook, ต่อ agent, ต่อโปรเจกต์, ต่อการรัน.

Claude Code hooks คืออะไร?

Claude Code hooks คือคำสั่ง shell ที่ผู้ใช้กำหนดซึ่ง Claude Code จะทำการรันโดยอัตโนมัติในจุดเฉพาะระหว่างเซสชันของ agent. พวกเขาถูกกำหนดค่าใน .claude/settings.json (แชร์, คอมมิตไปยัง git) หรือ .claude/settings.local.json (ส่วนตัว, gitignored), และพวกเขาให้คุณควบคุมพฤติกรรมของ Claude Code agents ของคุณได้อย่างกำหนดได้. ในขณะที่ prompt เป็นแบบสุ่ม, hook จะเป็นแบบกำหนดได้ 100%: มันจะทำงานทุกครั้งที่เหตุการณ์ที่ตรงกันเกิดขึ้น, ไม่มีข้อยกเว้น.

Hooks คือคำตอบของ Anthropic ต่อความต้องการด้าน guardrails, การทำงานอัตโนมัติ, telemetry, audit logging และการเชื่อมต่อแบบกำหนดเอง คุณใช้ Claude Code hooks เพื่อจัดรูปแบบโค้ดอัตโนมัติหลังการแก้ไขทุกครั้ง บล็อกคำสั่งอันตรายก่อนที่มันจะรัน บันทึกการเรียกเครื่องมือทุกครั้งลงไฟล์ ส่งการแจ้งเตือนบนเดสก์ท็อปเมื่อเอเจนต์รอข้อมูลจากคุณ สั่งรันงาน CI เมื่อเซสชันจบ หรือสตรีมทุกพรอมต์ไปยังแบ็กเอนด์ observability ได้ คำสั่ง shell ใดก็ตามที่คุณเขียนได้ คุณก็เชื่อมเข้ากับ Claude Code hook ได้

เนื่องจาก hooks อยู่ในโปรเจกต์เอง (.claude/settings.json ถูกคอมมิตไปยัง git), พวกเขาจะเดินทางไปพร้อมกับฐานโค้ดของคุณ. นักพัฒนาทุกคนในทีม, และ AI agent ทุกตัวที่เกิดจากโปรเจกต์นั้น, จะได้รับเครือข่ายความปลอดภัยเดียวกัน. AgentsRoom เคารพโมเดลนี้ตั้งแต่ต้นจนจบ: แอปเดสก์ท็อปไม่เขียนใหม่ hooks ของคุณ, มันรัน Claude Code CLI ที่แท้จริงเป็นกระบวนการลูก, ซึ่งจะรับการกำหนดค่า hook ของคุณโดยอัตโนมัติ, เช่นเดียวกับการรัน claude code จากเทอร์มินัล.

6 เหตุการณ์ Claude Code Hook

ทุกเซสชันของ Claude Code agent จะเกิดเหตุการณ์ hook ที่จุดที่กำหนดไว้อย่างชัดเจน. นี่คือความหมายของแต่ละเหตุการณ์และสิ่งที่คุณสามารถทำได้กับมัน.

PreToolUse

PreToolUse hook จะทำงานก่อนที่ Claude Code จะเรียกใช้เครื่องมือใด ๆ (Bash, Edit, Write, Read, Grep ฯลฯ) จึงเป็นจุดที่เหมาะที่สุดสำหรับ guardrails: บล็อกคำสั่งอันตราย บังคับให้ยืนยันก่อนการดำเนินการที่ทำลายข้อมูล บังคับใช้กฎเฉพาะของโปรเจกต์ หรือแก้ไขอาร์กิวเมนต์ของเครื่องมือก่อนสั่งรัน คืนค่า exit code ที่ไม่ใช่ศูนย์จาก hook เพื่อบล็อกการเรียกเครื่องมือนั้นทั้งหมด PreToolUse คือ Claude Code hook อันดับหนึ่งสำหรับทีมที่ให้ความสำคัญกับความปลอดภัย

PostToolUse

PostToolUse hook จะเกิดขึ้นทันทีหลังจากเครื่องมือใด ๆ ของ Claude Code เสร็จสิ้น. นี่คือที่ที่คุณเชื่อมต่อการประมวลผลหลังอัตโนมัติ: รันฟอร์แมตเตอร์ (Prettier, Black, rustfmt) หลังจากการแก้ไขทุกครั้ง, กระตุ้น linter หลังจากการเขียนทุกครั้ง, อัปเดต changelog เมื่อไฟล์ถูกแก้ไข, หรือส่งเหตุการณ์ telemetry. PostToolUse คือ hook ที่สำคัญสำหรับการทำให้ Claude Code กลายเป็นสมาชิกทีมที่มีระเบียบซึ่งทำให้ฐานโค้ดสะอาดกว่าที่มันพบ.

UserPromptSubmit

UserPromptSubmit hook จะเกิดขึ้นเมื่อมีการส่ง prompt ใหม่ไปยัง Claude Code agent. ใช้มันเพื่อบันทึกทุก prompt สำหรับการตรวจสอบและการปฏิบัติตาม, เขียนใหม่ prompts แบบสด (ฉีดบริบท, แดงความลับ), ส่งคำขอไปยังโมเดลที่แตกต่างกัน, หรือบังคับใช้กฎการตั้งชื่อ. ร่วมกับแดชบอร์ดหลาย agent ของ AgentsRoom, UserPromptSubmit ให้คุณมีเส้นทางการตรวจสอบเต็มรูปแบบของคำสั่งทุกคำสั่งที่ส่งไปยัง Claude Code agent ทุกตัว.

Stop

Stop hook จะเกิดขึ้นเมื่อเซสชันของ Claude Code agent สิ้นสุด, ไม่ว่าจะเพราะงานเสร็จสิ้นหรือถูกยกเลิก. มันคือสถานที่ที่เหมาะสมในการรันงานทำความสะอาด, ส่งสรุปสุดท้ายไปยังระบบติดตาม, คอมมิต artifacts, หรือแจ้งให้มนุษย์ทราบว่าเซสชันสิ้นสุดแล้ว. AgentsRoom เสริม Stop hook ด้วยระบบการแจ้งเตือนของตัวเอง, ดังนั้นคุณจะได้รับการแจ้งเตือนทั้งจาก hook ที่กำหนดเองและจากการแจ้งเตือนเดสก์ท็อป + มือถือของ AgentsRoom.

Notification

Notification hook จะเกิดขึ้นเมื่อ Claude Code ส่งการแจ้งเตือนระบบ, โดยทั่วไปเมื่อ agent รอการป้อนข้อมูลจากผู้ใช้หรือเสร็จสิ้นงานที่ใช้เวลานาน. ใช้มันเพื่อส่งการแจ้งเตือนไปยัง Slack, Discord, Telegram, อีเมล, หรือ webhook ใด ๆ ที่คุณต้องการ. AgentsRoom แสดงการแจ้งเตือนของ Claude Code โดยตรงในแดชบอร์ดหลาย agent ของมันและเป็นการแจ้งเตือนแบบพุชบนโทรศัพท์ของคุณ, ดังนั้น Notification hook จึงเป็นสถานที่ที่สมบูรณ์แบบในการเพิ่มการรวมที่กำหนดเอง.

SubagentStop

SubagentStop hook จะเกิดขึ้นเมื่อ Claude Code subagent เสร็จสิ้นงานของมันและส่งคืนการควบคุมให้กับผู้ปกครอง. หากคุณใช้ Claude Code subagents ที่กำหนดใน .claude/agents/*.md เพื่อมอบหมายงานเฉพาะ, SubagentStop ช่วยให้คุณบันทึกสิ่งที่แต่ละ subagent ทำ, รวมผลลัพธ์ของพวกเขา, หรือกระตุ้นขั้นตอนถัดไป. ภายใน AgentsRoom, เหตุการณ์ SubagentStop จะปรากฏในไทม์ไลน์ agent สดเพื่อให้คุณเห็นว่า subagents ใดทำงานภายในเซสชัน Claude Code แต่ละตัว.

ทั้งหกนี้ครอบคลุมงานประจำวันส่วนใหญ่ แต่ยังไม่ใช่ทั้งหมด: Claude Code มีเหตุการณ์ hook ทั้งหมด 30 เหตุการณ์ ดูทั้ง 30 เหตุการณ์ตามลำดับการทำงาน

ทำไม Claude Code Hooks ถึงสำคัญ

Hooks เปลี่ยน Claude Code จาก AI ที่น่าประทับใจให้กลายเป็น agent การเขียนโค้ดที่มีคุณภาพระดับการผลิตที่ทีมของคุณสามารถพึ่งพาได้.

การควบคุมความปลอดภัยที่กำหนดได้

Prompts เป็นแบบสุ่มและสามารถถูกข้ามได้. Claude Code hooks คือคำสั่ง shell ที่กำหนดได้ซึ่งจะทำงานเสมอ. PreToolUse hook สามารถบล็อกคำสั่ง rm -rf ใด ๆ, push --force ใด ๆ, การโยกย้ายที่ทำลายล้างใด ๆ, ไม่ว่าตัว agent จะอธิบายเหตุผลอย่างไร. นี่คือมาตรฐานทองคำสำหรับการปรับใช้ Claude Code ที่สำคัญต่อความปลอดภัย.

การทำงานอัตโนมัติที่ไม่ต้องใช้ความพยายาม

เชื่อมต่อ Claude Code hooks กับฟอร์แมตเตอร์, ลินเตอร์, ตัวทดสอบ, ตัวตรวจสอบประเภท และสคริปต์การสร้าง ทุกการแก้ไขที่เอเจนต์ทำจะกระตุ้นการตรวจสอบเดียวกันที่ CI pipeline ของคุณทำงานอยู่ในท้องถิ่น ทันที และอัตโนมัติ เอเจนต์ Claude Code ของคุณจะกลายเป็นผู้มีส่วนร่วมที่มีวินัยในตนเองซึ่งไม่เคยลืมที่จะเรียกใช้ฟอร์แมตเตอร์

บันทึกการตรวจสอบที่สมบูรณ์

ทุกคำสั่ง, ทุกการเรียกเครื่องมือ, ทุกการเริ่มต้นและหยุดเซสชันสามารถถูกบันทึกโดย Claude Code hooks รวมเข้ากับไทม์ไลน์ภาพของ AgentsRoom และคุณจะได้บันทึกการตรวจสอบที่สมบูรณ์ของทุกการกระทำของเอเจนต์การเขียนโค้ด AI ซึ่งจำเป็นสำหรับทีมที่ต้องปฏิบัติตามกฎระเบียบอย่างเข้มงวด บริษัทที่ใส่ใจด้านความปลอดภัย และใครก็ตามที่จริงจังเกี่ยวกับการพัฒนา AI ที่สามารถสังเกตได้

ข้อตกลงทั่วทั้งทีม

เนื่องจาก .claude/settings.json ถูกบันทึกใน git ชุดเดียวของ Claude Code hooks จะบังคับใช้ข้อตกลงเดียวกันสำหรับนักพัฒนาทุกคนในทีมและเอเจนต์ AI ทุกตัวที่เกิดจากโครงการ สมาชิกทีมใหม่จะได้รับการป้องกันในทันทีที่พวกเขาคลอนโค้ดรีโป อัปเกรดพฤติกรรมของทีมการเขียนโค้ด AI ทั้งหมดของคุณด้วยการดึงคำขอเดียว

การสังเกตการณ์ Hook แบบสด

Claude Code hooks สร้างเหตุการณ์ AgentsRoom เปลี่ยนเหตุการณ์เหล่านั้นให้เป็นฟีดภาพ: ทุกการกระตุ้น hook, ทุกการเรียกเครื่องมือ, ทุกการเปลี่ยนสถานะ สตรีมสดต่อแต่ละเอเจนต์และแต่ละโครงการ คุณไม่ต้องติดตามบันทึกอีกต่อไป: คุณสามารถดูฟลีต Claude Code ของคุณทำงานในเวลาจริง

เปลี่ยนจากการดูเป็นการควบคุม

หากไม่มี hooks การเรียกใช้ Claude Code หมายถึงการดูทุกการเรียกเครื่องมือ ด้วย hooks คุณสามารถมอบหมายการดูให้กับโค้ดที่กำหนดและควบคุมในระดับข้อยกเว้น AgentsRoom ขยายสิ่งนี้: คุณเห็นเอเจนต์ Claude Code ที่ได้รับการป้องกันด้วย hooks ทั้งหมดในครั้งเดียว และคุณจะเข้ามาเมื่อมีสิ่งใดที่ต้องการความสนใจของคุณ

Claude Code Hooks + AgentsRoom

AgentsRoom เป็นศูนย์กลางการควบคุมภาพสำหรับ Claude Code และ AI coding CLIs อื่นๆ มันไม่ทำการ fork Claude Code, ไม่ทำการ re-implement hooks, ไม่ทำการ intercept การเรียกเครื่องมือ มันเรียกใช้ CLI ของ Claude Code ที่แท้จริงเป็นกระบวนการลูกภายในเทอร์มินัล xterm.js เต็มรูปแบบ ซึ่งหมายความว่าทุก hook ที่คุณกำหนดใน .claude/settings.json หรือ .claude/settings.local.json จะทำงานตามที่ Anthropic ออกแบบไว้: ไม่มีการประนีประนอม, ไม่มีเซอร์ไพรส์, ไม่มี middleware ที่มองไม่เห็น

สิ่งที่ AgentsRoom เพิ่มคือขนาดและความสามารถในการมองเห็น คุณสามารถเรียกใช้เอเจนต์ Claude Code ได้หลายสิบตัวพร้อมกัน ข้ามหลายโครงการ แต่ละตัวมีการกำหนด hook ของตนเอง และเห็นทุกการกระตุ้น hook บนแดชบอร์ดเดียว ร่วมกับการแจ้งเตือนต่อแต่ละเอเจนต์ของ AgentsRoom, แอปคู่หูบนมือถือ และการติดตามสถานะแบบเรียลไทม์ Claude Code hooks จะกลายเป็นชั้นการสังเกตการณ์ระดับหนึ่งสำหรับการดำเนินการเขียนโค้ด AI ทั้งหมดของคุณ

เรียกใช้ CLI ของ Claude Code ที่แท้จริง

AgentsRoom สร้างกระบวนการ claude CLI ที่แท้จริงภายในเทอร์มินัล xterm.js เต็มรูปแบบ ทุก hook ที่กำหนดใน .claude/settings.json หรือ .claude/settings.local.json จะทำงานโดยอัตโนมัติ เช่นเดียวกับที่คุณเรียกใช้ Claude Code จากเทอร์มินัลของคุณ hooks ระดับผู้ใช้ก็ทำงานด้วย ทั้งบนการเข้าสู่ระบบ Claude Code เริ่มต้นของคุณ และเมื่อเปิด "ใช้การตั้งค่า CLI ส่วนตัวของฉัน" แล้ว ก็ทำงานในทุกบัญชีที่คุณลงชื่อเข้าใช้ไว้ ไม่มีการแก้ไข, ไม่มีการเขียนใหม่, ไม่มีการสูญเสียความถูกต้อง

เหตุการณ์ Hook ข้ามฟลีตหลายเอเจนต์

เรียกใช้เอเจนต์ Claude Code 10, 20, 50 ตัวพร้อมกับ hooks ที่เปิดใช้งาน แดชบอร์ดหลายเอเจนต์ของ AgentsRoom จะแสดงการแจ้งเตือนและการเปลี่ยนสถานะที่กระตุ้นโดย hook สำหรับทุกเอเจนต์ในเวลาเดียวกัน การป้องกัน PreToolUse, ฟอร์แมตเตอร์ PostToolUse และตัวจัดการ Stop ของคุณทั้งหมดทำงานในระดับฟลีต

การมองเห็น Hook ข้ามโครงการ

ทุกโครงการใน AgentsRoom มี .claude/settings.json ของตนเองและดังนั้นจึงมีการกำหนดค่า hook ของ Claude Code ของตนเอง แถบด้านข้างรวมสถานะสดจากโครงการต่างๆ เพื่อให้คุณสามารถมองเห็นว่า hook ใดกำลังทำงานอยู่ที่ไหน เอเจนต์ใดถูกบล็อกจากการป้อนข้อมูลของผู้ใช้ และ hook Stop ใดเพิ่งเสร็จสิ้นการทำงาน

การแจ้งเตือนบนเดสก์ท็อป + มือถือ

AgentsRoom มาพร้อมกับการแจ้งเตือนบนเดสก์ท็อปแบบเนทีฟและการแจ้งเตือนแบบพุชมือถือที่เข้ารหัสแบบ end-to-end hook การแจ้งเตือนของ Claude Code, hook Stop และ hook SubagentStop ทั้งหมดสร้างสัญญาณที่ AgentsRoom แสดงโดยตรงบนเดสก์ท็อปและโทรศัพท์ของคุณ คุณสามารถออกจากคอมพิวเตอร์และยังรู้เมื่อ hook บอกให้คุณกลับมา

คำถามที่พบบ่อยเกี่ยวกับ Claude Code Hooks

Claude Code hooks คืออะไรในประโยคเดียว?+
Claude Code hooks คือคำสั่ง shell ที่ผู้ใช้กำหนดเอง ซึ่ง Claude Code จะรันโดยอัตโนมัติเมื่อเกิดเหตุการณ์ในวงจรชีวิตที่ระบุไว้ (PreToolUse, PostToolUse, UserPromptSubmit, Stop, Notification, SubagentStop) ทำให้คุณควบคุมพฤติกรรมของเอเจนต์การเขียนโค้ด AI ของคุณได้อย่างแน่นอนและคาดเดาได้
Claude Code hooks ถูกกำหนดค่าไว้ที่ไหน?+
Claude Code hooks จะอยู่ใน .claude/settings.json (บันทึกใน git, แบ่งปันกับทีม) ใน .claude/settings.local.json (gitignored, ส่วนตัว) หรือในระดับผู้ใช้ภายในไดเรกทอรีการตั้งค่า Claude Code ของคุณ ทั้งหมดจะถูกนำไปใช้โดยอัตโนมัติโดย CLI ของ Claude Code AgentsRoom เรียกใช้ CLI ของ Claude Code ที่แท้จริง ดังนั้นจึงเคารพไฟล์ของโครงการโดยไม่ต้องการการกำหนดค่าเพิ่มเติม หากคุณลงชื่อเข้าใช้บัญชี Claude หลายบัญชี แต่ละบัญชีจะได้ไดเรกทอรีการตั้งค่าของตัวเอง: ให้เปิด "ใช้การตั้งค่า CLI ส่วนตัวของฉัน" ในการตั้งค่า เพื่อให้ hooks ระดับผู้ใช้ของคุณทำงานบนทุกบัญชี
AgentsRoom แทนที่ Claude Code hooks หรือไม่?+
ไม่ AgentsRoom ไม่แทนที่, เขียนใหม่, หรือดักจับ Claude Code hooks มันเรียกใช้ CLI ของ Claude Code ที่แท้จริงเป็นกระบวนการลูก ซึ่งหมายความว่า hooks ของคุณยังคงทำงานตามที่ Anthropic ออกแบบไว้ บทบาทของ AgentsRoom คือการให้คุณมีศูนย์กลางการควบคุมภาพและแดชบอร์ดหลายเอเจนต์บนเซสชัน Claude Code ที่ขับเคลื่อนด้วย hooks
ฉันสามารถติดตามเหตุการณ์ hook ของ Claude Code ใน AgentsRoom ได้หรือไม่?+
ใช่ AgentsRoom สตรีมผลลัพธ์ของทุกเซสชัน Claude Code แบบสด รวมถึงเหตุการณ์ที่กระตุ้นโดย hook (ผลลัพธ์ของฟอร์แมตเตอร์, การปฏิเสธการป้องกัน, ข้อความการแจ้งเตือน, การหยุดเอเจนต์) แดชบอร์ดหลายเอเจนต์รวมสถานะจากเอเจนต์ที่กำลังทำงานทุกตัว ดังนั้นคุณสามารถมองเห็นได้ทันทีว่า hook ใดทำงานที่ไหน
ฮุค Claude Code ที่มีประโยชน์ที่สุดในการเริ่มต้นคืออะไร?+
สำหรับทีมส่วนใหญ่ PostToolUse คือ hook แรกที่คุ้มค่าที่สุด: เชื่อมมันเข้ากับ formatter และ linter ของคุณ เพื่อให้ทุกการแก้ไขถูกจัดระเบียบทันที สำหรับโครงการที่ความปลอดภัยเป็นเรื่องคอขาดบาดตาย PreToolUse คือสิ่งที่ขาดไม่ได้: บล็อกคำสั่ง Bash ที่ทำลายข้อมูลก่อนที่เอเจนต์จะรันมัน เมื่อสองตัวนี้พร้อมแล้ว ค่อยเพิ่ม UserPromptSubmit สำหรับ audit logging และ Stop สำหรับเก็บ telemetry เมื่องานเสร็จ
AgentsRoom ใช้งานฟรีกับฮุค Claude Code หรือไม่?+
ใช่. AgentsRoom สามารถดาวน์โหลดและใช้งานได้ฟรีกับโครงการสูงสุด 2 โครงการ นำการสมัครสมาชิก Anthropic หรือ API key ของคุณมาเอง ฮุคทุกตัว, รั้วป้องกัน PreToolUse ทุกตัว, ฟอร์แมตเตอร์ PostToolUse ทุกตัวที่คุณตั้งค่าใน .claude/settings.json จะทำงานทันที: ไม่มีการตั้งค่าเพิ่มเติม, ไม่มีค่าธรรมเนียมเพิ่มเติม.

เจาะลึกเพิ่มเติม

ดูฮุค Claude Code ของคุณทำงานแบบสด

ดาวน์โหลด AgentsRoom, เปิดโครงการที่มีฮุค .claude/settings.json, สร้างเอเจนต์ Claude Code, และดูเหตุการณ์ฮุคทุกเหตุการณ์สตรีมเข้าสู่แดชบอร์ดแบบเรียลไทม์.

ฟรีดาวน์โหลด AgentsRoom

แอปคู่หู: ตรวจสอบเอเจนต์ของคุณได้ทุกที่

นำของคุณเอง: Claude, Codex, Antigravity CLI, หรือผู้ให้บริการ AI อื่น ๆ

รับส่วนขยาย
Chrome Web Store

ส่งข้อบกพร่องและคำขอไปยังแบ็คล็อกสาธารณะของคุณโดยตรง

มองเห็น AgentsRoom ในการทำงาน

หลายโปรเจกต์
ผู้ให้บริการหลายราย
หลาย agents
สถานะสด
ไฟล์ diff & commit
คู่หูมือถือ
ตัวอย่างสด
ทีมเอเจนต์
การทำงานอัตโนมัติในเบราว์เซอร์
การพัฒนาที่ขับเคลื่อนด้วย backlog
ห้องสมุดคำสั่ง
ห้องสมุดทักษะ
ดูฟีเจอร์ทั้งหมด