Claude Code ใช้คำสั่งไม่ได้ ต้องตรวจการติดตั้งอย่างไร

ถ้าพิมพ์ claude แล้วระบบแจ้งว่าไม่รู้จักคำสั่ง หรือ Claude Code เปิดไม่ได้ ให้ตรวจว่าติดตั้งในช่องทางใด เปิด Terminal หรือ PowerShell ใหม่หลังติดตั้งแล้วหรือยัง และตำแหน่งคำสั่งอยู่ใน PATH หรือไม่

บทความนี้แนะนำวิธีตรวจการติดตั้งบน macOS, Windows, Linux และ WSL รวมถึงวิธีแยกปัญหาเวอร์ชัน Node.js กับสิทธิ์ของ npm

❶ ตรวจว่ากำลังใช้ Claude Code แบบใด

หากใช้ Claude Code ใน Claude Desktop ไม่ต้องติดตั้งคำสั่ง Terminal เพิ่ม ให้ลงชื่อเข้าใช้แอปด้วยบัญชีที่มีสิทธิ์ใช้ Claude Code แล้วเปิดแท็บ Code

หากต้องการใช้จาก Terminal หรือ PowerShell ให้ตรวจว่าติดตั้ง Claude Code สำหรับระบบปฏิบัติการและช่องทางที่ใช้อยู่แล้ว

❷ ตรวจว่าติดตั้งสำเร็จหรือไม่

เปิด Terminal หรือ PowerShell ใหม่ แล้วลองตรวจเวอร์ชันด้วยคำสั่ง:

claude --version

หากเห็นเลขเวอร์ชัน แสดงว่าระบบเรียกคำสั่งได้แล้ว หากยังขึ้น command not found หรือข้อความว่าไม่รู้จักคำสั่ง ให้ไปตรวจ PATH ในข้อถัดไป

❸ แก้ปัญหา claude: command not found

หลังติดตั้ง Shell เดิมอาจยังไม่รู้จักคำสั่งใหม่ ให้ปิดแล้วเปิด Terminal หรือ PowerShell ใหม่ หากยังไม่พบคำสั่ง ให้โหลดการตั้งค่า Shell ใหม่บน macOS หรือ Linux:

source ~/.zshrc

หรือถ้าใช้ Bash:

source ~/.bashrc

ตัวติดตั้งแบบ Native อาจวางคำสั่งไว้ใน ~/.local/bin/claude บน macOS หรือ Linux และ %USERPROFILE%\.local\bin บน Windows ตรวจว่าโฟลเดอร์ที่เก็บคำสั่งถูกรวมอยู่ใน PATH ของระบบแล้ว

❹ ตรวจช่องทางติดตั้งให้ตรงกับระบบ

คู่มือ Claude Code แนะนำช่องทางติดตั้งเหล่านี้:

macOS, Linux หรือ WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Homebrew

brew install --cask claude-code

npm

npm install -g @anthropic-ai/claude-code

หากติดตั้งผ่าน npm ไม่ควรใช้ sudo เพราะอาจทำให้สิทธิ์ไฟล์ติดตั้งผิดพลาด

❺ ตรวจ Node.js และข้อผิดพลาดสิทธิ์ npm

ถ้าเห็นข้อความว่า Node version ไม่รองรับ หรือ Claude Code ปิดตัวเอง ให้ตรวจเวอร์ชันด้วย:

node -v

การติดตั้งผ่าน npm ต้องใช้ Node.js 18 ขึ้นไป หากเวอร์ชันเก่ากว่านี้ ให้อัปเดต Node.js หรือพิจารณาใช้ Native installer ซึ่งมี Runtime ของตัวเอง

หาก npm แจ้ง EACCES หรือ permission denied ให้หลีกเลี่ยงการติดตั้งด้วยสิทธิ์ผู้ดูแลระบบแบบ sudo ตรวจค่า npm prefix และ PATH หรือเปลี่ยนไปใช้ Native installer

❻ ตรวจปัญหาเฉพาะ WSL และเครือข่ายองค์กร

บน WSL อาจมี PATH ของ Windows แทรกเข้ามา ทำให้คำสั่งเรียก Node.js ฝั่ง Windows แทนเวอร์ชัน Linux ให้ตรวจผลของ which node และ node -v ใน WSL ว่าเป็นเวอร์ชันที่ต้องการ

