วิธีติดตั้ง Claude Code: คู่มือฉบับสมบูรณ์ (2026)

สรุปโดยย่อ: Claude Code สามารถติดตั้งได้ผ่านตัวติดตั้งแบบเนทีฟบน macOS, Windows และ Linux จากเว็บไซต์ Claude Code อย่างเป็นทางการ ผู้ใช้ Windows ต้องติดตั้ง WSL2 ก่อนจึงจะสามารถเรียกใช้ Claude Code ได้ หลังจากการติดตั้ง ให้ยืนยันตัวตนด้วยบัญชี Claude ของคุณเมื่อ Claude Code เปิดหน้าต่างเบราว์เซอร์เพื่อให้คุณเข้าสู่ระบบในการเปิดใช้งานครั้งแรก เพื่อเริ่มเขียนโค้ดด้วยความช่วยเหลือจาก AI โดยตรงจากเทอร์มินัลหรือแอปเดสก์ท็อปของคุณ

Claude Code แสดงถึงความพยายามของ Anthropic ในการพัฒนาเครื่องมือ AI แบบ Agentic ผู้ช่วยแบบ Command-line นี้สามารถอ่านฐานโค้ด แก้ไขไฟล์ เรียกใช้คำสั่ง และผสานรวมกับเวิร์กโฟลว์การพัฒนา

แต่การติดตั้งนั้นไม่ได้ง่ายเสมอไป แต่ละแพลตฟอร์มต้องการวิธีการที่แตกต่างกัน Windows ต้องการการตั้งค่าเพิ่มเติม และเอกสาร แม้จะครบถ้วนสมบูรณ์ ก็อาจทำให้ผู้มาใหม่รู้สึกท่วมท้น

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

ข้อกำหนดของระบบก่อนการติดตั้ง

ตามเอกสารอย่างเป็นทางการของ Claude Code เครื่องมือนี้รองรับ macOS, Windows และ Linux อย่างไรก็ตาม แต่ละแพลตฟอร์มมีข้อกำหนดเบื้องต้นเฉพาะ

สำหรับ macOS ข้อกำหนดมีน้อยที่สุด ระบบต้องการ macOS 13.0 ขึ้นไป ชิป Intel และ Apple Silicon ใช้งานได้ดี

Windows มีความซับซ้อนมากกว่า ระบบปฏิบัติการต้องเป็น Windows 10 Build 19041 ขึ้นไป หรือ Windows 11 แต่ประเด็นสำคัญคือ Claude Code ไม่ได้ทำงานแบบเนทีฟบน Windows

Windows Subsystem for Linux 2 (WSL2) เป็นสิ่งจำเป็น สิ่งนี้จะสร้างสภาพแวดล้อม Linux ที่ Claude Code ทำงานอยู่จริง หากไม่มี WSL2 การติดตั้งจะล้มเหลว

ผู้ใช้ Linux ต้องการการกระจายแบบ 64 บิต เอกสารอย่างเป็นทางการยืนยันการรองรับ Ubuntu, Debian, Fedora และการกระจายหลักอื่นๆ Alpine Linux และระบบที่ใช้ musl ต้องการการกำหนดค่าเพิ่มเติม

ทุกแพลตฟอร์มต้องการการเชื่อมต่ออินเทอร์เน็ตที่เสถียรระหว่างการติดตั้ง ขนาดการดาวน์โหลดแตกต่างกันไป แต่โดยทั่วไปจะอยู่ระหว่าง 50MB ถึง 500MB ขึ้นอยู่กับสิ่งที่ติดตั้งไว้แล้ว

การติดตั้ง Claude Code บน macOS

กระบวนการติดตั้ง macOS ใช้ตัวติดตั้งแบบเนทีฟ นี่เป็นวิธีที่ง่ายที่สุดในบรรดาแพลตฟอร์มทั้งหมด

