Claude Code Mods: 6 ขั้นสร้างฟีเจอร์ให้เครื่องมือของตัวเอง

แก่นของเรื่อง

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

ทำไมแนวคิดนี้ได้ผล (กลไกเหตุและผล)

1. Claude Code เรียก handler ของ mod ทุกครั้งที่เกิดเหตุการณ์ เช่น tool call, ส่ง prompt, หรือวาดส่วนหนึ่งของหน้าจอ handler จะ สังเกต แก้ หรือตอบแทน เหตุการณ์นั้นก่อนที่ Claude Code จะทำต่อ
2. mod ไม่ต้อง build ไม่ต้องมี Node.js เพราะ Claude Code โหลดไฟล์ .js และ .ts ตรง ๆ และโหลดซ้ำเองเมื่อไฟล์เปลี่ยน วงจร "บอก, ลอง, ปรับ" จึงจบในเซสชันเดียว
3. mod ที่ Claude เขียนให้ถูกเก็บในโฟลเดอร์ของเซสชัน และโหลดได้หลังผู้ใช้อนุมัติเท่านั้น ผู้ใช้จึงยังเป็นคนตัดสินว่าโค้ดไหนรันบนเครื่อง
4. 6 แบบในหน้านี้มีรากเดียวกัน: เอางานที่ทำซ้ำหรือเสี่ยงพลาดทุกวัน มาเป็นหน้าจอหรือปุ่มที่เห็นทันที

20% ที่สำคัญที่สุดในทางปฏิบัติ

ที่เลื่อนได้: Recording Mode และ Goal Meter ทำเมื่อมีเหตุจำเป็น (ถ่ายวิดีโอ, ทำงานยาวข้ามเซสชัน)

ช่วยให้ดีขึ้นอย่างไร

ป้ายหลักฐาน: (a) แสดงในภาพ (เป็นตัวเลขจากภาพจำลองหน้าจอ ไม่ใช่ผลวัดจริง), (b) ตีความ, (c) ยังไม่ทดสอบ

ตัวเลข 71%, 38%, 4:12, 23:48 และ "12x a week" ในภาพเป็นข้อความตัวอย่างในหน้าจอจำลอง ไม่ควรอ่านเป็นผลวัดของใคร

ลองใช้

ตัวอย่างประกอบ: คำนวณคุ้มค่าของปุ่ม handoff

ตัวเลขชุดนี้เป็นตัวอย่างประกอบ (ใช้ 12 ครั้งต่อสัปดาห์ตามค่าตัวอย่างในภาพ และ 20 วินาทีต่อขั้นเป็นสมมติ)

ผลคือประหยัดขั้นตอนได้ 36 ขั้นต่อสัปดาห์ ถ้า mod ใช้เวลาเขียนและตรวจเกิน 12 นาทีต่อสัปดาห์ที่ได้คืน ต้องใช้หลายสัปดาห์กว่าจะคุ้ม

ตัวอย่างประกอบ: นับเวลา cache ที่เหลือ

ค่า TTL ห้ามเชื่อตามตัวอย่าง ให้ตรวจกับเอกสาร prompt caching ของ API ที่ใช้จริง

เมื่อไหร่ควรใช้ และเมื่อไหร่ไม่ควร

เงื่อนไขก่อนเริ่ม: Claude Code ฝั่ง terminal เวอร์ชัน 2.1.287 ขึ้นไป (ฝั่ง Desktop 2.1.286 ขึ้นไป) ตรวจด้วย claude --version

ก้าวแรกที่เล็กที่สุด

1. เปิดเซสชัน Claude Code แล้วพิมพ์: make a mod that shows the current git branch above the prompt
2. เมื่อ Claude ถามว่าจะเปิด hot reload สำหรับเซสชันนี้ไหม ให้เลือก "Enable for this session"
3. พิมพ์ /plugin ไปที่แท็บ Installed ต้องเห็น mod ในรายการ
4. ชื่อ branch ต้องขึ้นเหนือช่อง prompt ถ้าไม่ตรงใจ บอก Claude ให้แก้ มันโหลดซ้ำเมื่อจบ turn

วิธีตรวจว่าช่วยได้จริง

ทดสอบความเข้าใจ

ภาพอ้างอิงและสิ่งที่อ่านได้จากภาพ

ภาพเป็นอินโฟกราฟิกแนวตั้ง มีหัวข้อ "Claude just dropped Mods and they are game changers" ข้อความนำบอกว่าอธิบายฟีเจอร์เป็นภาษาอังกฤษปกติแล้ว Claude Code เพิ่มให้เอง (ปุ่ม, panel, คำเตือน) ตามด้วย 6 ขั้น แต่ละขั้นมีกรอบหน้าจอจำลองอยู่ด้านขวา

ข้อเท็จจริงที่อ่านได้จากภาพ

สิ่งที่ภาพไม่ได้บอก

Mod คืออะไร

