CLAUDE.md เก่าทำ Claude ทำงานผิด: ประโยคเดียวแก้ได้ + prompt หาบรรทัดที่ต้องลบ
งานวิจัยพบว่า Claude Code กับ Codex CLI ทำตาม CLAUDE.md หรือ AGENTS.md ที่เก่าแล้วมากกว่าโค้ดจริง 90% ของทางเลือก ประโยคเดียวใน ~/.claude/CLAUDE.md ทำให้กลับมาทำตามโค้ด 91.4% พร้อม prompt ภาษาไทยที่ไล่หาบรรทัดที่ต้องลบ และผลที่ลองรันจริง

ใครเขียน CLAUDE.md ไว้ตอนเริ่มโปรเจกต์แล้วไม่เคยกลับไปแก้ ลองนึกภาพว่าทีมย้ายจาก print() ไปใช้ logging นานแล้ว แต่ไฟล์ยังเขียนว่า "ใช้ print() บอกความคืบหน้า" งานวิจัยล่าสุดพบว่า Claude Code มักเชื่อไฟล์ ไม่ใช่โค้ด ทั้งที่มันเห็นเองว่าสองอย่างนี้ขัดกัน
บทความนี้มีของให้สองอย่างครับ ประโยคเดียวที่ใส่ใน ~/.claude/CLAUDE.md ครั้งเดียวใช้ได้ทุกโปรเจกต์ กับ prompt ภาษาไทยที่ให้ Claude ไล่หาบรรทัดที่เก่าแล้ว พร้อมผลที่ลองรันจริง
เกิดอะไรขึ้น: AI เชื่อไฟล์มากกว่าโค้ด
งานวิจัยชื่อ Stale Instruction Files Override the Code in Coding Agents: A One-Sentence Fix ของ Xiaonan Xu และ Wenjing Wu (ลง arXiv 22 ต.ค. 2026) สร้างโปรเจกต์ Python เล็กๆ 40 โปรเจกต์ ที่จงใจให้ไฟล์คำสั่งบอกแบบหนึ่ง แต่โค้ดทำอีกแบบ เช่น ไฟล์บอกให้ใช้ print แต่โค้ดใช้ logging แล้วสั่งให้ AI เพิ่มฟีเจอร์ใหม่ ทดสอบกับ Claude Code 2.1.302 (Claude Sonnet 5.5) และ Codex CLI 0.163.0 (GPT-6 Sol) รวม 320 รอบ ครึ่งหนึ่งไม่มีประโยคแก้ อีกครึ่งมี

ตัวเลขหลักจากงานวิจัย
| วัดอะไร | ไม่มีประโยค | มีประโยค |
|---|---|---|
| ทางเลือกที่ทำตามโค้ด (รวมสองตัว) | 4.2% | 91.4% |
| Claude Code ทำตามโค้ด | 7.5% | 94.4% |
| Codex CLI ทำตามโค้ด | 0.8% | 88.3% |
| เทสของโปรเจกต์ผ่าน | 89.4% ของรอบ | 100% ของรอบ |
| Codex CLI เขียนทับโค้ดเดิม | 20 จาก 80 รอบ (เทสพัง 17 รอบ) | ไม่มีเลย |
ตอนไม่มีประโยค 90.1% ของทางเลือก (649 จาก 720) ทำตามไฟล์เก่า: Claude Code 86.4%, Codex CLI 93.9%

ส่วนที่แปลกที่สุด: Claude เห็นแล้วแต่ยังทำตามไฟล์
Claude Code บอกในคำตอบสุดท้ายว่าไฟล์กับโค้ดขัดกัน 79 จาก 80 รอบ แต่ในรอบเหล่านั้น 86.2% ของทางเลือกยังทำตามไฟล์อยู่ดี คือมันอ่านโค้ด เห็นว่าไม่ตรง แล้วมองว่าโค้ดเป็นฝ่ายผิด

