🎯 แก่นของเรื่อง
แนวคิดหลัก: เมื่อ AI Agent ทำงานหลายขั้นตอนเอง ความสามารถในการเขียนโค้ดไม่พอ ต้องมี "ช่องมองเห็น" (สถานะ, context, ผลรีวิว) และ "จุดหยุด" (ถามคนก่อนทำสิ่งที่ย้อนกลับไม่ได้) ชุด mods ทำสองอย่างนี้ผ่าน hook ของ Claude Code อ่านจาก repo (2026-10-19)
ทำไมได้ผล (กลไกเหตุ-ผล)
- Claude Code มี hook ที่เปิดให้ปลั๊กอินเสียบเข้าไปตอนมีการเรียกเครื่องมือและตอนวาดหน้าจอ
- mod ที่ดักการเรียก Bash (เช่น blast-radius) เห็นคำสั่งก่อนรัน จึงวัดผลกระทบและถามคนได้ก่อน
- mod ที่วาด "band" เหนือช่องพิมพ์ (เช่น context-bar) ดึงข้อมูลที่ปกติมองไม่เห็นมาไว้หน้าจอตลอดเวลา
- ผลคือคนตัดสินใจจากข้อมูลจริงแทนการเดา
ตีความ
20% ที่สำคัญที่สุดในทางปฏิบัติ
| ลำดับ | ทำเรื่องนี้ก่อน | รอได้ |
|---|---|---|
| 1 | ติดตั้ง blast-radius เพื่อกันลบไฟล์ทั้งโฟลเดอร์, force push, migration | mod เกมและความบันเทิง (reels, snake, now-playing) |
| 2 | ติดตั้ง context-bar เพื่อรู้ว่า context ใกล้เต็มหรือยัง | mod ยอดเงิน API (openai-balance, openrouter-balance) |
| 3 | ตั้ง timeoutSeconds ให้เหมาะกับการนั่งเฝ้าของคุณ |
การสลับลำดับ band |
| 4 | เปิด review-watch ถ้าใช้ Codex หรือ subagent รีวิวโค้ด | mod "ตั้งค่าส่วนตัว" ที่ต้อง fork ไปแก้ก่อนใช้ |
📈 ช่วยให้ดีขึ้นอย่างไร
| สถานการณ์ | ถ้าไม่มี | ถ้ามี | วัดอย่างไร | ป้ายหลักฐาน |
|---|---|---|---|---|
Agent สั่ง rm -r |
ลบทันที ไม่เห็นว่าลบอะไร | ถูกพักไว้ แสดงรายการไฟล์และขนาดรวมก่อนให้กด | นับครั้งที่ยกเลิกหลังเห็นรายการ | ตีความ (กลไกอ่านจากโค้ดแล้ว แต่ไม่มีตัวเลขผลลัพธ์) |
| Force push | ไม่รู้ว่า commit ใดจะหาย | แสดง commit บน remote ที่จะถูกทิ้ง (เทียบตาม fetch ล่าสุด) | เทียบรายการกับ git log เอง |
ตีความ |
| Context ใกล้เต็ม | รู้ตัวเมื่อ Agent เริ่มลืมงานหรือเกิด compaction | เห็นเปอร์เซ็นต์และสีเหลือง/แดงล่วงหน้า | จำนวนครั้งที่ compaction ไม่คาดคิดต่อวัน | ตีความ |
| Session ไม่มีคนเฝ้า | คำสั่งเสี่ยงอาจค้างรอหรือรันเอง | ไม่มีคนกดภายใน 60 วินาที ถือเป็นยกเลิก | ดูข้อความปฏิเสธใน transcript | อ่านจาก repo (2026-10-19) (พฤติกรรม); ประโยชน์เชิงตัวเลข ยังไม่ทดสอบ |
| ตามรีวิวของ Codex | ต้องสลับไปดู terminal อื่น | เห็นเวลา, บรรทัดล่าสุด, จำนวนข้อพบ [P1]/[P2] ในแถบเดียว |
เวลาที่ใช้เช็กสถานะต่อรีวิว | ยังไม่ทดสอบ |
ไม่มีตัวเลขวัดผลจริง (เช่น ลดอุบัติเหตุได้กี่ %) ใน repo ทุกแถวจึงเป็นการอนุมานจากกลไก ไม่ใช่ผลที่พิสูจน์แล้ว
🧩 ภาพรวมโปรเจกต์
Claude Code mods เป็นชุดปลั๊กอินสำหรับ Claude Code ที่สร้างบน function hooks เพิ่ม "เส้นสถานะเหนือช่องพิมพ์ ตัวกัน แผงข้อมูล และเกม" ติดตั้งเฉพาะที่ต้องการได้ใต้ MIT License อ่านจาก repo (2026-10-19)
| ข้อมูล | ค่า |
|---|---|
| Repo | hamzafer/claude-code-mods |
| License | MIT |
| ขนาดชุมชน ณ วันอ่าน | 288 ดาว, 27 fork, 95 commit |
| Claude Code ขั้นต่ำ | 2.1.287 ขึ้นไป |
| โครงสร้าง | mods/ (แต่ละ mod), cli/ (ตัวติดตั้ง), shared/, docs/, site/ |
| ภาษาโค้ดที่เห็นในไฟล์ | TypeScript/TSX เป็นหลัก มี .mjs/.cjs บางส่วน |
repo มีมากกว่าสี่ mod ที่มักถูกพูดถึง คือมีหลายสิบตัว แบ่งเป็นกลุ่ม:
| กลุ่ม | mod |
|---|---|
| เห็นว่าเกิดอะไรขึ้น | mission-control, context-bar, token-weather, cache-clock, where-am-i |
| เห็นว่าเกิดอะไรขึ้น (ต่อ) | next-steps, usage-meter, heatmap, openai-balance, openrouter-balance |
| เห็นว่าเกิดอะไรขึ้น (ต่อ) | agent-radar, review-watch, browser-lanes, prayer-times |
| เห็นว่าเกิดอะไรขึ้น (ต่อ) | replay-theater, md-preview |
| ปกป้อง repo | blast-radius |
| ประหยัดค่าใช้จ่าย | switchboard |
| ตั้งค่าส่วนตัว (ตั้งใจให้ fork) | glance, merge-gate, rulebook-guard, session-saver |
| ความบันเทิง (เลือกเปิด) | reels, snake, now-playing |
| mod จากผู้พัฒนาอื่น | 7 ตัวใน marketplace แยก ไม่ได้ดูแลโดยโปรเจกต์นี้ |
🔧 mod หลักทีละตัว
Context Bar
- คืออะไร: แถบเดียวที่แยกการใช้ context window เป็น system prompt, tools, MCP tools, memory files, skills, messages, พื้นที่ว่าง และ compaction buffer
- ทำไมสำคัญ: context เต็มทำให้เกิด auto-compaction ซึ่งสรุปบทสนทนาเดิมและอาจทำให้รายละเอียดหาย
ตีความ - อ่านค่า: ส่วนหัวบอก token ที่ใช้, ขนาดหน้าต่าง, จุด auto-compaction และเปอร์เซ็นต์ สีเหลืองเมื่อถึง 70% ของจุด compaction สีแดงเมื่อถึง 90%
- ข้อควรรู้: คำนวณในเครื่อง ไม่เรียก API เพิ่ม อัปเดตหลังแต่ละเทิร์นของ agent หลักและหลัง compaction ไม่นับ schema ของเครื่องมือแบบ on-demand (เหมือน
/context) สั่ง/context-barเพื่อซ่อน/แสดงอ่านจาก repo (2026-10-19)
Review Watch
- ติดตาม: คำสั่ง
codex review,/codex:review,/codex:adversarial-reviewและ subagent ที่คำอธิบายมีคำว่า "review" - แต่ละบรรทัดแสดง: โมเดล, ชื่อ/เป้าหมายรีวิว, เวลาที่ผ่านไป และบรรทัดล่าสุดที่ Codex พิมพ์
- ตอนจบ: toast แจ้งเตือน นับข้อพบ
[P1]/[P2]เฉพาะเมื่อเอาต์พุตลงไฟล์หรือรันเบื้องหลัง ถ้าอ่านผลไม่ได้จะ ไม่แสดงจำนวน และไม่เดาว่า "ไม่พบอะไร" แสดงบรรทัด ✅ 30 วินาทีแล้วหายไป - ต้องมี:
psและtailอ่านจาก repo (2026-10-19)
Markdown Preview
- ทำอะไร: เมื่อ Claude แก้ไฟล์
.md,.mdx,.markdownจะมี toast และพรีวิวแบบ GitHub ส่วนที่เปลี่ยนมีแถบสีเขียว การเขียนผ่านคำสั่ง shell ก็ถูกจับโดยเทียบ Markdown ก่อนคำสั่งแรกกับตอนจบเทิร์น - คำสั่ง:
/md,/md <path>,/md compare <a> <b>,/md open, alias/mdview - ตัว render: ลำดับ (1)
gh api /markdownของ GitHub (2) renderer ในตัวถ้าghไม่พร้อม/ออฟไลน์ (3) มุมมองข้อความถ้าไม่มี Chrome หรือเทอร์มินัลที่แสดงภาพได้ - ข้อจำกัด: ต้องมี Chrome/Chromium และเทอร์มินัลแสดงภาพ (Ghostty, kitty, iTerm2, WezTerm) ใช้ผ่าน tmux ไม่ได้ สร้างและทดสอบบน macOS
- ความเป็นส่วนตัว: ถ้าใช้ renderer ของ GitHub ข้อความไฟล์จะถูกส่งไป API ของ GitHub ภายใต้การล็อกอิน
ghของคุณ ใน repo ที่มี GitHub remote เกิดขึ้นกับทุกไฟล์ Markdown ที่ถูกแก้ตอนจบเทิร์น แม้ไม่ได้สั่ง/mdอ่านจาก repo (2026-10-19)
Blast-radius Guard
คืออะไร: hook ที่ดักทุกการเรียกเครื่องมือ Bash หากเข้าข่ายเสี่ยงจะพักไว้ แสดงผลกระทบ แล้วรอคนตัดสิน
| ประเภท | ตรวจจับ | พรีวิวที่แสดง |
|---|---|---|
| ลบ | rm flag recursive (-r, -R, -rf, --recursive) ต้นคำสั่ง/หลัง sudo |
ไฟล์ (สูงสุด 5000) และขนาดรวม; ขยาย ~/$HOME; ตัวแปรอื่น "can't preview" |
| Force push | git push กับ -f, --force... หรือ refspec ขึ้นต้น + |
commit ที่จะถูกทิ้ง เทียบ HEAD..@{u} และ @{u}..HEAD ตาม fetch ล่าสุด |
| Migration | Prisma, Supabase, Drizzle, Knex, Sequelize, Rails, Alembic, TypeORM | ไฟล์ที่เกี่ยวกับ schema ที่ยังไม่ commit (ตัว migration เองพรีวิวไม่ได้) |
ลำดับการตัดสิน
คำสั่ง Bash เข้ามา
|
+-- ไม่เข้าข่ายเสี่ยง ------------> รันตามปกติ
|
+-- ไม่มีหน้าจอ (claude -p) ------> ปฏิเสธทันที
|
+-- เข้าข่ายเสี่ยง
-> คิว (พักได้ทีละคำสั่ง)
-> วัดผลกระทบ (เวลานี้ไม่นับใน timeout)
-> แสดง Cancel (c, โฟกัสเริ่มต้า) / Proceed (y) + นับถอยหลัง
|-- Proceed ---> รันคำสั่งตามที่เขียนไว้
|-- Cancel ----> ปฏิเสธ พร้อมบอกว่าคำสั่งจะทำอะไร
|-- หมดเวลา ---> ปฏิเสธ และบอก agent ว่าอย่าลองใหม่เอง
- คำสั่งผสม (
&&,||,;, ขึ้นบรรทัดใหม่) ถูกแยกตรวจทีละส่วน และcdใช้กำหนดโฟลเดอร์ที่วัด timeoutSecondsค่าเริ่มต้น 60 ตั้ง 0 เพื่อรอตลอด ค่าติดลบหรือไม่ใช่ตัวเลขกลับไปเป็น 60 เศษปัดขึ้น ตั้งที่/configหรือในsettings.jsonภายใต้pluginConfigs["blast-radius"].options- ถ้าวัดผลกระทบไม่สำเร็จ ยังพักคำสั่งไว้และแสดงสรุปแบบทั่วไป
- ใน auto mode ตัวอื่น (rulebook-guard, merge-gate) จะรอคำตอบ แต่ blast-radius ยกเลิกเมื่อหมดเวลา
อ่านจาก repo (2026-10-19)
Switchboard (ส่วนเสริมที่เกี่ยวกับต้นทุน)
เลือกโมเดลให้ subagent ที่ไม่ได้ระบุโมเดล และบันทึกต้นทุนต่อ subagent ผ่าน /route โหมดเริ่มต้นคือ off (ติดตามต้นทุนอย่างเดียว) ส่งไปยัง picker เฉพาะประเภท subagent และป้าย 3–5 คำ ไม่ส่งเนื้อหางาน ราคาเป็นการประมาณ ณ 2026-09-25 อ่านจาก repo (2026-10-19)
Mission Control
แผงสดแสดง subagent, tool call และไฟล์ที่แตะ เปิดด้วย /mission (w ดูตัว agent, c ดูแผนที่โค้ด, q ปิด) มุมมองโค้ดใช้ได้บน macOS เท่านั้น ไฟล์สีน้ำเงิน = กำลังอ่าน ส้ม = กำลังแก้ เขียวพร้อมเครื่องหมายถูก = แก้แล้ว หลังแต่ละเทิร์นมีการเรียก Haiku หนึ่งครั้งเพื่อสรุปการเปลี่ยนแปลง อ่านจาก repo (2026-10-19)
📦 ติดตั้งและตั้งค่า
| ขั้นตอน | คำสั่ง / การกระทำ |
|---|---|
| ติดตั้งแบบเลือก | npx claude-code-mods@latest ติ๊ก mod ที่ต้องการ กด Enter แล้วรีสตาร์ท |
| เฉพาะโปรเจกต์นี้ | เพิ่ม --project |
| ดูคำสั่งโดยไม่รัน | เพิ่ม --dry-run |
| ระบุ mod ตรง ๆ | --pick a,b |
| ใช้ profile อื่น | ตั้ง CLAUDE_CONFIG_DIR ก่อน |
| ติดตั้งมือ ขั้นแรก | claude plugin marketplace add hamzafer/claude-code-mods |
| ติดตั้งมือ ขั้นสอง | claude plugin install context-bar@claude-code-mods |
| ลองก่อนไม่ติดตั้ง | clone repo แล้ว claude --plugin-dir mods/context-bar |
| จัดลำดับ band | กด o ในรายการ เลื่อนด้วย Shift+ลูกศร หรือ K/J |
| ที่เก็บลำดับ band | บันทึกที่ <config dir>/claude-code-mods/bands.json |
| band ที่ไม่ถูกระบุ | อยู่บนสุด |
บาง mod ต้องมีของเพิ่ม เช่น Chrome, gh, Codex CLI, Node, macOS, Spotify หรือ OpenAI Admin key อ่านจาก repo (2026-10-19)
✍️ ลองใช้
ตัวอย่างประกอบ (ตัวเลขสมมติ คำนวณตามได้)
สมมติ context window 200,000 token และจุด auto-compaction อยู่ที่ 160,000 token (ค่าสมมติ ไม่ใช่ค่าจาก repo)
| เกณฑ์ | สูตร | token |
|---|---|---|
| เหลือง (70% ของจุด compaction) | 160,000 × 0.70 | 112,000 |
| แดง (90% ของจุด compaction) | 160,000 × 0.90 | 144,000 |
ถ้าแถบแสดง 120,000 token จะเป็นสีเหลือง (120,000 / 160,000 = 75%) ยังเหลืออีก 40,000 token ก่อน compaction ควรจบงานย่อยหรือเริ่ม session ใหม่ก่อนแตะ 144,000
ตัวอย่างคิวของ blast-radius: ถ้า agent ส่ง 3 คำสั่งเสี่ยงติดกัน และไม่มีใครอยู่ แต่ละคำสั่งได้นับถอยหลังเต็ม 60 วินาที รวมสูงสุดประมาณ 180 วินาทีก่อนทุกคำสั่งถูกปฏิเสธ (60 × 3) เพราะพักได้ทีละคำสั่งและคำสั่งอื่นต่อคิว
เมื่อไรควร / ไม่ควรใช้
| สถานการณ์ | ใช้หรือไม่ | เหตุผล / เงื่อนไขก่อน |
|---|---|---|
| Agent ทำงานยาวใน repo ที่มีข้อมูลสำคัญ | ใช้ blast-radius | มีจุดหยุดก่อนลบ/force push/migration |
| Session ยาวหลายชั่วโมง | ใช้ context-bar | เห็นจุดใกล้ compaction |
ใช้ claude -p หรือ SDK ที่ไม่มีหน้าจอ |
ระวัง | blast-radius ปฏิเสธคำสั่งเสี่ยงทันที ทำงานอัตโนมัติที่ต้องลบไฟล์จะติด |
| ทำงานผ่าน tmux | md-preview ใช้ไม่ได้ | ต้องการเทอร์มินัลแสดงภาพโดยตรง |
| Repo ลับ + md-preview | ไตร่ตรองก่อน | renderer ของ GitHub ส่งข้อความไฟล์ไป API |
| ไม่ใช่ macOS | ตรวจข้อกำหนดแต่ละ mod | หลาย mod สร้างและทดสอบบน macOS |
| ต้องการกันคำสั่งอันตรายทุกชนิด | ไม่พอ | ครอบคลุมเฉพาะรูปแบบที่ตรวจจับได้ (ดู Risks) |
ก้าวแรกที่เล็กที่สุด
- รัน
npx claude-code-mods@latest --dry-run --pick context-bar,blast-radiusเพื่อดูคำสั่งที่จะรันโดยยังไม่เปลี่ยนอะไร - ถ้าพอใจ รันโดยไม่มี
--dry-runแล้วรีสตาร์ท Claude Code
การทดสอบก่อน/หลัง
| รายการ | ค่า |
|---|---|
| ตัวชี้วัด | blast-radius: ให้ agent rm -rf โฟลเดอร์ทดสอบ แล้วดูว่าถูกพักพร้อมรายการไฟล์ |
| ค่าฐาน | ก่อนติดตั้ง คำสั่งรันทันที |
| เงื่อนไขผ่าน (กำหนดก่อนรัน) ข้อ 1 | มีแผงแสดงรายการไฟล์และนับถอยหลัง |
| เงื่อนไขผ่าน (กำหนดก่อนรัน) ข้อ 2 | กด c แล้วโฟลเดอร์ยังอยู่ |
| เงื่อนไขผ่าน (กำหนดก่อนรัน) ข้อ 3 | ปล่อยหมดเวลาแล้วโฟลเดอร์ยังอยู่ |
| ตัวชี้วัดที่สอง | context-bar: ค่า % บนแถบใกล้เคียง /context (ไม่ตรงเป๊ะ เพราะคำนวณในเครื่อง) |
ทดสอบเฉพาะโฟลเดอร์ทิ้งได้ ห้ามทดสอบกับข้อมูลจริง
⚠️ Risks
Warning ตัวกันครอบคลุมเฉพาะรูปแบบที่ตรวจจับได้
rmที่ไม่มี flag recursive, คำสั่งที่ซ่อนในสคริปต์หรือเครื่องมืออื่น (นอก Bash) และเครื่องมือ migration ที่ไม่อยู่ในรายการ จะไม่ถูกพัก อย่าถือว่าเป็นกำแพงความปลอดภัยครบวงจรตีความจากรายการ pattern ที่อ่านในโค้ด
| ความเสี่ยง / ความเข้าใจผิด | ความจริง |
|---|---|
| "หมดเวลา = อนุญาต" | หมดเวลา = ปฏิเสธ ไม่มีการรันเอง |
| "พรีวิวแสดงผลกระทบจริงทั้งหมด" | force push เทียบตาม fetch ล่าสุด ถ้ายังไม่ fetch ข้อมูลอาจเก่า |
| "พรีวิวแสดงผลกระทบจริงทั้งหมด" (ต่อ) | ตัวแปร shell อื่นนอกจาก ~/$HOME พรีวิวไม่ได้ |
| "ไม่เห็นจำนวนข้อพบ = ไม่มีข้อพบ" | review-watch ไม่แสดงจำนวนเมื่ออ่านผลไม่ได้ เพื่อไม่ให้เข้าใจผิดว่าไม่มี |
| "ทุก mod ปลอดภัยเท่ากัน" | mod ชุมชนไม่ได้ดูแลโดยโปรเจกต์ ต้องอ่านโค้ดก่อนติดตั้ง |
| "ข้อมูลอยู่ในเครื่องทั้งหมด" | md-preview (renderer GitHub) และ switchboard (picker) ส่งข้อมูลออกนอกเครื่อง |
| "ข้อมูลอยู่ในเครื่องทั้งหมด" (ต่อ) | mission-control (เรียก Haiku) ส่งข้อมูลออกนอกเครื่อง ทั้งหมดเฉพาะบางโหมด |
| ตัวเลข context เป็นค่าประมาณ | คำนวณในเครื่อง ไม่ใช่ค่าจริงจากเซิร์ฟเวอร์ |
ข้อมูลที่ยังไม่ทราบ: mod ส่วนใหญ่ใช้ hook event ใดบ้าง และตัวแปรตั้งค่าของ context-bar/review-watch เพราะเอกสารที่อ่านไม่ระบุ ส่วนการอ่านโค้ดทำเฉพาะ blast-radius ยังไม่ทดสอบ ว่า mod ที่เหลือทำงานตามเอกสารจริงหรือไม่ การอ่านครั้งนี้ไม่ได้รันหรือติดตั้งอะไรจาก repo เลย
✅ เช็กลิสต์ตัดสินใจ
| ข้อ | คำถาม | ถ้าใช่ |
|---|---|---|
| 1 | Claude Code เป็นรุ่น 2.1.287 ขึ้นไปหรือยัง | ผ่าน ไปข้อ 2 |
| 2 | Agent มีสิทธิ์ลบไฟล์/push/migrate ในงานของคุณหรือไม่ | ติดตั้ง blast-radius |
| 3 | Session ยาวเกินครึ่งชั่วโมงบ่อยหรือไม่ | ติดตั้ง context-bar |
| 4 | ใช้ Codex หรือ subagent รีวิวหรือไม่ | ติดตั้ง review-watch |
| 5 | เทอร์มินัลแสดงภาพได้และไม่ผ่าน tmux หรือไม่ | พิจารณา md-preview |
| 6 | ยอมรับการส่งข้อความ Markdown ไป GitHub API หรือไม่ | ถ้าไม่ ใช้เฉพาะ renderer ในตัว หรือไม่ติดตั้ง |
| 7 | มักรันแบบ headless หรือไม่ | ทดสอบพฤติกรรม "ปฏิเสธทันที" ก่อนใช้จริง |
| 8 | จะติดตั้ง mod ชุมชนหรือไม่ | อ่านโค้ดก่อนเสมอ |
🧪 ทดสอบความเข้าใจ
| คำถาม | คำตอบ | คำตอบที่มักผิด |
|---|---|---|
1. คุณออกไปกินข้าวระหว่างที่ blast-radius พัก rm -rf build/ ไว้ กลับมาพบอะไร |
คำสั่งถูกปฏิเสธเมื่อครบ 60 วินาที (ค่าเริ่มต้น) และ agent ถูกบอกไม่ให้ลองซ้ำเอง | "คำสั่งรันไปแล้วเพราะไม่มีใครคัดค้าน" |
2. ทำไมตั้ง timeoutSeconds เป็น 0 จึงเสี่ยงต่อ workflow อัตโนมัติ |
0 คือรอตลอด session ที่ไม่มีคนเฝ้าจะค้างไม่ถูกปฏิเสธเอง | "0 คือปิดตัวกัน" |
| 3. Context Bar แสดง 78% สีเหลือง แปลว่า context เหลือ 22% ใช่หรือไม่ | ไม่ใช่ % อิงจุด auto-compaction ไม่ใช่หน้าต่าง สีเหลืองเริ่ม 70% ของจุดนั้น | "เหลือ 22% ของหน้าต่างทั้งหมด" |
| 4. review-watch ไม่แสดงจำนวนข้อพบหลังรีวิวจบ หมายความว่ารีวิวสะอาดหรือไม่ | ไม่ได้ แปลว่าอ่านผลไม่ได้ (เช่น เอาต์พุตไม่ลงไฟล์) ต้องเปิดผลดูเอง | "ไม่มีข้อพบ" |
| 5. (กับดัก) ติดตั้ง blast-radius แล้ว agent ปลอดภัยจากการทำลายข้อมูลหรือไม่ | ไม่ ครอบคลุมเฉพาะ rm recursive, force push, migration บางตัว และเฉพาะ Bash | "ปลอดภัยครบแล้ว" |
| 6. ทำไมเอกสารแนะนำให้อ่านโค้ด mod ชุมชนก่อนติดตั้ง | โปรเจกต์ไม่ได้ดูแลหรือตรวจสอบ และ mod รันในเซสชันที่เข้าถึง repo ของคุณ | "เพราะมีบั๊กเยอะ" |
📚 Sources
| รายการ | ข้อมูล |
|---|---|
| Repo | hamzafer/claude-code-mods |
| ลิงก์ | https://github.com/hamzafer/claude-code-mods |
| Commit ที่อ่าน | 77f1ebc (2026-10-16, "community mods join the checklist (#126)") |
| วันที่อ่าน | 2026-10-19 |
| ไฟล์ที่อ่าน | README.md, docs/mods.md, mods/blast-radius/hooks/register.tsx |
| ไฟล์ที่อ่าน (ต่อ) | รายการไฟล์ทั้งหมดของ repo |
| ข้อจำกัดการอ่าน | อ่านผ่านการดึงหน้าเว็บและสรุป ไม่ได้ใช้ gh หรือ clone |
| ข้อจำกัดการอ่าน (ต่อ) | รายการไฟล์ถูกตัดท้ายส่วนหนึ่ง |
🔤 ตัวย่อที่ใช้ในหน้านี้
| ตัวย่อ | ชื่อเต็ม | คืออะไร | อ่านค่าอย่างไร |
|---|---|---|---|
| MIT | MIT License | สัญญาอนุญาตโอเพนซอร์สที่ให้ใช้ แก้ และแจกจ่ายได้ | ใช้ในโปรเจกต์ส่วนตัวหรือการค้าได้โดยเก็บประกาศลิขสิทธิ์ |
| MCP | Model Context Protocol | มาตรฐานให้ AI เรียกเครื่องมือภายนอก | "MCP tools" บนแถบ = ส่วนของ context ที่ถูกเครื่องมือเหล่านี้ใช้ |
| CLI | Command-Line Interface | โปรแกรมที่สั่งผ่านบรรทัดคำสั่ง | cli/ ใน repo คือตัวติดตั้งแบบโต้ตอบ |
| API | Application Programming Interface | ช่องทางให้โปรแกรมคุยกัน | "ไม่เรียก API เพิ่ม" = ไม่มีค่าใช้จ่ายโทเคนเพิ่ม |
| SDK | Software Development Kit | ชุดเครื่องมือสร้างแอปบนแพลตฟอร์ม | host ที่ไม่วาดหน้าจอ → blast-radius ปฏิเสธทันที |
| hook | Hook | จุดที่ปลั๊กอินเสียบเข้าไปในวงจรทำงานของ Claude Code | tool.call = ดักก่อนเรียกเครื่องมือ |
| band | Band | เส้นสถานะที่วาดเหนือช่องพิมพ์ | ลำดับเก็บใน bands.json |
| token | Token | หน่วยข้อความที่โมเดลนับ | 112,000 token = ใช้ context ไป 112,000 หน่วย |
| rm | remove | คำสั่งลบไฟล์ใน shell | rm -rf = ลบแบบ recursive และบังคับ |
-r / -R / -rf |
recursive / force flags | ตัวเลือกให้ลบลงไปในโฟลเดอร์ย่อย / ข้ามการถาม | -rf = ลบทั้งต้นไม้โดยไม่ถาม |
-f / --force |
force | ตัวเลือก push ทับ history ของ remote | commit ฝั่ง remote อาจหาย |
| HEAD | HEAD | commit ปัจจุบันของ branch ในเครื่อง | HEAD..@{u} = commit ที่ remote มีแต่เราไม่มี |
@{u} |
upstream | branch ปลายทางที่ branch ปัจจุบันติดตาม | @{u}..HEAD = commit ที่ push จะส่งออก |
| P1 / P2 | Priority 1 / 2 | ป้ายความสำคัญของข้อพบในผลรีวิว Codex | [P1] ×2 = มีข้อพบระดับสูง 2 ข้อ |
| tmux | Terminal multiplexer | โปรแกรมแบ่งหน้าต่างเทอร์มินัล | md-preview ใช้ผ่าน tmux ไม่ได้ |
gh |
GitHub CLI | เครื่องมือบรรทัดคำสั่งของ GitHub | md-preview ใช้เรียก render ของ GitHub |
ps / tail |
process status / tail | คำสั่ง Unix ดูโปรเซสและท้ายไฟล์ | review-watch ต้องการทั้งสอง |
npx |
Node package runner | รันแพ็กเกจ npm โดยไม่ติดตั้งถาวร | npx claude-code-mods@latest |
| Node | Node.js | รันไทม์ JavaScript | บาง mod ต้องใช้ |
| macOS | macOS | ระบบปฏิบัติการของ Apple | mission-control มุมมองโค้ดใช้ได้เฉพาะระบบนี้ |
| Codex | Codex | เครื่องมือเขียน/รีวิวโค้ดด้วย AI ของ OpenAI | review-watch ติดตามคำสั่ง codex review |
| Haiku | Claude Haiku | โมเดล Claude ขนาดเล็ก | mission-control เรียกหนึ่งครั้งต่อเทิร์นเพื่อสรุป |
| TSX | TypeScript XML | ไฟล์ TypeScript ที่มี JSX | register.tsx คือไฟล์ลงทะเบียน hook ของ mod |
| Prisma, Supabase, Drizzle, Knex, Sequelize, Rails, Alembic, TypeORM | ชื่อเครื่องมือ migration | เฟรมเวิร์กจัดการ schema ฐานข้อมูล | blast-radius พักคำสั่ง migration ของเครื่องมือเหล่านี้ |
| Ghostty, kitty, iTerm2, WezTerm | ชื่อเทอร์มินัล | เทอร์มินัลที่แสดงภาพได้ | md-preview ต้องใช้อย่างใดอย่างหนึ่ง |
CLAUDE_CONFIG_DIR |
ตัวแปรสภาพแวดล้อม | โฟลเดอร์ตั้งค่าของ Claude Code | ไม่ตั้ง = ใช้ ~/.claude |
| s (วินาที) | second | หน่วยเวลา | auto-cancels in 42 s = เหลือ 42 วินาที |
| % | เปอร์เซ็นต์ | สัดส่วนต่อ 100 | 75% ของ 160,000 = 120,000 |
แถวที่มาจากความรู้ทั่วไป ไม่ใช่นิยามใน repo: MIT, MCP, CLI, API, SDK, token, rm และ flag ต่าง ๆ, HEAD, @{u}, tmux, gh, ps/tail, npx, Node, macOS, Codex, Haiku, TSX, ชื่อเครื่องมือ migration และเทอร์มินัล, P1/P2 (repo ใช้ป้ายนี้แต่ไม่นิยามความหมาย)
สัญลักษณ์ในสูตร
| สัญลักษณ์ | ความหมาย | ตัวอย่างอ่านค่า |
|---|---|---|
| × | คูณ | 160,000 × 0.70 = 112,000 |
| / | หาร | 120,000 / 160,000 = 0.75 |
| n | จำนวนคำสั่งที่ต่อคิว | n = 3 → รอสูงสุด 60 × 3 = 180 วินาที |
📝 Summary
| หัวข้อ | สรุป |
|---|---|
| ความคิดหลัก | เห็นสถานะ + มีจุดหยุดก่อนทำสิ่งย้อนกลับไม่ได้ |
| เริ่มจากอะไร | blast-radius และ context-bar |
| กับดักใหญ่สุด | ตัวกันครอบคลุมเฉพาะ pattern ที่ตรวจได้ หมดเวลา = ปฏิเสธ |
| เรื่องความเป็นส่วนตัว | บาง mod ส่งข้อมูลออกนอกเครื่อง ตรวจก่อนเปิด |
| หลักฐานผลลัพธ์ | ยังไม่มีตัวเลขวัดผลใน repo ประโยชน์ทุกข้อเป็นการอนุมานจากกลไก ให้ทดสอบเองด้วยเช็กลิสต์ข้างต้น |
