การแก้ไขปัญหา

แก้ไขการใช้ CPU หรือ memory สูง, การค้าง, auto-compact thrashing, และปัญหาการค้นหาใน Claude Code

หน้านี้ครอบคลุมปัญหาด้าน performance, ความเสถียร, และการค้นหาเมื่อ Claude Code กำลังทำงานอยู่

อาการ	ไปที่
command not found, การติดตั้งล้มเหลว, ปัญหา PATH	แก้ไขปัญหาการติดตั้งและการล็อกอิน
Loop การล็อกอิน, OAuth errors, 403 Forbidden	แก้ไขปัญหาการติดตั้งและการล็อกอิน
Settings ไม่ถูกนำไปใช้, hooks ไม่ทำงาน, MCP servers ไม่โหลด	Debug การตั้งค่า
API Error: 5xx, 529 Overloaded, 429	Error reference
VS Code extension ไม่เชื่อมต่อ	VS Code integration

หากคุณไม่แน่ใจว่าอะไรใช้ได้ รัน /doctor ภายใน Claude Code สำหรับการตรวจสอบอัตโนมัติ

ประสิทธิภาพและความเสถียร

การใช้ CPU หรือ Memory สูง

Claude Code ออกแบบมาให้ทำงานกับ development environments ส่วนใหญ่ แต่อาจใช้ทรัพยากรสำคัญเมื่อประมวลผล codebase ขนาดใหญ่:

1. ใช้ /compact เป็นประจำเพื่อลดขนาด context
2. ปิดและรีสตาร์ท Claude Code ระหว่างงานสำคัญ
3. พิจารณาเพิ่ม large build directories ใน .gitignore
4. รีสตาร์ทด้วย claude --safe-mode เพื่อตรวจสอบว่า plugin, MCP server, หรือ hook เป็นสาเหตุหรือไม่

หาก memory usage ยังคงสูงหลังจากขั้นตอนเหล่านี้ รัน /heapdump เพื่อเขียน JavaScript heap snapshot และ memory breakdown ไปยัง ~/Desktop

Auto-Compaction หยุดพร้อมข้อผิดพลาด Thrashing

หากคุณเห็น Autocompact is thrashing: the context refilled to the limit... ให้ทำ:

1. ขอให้ Claude อ่านไฟล์ขนาดใหญ่เป็น chunk เล็กๆ แทนที่จะเป็นทั้งไฟล์
2. รัน /compact พร้อม focus เช่น /compact keep only the plan and the diff
3. ย้ายงานไฟล์ขนาดใหญ่ไปยัง subagent เพื่อให้รันใน context window แยก
4. รัน /clear หากการสนทนาก่อนหน้าไม่จำเป็นอีกต่อไป

คำสั่งค้างหรือหยุดนิ่ง

หาก Claude Code ดูเหมือนไม่ตอบสนอง:

1. กด Ctrl+C เพื่อพยายามยกเลิกการดำเนินการปัจจุบัน
2. หากไม่ตอบสนอง คุณอาจต้องปิด terminal และรีสตาร์ท

การรีสตาร์ทไม่ทำให้การสนทนาของคุณหายไป รัน claude --resume ในไดเรกทอรีเดียวกันเพื่อดำเนินการ session ต่อ

ข้อความเสียหายหรือแปลกใน Terminal แบบบูรณาการของ Editor

หากตัวอักษรแสดงเป็นกล่องหรือ glyphs ผิดเมื่อรัน Claude Code ใน terminal แบบบูรณาการของ VS Code, Cursor, หรือ Devin Desktop รัน /terminal-setup ภายใน Claude Code เพื่อตั้ง terminal.integrated.gpuAcceleration เป็น "off"

ปัญหาการค้นหาและการค้นพบ

หาก Search tool, @file mentions, custom agents, หรือ custom skills ไม่ค้นหาไฟล์ binary ripgrep ที่รวมไว้อาจไม่รันบนระบบของคุณ ติดตั้ง ripgrep สำหรับ platform ของคุณ:

macOS:

brew install ripgrep

Ubuntu/Debian:

sudo apt install ripgrep

Alpine:

apk add ripgrep

Windows:

winget install BurntSushi.ripgrep.MSVC

จากนั้นตั้ง USE_BUILTIN_RIPGREP=0 ใน environment ของคุณ

ผลการค้นหาช้าหรือไม่ครบถ้วนบน WSL

ความล่าช้าด้าน disk read เมื่อทำงานข้ามระบบไฟล์บน WSL อาจส่งผลให้มีการจับคู่น้อยกว่าที่คาดเมื่อใช้ Claude Code บน WSL

note

/doctor จะแสดง Search เป็น OK ในกรณีนี้

วิธีแก้ไข:

1. ส่งการค้นหาที่เฉพาะเจาะจงมากขึ้น: ระบุไดเรกทอรีหรือประเภทไฟล์
2. ย้ายโปรเจกต์ไปยัง Linux filesystem: ตรวจสอบว่าโปรเจกต์ของคุณอยู่บน Linux filesystem (/home/) แทนที่จะเป็น Windows filesystem (/mnt/c/)
3. ใช้ Windows native แทน: พิจารณาการรัน Claude Code บน Windows โดยตรงแทน WSL

รับความช่วยเหลือเพิ่มเติม

หากคุณประสบปัญหาที่ไม่ครอบคลุมที่นี่:

1. รัน /doctor เพื่อตรวจสอบสุขภาพการติดตั้ง, ความถูกต้องของ settings, การตั้งค่า MCP, และการใช้ context ในครั้งเดียว
2. ใช้คำสั่ง /feedback ภายใน Claude Code เพื่อรายงานปัญหาโดยตรงกับ Anthropic
3. ตรวจสอบ GitHub repository สำหรับปัญหาที่รู้จัก
4. ถาม Claude โดยตรงเกี่ยวกับความสามารถและฟีเจอร์ต่างๆ