Mods ของ Claude Code: คืออะไร และตัวที่เราใส่ไว้ในทุกเอเจนต์

วันที่ 1 ตุลาคม 2026 Claude Code 2.1.287 ออกมาพร้อมรายการ changelog บรรทัดเดียว: "Added Claude Mods" สี่วันต่อมา AgentsRoom ก็เริ่มโหลด mod ตัวหนึ่งของเราเข้าไปในเอเจนต์ Claude ที่มันรันอยู่

บทความนี้อธิบายว่า mod คืออะไร มันทำอะไรได้บ้างที่จุดต่อขยายแบบเดิมทำไม่ได้ วิธีเขียน โหลด และทดสอบ mod และสิ่งที่เราได้เรียนรู้จากการใส่ mod ไว้ในทุกเอเจนต์ Claude ที่ AgentsRoom เปิดขึ้นมา ข้อมูลเกี่ยวกับ Claude Code มาจากเอกสารและ changelog ของมัน ซึ่งเราอ่านเมื่อวันที่ 9 พฤศจิกายน 2026 โดยติดตั้ง Claude Code 2.1.318 ไว้

คำตอบสั้น ๆ mod คือปลั๊กอินของ Claude Code ที่มี hooks module: ไฟล์ JavaScript หรือ TypeScript ที่ Claude Code เรียกฟังก์ชันของมันจากภายในโปรเซสของตัวเองเมื่อเกิดอีเวนต์ขึ้น ฟังก์ชันหนึ่งจะปล่อยอีเวนต์ผ่านไป แก้ไขมัน หรือตอบมันแทน Claude Code ก็ได้ นี่คือวิธีที่ mod วาดแผง เพิ่มคำสั่ง หรือหยุดคำสั่ง shell ก่อนที่มันจะรัน

mod คืออะไร

Claude Code มีปลั๊กอินอยู่แล้ว: โฟลเดอร์ที่มีแมนิเฟสต์อยู่ที่ .claude-plugin/plugin.json ซึ่งรวม skill, subagent, settings hook และเซิร์ฟเวอร์ MCP ไว้ด้วยกันเพื่อให้ติดตั้งเป็นชุดเดียว mod คืออีกหนึ่งสิ่งที่ปลั๊กอินบรรจุไว้ได้ เมื่อไฟล์ hooks/hooks.json ของปลั๊กอินระบุไฟล์โค้ดไว้ใต้คีย์ modules Claude Code จะโหลดไฟล์นั้นและเรียกฟังก์ชัน register ที่ไฟล์นั้น export ออกมา จากนั้นปลั๊กอินนี้ก็ถูกเรียกว่า mod

ภายใน register การเรียก on(event, hook) แต่ละครั้งจะผูกฟังก์ชันหนึ่งเข้ากับอีเวนต์หนึ่ง: tool.call ก่อนที่เครื่องมือจะรัน, prompt.submit เมื่อคุณส่งพรอมต์, session.start, command.run สำหรับคำสั่ง slash, ui.render เมื่อ Claude Code วาดส่วนหนึ่งของหน้าจอ และอื่น ๆ อีก ทุก hook ได้รับสามสิ่ง:

• $ คือ API ของ mods: ทุกอย่างที่ mod ทำได้นอกโค้ดของตัวเอง เช่น $.ui, $.command, $.fs, $.process หรือ $.http
• e คืออีเวนต์ ในรูปข้อมูลธรรมดา: สำหรับการเรียกเครื่องมือ ก็คือชื่อเครื่องมือและอาร์กิวเมนต์ของมัน
• next ซึ่งส่งอีเวนต์ต่อไปยัง mod ตัวอื่น แล้วจึงไปยังพฤติกรรมของ Claude Code เอง และคืนผลลัพธ์กลับมา

