Skip to main content

แก้ไขปัญหาการติดตั้งและการล็อกอิน

แก้ไข command not found, PATH, permission, network, และข้อผิดพลาด authentication เมื่อติดตั้งหรือล็อกอิน Claude Code

หากการติดตั้งล้มเหลวหรือคุณไม่สามารถล็อกอินได้ ค้นหาข้อผิดพลาดของคุณด้านล่าง

ค้นหาข้อผิดพลาดของคุณ​

สิ่งที่คุณเห็นวิธีแก้ไข
command not found: claude หรือ 'claude' is not recognizedแก้ไข PATH
syntax error near unexpected token '<'Install script ส่งกลับ HTML
curl: (22) The requested URL returned error: 403Install script ส่งกลับ 403
Killed ระหว่างติดตั้งบน Linuxเพิ่ม swap space
TLS connect error หรือ SSL/TLS secure channelอัปเดต CA certificates
OAuth error หรือ 403 Forbiddenแก้ไข authentication
tip

หากคุณต้องการข้ามการใช้ terminal ทั้งหมด Claude Code Desktop app ให้คุณติดตั้งและใช้ Claude Code ผ่าน graphical interface ดาวน์โหลดสำหรับ macOS หรือ Windows

การตรวจสอบวินิจฉัย​

ตรวจสอบ Network Connectivity​

Installer ดาวน์โหลดจาก downloads.claude.ai ตรวจสอบว่าคุณสามารถเข้าถึงได้:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

บรรทัด HTTP/2 200 หมายความว่าคุณเข้าถึง server ได้

ตรวจสอบ PATH ของคุณ​

หากการติดตั้งสำเร็จแต่คุณได้รับข้อผิดพลาด command not found ไดเรกทอรีติดตั้งไม่อยู่ใน PATH ของคุณ Installer วาง claude ที่ ~/.local/bin/claude บน macOS/Linux

macOS/Linux:

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

หากไม่มี output ให้เพิ่ม:

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

Windows PowerShell:

$env:PATH -split ';' | Select-String '\.local\\bin'

ปัญหาการติดตั้งที่พบบ่อย​

Install Script ส่งกลับ HTML แทน Shell Script​

เมื่อรันคำสั่งติดตั้ง คุณอาจเห็นข้อผิดพลาดเหล่านี้:

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

หมายความว่า install URL ส่งกลับ HTML page แทน install script

วิธีแก้ไข:

บน macOS ติดตั้งผ่าน Homebrew:

brew install --cask claude-code

บน Windows ติดตั้งผ่าน WinGet:

winget install Anthropic.ClaudeCode

command not found: claude หลังจากติดตั้ง​

ดู ตรวจสอบ PATH ของคุณ ด้านบน

curl: (56) Failure writing output to destination​

วิธีแก้ไข:

  1. ตรวจสอบความเสถียรของ network
  2. ลองวิธีการติดตั้งทางเลือก: 
    brew install --cask claude-code  # macOS
    winget install Anthropic.ClaudeCode  # Windows

Homebrew Cask ไม่พร้อมใช้งานหรือล้าสมัย​

brew update
brew install --cask claude-code

ข้อผิดพลาด TLS หรือ SSL​

วิธีแก้ไข:

  1. อัปเดต CA certificates:

    sudo apt-get update && sudo apt-get install ca-certificates  # Ubuntu/Debian

  2. บน Windows เปิดใช้งาน TLS 1.2:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    irm https://claude.ai/install.ps1 | iex

ติดตั้งถูก Kill บน Linux ที่มี Memory ต่ำ​

Claude Code ต้องการ RAM ว่างอย่างน้อย 4 GB เพิ่ม swap space:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

จากนั้นลองติดตั้งใหม่

คำสั่งติดตั้งผิดบน Windows​

  • irm ไม่ถูกจดจำ: คุณอยู่ใน CMD ไม่ใช่ PowerShell เปิด PowerShell แล้วรัน:

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

  • bash ไม่ถูกจดจำ: คุณรัน macOS/Linux installer บน Windows ใช้ PowerShell installer แทน

การล็อกอินและ Authentication​

รีเซ็ตการล็อกอิน​

เมื่อการล็อกอินล้มเหลว:

  1. รัน /logout เพื่อออกจากระบบอย่างสมบูรณ์
  2. ปิด Claude Code
  3. รีสตาร์ทด้วย claude และทำ authentication process ใหม่

OAuth Error: Invalid Code​

หากคุณเห็น OAuth error: Invalid code:

  • กด Enter เพื่อลองใหม่และทำการล็อกอินให้เสร็จสิ้นอย่างรวดเร็วหลังจากเบราว์เซอร์เปิด
  • พิมพ์ c เพื่อคัดลอก URL หากเบราว์เซอร์ไม่เปิดโดยอัตโนมัติ

403 Forbidden หลังจากล็อกอิน​

  • ผู้ใช้ Claude Pro/Max: ตรวจสอบว่า subscription ของคุณยังใช้งานได้ที่ claude.ai/settings
  • ผู้ใช้ Anthropic Console: ยืนยันว่าบัญชีของคุณมีบทบาท "Claude Code" หรือ "Developer"
  • อยู่หลัง proxy: proxies ขององค์กรสามารถรบกวน API requests

OAuth Login ล้มเหลวใน WSL2, SSH, หรือ Containers​

เมื่อ Claude Code รันใน WSL2 บนเครื่องระยะไกลผ่าน SSH หรือภายใน container เบราว์เซอร์มักเปิดบน host ที่แตกต่างกัน วาง login code ลงใน terminal ที่ Paste code here if prompted

หากเบราว์เซอร์ไม่เปิดจาก WSL2 ตั้ง environment variable:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Credentials ของ Bedrock, Vertex, หรือ Foundry ไม่โหลด​

สำหรับ Bedrock ยืนยัน AWS credentials ของคุณ:

aws sts get-caller-identity

สำหรับ Vertex AI ตั้งค่า application default credentials:

gcloud auth application-default login

สำหรับ Microsoft Foundry ยืนยัน ANTHROPIC_FOUNDRY_API_KEY หรือล็อกอิน:

az login

ยังติดขัดอยู่​

หากไม่มีอะไรข้างต้นแก้ไขปัญหาของคุณ:

  1. ตรวจสอบ GitHub repository สำหรับปัญหาที่รู้จัก
  2. หาก claude --version ทำงานแต่มีบางสิ่งอื่นผิด รัน claude doctor สำหรับรายงานการวินิจฉัยอัตโนมัติ
  3. หากคุณสามารถเริ่ม session ได้ ใช้ /feedback ภายใน Claude Code เพื่อรายงานปัญหา