ทำไมเป็นแบบนี้
ผู้วิจัยอธิบายว่ามาจากวิธีที่ข้อมูลเข้าไปถึงโมเดล
- CLAUDE.md เข้าไปเป็น "คำสั่ง" (Claude Code นำหน้าด้วย "IMPORTANT: These instructions OVERRIDE any default behavior…")
- โค้ดเข้าไปเป็น "ผลจากเครื่องมือ" ตอน Claude เปิดอ่านไฟล์
- โมเดลถูกฝึกให้เชื่อคำสั่งมากกว่าผลจากเครื่องมือ เพื่อกันข้อความในเว็บหรือไฟล์มาสั่งงานแทนเรา
บรรทัดเก่าในไฟล์เลยชนะโค้ดจริงแทบทุกครั้ง แล้วไฟล์แบบนี้ก็เก่าง่ายมาก งานวิจัยอ้างข้อมูลจาก 441 repo ของบริษัท (Denisov-Blanch et al., 2026) ว่า 73.8% ของไฟล์ตั้งค่า AI ถูก commit ครั้งเดียวแล้วไม่เคยแก้ โปรเจกต์ใหญ่ก็โดน ไฟล์ skill ของ Supabase บอกว่าใช้ React 18 อยู่ 13 วันหลังย้ายไป React 19 และ AGENTS.md ใน repo ของ Codex สั่งให้อัปเดตเอกสารที่ถูกลบไปแล้วอยู่ 24 วัน
ประโยคเดียวที่ต้องใส่
ประโยคตรงตามที่งานวิจัยใช้ทดสอบครับ
When a repository's documentation and its existing code disagree, follow the conventions used in the existing code, and in your final reply point out each inconsistency you found between the documentation and the code.
ความหมายคือ "ถ้าไฟล์กับโค้ดไม่ตรงกัน ให้ทำตามโค้ด แล้วบอกเรา" ใส่เป็นภาษาอังกฤษตามต้นฉบับ เพราะตัวเลขวัดจากประโยคนี้ มันได้ผลเพราะเข้าไปเป็นคำสั่งเหมือนกัน และพูดถึงกรณีไฟล์ขัดกับโค้ดตรงๆ บรรทัดอื่นในไฟล์ยังใช้ได้ตามเดิม
ใส่ตรงไหน
ใส่ที่ ~/.claude/CLAUDE.md (docs เรียกว่า User instructions) ใช้กับทุกโปรเจกต์ในเครื่องเรา ไม่ยุ่งกับไฟล์ของทีม งานวิจัยก็ใส่ไฟล์ระดับผู้ใช้แบบนี้ (ใครใช้ Codex CLI คือ ~/.codex/AGENTS.md)