mod คือ plugin ที่มีไฟล์เข้าจุดเดียว (hooks module) เป็น JavaScript หรือ TypeScript Claude Code เรียกฟังก์ชัน register ในไฟล์นั้นตอนโหลด แล้วฟังก์ชันลงทะเบียน handler ผ่านตัวแปร on

โครงไฟล์ขั้นต่ำ

first-mod/
├── .claude-plugin/
│   └── plugin.json      # manifest
└── hooks/
    ├── hooks.json       # { "modules": ["./register.js"] }
    └── register.js      # export function register(on) { ... }

handler ทำอะไรกับเหตุการณ์ได้ 3 อย่าง

เทียบ mod กับของที่คล้ายกัน

ที่ที่ mod ทำงาน

6 ขั้นอย่างละเอียด

ทุกขั้นเริ่มจากการบอก Claude ด้วยภาษาปกติ Claude ใช้ skill ชื่อ plugin-authoring เขียน mod ลงโฟลเดอร์ ~/.claude/dev-mods/<session-id>/ ของเซสชันนั้น ป้ายความมั่นใจในตาราง: 🟢 มีในเอกสารทางการ, 🟡 ตีความจากเอกสาร, ⚪ ยังไม่ยืนยัน

ขั้น 1: วิเคราะห์ log ของตัวเอง

เป้าหมายคือหาว่างานซ้ำอะไรบ่อยสุด ก่อนจะลงมือสร้างอะไร

1. ให้ Claude อ่านบันทึกเซสชันของคุณ (ที่เก็บ transcript เป็นไฟล์ในโฟลเดอร์ ~/.claude/projects/ ⚪ ความรู้ทั่วไป ควรตรวจบนเครื่องตัวเอง)
2. ให้นับรูปแบบที่ซ้ำ: คำสั่งที่พิมพ์ซ้ำ, ขั้นตอน copy-paste, ข้อความเตือนที่เจอบ่อย
3. ให้จัดอันดับตาม (ความถี่ x จำนวนขั้นมือ)
4. เลือกอันดับ 1-2 ไปทำเป็น mod

Read my last 30 session transcripts. List the manual actions I repeat
(count per week, steps per action). Rank by count x steps. Propose which
Claude Code mods would remove the top 2. Do not write any mod yet.

Note: ตัวอย่างในภาพคือ "hand off 12 ครั้งต่อสัปดาห์" ซึ่งเป็นค่าตัวอย่างในภาพจำลอง ผลของคุณจะต่างออกไป

ขั้น 2: Cache Keeper (แถบ context, limit, cache, ปุ่ม handoff)

ข้อควรระวัง: ตัวเลขเปอร์เซ็นต์ของ limit มาจากค่าที่ Claude Code ให้ ถ้าแผนที่ใช้ไม่มี rate limit ค่านั้นอาจว่าง ให้ mod รับมือกรณีไม่มีค่า

ขั้น 3: Recording Mode (บังค่าลับบนจอ)

กลไก: hook ui.render ที่ render site ของข้อความ (UserMessage, AssistantMessage, ToolUse, ToolResult, CommandOutput) แก้ e.props ให้ค่าที่ตรงกับรูปแบบลับ (เช่น sk-live-...) ถูกแทนด้วยจุด ส่วนข้อมูลที่ส่งให้โมเดลไม่ถูกแตะ

Warning: Recording Mode ลดความเสี่ยงตอนถ่ายหน้าจอ ไม่ใช่การเก็บความลับ อย่าถ่ายตอนที่ permission prompt อาจแสดงค่าลับ และอย่าใช้ค่าจริงของระบบ production ตอนทดสอบ

ขั้น 4: Goal Meter (task list กับตัวจับเวลาต่อ /goal)

กับดัก: ตัวแปรในไฟล์ mod หายทุกครั้งที่ hot reload ค่าที่ต้องรอดให้ใส่ $.state (รอดตอน reload ในเซสชันเดียว) หรือ $.store (รอดข้ามเซสชัน) และต้องหยุด timer ตอนเกิด ui.close กับ session.end ไม่เช่นนั้น timer ค้างสะสม

ขั้น 5: Collision Guard (เตือนเมื่อแชตอื่นแก้ไฟล์เดียวกัน)

ลำดับการทำงาน:

1. ดัก tool.call ของ tool ที่เขียนไฟล์ (เช่น Edit, Write)
2. อ่านใน $.store ว่าไฟล์ path นี้ถูกเซสชันอื่นแก้ล่าสุดเมื่อไร
3. ถ้าเป็นเซสชันอื่นและยังไม่เกินกรอบเวลา (เช่น 5 นาที) ให้ถามผู้ใช้
4. Proceed: next(e) และบันทึกว่าเซสชันนี้แก้ล่าสุด
5. Worktree: ปฏิเสธด้วยเหตุผลที่บอก Claude ให้ไปทำใน worktree
6. Cancel: { deny: reason }