ก่อนอื่น ดาวน์โหลดตัวติดตั้งจากเว็บไซต์ Claude Code อย่างเป็นทางการ หน้าดาวน์โหลดจะตรวจจับ macOS โดยอัตโนมัติและเสนอแพ็คเกจที่เหมาะสม

เปิดไฟล์ .dmg ที่ดาวน์โหลด ลากแอปพลิเคชัน Claude Code ไปยังโฟลเดอร์ Applications การติดตั้ง macOS มาตรฐาน—ไม่มีอะไรผิดปกติที่นี่

ผู้ใช้บางรายพบปัญหาการแจ้งเตือนด้านความปลอดภัยเมื่อเปิดใช้งานครั้งแรก macOS บล็อกแอปจากนักพัฒนาที่ไม่ระบุตัวตนโดยค่าเริ่มต้น คลิกขวาที่แอปพลิเคชัน Claude Code และเลือก "เปิด" เพื่อข้ามคำเตือนครั้งเดียวนี้

เครื่องมือ Command-line จะติดตั้งโดยอัตโนมัติพร้อมกับแอปพลิเคชันเดสก์ท็อป เปิด Terminal และพิมพ์ claude --version เพื่อยืนยัน หากหมายเลขเวอร์ชันปรากฏขึ้น แสดงว่าการติดตั้งสำเร็จ

การตรวจสอบการติดตั้ง macOS

เรียกใช้คำสั่งเหล่านี้เพื่อยืนยันว่าทุกอย่างทำงานได้:

ทั้งสองคำสั่งควรส่งคืนผลลัพธ์โดยไม่มีข้อผิดพลาด คำสั่งเวอร์ชันแสดงเวอร์ชัน Claude Code ที่ติดตั้ง คำสั่ง help แสดงตัวเลือกและคำสั่งที่มีอยู่

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

การติดตั้ง Windows ด้วย WSL2

การติดตั้ง Windows ต้องใช้หลายขั้นตอน กระบวนการนี้ใช้เวลานานกว่า macOS แต่ก็ยังจัดการได้

ต้องติดตั้ง WSL2 ก่อน เปิด PowerShell ในฐานะผู้ดูแลระบบและเรียกใช้:

คำสั่งนี้จะติดตั้ง WSL2 และ Ubuntu โดยค่าเริ่มต้น ระบบจะต้องการรีสตาร์ท หลังจากรีบูต Ubuntu จะเปิดขึ้นโดยอัตโนมัติเพื่อตั้งค่าเบื้องต้นให้สมบูรณ์

สร้างชื่อผู้ใช้และรหัสผ่าน Unix เมื่อได้รับแจ้ง ข้อมูลประจำตัวเหล่านี้แยกต่างหากจากข้อมูลประจำตัวการเข้าสู่ระบบ Windows

เมื่อ WSL2 ทำงานแล้ว กระบวนการติดตั้ง Linux จะมีผลบังคับใช้ เปิดเทอร์มินัล Ubuntu (ที่ติดตั้งกับ WSL2) และดาวน์โหลดตัวติดตั้ง Claude Code สำหรับ Linux

การติดตั้ง Claude Code ใน WSL2

ตามเอกสารอย่างเป็นทางการ คำสั่งติดตั้งจะดาวน์โหลดและเรียกใช้ตัวติดตั้งแบบเนทีฟ:

สคริปต์นี้จัดการ dependency โดยอัตโนมัติ จะติดตั้ง Node.js หากจำเป็น ตั้งค่า binary ของ Claude Code และกำหนดค่าตัวแปร PATH

การติดตั้งใช้เวลาสองสามนาที แถบความคืบหน้าและข้อความสถานะจะแสดงสิ่งที่กำลังเกิดขึ้น เมื่อเสร็จสิ้น ให้ปิดและเปิดเทอร์มินัลใหม่เพื่อรีเฟรชตัวแปรสภาพแวดล้อม