สิ่งที่ hook ทำกับ next เป็นตัวตัดสินว่าจะเกิดอะไรขึ้น คืนค่า next(e) แปลว่าคุณแค่สังเกตการณ์ เรียก next ด้วยสำเนาของ e ที่แก้ไขแล้ว แปลว่าคุณเขียนอีเวนต์นั้นใหม่ คืนผลลัพธ์ของคุณเองโดยไม่เรียก next แปลว่าคุณตอบมันแทน: เครื่องมือจะไม่ได้รันเลย หรือ Claude Code จะไม่ได้วาดส่วนนั้นด้วยตัวเอง

เอกสารก็เรียกฟังก์ชันเหล่านี้ว่า hook เหมือนกัน แต่มันไม่ใช่ hook ที่คุณเขียนใน settings.json ซึ่งตอนนี้ Claude Code เรียกว่า settings hooks

mod, settings hook, skill หรือเซิร์ฟเวอร์ MCP

ทั้งสี่อย่างทับซ้อนกัน และ mod หนักที่สุดในบรรดาทั้งหมด เลือกตัวที่เบาที่สุดที่ทำงานนั้นได้

ปลั๊กอินหนึ่งตัวบรรจุได้ทั้งสี่อย่าง ดังนั้น mod จึงมาพร้อมกับ skill และเซิร์ฟเวอร์ MCP ที่มันทำงานร่วมด้วยได้

สามไฟล์ของ mod

my-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.ts

plugin.json คือแมนิเฟสต์ปกติของปลั๊กอิน: ชื่อ เวอร์ชัน และคำอธิบาย hooks.json ชี้ไปที่โค้ด { "modules": ["./register.ts"] } เป็นพาธเดียว โดยนับจากตำแหน่งของไฟล์นั้น register.ts คือ hooks module Claude Code โหลด .js และ .ts ได้โดยตรง ไม่ต้องใช้ bundler และไม่มีขั้นตอนบิลด์ และ import แบบไม่ระบุพาธเพียงตัวเดียวที่อนุญาตคือ claude-code สำหรับ type และตัวช่วยอีกไม่กี่ตัว

mod ที่เราใส่ไว้: ใครแก้ไฟล์นี้?

AgentsRoom รันเอเจนต์เขียนโค้ดหลายตัวบน repository เดียวกัน และแสดงในแท็บการเปลี่ยนแปลงว่าเอเจนต์ไหนแก้ไฟล์ไหน เพื่อให้คุณรีวิวและคอมมิตงานของแต่ละเอเจนต์แยกกันได้ ไฟล์ที่เขียนด้วยเครื่องมือ Edit และ Write ของ Claude นั้นง่าย: Claude Code รายงานมันผ่าน settings hook แต่ไฟล์ที่เขียนด้วยคำสั่ง shell ไม่ง่ายเลย sed -i, heredoc, codemod หรือ rm ไม่เคยผ่านเครื่องมือจัดการไฟล์

ก่อนจะมี mods เราใช้การเดา AgentsRoom อ่านทรานสคริปต์ของเซสชันเอเจนต์เพื่อดูว่าคำสั่ง Bash แต่ละคำสั่งเริ่มและจบเมื่อไร แล้วเทียบเวลาแก้ไขของไฟล์กับช่วงเวลาเหล่านั้น วิธีนี้ใช้ได้เกือบตลอด และพังในสามแบบที่เราระบุได้ชัด:

• ไฟล์ที่ถูกลบไม่มีเวลาแก้ไขอีกต่อไป การลบจึงไม่เคยถูกระบุว่าเป็นฝีมือของเอเจนต์ไหน
• คำสั่งแบบอ่านอย่างเดียวอย่าง grep เปิดช่วงเวลาที่เอเจนต์อาจเขียนอะไรก็ได้
• ทุกอย่างขึ้นกับรูปแบบของทรานสคริปต์ ซึ่ง Claude Code จะเปลี่ยนเมื่อไรก็ได้

