การติดตั้งขั้นสูง
ความต้องการของระบบ การติดตั้งเฉพาะแพลตฟอร์ม การจัดการเวอร์ชัน และการถอนการติดตั้ง Claude Code
หน้านี้ครอบคลุมความต้องการของระบบ รายละเอียดการติดตั้งเฉพาะแพลตฟอร์ม การอัปเดต และการถอนการติดตั้ง สำหรับคำแนะนำแบบ guided walkthrough ของ session แรก ดู quickstart
ความต้องการของระบบ
Claude Code รันบนแพลตฟอร์มและการตั้งค่าต่อไปนี้:
- ระบบปฏิบัติการ: macOS 13.0+, Windows 10 1809+ หรือ Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
- Hardware: RAM 4 GB+, โปรเซสเซอร์ x64 หรือ ARM64
- เครือข่าย: ต้องการการเชื่อมต่ออินเทอร์เน็ต
- Shell: Bash, Zsh, PowerShell หรือ CMD
- ที่ตั้ง: ประเทศที่ Anthropic รองรับ
ติดตั้ง Claude Code
ติดตั้ง Claude Code ด้วยวิธีใดวิธีหนึ่งต่อไปนี้:
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
ตั้งค่าบน Windows
คุณสามารถรัน Claude Code บน Windows แบบ native หรือใน WSL เลือกตามว่าโปรเจกต์ของคุณอยู่ที่ไหนและฟีเจอร์ที่คุณต้องการ:
| ตัวเลือก | ต้องการ | เมื่อใดควรใช้ |
|---|---|---|
| Native Windows | ไม่มี; Git for Windows เป็นทางเลือก | โปรเจกต์และเครื่องมือ Windows-native |
| WSL 2 | เปิดใช้ WSL 2 | Linux toolchains หรือ sandboxed command execution |
| WSL 1 | เปิดใช้ WSL 1 | ถ้า WSL 2 ไม่พร้อมใช้ |
Alpine Linux และ musl-based distributions
installer แบบ native บน Alpine และ distribution musl/uClibc อื่นๆ ต้องการ libgcc, libstdc++ และ ripgrep
apk add libgcc libstdc++ ripgrep
จากนั้นตั้ง USE_BUILTIN_RIPGREP เป็น 0 ใน settings.json:
{
"env": {
"USE_BUILTIN_RIPGREP": "0"
}
}
ตรวจสอบการติดตั้ง
หลังติดตั้ง ยืนยันว่า Claude Code ทำงานได้:
claude --version
สำหรับการตรวจสอบการติดตั้งและการตั้งค่าโดยละเอียดยิ่งขึ้น รัน:
claude doctor
ยืนยันตัวตน
Claude Code ต้องการบัญชี Pro, Max, Team, Enterprise หรือ Console หลังติดตั้ง login โดยรัน claude และทำตามขั้นตอนในเบราว์เซอร์ ดู Authentication สำหรับประเภทบัญชีทั้งหมดและตัวเลือกการตั้งค่าทีม
อัปเดต Claude Code
การติดตั้งแบบ native จะอัปเดตโดยอัตโนมัติในพื้นหลัง คุณสามารถ กำหนด release channel เพื่อควบคุมว่าจะรับอัปเดตทันทีหรือตามกำหนดการ stable ที่ล่าช้า
Auto-updates
Claude Code ตรวจหาอัปเดตเมื่อเริ่มต้นและเป็นระยะในขณะรัน อัปเดตจะดาวน์โหลดและติดตั้งในพื้นหลัง แล้วมีผลในครั้งถัดไปที่คุณเริ่ม Claude Code
กำหนด release channel
ควบคุม release channel ที่ Claude Code ตาม:
"latest"(ค่าเริ่มต้น): รับฟีเจอร์ใหม่ทันทีที่ออก"stable": ใช้เวอร์ชันที่มักจะเก่าประมาณหนึ่งสัปดาห์
กำหนดผ่าน /config → Auto-update channel หรือเพิ่มใน settings.json:
{
"autoUpdatesChannel": "stable"
}
ปิด auto-updates
ตั้ง DISABLE_AUTOUPDATER เป็น "1" ในไฟล์ settings.json:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
อัปเดตด้วยตนเอง
เพื่อ apply อัปเดตทันทีโดยไม่รอ background check ถัดไป รัน:
claude update
ตัวเลือกการติดตั้งขั้นสูง
ติดตั้งเวอร์ชันเฉพาะ
# ติดตั้ง stable version
curl -fsSL https://claude.ai/install.sh | bash -s stable
# ติดตั้งเวอร์ชันหมายเลขเฉพาะ
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
ติดตั้งด้วย Linux package managers
Claude Code เผยแพร่ apt, dnf และ apk repositories ที่ลงนามแล้ว
apt (Debian และ Ubuntu):
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code
dnf (Fedora และ RHEL):
sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code
apk (Alpine Linux):
wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code
ติดตั้งด้วย npm
npm install -g @anthropic-ai/claude-code
อย่าใช้ sudo npm install -g เพราะอาจทำให้เกิดปัญหาสิทธิ์และความเสี่ยงด้านความปลอดภัย
ถอนการติดตั้ง Claude Code
การติดตั้งแบบ native
# macOS, Linux, WSL
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Homebrew installation
brew uninstall --cask claude-code
# หรือสำหรับ latest cask:
brew uninstall --cask claude-code@latest
WinGet installation
winget uninstall Anthropic.ClaudeCode
apt / dnf / apk
# apt
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
# dnf
sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo
# apk
apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub
npm
npm uninstall -g @anthropic-ai/claude-code
ลบไฟล์ configuration
คำเตือน: การลบไฟล์ configuration จะลบการตั้งค่า เครื่องมือที่อนุญาต การตั้งค่า MCP server และประวัติ session ทั้งหมด
# macOS, Linux, WSL
rm -rf ~/.claude
rm ~/.claude.json
# ลบการตั้งค่าเฉพาะโปรเจกต์ (รันจาก project directory)
rm -rf .claude
rm -f .mcp.json
# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force
# ลบการตั้งค่าเฉพาะโปรเจกต์
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force