Claude Code ชุดบทช่วยสอน 5: วิธีการติดตั้ง Claude Code?

วิธีการติดตั้ง Claude Code

การติดตั้ง Claude Code ไม่มีหน้าจอกราฟิกให้คลิก "ถัดไป" ทุกอย่างทำในบรรทัดคำสั่ง หากคุณใช้ npm เป็นประจำ กระบวนการทั้งหมดจะใช้เวลาไม่เกินสองนาที

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมีสิ่งต่อไปนี้:

• Node.js 18 หรือสูงกว่า
  วิธีตรวจสอบ: รัน node -v ในเทอร์มินัล หากเวอร์ชันต่ำกว่า 18 ให้อัปเกรดโดยใช้ nvm, fnm หรือไปที่ nodejs.org โดยตรง
• บัญชี Anthropic
  ลงทะเบียนที่ https://console.anthropic.com บัญชีจะให้ API Key ซึ่งคุณจะต้องใช้หลังจากติดตั้ง การลงทะเบียนฟรี แต่ค่าใช้จ่ายจริงขึ้นอยู่กับการใช้งาน
• เครือข่ายสามารถเข้าถึง API endpoint ของ Anthropic
  โดเมนเริ่มต้นคือ api.anthropic.com หากสภาพแวดล้อมต้องกำหนดพร็อกซี อย่าลืมตั้งค่า HTTP_PROXY หรือ HTTPS_PROXY ในเทอร์มินัล

วิธีการติดตั้งแบบที่ 1: ติดตั้งแบบ global ด้วย npm

นี่เป็นวิธีที่ใช้บ่อยที่สุด ติดตั้งครั้งเดียวแล้วสามารถใช้ได้ทุกที่

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

หลังจากเสร็จสิ้น ให้รัน claude --version หากแสดงหมายเลขเวอร์ชัน แสดงว่าติดตั้งสำเร็จ เมื่อติดตั้งแบบ global แล้ว คุณสามารถเรียกใช้คำสั่ง claude ได้จากทุกไดเรกทอรี

หากพบข้อผิดพลาดเรื่องสิทธิ์ (พบบ่อยใน macOS ที่ไดเรกทอรี /usr/local/lib) มีสองวิธีจัดการ:

1. ใช้ sudo ในการติดตั้ง (สะดวกแต่มีข้อกังวลด้านความปลอดภัย)
2. กำหนดค่า npm ให้ใช้ไดเรกทอรีผู้ใช้เพื่อหลีกเลี่ยง sudo:
   bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
   จากนั้นเพิ่ม ~/.npm-global/bin ลงใน PATH และเปิดเทอร์มินัลใหม่

วิธีการติดตั้งแบบที่ 2: ใช้ npx แบบชั่วคราว

หากคุณไม่ต้องการติดตั้งอะไรแบบ global หรือแค่อยากลองใช้ชั่วคราว การใช้ npx จะตรงไปตรงมากว่า

npx @anthropic-ai/claude-code

npx จะดาวน์โหลดแพ็กเกจล่าสุดชั่วคราว รันแล้วไม่ทิ้งคำสั่ง global ไว้ ทุกครั้งที่ใช้จะตรวจสอบอัปเดต ดังนั้นจึงเป็นเวอร์ชันล่าสุดเสมอ ข้อเสียคือช้าเล็กน้อย (ต้องดาวน์โหลดทุกครั้ง) และไม่เหมาะสำหรับการเรียกใช้บ่อยในสคริปต์อัตโนมัติ

เหมาะสำหรับ: การลองใช้ครั้งแรก, การใช้งานบนเครื่องผู้อื่นชั่วคราว, หรือใช้งานเป็นครั้งคราว

ตรวจสอบว่าสามารถเริ่มต้นได้หรือไม่

หลังจากติดตั้ง อย่าเพิ่งรีบยืนยันตัวตน ให้รันคำสั่งง่ายๆ เพื่อดูว่าเครื่องมือสามารถทำงานได้หรือไม่:

claude --help

หากแสดงข้อมูลช่วยเหลือ แสดงว่าไฟล์ไบนารีทำงานได้ปกติ ขั้นตอนถัดไปคือเชื่อมต่อบัญชีของคุณ ซึ่งจะอธิบายในภายหลัง

สองวิธีติดตั้งให้ตัวเครื่องมือเดียวกัน กระบวนการยืนยันตัวตนและการใช้งานภายหลังเหมือนกันทุกประการ เลือกวิธีที่คุณสะดวก

ปัญหาที่พบบ่อย

• เวอร์ชัน Node ต่ำเกินไป
  หากต่ำกว่า 18 จะเกิดข้อผิดพลาดทันที ไม่ใช่คำเตือน การอัปเกรด Node เป็นทางออกที่ตรงไปตรงมาที่สุด
• เครือข่ายหมดเวลา
  ไม่ว่าจะเป็นการดึงแพ็กเกจ npm หรือการเชื่อมต่อ API ภายหลัง อาจติดขัดเนื่องจากพร็อกซีหรือไฟร์วอลล์ ก่อนอื่นให้ตรวจสอบว่า curl https://api.anthropic.com ใช้งานได้ แล้วจึงดำเนินการขั้นต่อไป
• การใช้ cmd ดั้งเดิมบน Windows
  แม้ว่าในทางทฤษฎีจะทำได้ แต่แนะนำให้ใช้ Git Bash, WSL2 หรือ Windows Terminal เพื่อหลีกเลี่ยงปัญหาการแปลงพาธที่แปลกประหลาด