mod ตัดการเดาทิ้งไป mod agentsroom-changes ของเราเกาะ hook ที่ tool.call สำหรับเครื่องมือ shell ทั้งสองตัว ก่อนคำสั่งจะรัน มันถ่ายสแนปช็อตของ repository (git status บวกขนาดและเวลาแก้ไขของทุกพาธที่มีการเปลี่ยนแปลง) ทันทีหลังคำสั่งรัน มันถ่ายอีกครั้ง พาธที่ต่างกันคือสิ่งที่คำสั่งนั้นเปลี่ยน รวมถึงการลบ และ mod ส่งรายการเหล่านั้นไปยังแอปเดสก์ท็อป AgentsRoom ผ่านเอนด์พอยต์ HTTP ในเครื่อง การเรียกที่ Claude Code เองระบุว่าอ่านอย่างเดียวจะไม่ถูกนับว่าแก้ไฟล์ใดเลย

นี่คือ hook ฉบับย่อ ไฟล์เต็มยาว 177 บรรทัด ส่วนใหญ่เป็นเรื่องสแนปช็อตและขีดจำกัดของมัน

import type { Register } from 'claude-code';

const SHELL_TOOLS = new Set(['Bash', 'PowerShell']);

export const register: Register = (on) => {
  on('tool.call', async ($, e, next) => {
    if (!SHELL_TOOLS.has(e.tool)) return next(e);
    const ready = await prepare($).catch(() => null); // agent id, repo root, snapshot
    if (!ready) return next(e);                        // outside AgentsRoom: do nothing
    const callId = e.tool_use_id;
    post($, ready.agentId, { kind: 'start', callId });
    const ran = await next(e);                         // the command runs here
    const wroteNothing = ran.deny !== undefined || ran.isReadOnly === true;
    await reportEnd($, { ...ready, callId }, wroteNothing)
      .catch(() => post($, ready.agentId, { kind: 'end', callId, paths: [] }));
    return ran;                                        // Claude sees the normal result
  });
};

แอปเดสก์ท็อปคัดลอก mod ไปไว้ในโฟลเดอร์ของตัวเอง และเปิดเอเจนต์ Claude แต่ละตัวด้วย claude --plugin-dir <that folder> เฉพาะเมื่อ Claude Code ที่ติดตั้งอยู่เป็นเวอร์ชัน 2.1.287 ขึ้นไป เราปล่อยมันใน AgentsRoom 1.201.0 เมื่อวันที่ 5 ตุลาคม 2026

สิ่งที่เราเรียนรู้จากการปล่อยมัน

mod ต้องไม่ทำให้ผู้ใช้เสียการเรียกเครื่องมือแม้แต่ครั้งเดียว hook ของเราอยู่หน้าคำสั่ง shell ทุกคำสั่งที่ Claude รัน ถ้ามันโยนข้อผิดพลาด หรือรอเครือข่าย งานของ Claude ก็หยุด ทุกขั้นตอนจึงมีการป้องกัน ทุกการส่งข้อมูลไปยังแอปเดสก์ท็อปจะส่งออกไปโดยไม่รอคำตอบ และการรอเพียงอย่างเดียวที่เรายอมรับคือสแนปช็อต git status สองครั้ง แต่ละครั้งจำกัดไว้ที่ 15 วินาที การส่งที่หายไปทำให้เสียการระบุเจ้าของไฟล์หนึ่งครั้ง ไม่เคยทำให้เสียคำสั่ง

อย่าทำอะไรเลยเมื่อไม่มีใครต้องการ mod อ่านตัวแปรสภาพแวดล้อมที่ AgentsRoom ตั้งไว้ให้เอเจนต์ของมัน ถ้าไม่มีตัวแปรนี้ เช่น เพราะมีคนคัดลอกโฟลเดอร์ไปใส่ในการตั้งค่าของตัวเอง ทุก hook จะข้ามตรงไปที่ next(e)

