การตั้งค่า Claude Code

Claude Code Setup with GLM Coding Plan

คู่มือการติดตั้งและตั้งค่า Claude Code เพื่อใช้งานกับ GLM Coding Plan จาก z.ai

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

ก่อนเริ่มต้นติดตั้ง Claude Code โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

รายการ รายละเอียด
บัญชี z.ai ต้องมีบัญชี z.ai พร้อมสมัครสมาชิก GLM Coding Plan
API Key ต้องมี API Key จาก z.ai (ดูได้จากหน้า z.ai Console)
Terminal ต้องมีสิทธิ์เข้าถึง Terminal/Command Line
ระบบปฏิบัติการ macOS, Linux หรือ Windows

การรับ API Key จาก z.ai

1

เข้าสู่ z.ai Console

2

ไปที่เมนู API Keys หรือ การจัดการ API

3

คลิก สร้าง API Key ใหม่

4

คัดลอก API Key และเก็บไว้ในที่ปลอดภัย

คำเตือน: อย่าเปิดเผย API Key ของคุณต่อสาธารณะ หรืออัปโหลดไปยัง public repository

การติดตั้ง Claude Code

macOS

เปิด Terminal และรันคำสั่งต่อไปนี้:

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

หลังจากติดตั้งเสร็จสิ้น ให้รีสตาร์ท Terminal หรือรันคำสั่ง:

source ~/.zshrc
# หรือหากใช้ bash
source ~/.bashrc

Linux

รันคำสั่งเดียวกับ macOS:

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

รีสตาร์ท shell หรือรัน:

source ~/.bashrc

Windows (PowerShell)

เปิด PowerShell ในโหมด Administrator และรัน:

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

หลังจากติดตั้งเสร็จ ให้รีสตาร์ท PowerShell

การตั้งค่า Environment Variables

เพื่อให้ Claude Code ทำงานกับ z.ai GLM Coding Plan คุณต้องตั้งค่า environment variables 2 ตัว:

ตัวแปรที่จำเป็น

ตัวแปร ค่า คำอธิบาย
ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic URL ของ z.ai API endpoint
ANTHROPIC_API_KEY API Key ของคุณ คีย์สำหรับยืนยันตัวตนกับ z.ai

macOS / Linux (bashrc)

เปิดไฟล์ ~/.bashrc ด้วย text editor:

nano ~/.bashrc

เพิ่มบรรทัดต่อไปนี้ที่ท้ายไฟล์:

# Claude Code - z.ai GLM Coding Plan
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_API_KEY="your-api-key-here"

บันทึกไฟล์และรัน:

source ~/.bashrc

macOS / Linux (zshrc)

เปิดไฟล์ ~/.zshrc:

nano ~/.zshrc

เพิ่มบรรทัดต่อไปนี้:

# Claude Code - z.ai GLM Coding Plan
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_API_KEY="your-api-key-here"

บันทึกและรัน:

source ~/.zshrc

Windows (PowerShell Profile)

เปิด PowerShell และรันคำสั่งต่อไปนี้เพื่อเพิ่ม environment variables:

# เพิ่มลงใน current session
$env:ANTHROPIC_BASE_URL = "https://open.bigmodel.cn/api/anthropic"
$env:ANTHROPIC_API_KEY = "your-api-key-here"

# ตั้งค่าถาวร (สำหรับ user)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://open.bigmodel.cn/api/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")

Windows (System Environment Variables)

ทางเลือกอื่น: ตั้งค่าผ่าน GUI

1

กด Win + R พิมพ์ sysdm.cpl แล้วกด Enter

2

ไปที่แท็บ Advanced

3

คลิก Environment Variables

4

ใต้ User variables คลิก New

5

เพิ่มตัวแปร ANTHROPIC_BASE_URL และ ANTHROPIC_API_KEY

6

รีสตาร์ท PowerShell

การกำหนดค่าโมเดล

ตำแหน่งไฟล์ settings.json

ระบบปฏิบัติการ ตำแหน่งไฟล์
macOS / Linux ~/.claude/settings.json
Windows %USERPROFILE%\.claude\settings.json