การทดสอบการติดตั้งเป็นไปตามกระบวนการเดียวกับ macOS เรียกใช้ claude --version เพื่อยืนยัน

กระบวนการติดตั้ง Linux

ผู้ใช้ Linux มีเส้นทางการติดตั้งที่ตรงไปตรงมาที่สุด ตัวติดตั้งแบบเนทีฟทำงานได้โดยตรงโดยไม่ต้องมีเลเยอร์เพิ่มเติมเช่น WSL2

ดาวน์โหลดและเรียกใช้สคริปต์การติดตั้ง:

สิ่งนี้จะดาวน์โหลด binary ของ Claude Code ติดตั้ง dependency และกำหนดค่าสภาพแวดล้อมเชลล์ สคริปต์จะตรวจจับการกระจายและปรับเปลี่ยนตามความเหมาะสม

สำหรับระบบที่ใช้ Ubuntu และ Debian สคริปต์จะกำหนดค่าการติดตั้ง เอกสารอย่างเป็นทางการยืนยันการรองรับ Ubuntu 20.04+, Debian 10+ และการกระจายอื่นๆ

ข้อควรพิจารณาสำหรับ Alpine Linux

Alpine Linux และการกระจายที่ใช้ musl ต้องการขั้นตอนเพิ่มเติม เอกสารอย่างเป็นทางการระบุว่าระบบเหล่านี้ต้องการการกำหนดค่าด้วยตนเอง

ตัวติดตั้งมาตรฐานอาจล้มเหลวบน Alpine แทน ให้ดาวน์โหลด binary ที่เข้ากันได้กับ musl โดยตรงจากหน้า releases คลายซิปไปยังไดเรกทอรีใน PATH ของระบบ โดยทั่วไปคือ /usr/local/bin

ตั้งค่าสิทธิ์ในการเรียกใช้งาน:

ผู้ใช้ Alpine ควรตรวจสอบความเข้ากันได้ก่อนดำเนินการ บางฟีเจอร์อาจไม่ทำงานเหมือนกับการกระจายที่ใช้ glibc

การยืนยันตัวตนและการตั้งค่าบัญชี

หลังจากติดตั้ง Claude Code แล้ว ให้เรียกใช้ claude ในเทอร์มินัลของคุณ เมื่อเปิดใช้งานครั้งแรก Claude Code จะเปิดหน้าต่างเบราว์เซอร์เพื่อให้คุณเข้าสู่ระบบ

นี่จะเปิดหน้ายืนยันตัวตนของ Claude ลงชื่อเข้าใช้ด้วยบัญชี Claude ที่มีอยู่ หรือสร้างบัญชีใหม่

เบราว์เซอร์จะแสดงรหัสการอนุญาต คัดลอกรหัสนี้และกลับไปที่เทอร์มินัล วางรหัสเมื่อได้รับแจ้ง

การยืนยันตัวตนสำเร็จจะจัดเก็บข้อมูลประจำตัวไว้ในเครื่อง เซสชันในอนาคตจะไม่ต้องเข้าสู่ระบบ เว้นแต่ข้อมูลประจำตัวจะหมดอายุหรือถูกลบด้วยตนเอง

การยืนยันตัวตนสำหรับทีมและองค์กร

ตามเอกสารการยืนยันตัวตนอย่างเป็นทางการ ทีมที่ใช้ Claude for Teams หรือ Enterprise มีตัวเลือกเพิ่มเติม องค์กรสามารถกำหนดค่า single sign-on (SSO) หรือการยืนยันตัวตนผ่านผู้ให้บริการคลาวด์ได้

การตั้งค่า SSO ต้องการการกำหนดค่าของผู้ดูแลระบบ จากนั้นนักพัฒนาแต่ละรายจะยืนยันตัวตนผ่านผู้ให้บริการข้อมูลประจำตัวขององค์กร แทนที่จะเป็นบัญชี Claude ส่วนบุคคล