โฟลเดอร์ที่โหลดด้วย --plugin-dir จะถูกเฝ้าดู Claude Code โหลด mod ใหม่เมื่อไฟล์ในโฟลเดอร์นั้นเปลี่ยน และการโหลดใหม่จะรัน register อีกรอบ เรื่องนี้กำหนดวิธีที่เราติดตั้งมัน: แอปเดสก์ท็อปจะเขียนไฟล์ของ mod ก็ต่อเมื่อเนื้อหาเปลี่ยนเท่านั้น เพราะการเขียนทับแบบไม่ดูอะไรทุกครั้งที่เปิดเอเจนต์จะทำให้ mod ถูกโหลดใหม่ในทุกคอนโซล Claude ที่เปิดอยู่แล้ว

เตรียมรับมือกับ API ที่เปลี่ยนไป อีเวนต์และเมธอดเปลี่ยนได้ระหว่างรุ่น และเอกสารก็บอกไว้เอง เมื่อ mod ถูกโหลดจาก --plugin-dir Claude Code จะเขียนการประกาศ type ของเวอร์ชันที่กำลังรันอยู่ลงใน .claude-plugin/types/ เราตรวจ type เทียบกับไฟล์เหล่านั้น ไม่ใช่เทียบกับหน้าเว็บ และถ้าบิลด์ไหนไม่โหลด mod ของเราอีกแล้ว ก็ไม่มีอะไรพัง: mod จะไม่เคยแจ้งว่าพร้อม และ AgentsRoom จะกลับไปใช้วิธีเดิมผ่านทรานสคริปต์

เขียน mod ของคุณเอง

คุณเริ่มได้สองทาง

ขอให้ Claude ทำ ในเซสชัน Claude Code แบบโต้ตอบ ให้อธิบาย mod ที่คุณต้องการ ("แสดง branch git ปัจจุบันเหนือพรอมต์") Claude จะใช้ skill ในตัวชื่อ plugin-authoring เขียน mod ลงในโฟลเดอร์เฉพาะของเซสชันนั้น และ Claude Code จะถามคุณหนึ่งครั้งว่าจะเปิดใช้ mods ที่ Claude เขียนหรือไม่ ตอบว่าใช่ แล้ว mod จะโหลดเมื่อจบเทิร์น จากนั้นจะโหลดใหม่หลังทุกเทิร์นที่แก้มัน

เขียนสามไฟล์ด้วยตัวเอง จากนั้น:

claude --plugin-dir ./my-mod       # load it for one session, hot reload on save
claude plugin validate ./my-mod    # what Claude Code reads from it, without running it
claude plugin test                 # run the mod's *.test.ts files, no session needed

claude plugin validate พิมพ์บรรทัด hooks: ที่มีอีเวนต์ที่ module ของคุณจัดการ และบรรทัด calls: ที่มีทุกเมธอดของ API ของ mods ที่มันเรียก ถ้าอีเวนต์ที่คุณตั้งใจจะจัดการไม่อยู่ในนั้น Claude Code ก็จะไม่เรียก hook นั้นเช่นกัน การวิเคราะห์โค้ดแบบสถิตมีกฎของมัน: เขียนทุกการเรียกให้เต็ม ($.ui.toast(...) ห้ามเขียน const ui = $.ui) ส่งชื่ออีเวนต์เป็นสตริงตรง ๆ และ import เฉพาะไฟล์ของคุณเองด้วยพาธแบบสัมพัทธ์

ถ้าจะแชร์ mod ให้ปฏิบัติกับมันเหมือนปลั๊กอินที่มันเป็นอยู่: ส่งโฟลเดอร์ไป หรือใส่ไว้ในมาร์เก็ตเพลส (repository ที่มี .claude-plugin/marketplace.json) เพื่อให้คนอื่นติดตั้งด้วย /plugin install <name>@<marketplace>

mods ที่คุณอ่านได้ตั้งแต่วันนี้