หากตัวติดตั้งค้างหรือดาวน์โหลดไม่ได้บนเครือข่ายบริษัท Proxy หรือ Firewall อาจบล็อกโฮสต์ดาวน์โหลด ให้ตรวจนโยบายเครือข่ายกับฝ่าย IT ก่อนปรับค่า Proxy หรือใบรับรองขององค์กร

❼ ตรวจการลงชื่อเข้าใช้หลังติดตั้ง

เมื่อติดตั้งได้แล้ว ให้เปิด Claude Code ด้วย:

claude

จากนั้นทำตามหน้าจอเพื่อลงชื่อเข้าใช้ หากพิมพ์ /login แล้ว Terminal ค้างที่ “Waiting for authentication…” อาจมีปัญหาการส่งผลกลับจากเบราว์เซอร์ไปยัง Terminal โดยเฉพาะเมื่อใช้ SSH, Dev Container หรือ Firewall เข้มงวด ให้ใช้วิธีล็อกอินแบบ Manual ที่ Claude แสดงใน Terminal

หากองค์กรใช้ Console API key, Amazon Bedrock หรือ Google Vertex AI วิธีตั้งค่าการยืนยันตัวตนจะแตกต่างกัน ให้ตรวจว่าตัวแปรและข้อมูลบัญชีถูกตั้งไว้ใน Shell เดียวกับที่เปิด Claude Code

❽ เรียกใช้คำสั่งตรวจวินิจฉัย

หากติดตั้งและลงชื่อเข้าใช้แล้ว แต่คำสั่งยังทำงานผิดปกติ ให้รันคำสั่งนี้จาก Shell ปกติ ไม่ใช่ภายในเซสชัน Claude Code:

claude doctor

คำสั่งจะแสดงรายงานวินิจฉัยที่ช่วยตรวจปัญหาการติดตั้ง หากต้องส่งรายงานให้ฝ่ายช่วยเหลือ ให้ตรวจและลบข้อมูลลับ เช่น API key หรือข้อมูลส่วนบุคคลก่อน

ComSiam แนะนำให้จดระบบปฏิบัติการ ช่องทางติดตั้ง ข้อความ Error และผล claude --version ไว้ จะช่วยให้วิเคราะห์สาเหตุได้ตรงขึ้น

❾ คำถามที่พบบ่อย

ติดตั้งแล้ว แต่ claude ยังไม่ทำงาน ต้องเริ่มจากอะไร?

เปิด Terminal หรือ PowerShell ใหม่ก่อน หากยังไม่พบคำสั่ง ให้ตรวจว่าโฟลเดอร์ที่ติดตั้งอยู่ใน PATH และโหลดไฟล์ตั้งค่า Shell ใหม่แล้ว

ต้องติดตั้ง Node.js ก่อนหรือไม่?

ขึ้นอยู่กับช่องทางติดตั้ง หากติดตั้งผ่าน npm ต้องใช้ Node.js 18 ขึ้นไป ส่วน Native installer มี Runtime ของตัวเองตามคู่มือ Claude Code

ใช้ Claude Code ใน Claude Desktop ต้องติดตั้ง Terminal หรือไม่?

ไม่ต้องติดตั้งเพิ่ม ให้ลงชื่อเข้าใช้ Claude Desktop แล้วเปิดแท็บ Code

ติดตั้งผ่าน npm แล้วเจอ permission denied ควรทำอย่างไร?

อย่าติดตั้งซ้ำด้วย sudo ให้ตรวจ npm prefix และ PATH หรือใช้ Native installer แทน

❿ สรุปวิธีตรวจ Claude Code ใช้คำสั่งไม่ได้

เริ่มจากตรวจว่าใช้ Claude Code ใน Desktop หรือ Terminal ถ้าใช้ Terminal ให้เปิด Shell ใหม่แล้วลอง claude --version หากระบบยังไม่พบคำสั่ง ให้ตรวจตำแหน่งติดตั้งและ PATH จากนั้นตรวจ Node.js และสิทธิ์ npm ตามช่องทางที่ใช้

หากยังมีปัญหา ให้รัน claude doctor จาก Shell ปกติ แล้วเก็บข้อความ Error ไว้ตรวจต่อ ComSiam แนะนำให้แก้ทีละจุดและหลีกเลี่ยงการใช้ sudo กับการติดตั้ง npm