ตัวแปร Environment สำหรับ GLM Coding Plan

เอกสารนี้อธิบายวิธีการตั้งค่าตัวแปร environment สำหรับใช้งาน GLM Coding Plan กับ Claude Code

ตัวแปรที่จำเป็น (Required Variables)

ตัวแปรเหล่านี้จำเป็นต้องตั้งค่าเพื่อให้ Claude Code สามารถเชื่อมต่อกับ GLM API ได้:

ตัวแปร ค่า คำอธิบาย
ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic URL ของ GLM API endpoint
ANTHROPIC_API_KEY Your z.ai API key API Key ของคุณจาก z.ai

ตัวแปรการแม็ปโมเดล (Model Mapping Variables)

ตัวแปรเหล่านี้ใช้สำหรับแม็ปโมเดลของ Anthropic กับโมเดล GLM:

ตัวแปร ค่า คำอธิบาย
ANTHROPIC_DEFAULT_OPUS_MODEL GLM-4.7 โมเดลหลักสำหรับงานที่ซับซ้อน
ANTHROPIC_DEFAULT_SONNET_MODEL GLM-4.7 โมเดลสำหรับงานทั่วไป
ANTHROPIC_DEFAULT_HAIKU_MODEL GLM-4.5-Air โมเดลสำหรับงานที่ต้องการความเร็ว

วิธีการตั้งค่า

macOS / Linux

สำหรับ Bash (.bashrc)

เปิดไฟล์ .bashrc ในโฮมไดเรกทอรี:

nano ~/.bashrc

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

# GLM Coding Plan Environment Variables
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_API_KEY="your-api-key-here"
export ANTHROPIC_DEFAULT_OPUS_MODEL="GLM-4.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="GLM-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="GLM-4.5-Air"

บันทึกไฟล์และรันคำสั่ง:

source ~/.bashrc

สำหรับ Zsh (.zshrc)

เปิดไฟล์ .zshrc ในโฮมไดเรกทอรี:

nano ~/.zshrc

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

# GLM Coding Plan Environment Variables
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_API_KEY="your-api-key-here"
export ANTHROPIC_DEFAULT_OPUS_MODEL="GLM-4.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="GLM-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="GLM-4.5-Air"

บันทึกไฟล์และรันคำสั่ง:

source ~/.zshrc

Windows

PowerShell

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

# ตั้งค่าสำหรับผู้ใช้ปัจจุบัน (ถาวร)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://open.bigmodel.cn/api/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "GLM-4.7", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "GLM-4.7", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "GLM-4.5-Air", "User")

หรือตั้งค่าชั่วคราว (เฉพาะ session ปัจจุบัน):

$env:ANTHROPIC_BASE_URL = "https://open.bigmodel.cn/api/anthropic"
$env:ANTHROPIC_API_KEY = "your-api-key-here"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "GLM-4.7"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "GLM-4.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "GLM-4.5-Air"

Command Prompt (CMD)

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

# ตั้งค่าถาวรสำหรับผู้ใช้ปัจจุบัน
setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
setx ANTHROPIC_API_KEY "your-api-key-here"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "GLM-4.7"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "GLM-4.7"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "GLM-4.5-Air"

หมายเหตุ: หลังจากรันคำสั่ง setx แล้ว คุณต้องปิดและเปิด CMD ใหม่เพื่อให้การตั้งค่ามีผล

การตรวจสอบการตั้งค่า

macOS / Linux

# ตรวจสอบตัวแปรทั้งหมด
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_DEFAULT_OPUS_MODEL
echo $ANTHROPIC_DEFAULT_SONNET_MODEL
echo $ANTHROPIC_DEFAULT_HAIKU_MODEL

# หรือตรวจสอบทีละครั้ง
env | grep ANTHROPIC

Windows PowerShell

# ตรวจสอบตัวแปรทั้งหมด
$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_API_KEY
$env:ANTHROPIC_DEFAULT_OPUS_MODEL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL

# หรือตรวจสอบทีละครั้ง
Get-ChildItem Env: | Where-Object { $_.Name -like "*ANTHROPIC*" }

Windows CMD

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_DEFAULT_OPUS_MODEL%
echo %ANTHROPIC_DEFAULT_SONNET_MODEL%
echo %ANTHROPIC_DEFAULT_HAIKU_MODEL%

แนวทางปฏิบัติด้านความปลอดภัย (Security Best Practices)

1. อย่า Commit API Keys ลงใน Git

อย่าเก็บ API keys ในไฟล์ที่จะถูก commit ลงใน repository:

# เพิ่มใน .gitignore
.env
.env.local
*.key
secrets.*

2. ใช้ไฟล์ .env สำหรับการพัฒนา

สร้างไฟล์ .env ในโปรเจค:

# .env
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_API_KEY=your-api-key-here
ANTHROPIC_DEFAULT_OPUS_MODEL=GLM-4.7
ANTHROPIC_DEFAULT_SONNET_MODEL=GLM-4.7
ANTHROPIC_DEFAULT_HAIKU_MODEL=GLM-4.5-Air

3. ใช้ Environment Variables แยกต่างหากสำหรับแต่ละ Environment

  • Development: ใช้ .env.development
  • Production: ใช้ .env.production
  • Testing: ใช้ .env.test

4. หมุนเวียน API Keys เป็นประจำ

เปลี่ยน API keys ของคุณเป็นประจำ โดยเฉพาะเมื่อ:

  • มีผู้ลาออกจากทีม
  • สงสัยว่า key รั่วไหล
  • ทำการ deploy ครั้งใหญ่

5. จำกัดสิทธิ์การเข้าถึง API Key

  • เก็บ API key เฉพาะในระบบที่จำเป็นต้องใช้
  • ใช้ secrets management tool เช่น:
  • AWS Secrets Manager
  • Azure Key Vault
  • HashiCorp Vault
  • GitHub Secrets (สำหรับ CI/CD)

6. ตรวจสอบการใช้งาน API

ตรวจสอบ logs และ usage reports เป็นประจำเพื่อตรวจจับการใช้งานที่ผิดปกติ

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

API Key ไม่ถูกต้อง

Error: Invalid API Key

วิธีแก้ไข:

  1. ตรวจสอบว่า API key ถูกคัดลอกถูกต้อง
  2. ตรวจสอบว่าไม่มีช่องว่างหรืออักขระพิเศษเกินมา
  3. ตรวจสอบว่า API key ยังไม่หมดอายุ

ไม่สามารถเชื่อมต่อกับ API

Error: Connection refused / Timeout

วิธีแก้ไข:

  1. ตรวจสอบการเชื่อมต่ออินเทอร์เน็ต
  2. ตรวจสอบว่า ANTHROPIC_BASE_URL ถูกต้อง
  3. ตรวจสอบ firewall หรือ proxy settings

โมเดลไม่รองรับ

Error: Model not found

วิธีแก้ไข:

  1. ตรวจสอบว่าชื่อโมเดลถูกต้อง
  2. ตรวจสอบว่าโมเดลพร้อมใช้งานในบัญชีของคุณ

ข้อมูลเพิ่มเติม

หากมีคำถามหรือปัญหาเพิ่มเติม กรุณาติดต่อทีมสนับสนุนหรือดูเอกสารเพิ่มเติมที่ z.ai