การยืนยันตัวตนผ่านผู้ให้บริการคลาวด์ใช้งานได้กับการปรับใช้ AWS, Google Cloud และ Azure วิธีนี้ใช้ข้อมูลประจำตัวคลาวด์ที่มีอยู่แทนบัญชี Claude แยกต่างหาก

การติดตั้งแอปเดสก์ท็อป

Claude Code มีทั้งแอปพลิเคชันแบบ Command-line และเดสก์ท็อป แอปเดสก์ท็อปมีอินเทอร์เฟซแบบกราฟิกพร้อมทั้งฟังก์ชันการทำงานของเทอร์มินัลเต็มรูปแบบ

ดาวน์โหลดตัวติดตั้งเดสก์ท็อปจากเว็บไซต์ Claude อย่างเป็นทางการ หน้าเว็บมีเวอร์ชัน macOS, Windows และ Windows ARM64 เลือกเวอร์ชันที่เหมาะสมสำหรับระบบ

การติดตั้ง macOS เป็นไปตามกระบวนการ .dmg เดียวกันที่อธิบายไว้ก่อนหน้านี้ ผู้ใช้ Windows สามารถดาวน์โหลดแอปเดสก์ท็อปสำหรับอินเทอร์เฟซแบบกราฟิกได้โดยไม่ต้องตั้งค่า WSL2

แอปเดสก์ท็อปมีการเข้าถึงเทอร์มินัลแบบบูรณาการ สามารถเปิดเซสชัน Claude Code ได้โดยไม่ต้องสลับไปใช้แอปพลิเคชันเทอร์มินัลภายนอก

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

ใช้ Get AI Perks เพื่อค้นหาเครดิตสำหรับ Claude Code Stack ของคุณ

การติดตั้งเป็นส่วนที่ง่าย ต้นทุนที่แท้จริงมักจะมาจากทุกสิ่งรอบตัว: โครงสร้างพื้นฐาน เครื่องมือสนับสนุน และบริการแบบชำระเงินที่ใช้ระหว่างการตั้งค่าและการทดสอบ Get AI Perks สามารถช่วยได้โดยการแสดงรายการเครดิตเริ่มต้นและส่วนลดในที่เดียว พร้อมคำแนะนำเกี่ยวกับวิธีการสมัคร

ด้วย Get AI Perks คุณสามารถ:

• ค้นหาเครดิตสำหรับเครื่องมือคลาวด์และ AI
• ตรวจสอบเงื่อนไขของ Perk ก่อนสมัคร
• หลีกเลี่ยงการเสียเวลาไปกับข้อเสนอที่คุณอาจไม่มีสิทธิ์ได้รับ
• ลดต้นทุนในการตั้งค่าของคุณ

เยี่ยมชม Get AI Perks เพื่อดูว่าข้อเสนอที่มีอยู่ตรงกับเครื่องมือที่คุณวางแผนจะใช้กับ Claude Code หรือไม่

ส่วนขยาย IDE และการผสานรวม

นอกเหนือจากการติดตั้งแบบสแตนด์อโลน Claude Code ยังผสานรวมกับสภาพแวดล้อมการพัฒนาที่ได้รับความนิยม มีส่วนขยายสำหรับ Visual Studio Code และ JetBrains IDEs

ส่วนขยาย VS Code ติดตั้งผ่าน Marketplace ค้นหา "Claude Code" ในแผง Extensions และคลิก Install ส่วนขยายต้องการให้เครื่องมือ Command-line ติดตั้งก่อน

ผู้ใช้บางรายรายงานปัญหาเกี่ยวกับไฟล์ส่วนขยาย VS Code ที่รวมอยู่ หากการติดตั้งอัตโนมัติล้มเหลวด้วยข้อผิดพลาด "End of central directory record signature not found" ไฟล์ .vsix ที่รวมไว้อาจเสียหาย