// ตัวอย่างประกอบ (pseudo-code): ลายเซ็นจริงของ $.store และ $.ui.ask
// ให้ตรวจกับไฟล์ types ที่ Claude Code เขียนไว้ใน .claude-plugin/types/
on('tool.call', { tool: 'Edit' }, async ($, e, next) => {
  const last = await $.store.get('edit:' + e.file_path)
  const isOther = last && last.session !== $.session.id()
  if (isOther && Date.now() - last.at < 5 * 60 * 1000) {
    // ถามผู้ใช้ 3 ทางเลือก แล้วตัดสินใจตามคำตอบ
  }
  await $.store.set('edit:' + e.file_path, { session: $.session.id(), at: Date.now() })
  return next(e)
})

ข้อจำกัดที่ควรรู้:

ขั้น 6: เปลี่ยนงานซ้ำเป็นปุ่ม

กลไก: วาด Button ใน band เหนือ prompt ผูกกับฟังก์ชันที่ทำขั้นตอนทั้ง 4 ใน handler เดียว เอกสารระบุว่ามี $.command.run (รันคำสั่ง), $.prompt.submit (ส่ง prompt) และ Button มี hotkey ให้กดตัวเลขเดียวได้เมื่อ prompt ว่าง

คำเตือนเรื่องปุ่มที่ส่ง prompt แทนผู้ใช้: $.prompt.submit มี 2 แบบ แบบปกติ Claude เห็นว่าผู้ส่งคือ mod ส่วน asUser: true ส่งเหมือนผู้ใช้พิมพ์เอง ให้เลือกแบบปกติเว้นแต่จำเป็น เพื่อให้ตรวจย้อนหลังได้ว่าอะไรมาจากไหน

ความเสี่ยงและข้อจำกัดโดยรวม

Warning: mod รันด้วยสิทธิ์ของผู้ใช้ ไม่ถูก sandbox อ่านและเขียนไฟล์ได้ทุกที่ที่บัญชีเข้าถึง เริ่มโปรแกรมได้ ส่งคำขอเครือข่ายได้ อ่านตัวแปรสภาพแวดล้อมและไฟล์ settings ได้ (รวมถึง API key) เห็นทุก prompt และ tool call เปลี่ยน prompt ได้ อนุมัติ tool call ก่อนถามผู้ใช้ได้ และเรียกโมเดลด้วยโควตาของผู้ใช้ได้

ข้อผิดพลาดที่พบบ่อย

• เก็บค่าที่ต้องรอดไว้ในตัวแปรของไฟล์ แล้วงงว่าทำไมค่าหายหลังแก้โค้ด
• ไม่หยุด timer ตอนปิด pane ทำให้ timer ซ้อนหลัง reload
• ทำ guard ก่อนทำแบบสังเกต แล้วถูกบล็อกงานจริงโดยไม่มีทางผ่าน
• ใส่ค่าอ่านจาก e ตรง ๆ ใน render hook ทั้งที่ค่า props อยู่ใน e.props
• คิดว่าการบังบนจอ เท่ากับการไม่ส่งค่าให้โมเดล

รายการตรวจก่อนใช้ mod ทุกตัว

ขั้นตอนถัดไป

Recommendation: เริ่มจากขั้น 1 ภายในสัปดาห์นี้ นับ handoff และงานซ้ำจาก log จริง ตัดสินใจสร้างเฉพาะ mod ที่ผลคูณ ความถี่ x ขั้นมือ สูงสุดสองอันดับแรก แล้วเริ่มด้วยแบบสังเกตอย่างเดียว

เก็บ mod ที่ใช้ได้จริงไว้นอกโฟลเดอร์เซสชัน (โฟลเดอร์ dev-mods ถูกลบเมื่อเก่าเกิน cleanupPeriodDays) แล้วโหลดด้วย claude --plugin-dir <path>

Sources

เอกสารทางการของ Anthropic (Claude Code documentation):

• Mods overview: นิยาม, สิ่งที่ mod ทำได้, ความเสี่ยง, ที่ที่ mod ทำงาน, เวอร์ชันที่ต้องใช้
• Create a mod: การขอให้ Claude เขียน mod, hot reload, claude plugin validate, claude plugin test
• Mods reference: รายการ event, $ API, render site, element, ขีดจำกัด

หัวข้อที่เติมจากความรู้ทั่วไปหรือตีความ (ไม่ได้มาจากเอกสารข้างต้นโดยตรง): ที่เก็บ transcript ใน ~/.claude/projects/, TTL ของ prompt cache ที่ 5 นาที, วิธีผูก Goal Meter กับ /goal, และรูปแบบ pseudo-code ของ Collision Guard

ตัวย่อที่ใช้ในหน้านี้

ตัวย่อที่มาจากความรู้ทั่วไป ไม่ได้ถูกนิยามในภาพหรือเอกสารที่อ่าน: UI, JS, TS, JSON, CLI, SDK, VS Code, WSL, TTL, HTTP, IDE, git, regex, sed, ID, sk-, n8n

สัญลักษณ์ในสูตร

Summary