การสร้างไฟล์ settings.json

หากไฟล์ยังไม่มี ให้สร้างไฟล์ใหม่:

# macOS / Linux
mkdir -p ~/.claude
nano ~/.claude/settings.json
# Windows PowerShell
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

Model Mapping Configuration

เพิ่มการตั้งค่าโมเดลลงใน settings.json:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-4.5-Air"
  }
}

คำอธิบายการ Mapping โมเดล

Claude Model GLM Model คำอธิบาย
Opus GLM-4.7 โมเดลที่ทรงพลังที่สุด สำหรับงานที่ซับซ้อน
Sonnet GLM-4.7 โมเดลหลัก สมดุลระหว่างความเร็วและคุณภาพ
Haiku GLM-4.5-Air โมเดลเร็ว สำหรับงานที่ต้องการการตอบสนองรวดเร็ว

โมเดล GLM ที่รองรับ

โมเดล ความสามารถ การใช้งานแนะนำ
GLM-4.7 โมเดลล่าสุด รองรับ context ยาว งาน coding ทั่วไป, การวิเคราะห์โค้ด
GLM-4.5-Air โมเดลเร็ว ต้นทุนต่ำ งานที่ต้องการความเร็ว, autocomplete
GLM-4-Plus โมเดลระดับสูง งานที่ซับซ้อนพิเศษ

การสลับโมเดล

วิธีที่ 1: แก้ไข settings.json

เปิดไฟล์ ~/.claude/settings.json และเปลี่ยนค่าโมเดล:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-4.5-Air"
  }
}

วิธีที่ 2: ใช้ Environment Variable ชั่วคราว

# ใช้โมเดลเฉพาะ session นี้
export ANTHROPIC_DEFAULT_SONNET_MODEL="GLM-4-Plus"
claude

วิธีที่ 3: ใช้ Flag ในคำสั่ง

# ระบุโมเดลโดยตรงในคำสั่ง
ANTHROPIC_DEFAULT_SONNET_MODEL="GLM-4-Plus" claude

ตัวอย่างการใช้งานตามกรณี

# สำหรับงาน coding ทั่วไป
export ANTHROPIC_DEFAULT_SONNET_MODEL="GLM-4.7"

# สำหรับงานที่ต้องการความเร็ว
export ANTHROPIC_DEFAULT_HAIKU_MODEL="GLM-4.5-Air"

# สำหรับงานที่ซับซ้อน
export ANTHROPIC_DEFAULT_OPUS_MODEL="GLM-4.7"

การเชื่อมต่อ MCP

MCP (Model Context Protocol) ช่วยให้ Claude Code สามารถเชื่อมต่อกับเครื่องมือภายนอกได้

Web Search MCP

สำหรับค้นหาข้อมูลจากอินเทอร์เน็ต:

{
  "mcpServers": {
    "web-search": {
      "command": "mcp-server-web-search",
      "args": []
    }
  }
}

Web Reader MCP

สำหรับอ่านเนื้อหาจากเว็บไซต์:

{
  "mcpServers": {
    "web-reader": {
      "command": "mcp-server-web-reader",
      "args": []
    }
  }
}

Zread MCP

สำหรับอ่านและสรุปเนื้อหา:

{
  "mcpServers": {
    "zread": {
      "command": "mcp-server-zread",
      "args": []
    }
  }
}

ตัวอย่างไฟล์ settings.json พร้อม MCP

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-4.5-Air"
  },
  "mcpServers": {
    "web-search": {
      "command": "mcp-server-web-search",
      "args": []
    },
    "web-reader": {
      "command": "mcp-server-web-reader",
      "args": []
    },
    "zread": {
      "command": "mcp-server-zread",
      "args": []
    }
  }
}

หมายเหตุ: สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ MCP โปรดดูเอกสาร MCP Configuration Guide

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

ตรวจสอบ Environment Variables