การแก้ไขปัญหาคือการติดตั้งส่วนขยายด้วยตนเองจาก Marketplace ของ VS Code แทนที่จะพึ่งพาเวอร์ชันที่รวมอยู่ใน CLI สิ่งนี้จะแยกส่วนประกอบทั้งสองออกจากกันและป้องกันความขัดแย้งในการติดตั้ง

การผสานรวม JetBrains ทำงานคล้ายกัน ติดตั้งปลั๊กอินจาก Marketplace ของ JetBrains ภายใน IntelliJ IDEA, PyCharm, WebStorm หรือผลิตภัณฑ์ JetBrains อื่นๆ

การตรวจสอบความสำเร็จของการติดตั้ง

การตรวจสอบที่ถูกต้องจะช่วยให้มั่นใจว่า Claude Code ทำงานได้อย่างถูกต้องก่อนเริ่มงานพัฒนาจริง

การตรวจสอบพื้นฐานจะตรวจสอบความพร้อมใช้งานของคำสั่ง:

คำสั่งเหล่านี้ควรดำเนินการได้โดยไม่มีข้อผิดพลาด คำสั่ง help จะแสดงรายการตัวเลือกที่มี คำสั่ง version จะแสดงเวอร์ชันที่ติดตั้ง

การทดสอบฟังก์ชันการทำงานต้องเริ่มเซสชัน สร้างไดเรกทอรีทดสอบ:

สิ่งนี้จะเริ่มต้นเซสชัน Claude Code แบบโต้ตอบ เครื่องมือควรวิเคราะห์ไดเรกทอรี (ว่างเปล่าในกรณีนี้) และแสดงพร้อมท์

ลองใช้คำสั่งพื้นฐานภายในเซสชัน พิมพ์ help เพื่อดูการดำเนินการที่มี ขอให้ทำงานง่ายๆ เช่น "สร้างไฟล์ README" หรือ "อธิบายว่าคุณทำอะไรได้บ้าง"

การตอบสนองที่สำเร็จบ่งชี้ว่าการติดตั้งถูกต้อง หากเกิดข้อผิดพลาด โดยทั่วไปจะเกี่ยวข้องกับการยืนยันตัวตน การเชื่อมต่อเครือข่าย หรือ dependency ที่ขาดหายไป

การจัดการการอัปเดตและเวอร์ชัน

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

พฤติกรรมการอัปเดตสามารถกำหนดค่าได้ผ่านการตั้งค่า Claude Code เอกสารอย่างเป็นทางการครอบคลุมการกำหนดค่าช่องทางการเผยแพร่และตัวเลือกการอัปเดตด้วยตนเอง

การอัปเดตด้วยตนเองต้องเรียกใช้สคริปต์การติดตั้งอีกครั้ง คำสั่งเดียวกันกับที่ใช้สำหรับการติดตั้งครั้งแรกจะดึงเวอร์ชันล่าสุด:

การติดตั้งเวอร์ชันเฉพาะเป็นไปได้เพื่อการทดสอบหรือเหตุผลด้านความเข้ากันได้ เอกสารการตั้งค่าขั้นสูงครอบคลุมการปักหมุดเวอร์ชันและการกำหนดค่าช่องทางการเผยแพร่

ช่องทางการเผยแพร่รวมถึง stable, beta และ nightly Stable แนะนำสำหรับงานที่ต้องใช้งานจริง ช่องทาง beta และ nightly ให้สิทธิ์เข้าถึงฟีเจอร์ใหม่ก่อนใคร แต่ก็อาจมีข้อผิดพลาด

ปัญหาการติดตั้งทั่วไป

ปัญหาหลายอย่างปรากฏขึ้นบ่อยครั้งในการสนทนาในชุมชนเกี่ยวกับการติดตั้ง Claude Code

การกำหนดค่า PATH ทำให้เกิดปัญหามากมาย หากคำสั่ง claude ไม่พบหลังจากติดตั้ง ไดเรกทอรี binary จะไม่อยู่ใน PATH ของระบบ