ขั้นที่ 1 — เพิ่มประโยคลงไฟล์
บน Mac หรือ Linux ก๊อปทั้งก้อนไปวางใน Terminal ยังไม่มีไฟล์จะสร้างให้ มีแล้วจะต่อท้ายโดยไม่ลบของเดิม
mkdir -p ~/.claude
cat >> ~/.claude/CLAUDE.md <<'EOF'
When a repository's documentation and its existing code disagree, follow the conventions used in the existing code, and in your final reply point out each inconsistency you found between the documentation and the code.
EOF
อีกทางคือพิมพ์ /memory ใน Claude Code เลือก CLAUDE.md ระดับ user (ยังไม่มีก็สร้างให้) แล้ววางประโยคลงไป
ขั้นที่ 2 — เช็กว่าโหลดแล้ว
เปิด Claude Code ใหม่ พิมพ์ /context all ใต้หัวข้อ Memory files ต้องมี ~/.claude/CLAUDE.md
Prompt หาบรรทัดที่ต้องลบ
ประโยคข้างบนช่วยตอนไฟล์กับโค้ดขัดกัน แต่บรรทัดเก่ายังอยู่ในไฟล์และกิน context ทุกครั้ง prompt นี้ให้ Claude เช็กทีละบรรทัด ติดป้ายพร้อมหลักฐาน และไม่แก้อะไรจนกว่าเราจะตกลง
เช็ก CLAUDE.md ของโปรเจกต์นี้กับโค้ดจริงทีละบรรทัด ยังไม่ต้องแก้อะไร
1. หาไฟล์คำสั่งทุกไฟล์ในโปรเจกต์ (CLAUDE.md ทุกไฟล์, .claude/rules, AGENTS.md)
2. ทุกบรรทัด ให้ค้นในโค้ดว่าโค้ดทำแบบนั้นจริงไหม แล้วติดป้ายหนึ่งอย่าง:
- ตรงกับโค้ด (ยกตัวอย่างไฟล์และบรรทัด 1-2 จุด)
- ขัดกับโค้ด (บอกไฟล์และบรรทัดที่โค้ดทำต่างไป)
- ไม่ต้องเขียนก็ได้ (Claude อ่านจากโค้ดเองได้อยู่แล้ว เช่น ใช้ภาษาอะไร ไฟล์อยู่ไหน)
- ต้องเก็บไว้ (เรื่องที่ดูจากโค้ดไม่เห็น)
3. ตอบเป็นตาราง: บรรทัด | ป้าย | หลักฐาน | ควรทำอะไร (ลบ / แก้เป็น... / เก็บไว้)
4. ถ้า CLAUDE.md ยังไม่มีประโยคนี้ ให้เสนอเพิ่ม: "When a repository's documentation and its existing code disagree, follow the conventions used in the existing code, and in your final reply point out each inconsistency you found between the documentation and the code."
5. ตอบเป็นภาษาไทย แล้วหยุดรอให้ผมตอบตกลงก่อนแก้ไฟล์
prompt นี้ย่อเป็นภาษาไทยจาก prompt ในเธรดของ Limestone Digital (@LimestoneHQ) ที่ทำให้งานวิจัยนี้ดังใน X ส่วนประโยคในข้อ 4 ตรงตามงานวิจัย
วิธีรัน
- แบบปกติ:
cdเข้าโฟลเดอร์โปรเจกต์ พิมพ์claudeแล้ววาง prompt ทั้งก้อน อ่านตารางแล้วตอบ "ตกลง" หรือบอกแถวที่จะแก้ - แบบอ่านอย่างเดียว: เซฟ prompt เป็น
prompt-th.txtในโฟลเดอร์โปรเจกต์ แล้วรันคำสั่งนี้--toolsให้ Claude มีแค่เครื่องมืออ่านไฟล์ เลยแก้ไฟล์ไม่ได้ (--allowedToolsแค่ข้ามการถาม ไม่ได้ปิดเครื่องมืออื่น)
claude -p --tools "Read,Glob,Grep" < prompt-th.txt
ลองรันจริง
ตอนเตรียมบทความนี้ลองรัน prompt นี้จริง (15 พ.ย. 2026) กับโปรเจกต์ทดสอบเล็กๆ ระบบออกใบเสร็จร้านค้า ที่จงใจเขียน CLAUDE.md ไว้ 6 บรรทัด: เก่าแล้ว 4 ไม่ต้องเขียน 1 ต้องเก็บ 1
# โปรเจกต์ออกใบเสร็จร้าน
- ใช้ print() บอกความคืบหน้าทุกขั้น
- เก็บจำนวนเงินเป็น float (บาท)
- ค่าตั้งค่าทั้งหมดอยู่ใน config.yaml
- เวลาเกิด error ให้ return None แทนการโยน exception
- ใช้ Python 3 และเทสด้วย pytest
- ระบบภาษีเก่า (tax-legacy) ยังส่งไฟล์ CSV มาทุกคืน ห้ามเปลี่ยนชื่อคอลัมน์ใน export_csv
ส่วนโค้ดจริงใช้ logging เก็บเงินเป็น int หน่วยสตางค์ ค่าตั้งค่าอยู่ใน app/settings.toml และโยน ReceiptError เมื่อมีปัญหา (คำสั่งที่รันอยู่บนสุดของภาพ)