• มาในตัว Claude Code: /plugin แท็บ Installed ส่วน Built-in ในนั้นมีแผง /diff และตัวโหลดที่อ่าน AGENTS.md เป็นคำแนะนำของโปรเจกต์ ซึ่ง Anthropic เผยแพร่ซอร์สโค้ดไว้ในโฟลเดอร์ mods ของ repository anthropics/claude-code พร้อมชุดทดสอบของมัน ที่มาในตัวเช่นกัน และปิดอยู่จนกว่าคุณจะเปิด: You should know เอเจนต์ข้างเคียงที่คอยชี้สิ่งที่คุณหรือ Claude อาจมองข้ามไป
• ตัวอย่างของ Anthropic ใน repository claude-code-playground: การพยากรณ์หน้าต่างบริบทที่วาดไว้เหนือพรอมต์ ตัวป้องกันที่กักคำสั่ง shell ที่มีความเสี่ยงไว้และแสดงว่ามันจะเปลี่ยนอะไร และคำสั่ง /replay ที่ไล่ดูการแก้ไขของเทิร์นล่าสุดทีละขั้น
• ของเรา ที่อธิบายไว้ข้างบน: mod ที่ไม่มีอินเทอร์เฟซเลย มีแค่ hook tool.call ตัวเดียว ซึ่งเป็นรูปแบบที่ดีสำหรับนำไปใช้ต่อ ถ้าสิ่งที่คุณต้องการคือข้อมูลมากกว่าแผง

ก่อนติดตั้ง mod ของคนอื่น

mod ไม่ได้ถูกแยกไว้ใน sandbox มันรันด้วยสิทธิ์ของคุณ: มันอ่านและเขียนไฟล์ของคุณได้ อ่านตัวแปรสภาพแวดล้อมและการตั้งค่าของคุณได้ (รวมถึงคีย์ API) เปิดโปรแกรม ส่งคำขอผ่านเครือข่าย เห็นทุกพรอมต์และทุกการเรียกเครื่องมือ และอนุมัติการเรียกเครื่องมือก่อนที่คุณจะถูกถามได้ ถ้าคุณเปิด sandbox ของ Claude Code ไว้ มันครอบคลุมคำสั่ง Bash ที่ Claude รัน ไม่ใช่โปรเซสที่ mod เปิดขึ้นมา

ดังนั้นอ่านก่อนติดตั้ง โคลน mod นั้นมาแล้วรัน claude plugin validate กับโฟลเดอร์: บรรทัด hooks: และ calls: บอกคุณว่ามันฟังอะไรและเข้าถึงอะไร โดยไม่ต้องรันอะไรเลย mod ที่แค่วาดแถบเหนือพรอมต์ไม่มีเหตุผลที่จะเรียก $.http หรือ $.process ถ้าจะหยุด mod ทุกตัวที่คุณติดตั้ง ให้เริ่มด้วย --safe-mode สำหรับหนึ่งเซสชัน หรือตั้ง "disableAllHooks": true ใน ~/.claude/settings.json

mods ทำงานที่ไหนบ้าง

mod ที่วาดอะไรบางอย่างควรตรวจว่าตัวเองรันอยู่ที่ไหน และถอยกลับไปใช้ข้อความในที่ที่ไม่มีอะไรถูกวาด

ใน AgentsRoom

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

แนวคิดเดียวกันนี้ใช้ใน CLI อื่นด้วยเท่าที่ทำได้: oh-my-pi ได้ส่วนขยายที่ใช้ข้อตกลงเดียวกัน และ CLI อื่น ๆ ยังจับคู่การเขียนไฟล์ของ shell แบบที่เคยทำ ถ้าคุณอยากไปให้ไกลกว่านี้กับสิ่งที่ Claude Code เปิดให้ในแต่ละขั้น คู่มือ hook ของ Claude Code ของเราครอบคลุม settings hook ที่ mod ทำงานอยู่ข้าง ๆ

คำถามที่พบบ่อย

mod ใน Claude Code คืออะไร?

