ตรวจสุขภาพ Coding Agent ด้วย doctor

25 สิงหาคม 2569 · อ่านประมาณ 3 นาที

เวลา Coding Agent ทำงานผิดปกติ ต้นเหตุอาจไม่ได้อยู่ที่ model หรือ prompt เสมอไปครับ ปัญหาอาจมาจาก installation, PATH, config, authentication, network, MCP หรือ state ที่เก็บไว้ในเครื่อง

Codex ใช้ codex doctor จาก shell ส่วน Claude Code ใช้ /doctor ภายใน session ทั้งสองคำสั่งช่วยรวบรวมสถานะของตัวเครื่องมือและ setup ที่เกี่ยวข้อง เพื่อให้เราเห็นจุดที่ควรตรวจต่อ

1. ตรวจสุขภาพ Codex

codex doctor จะตรวจ environment, config, network, desktop app, updates และ storage ที่เกี่ยวข้องกับ Codex พร้อมสรุปจำนวน ok, idle, note, warn และ fail เพื่อให้เห็นภาพรวมก่อนเปิดดูรายละเอียดของรายการที่มีปัญหา

วิธีรัน

เริ่มจากรายงานแบบย่อ:

codex doctor --summary

ถ้าต้องการดูรายละเอียดของแต่ละ check:

codex doctor

ถ้าต้องการผลลัพธ์ที่โปรแกรมหรือ Coding Agent อ่านต่อได้ ให้ใช้ --json คำสั่งนี้จะสร้าง machine-readable report และ redact ข้อมูลบางส่วนให้แล้ว:

codex doctor --json

วิธีอ่านผล

ผลของ codex doctor แบ่งเป็นหมวด เช่น Environment, Configuration, Desktop App, Updates และ Connectivity พร้อมสถานะของแต่ละ check

• ok คือ check นั้นผ่านตามเงื่อนไขที่ Codex รู้จัก
• idle คือ component ไม่ได้ทำงานในตอนตรวจ แต่ไม่จำเป็นต้องเป็นปัญหา
• note คือข้อมูลที่ควรรู้ เช่น sandbox หรือพื้นที่เก็บ rollout
• warn คือความไม่สอดคล้องที่ควรตรวจต่อ
• fail คือ check ที่ไม่ผ่าน

ตัวอย่างจากเครื่องผม

ผมนำ report นี้ไปคุยกับ Codex ต่อ แล้วตัดสินใจว่ายังไม่แก้อะไรครับ

2. ตรวจสุขภาพ Claude Code

/doctor เป็น slash command ที่รันภายใน Claude Code session ใช้ตรวจ setup ที่อาจมีปัญหา เช่น installation ซ้ำ, PATH หรือ settings ผิด รวมถึง skills, MCP, plugins, hooks และ CLAUDE.md

นอกจากปัญหา /doctor ยังชี้รายการที่ควรจัดระเบียบ เช่น skills ที่ไม่ได้ใช้แต่กิน context หรือ hooks ที่ทำงานช้า หลังตรวจเสร็จจะแสดงสิ่งที่พบและคำสั่งให้เลือกว่าจะจัดการอย่างไร เราเป็นคนตัดสินใจก่อน Claude Code เปลี่ยนอะไร

วิธีรัน

เปิด Claude Code:

claude

จากนั้นพิมพ์:

/doctor

ตัวอย่างจากเครื่องผม

ผมรัน /doctor ใน Claude Code session จริง ผลตรวจ installation, version, config และ hooks ปกติ สิ่งที่พบคือ skill listing ของเครื่องนี้ใช้ context มากจนคำอธิบายบางส่วนถูกตัด:

• มี skills 57 ตัว ใช้ประมาณ 7.3k tokens ต่อ session
• คำอธิบายของ skills ประมาณ 20 ตัวถูกตัดออกจาก listing
• /doctor เสนอให้ปิด skills ที่ไม่เคยใช้ 16 ตัว เพื่อคืนประมาณ 2.2k tokens ต่อ session

หลังตรวจเสร็จ /doctor แสดงตัวเลือกให้ตัดสินใจก่อนเปลี่ยนอะไร:

ผมเลือกตรวจและลบ skills ที่ไม่ได้ใช้ทีละตัวครับ

สรุปและข้อสังเกต

ผลของ doctor ไม่จำเป็นต้องลงท้ายด้วยการแก้ไขทุกครั้งครับ เคส Codex ผมเลือกยังไม่ทำอะไร ส่วน Claude Code ผมเลือกตรวจและลบ skills ที่ไม่ได้ใช้ทีละตัว

รายงานช่วยให้เห็นสถานะและรายการที่ควรพิจารณา ส่วนเรายังเป็นคนตัดสินใจว่าจะปล่อยไว้ ตรวจเพิ่ม หรือแก้รายการไหน

อ้างอิง

• OpenAI: Codex changelog
• Anthropic: Claude Code commands