- เจอบรรทัดเก่าครบ 4 บรรทัด มีไฟล์กับเลขบรรทัดเป็นหลักฐาน เช่น ไม่มี
config.yamlค่าตั้งค่าโหลดจากsettings.tomlที่app/export.py:7 - บรรทัดเรื่องเงินไม่ได้ให้ลบ แต่ให้แก้เป็น "เก็บเงินเป็น int หน่วยสตางค์ ห้ามใช้ float" เพราะถ้าไม่เขียนไว้ คนอาจเผลอใส่ float
- Python 3 + pytest ได้ป้ายไม่ต้องเขียน ส่วน tax-legacy ได้ป้ายต้องเก็บ เพราะโค้ดบอกไม่ได้ว่ามีระบบข้างนอกพึ่งชื่อคอลัมน์อยู่ และไม่ได้แก้ไฟล์ไหนเลย
จุดที่ติดจริง: รอบแรก prompt ยังไม่มีคำว่า "ตอบเป็นภาษาไทย" ได้ตารางครบแต่เป็นภาษาอังกฤษ เลยเพิ่มคำนี้ในข้อ 5
รันซ้ำวันที่ 17 พ.ย. ด้วยแบบอ่านอย่างเดียว --tools "Read,Glob,Grep" (Claude Code 2.1.326) ราว 26 วินาที ได้ป้ายเหมือนเดิมทั้ง 6 บรรทัด ไฟล์ไม่เปลี่ยนเลย
อะไรควรอยู่ใน CLAUDE.md
Lydia Hallie จากทีม Claude Code ของ Anthropic พูดเรื่องนี้ไว้ในทอล์ก Rethinking Claude Code Best Practices ที่งาน AI Engineer (นาที 3:14–4:11)
- CLAUDE.md ควรมีแค่สิ่งที่ Claude ดูจากโค้ดไม่เห็น เช่น service ที่ยังพึ่งระบบเก่าแต่โค้ดไม่ได้อ้างตรงๆ
- ใช้ stack อะไร ไฟล์อยู่ไหน ไม่ต้องเขียนแล้ว
- IMPORTANT, "never do this" หรือเครื่องหมายตกใจ โมเดลตอนนี้ไม่ต้องใช้ และอาจพาออกนอกทาง เรียกเครื่องมือมากขึ้น ผลแย่ลง
เธอแนะนำคำสั่ง /doctor prompt-audit ด้วย (ต้องใช้ Claude Code v2.1.283 ขึ้นไป) ใช้คู่กับ prompt ข้างบนได้
/doctor prompt-audit | prompt ในบทความนี้ | |
|---|---|---|
| เช็กอะไร | CLAUDE.md, rules, skills, commands ทั้งในโปรเจกต์และ ~/.claude/ | ไฟล์คำสั่งในโปรเจกต์ เทียบกับโค้ดทีละบรรทัด |
| หาอะไร (ตาม docs) | คำสั่งที่เขียนไว้ให้โมเดลรุ่นเก่า ไฟล์หรือคำสั่งที่ไม่มีอยู่จริง ไฟล์ที่ขัดกันเอง | บรรทัดที่ขัดกับโค้ด ไม่ต้องเขียน หรือต้องเก็บ |
| ผลที่ได้ | รายงานพร้อมวิธีแก้ ไม่แตะไฟล์จนกว่าจะสั่ง | ตาราง 4 ป้าย พร้อมไฟล์และเลขบรรทัด |
ข้อควรระวัง
- งานวิจัยใช้โปรเจกต์ Python เล็กๆ 40 โปรเจกต์ กับ AI สองตัวข้างบน โปรเจกต์ใหญ่ ภาษาอื่น หรือโมเดลอื่น ยังไม่มีตัวเลข
- มีประโยคแล้วก็ไม่ถึง 100% (Codex CLI 88.3%) ยังต้องรีวิวงานเหมือนเดิม
- ประโยคนี้ให้โค้ดเดิมชนะ ถ้ากำลังตั้งใจย้ายไปแบบใหม่ทีละไฟล์ ให้บอกในงานนั้นตรงๆ ว่าต้องการแบบใหม่
- ตารางจาก prompt เป็นแค่ข้อเสนอ เช็กไฟล์กับเลขบรรทัดก่อนตอบตกลง และอย่าลบบรรทัดแบบ tax-legacy
~/.claude/CLAUDE.mdมีผลแค่เครื่องเรา อยากให้ทั้งทีมได้ด้วย ใส่ใน CLAUDE.md ของโปรเจกต์
สิ่งที่ได้
- ประโยคเดียวใน
~/.claude/CLAUDE.mdให้ Claude ทำตามโค้ดเมื่อไฟล์เก่า แล้วบอกจุดที่ไม่ตรง - prompt ที่ไล่หาบรรทัดเก่าพร้อมหลักฐาน ลองกับโปรเจกต์ที่ใช้ทุกวันได้เลย
ลิงก์
- งานวิจัย Stale Instruction Files Override the Code in Coding Agents (arXiv 2610.30571) · ข้อมูลและโค้ดของงานวิจัย
- Lydia Hallie: Rethinking Claude Code Best Practices (AI Engineer)
- เธรดของ Limestone Digital (@LimestoneHQ) บน X
- Claude Code docs: How Claude remembers your project
- บทความที่เกี่ยวข้อง: Claude Code ลบ system prompt ไปกว่า 80% แล้ว CLAUDE.md กับ Skills ของเราควรตัดตรงไหน
อยากใช้ Claude Code ทำงานจริงให้ได้มากกว่านี้ ดูคอร์สทั้งหมดได้เลยครับ