mod คือปลั๊กอินของ Claude Code ที่มี hooks module อยู่ข้างใน: ไฟล์ JavaScript หรือ TypeScript ที่ Claude Code เรียกฟังก์ชันของมันจากภายในโปรเซสของตัวเองเมื่อมีบางอย่างเกิดขึ้น เช่น การเรียกเครื่องมือ พรอมต์ที่ถูกส่ง หรือส่วนหนึ่งของหน้าจอที่กำลังถูกวาด แต่ละฟังก์ชันจะปล่อยอีเวนต์ผ่านไป แก้ไขมัน หรือจัดการมันเองก็ได้ นั่นคือสิ่งที่ทำให้ mod วาดแผง เพิ่มคำสั่ง หรือกักคำสั่ง shell ที่มีความเสี่ยงไว้ได้

ต้องใช้ Claude Code เวอร์ชันไหนสำหรับ mods?

Claude Code 2.1.287 ขึ้นไปในเทอร์มินัล ซึ่งออกเมื่อวันที่ 1 ตุลาคม 2026 โดย changelog เขียนไว้ว่า "Added Claude Mods" แท็บ Code ของแอป Claude Desktop รองรับตั้งแต่ 2.1.286 ในส่วนขยาย VS Code นั้น hook ทำงานได้ และสิ่งที่ mod วาดต้องใช้ส่วนขยาย 2.1.299 ขึ้นไป รัน claude --version เพื่อตรวจสอบ

mod กับ hook ของ Claude Code ต่างกันอย่างไร?

hook ใน settings.json จะรันคำสั่ง shell คำขอ HTTP หรือพรอมต์เมื่อมีอีเวนต์เกิดขึ้น โดยทำงานอยู่นอก Claude Code ส่วน hook ของ mod คือฟังก์ชันที่ทำงานอยู่ภายใน Claude Code มันทำสิ่งที่ settings hook ทำไม่ได้: วาดในอินเทอร์เฟซ เพิ่มคำสั่ง slash ที่รันได้โดยไม่ต้องใช้เทิร์นของ Claude เขียนการเรียกเครื่องมือใหม่หรือตอบมันโดยไม่รันเครื่องมือ และแชร์สถานะระหว่าง hook ต่าง ๆ

ติดตั้ง mods ของ Claude Code ปลอดภัยไหม?

mod ไม่ได้ถูกแยกไว้ใน sandbox มันรันด้วยสิทธิ์ของคุณ อ่านไฟล์และตัวแปรสภาพแวดล้อมของคุณได้ เปิดโปรแกรม ส่งคำขอผ่านเครือข่าย และอนุมัติการเรียกเครื่องมือได้ ติดตั้ง mods จากผู้เขียนที่คุณไว้ใจเท่านั้น และรัน claude plugin validate กับโฟลเดอร์ก่อน: มันจะแสดงอีเวนต์ที่ mod เกาะ hook ไว้และการเรียกที่มันทำ โดยไม่ต้องรัน mod นั้น

หาตัวอย่าง mods ของ Claude Code ได้ที่ไหน?

Anthropic เผยแพร่ซอร์สโค้ดของ mod ในตัวบางตัว เช่น แผง /diff และตัวโหลด AGENTS.md ไว้ในโฟลเดอร์ mods ของ repository anthropics/claude-code และมี mod ตัวอย่างใน repository anthropics/claude-code-playground ส่วน mod ของ AgentsRoom ที่อธิบายในบทความนี้เป็นตัวอย่างแบบที่สี่: mod ที่ไม่มีอินเทอร์เฟซ มีเพียง hook tool.call ตัวเดียว

ปิด mods ได้ไหม?

ได้ ปิด mod ทีละตัวได้จากแท็บ Installed ของ /plugin เริ่มเซสชันเดียวด้วย --safe-mode หรือตั้ง disableAllHooks เป็น true ใน ~/.claude/settings.json เพื่อหยุด mod ทุกตัวที่คุณติดตั้ง พร้อมกับ settings hook ของคุณ --safe-mode และ disableAllHooks ยังปล่อยให้ mod ในตัวทำงานต่อ: ตัวเหล่านั้นต้องปิดทีละตัวใน /plugin