# macOS / Linux
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# Windows PowerShell
Write-Host $env:ANTHROPIC_BASE_URL
Write-Host $env:ANTHROPIC_API_KEY

ผลลัพธ์ที่คาดหวัง:

https://open.bigmodel.cn/api/anthropic
your-api-key-here

ตรวจสอบเวอร์ชัน Claude Code

claude --version

ทดสอบการเชื่อมต่อ

รัน Claude Code และส่งคำถามทดสอบ:

claude

ภายใน Claude Code ให้ลองพิมพ์:

สวัสดีครับ ช่วยเขียนโค้ด Python ง่ายๆ ที่ print "Hello World" หน่อยครับ

หากได้รับการตอบกลับ แสดงว่าการติดตั้งสำเร็จ

ทดสอบด้วยคำสั่งแบบบรรทัดเดียว

# macOS / Linux
echo "เขียนฟังก์ชัน JavaScript บวกเลขสองตัว" | claude

# Windows PowerShell
"เขียนฟังก์ชัน JavaScript บวกเลขสองตัว" | claude

การแก้ไขปัญหาทั่วไป

1. API Key Invalid

อาการ:

Error: Invalid API Key
Authentication failed

สาเหตุ:

  • API Key ไม่ถูกต้องหรือหมดอายุ
  • API Key ถูกคัดลอกผิด
  • Environment variable ไม่ถูกตั้งค่า

วิธีแก้:

# ตรวจสอบ API Key
echo $ANTHROPIC_API_KEY

# ตั้งค่าใหม่
export ANTHROPIC_API_KEY="your-correct-api-key"

2. Connection Failed

อาการ:

Error: Connection refused
Network timeout
Unable to reach API endpoint

วิธีแก้:

# ตรวจสอบ URL
echo $ANTHROPIC_BASE_URL
# ควรแสดง: https://open.bigmodel.cn/api/anthropic

# ทดสอบการเชื่อมต่อ
curl -I https://open.bigmodel.cn/api/anthropic

# หากใช้ proxy
export HTTP_PROXY="http://your-proxy:port"
export HTTPS_PROXY="http://your-proxy:port"

3. Model Not Found

อาการ:

Error: Model not found
Invalid model specified

วิธีแก้:

# ตรวจสอบ settings.json
cat ~/.claude/settings.json

# ตรวจสอบว่า JSON ถูกต้อง
python3 -m json.tool ~/.claude/settings.json

ใช้ชื่อโมเดลที่ถูกต้อง: GLM-4.7, GLM-4.5-Air, GLM-4-Plus

4. Quota Exhausted

อาการ:

Error: Quota exceeded
Rate limit reached
Insufficient credits

วิธีแก้:

  • เข้าสู่ z.ai Console และตรวจสอบยอดคงเหลือ
  • รอ Rate Limit Reset
  • เปลี่ยนไปใช้โมเดลที่ประหยัดกว่า (GLM-4.5-Air)
  • เติมเงินหรืออัปเกรด Plan

ตารางสรุปการแก้ไขปัญหา

ปัญหา สาเหตุหลัก วิธีแก้ด่วน
API Key Invalid Key ผิด/หมดอายุ ตรวจสอบและรีเซ็ต Key
Connection Failed เครือข่าย/URL ตรวจสอบ URL และ network
Model Not Found ชื่อโมเดลผิด แก้ไข settings.json
Quota Exhausted เกินโควต้า เติมเงิน/รอ reset

สรุป

การตั้งค่า Claude Code กับ GLM Coding Plan ประกอบด้วยขั้นตอนหลัก:

1

ติดตั้ง Claude Code ตามระบบปฏิบัติการ

2

ตั้งค่า Environment Variables (ANTHROPIC_BASE_URL และ ANTHROPIC_API_KEY)

3

กำหนดค่าโมเดล ใน settings.json

4

ตรวจสอบการติดตั้ง ด้วยคำสั่งทดสอบ

หลังจากตั้งค่าเสร็จสิ้น คุณสามารถใช้ Claude Code กับโมเดล GLM ได้อย่างเต็มที่

อ้างอิง