บน macOS และ Linux การเพิ่มไดเรกทอรีไปยัง PATH โดยทั่วไปเกี่ยวข้องกับการแก้ไข ~/.bashrc, ~/.zshrc หรือไฟล์กำหนดค่าเชลล์ที่คล้ายกัน สคริปต์การติดตั้งมักจะจัดการเรื่องนี้โดยอัตโนมัติ แต่การตรวจสอบด้วยตนเองจะช่วยแก้ไขปัญหาได้

ผู้ใช้ Windows ใน WSL2 อาจต้องปิดและเปิดเทอร์มินัลใหม่หลังจากติดตั้ง ตัวแปรสภาพแวดล้อมจะไม่รีเฟรชในเซสชันที่มีอยู่

ข้อจำกัดเครือข่ายบล็อกการติดตั้งบางอย่าง ไฟร์วอลล์องค์กรหรือเซิร์ฟเวอร์พร็อกซีอาจป้องกันการดาวน์โหลดตัวติดตั้งหรือการเชื่อมต่อไปยังเซิร์ฟเวอร์ยืนยันตัวตน

การกำหนดค่าพร็อกซีต้องการตัวแปรสภาพแวดล้อม:

เกิดข้อผิดพลาดเกี่ยวกับสิทธิ์เมื่อติดตั้งในไดเรกทอรีที่ได้รับการป้องกัน ตัวติดตั้งต้องการสิทธิ์ในการเขียนไปยัง /usr/local/bin หรือตำแหน่งที่เทียบเท่า การเรียกใช้ด้วย sudo จะแก้ไขปัญหานี้ แต่ควรหลีกเลี่ยงเว้นแต่จำเป็น

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

การเริ่มต้นใช้งานหลังการติดตั้ง

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

เอกสาร quickstart แนะนำให้เริ่มต้นด้วยงานง่ายๆ นำทางไปยังโปรเจ็กต์ที่มีอยู่และเรียกใช้ claude เพื่อเริ่มเซสชันแบบโต้ตอบ

ขอให้ Claude อธิบายโครงสร้างโปรเจ็กต์ ขอสรุปว่าฐานโค้ดทำอะไร คำถามสำรวจเหล่านี้ช่วยให้เข้าใจว่าเครื่องมือตีความโค้ดอย่างไร

ลองทำการเปลี่ยนแปลงเล็กๆ น้อยๆ ขอให้ Claude เพิ่มความคิดเห็นให้กับฟังก์ชัน สร้างไฟล์ทดสอบง่ายๆ หรือจัดระเบียบโค้ดบล็อกใหม่ งานเหล่านี้แสดงความสามารถในการแก้ไขโดยไม่มีความเสี่ยง

การผสานรวม Git ทำงานโดยอัตโนมัติหากโปรเจ็กต์ใช้การควบคุมเวอร์ชัน Claude Code สามารถสร้าง commit อธิบาย diff และเสนอการปรับปรุงตามการเปลี่ยนแปลง

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

Claude Code เป็นเครื่องมือที่กำลังพัฒนา การติดตั้งเป็นเพียงรากฐาน การทำความเข้าใจความสามารถ ข้อจำกัด และแนวทางปฏิบัติที่ดีที่สุดต้องอาศัยการทดลองและการฝึกฝน

พร้อมที่จะติดตั้ง Claude Code แล้วหรือยัง? ดาวน์โหลดตัวติดตั้งที่เหมาะสมสำหรับแพลตฟอร์มของคุณจากเว็บไซต์อย่างเป็นทางการและทำตามขั้นตอนที่ระบุไว้ในคู่มือนี้ ยืนยันตัวตนด้วยบัญชี Claude ของคุณ ตรวจสอบว่าการติดตั้งทำงานได้อย่างถูกต้อง และเริ่มสำรวจการพัฒนาด้วยความช่วยเหลือจาก AI