แก้ปัญหารหัสข้อผิดพลาดของ Claude Code

สาเหตุที่พบบ่อย: ไดเรกทอรีที่ติดตั้งไม่ได้อยู่ใน PATH หรือ shell ปัจจุบันยังไม่ได้โหลดการตั้งค่าใหม่

วิธีแก้: เปิดเทอร์มินัลใหม่ หรือเพิ่มไดเรกทอรีที่ติดตั้ง Claude Code ลงใน PATH แล้วโหลดการตั้งค่า shell ใหม่

export PATH="$PATH:$HOME/.local/bin"
source ~/.zshrc

สาเหตุที่พบบ่อย: เวอร์ชัน Node ต่ำกว่าข้อกำหนดทางการ หรือ WSL เรียกใช้ Node ฝั่ง Windows

วิธีแก้: อัปเกรด Node หรือใช้ native installer อย่างเป็นทางการ บน WSL ให้ยืนยันด้วย which node / which npm ว่าพาธมาจากสภาพแวดล้อม Linux

node -v
which node
which npm

สาเหตุที่พบบ่อย: ไดเรกทอรี npm แบบ global เป็นของ root หรือการติดตั้งด้วย sudo ก่อนหน้านี้ทำให้สิทธิ์ผิดเพี้ยน

วิธีแก้: อย่าติดตั้ง Claude Code ด้วย sudo ให้เปลี่ยน prefix ของ npm ไปที่ไดเรกทอรีของผู้ใช้ หรือใช้ native installer

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

สาเหตุที่พบบ่อย: callback ของ OAuth จากเบราว์เซอร์ไปไม่ถึง CLI ในเครื่อง - พบบ่อยกับ remote SSH, devcontainer, ไฟร์วอลล์ที่เข้มงวด หรือเมื่อ callback ไปยัง localhost ถูกบล็อก

วิธีแก้: ตรวจว่าเบราว์เซอร์และ CLI สื่อสารกันได้บนเครื่องเดียวกัน หากจำเป็นให้ออกจากระบบ รีสตาร์ท Claude Code แล้วยืนยันตัวตนอีกครั้ง

/logout
# 关闭 Claude Code 后重新运行
claude

สาเหตุที่พบบ่อย: proxy หรือเกตเวย์ความปลอดภัยขององค์กรแทรก CA แบบ self-signed ที่ Node ไม่เชื่อถือโดยค่าเริ่มต้น

วิธีแก้: ขอ CA bundle ขององค์กรจากฝ่าย IT แล้วระบุผ่าน NODE_EXTRA_CA_CERTS

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

สาเหตุที่พบบ่อย: ตั้งค่าตัวแปร proxy ผิด ใช้โปรโตคอล proxy ที่ไม่รองรับ NO_PROXY ครอบโดเมนเป้าหมายไว้ หรือไฟร์วอลล์องค์กรบล็อกการเข้าถึง

วิธีแก้: Claude Code ใช้ตัวแปรสภาพแวดล้อม proxy มาตรฐานของ HTTP/HTTPS และเอกสารระบุว่าไม่รองรับ proxy แบบ SOCKS ให้ทดสอบซ้ำด้วย HTTPS_PROXY ก่อน

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

สาเหตุที่พบบ่อย: องค์กรยังไม่ได้เปิดใช้ Claude Code ขาออกปัจจุบันไม่อยู่ใน allowlist ขององค์กร ติดข้อจำกัดด้านบัญชี/ภูมิภาค/นโยบาย หรือ proxy ถูกปฏิเสธ

วิธีแก้: บัญชีส่วนบุคคลให้ตรวจภูมิภาคที่รองรับและสถานะบัญชีก่อน ส่วนบัญชีองค์กรให้ผู้ดูแลตรวจสิทธิ์ Claude Code, SSO, IP allowlist และกฎไฟร์วอลล์

สาเหตุที่พบบ่อย: ส่งคำขอถี่เกินไป ทำงานพร้อมกันมากเกินไป หรือแพ็กเกจของบัญชีหรือองค์กรถึงขีดจำกัดอัตราแล้ว

วิธีแก้: ลดการทำงานพร้อมกันจากภายนอก หยุดลูปการลองซ้ำ และรอให้ขีดจำกัดรีเซ็ต อย่าครอบ Claude Code ด้วย worker หลายตัวเพื่อเร่งความเร็ว

สาเหตุที่พบบ่อย: คีย์ API มาจาก shell อื่น คีย์ของ Console ขัดแย้งกับเซสชัน OAuth หรือองค์กรกำหนดให้เข้าสู่ระบบด้วย SSO

วิธีแก้: ตรวจว่ามีการตั้ง ANTHROPIC_API_KEY ใน shell ปัจจุบันหรือไม่ บัญชีองค์กรควรเข้าสู่ระบบผ่าน Console/SSO ตามที่ผู้ดูแลกำหนด

echo $ANTHROPIC_API_KEY