การตั้งค่า OpenCode

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

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

1. บัญชี z.ai พร้อม GLM Coding Plan

• ต้องมีบัญชี z.ai ที่สมัครสมาชิกแล้ว
• ต้องสมัคร GLM Coding Plan subscription
• สามารถสมัครได้ที่: https://z.ai

2. OpenCode ติดตั้งในระบบ

• ดาวน์โหลด OpenCode จากเว็บไซต์ทางการ
• รองรับ Windows, macOS และ Linux

3. API Key จาก z.ai

• ต้องได้รับ API Key จาก z.ai dashboard
• API Key จะใช้ในการยืนยันตัวตนกับ GLM API

การดาวน์โหลดและติดตั้ง

ดาวน์โหลดจากเว็บไซต์ทางการ

URL ดาวน์โหลด: https://opencode.ai (หรือตรวจสอบ URL ทางการล่าสุด)

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

# ติดตั้งผ่าน Homebrew (แนะนำ)
brew install opencode

# หรือดาวน์โหลดไฟล์ .dmg จากเว็บไซต์
# จากนั้นลาก OpenCode ไปใส่ใน Applications folder

การติดตั้งบน Windows

# ติดตั้งผ่าน winget
winget install OpenCode

# หรือดาวน์โหลดไฟล์ .exe จากเว็บไซต์
# จากนั้นรันตัวติดตั้งและทำตามขั้นตอน

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

# ติดตั้งผ่าน Snap
sudo snap install opencode

# หรือติดตั้งผ่าน AUR (Arch Linux)
yay -S opencode

# หรือดาวน์โหลดไฟล์ .AppImage
chmod +x opencode.AppImage
./opencode.AppImage

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

หลังติดตั้งเสร็จสิ้น ตรวจสอบว่า OpenCode พร้อมใช้งาน:

opencode --version

การตั้งค่า Configuration

API Endpoint

OpenCode จะเชื่อมต่อกับ GLM API ผ่าน endpoint ที่รองรับ Anthropic-compatible format:

https://open.bigmodel.cn/api/anthropic

API Key Setup

API Key สามารถรับได้จาก z.ai Dashboard:

การตั้งค่าผ่าน Environment Variable

# เพิ่มใน ~/.bashrc หรือ ~/.zshrc
export OPENCODE_API_KEY="your-api-key-here"
export OPENCODE_API_ENDPOINT="https://open.bigmodel.cn/api/anthropic"

การตั้งค่าผ่าน Configuration File

สร้างไฟล์ configuration ที่ ~/.config/opencode/config.json:

{
  "api": {
    "endpoint": "https://open.bigmodel.cn/api/anthropic",
    "key": "your-api-key-here"
  },
  "model": {
    "default": "glm-4-plus",
    "fallback": "glm-4-flash"
  },
  "settings": {
    "maxTokens": 4096,
    "temperature": 0.7
  }
}

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

คู่มือการตั้งค่าทีละขั้นตอน

# macOS
brew install opencode

# Windows
winget install OpenCode

# Linux
sudo snap install opencode

# เปิด OpenCode จาก command line
opencode

# หรือเปิดจาก Applications menu

https://open.bigmodel.cn/api/anthropic

# หรือตั้งค่าผ่าน command line
opencode config set api.key "your-api-key-here"
opencode config set api.endpoint "https://open.bigmodel.cn/api/anthropic"

# ตั้งค่าโมเดลผ่าน command line
opencode config set model.default "glm-4-plus"

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

# หรือส่งคำถามทดสอบ
opencode ask "Hello, can you help me write a function to calculate factorial?"

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

คำสั่งพื้นฐาน

# เริ่มต้น OpenCode ในโปรเจคปัจจุบัน
opencode init

# ถามคำถามง่ายๆ
opencode ask "How do I reverse a string in Python?"

# ขอให้ AI อธิบายโค้ด
opencode explain path/to/file.py

# ขอให้ AI refactor โค้ด
opencode refactor path/to/file.py

# ขอให้ AI เขียน tests
opencode test path/to/file.py

การใช้งานกับโปรเจคจริง

# เข้าไปในโฟลเดอร์โปรเจค
cd /path/to/your/project

# เริ่ม OpenCode
opencode

# ใน OpenCode session:
# User: วิเคราะห์โครงสร้างโปรเจคนี้ให้หน่อย
# AI: [วิเคราะห์โครงสร้างโปรเจค...]

# User: ช่วยเขียน function สำหรับ validate email
# AI: [เขียนโค้ดให้...]

# User: มี bugs อะไรที่น่าจะเกิดขึ้นในโค้ดนี้บ้าง?
# AI: [วิเคราะห์และแนะนำ...]

ตัวอย่างการเขียนโค้ดร่วมกับ AI

# ขอให้ AI เขียน API endpoint
opencode ask "Create a REST API endpoint for user authentication using Express.js with JWT tokens"

# ขอให้ AI เพิ่ม error handling
opencode ask "Add comprehensive error handling to this code: $(cat server.js)"

# ขอให้ AI เขียน documentation
opencode doc generate path/to/module.js

การใช้งาน Keyboard Shortcuts

ตัวอย่างโค้ดที่ AI สร้างให้

# ตัวอย่าง: ขอให้ AI เขียน function คำนวณ factorial

def factorial(n: int) -> int:
    """
    คำนวณ factorial ของจำนวนเต็มบวก

    Args:
        n: จำนวนเต็มบวกที่ต้องการคำนวณ factorial

    Returns:
        factorial ของ n

    Raises:
        ValueError: ถ้า n เป็นค่าลบ
    """
    if n < 0:
        raise ValueError("Factorial is not defined for negative numbers")
    if n <= 1:
        return 1
    return n * factorial(n - 1)


# ตัวอย่างการใช้งาน
if __name__ == "__main__":
    print(factorial(5))  # Output: 120
    print(factorial(10)) # Output: 3628800

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

Error: Invalid API Key
Authentication failed

# 1. ตรวจสอบ API Key format
opencode config get api.key

# 2. ตรวจสอบว่าไม่มีช่องว่าง
# API Key ควรมีลักษณะเช่น: sk-xxxxxxxxxxxxxxxx

# 3. สร้าง API Key ใหม่จาก z.ai Dashboard
# แล้วตั้งค่าใหม่
opencode config set api.key "new-api-key-here"

# 4. ทดสอบการเชื่อมต่อ
opencode test

Error: Connection failed
Unable to reach API endpoint
Timeout error

# 1. ตรวจสอบ API Endpoint
opencode config get api.endpoint
# ควรได้: https://open.bigmodel.cn/api/anthropic

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

# 3. หากใช้ proxy ให้ตั้งค่า
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

# 4. เพิ่ม timeout ใน configuration
opencode config set api.timeout 60000  # 60 seconds

Error: Model not found
Model 'glm-4-plus' is not available

# 1. ตรวจสอบโมเดลที่รองรับ
opencode models list

# 2. ตั้งค่าโมเดลที่ถูกต้อง
opencode config set model.default "glm-4-flash"

# 3. ตรวจสอบ subscription plan
# เข้าไปที่ z.ai Dashboard เพื่อดูโมเดลที่รองรับในแผนของคุณ

Error: Rate limit exceeded
Too many requests

# 1. รอสักครู่แล้วลองใหม่
# Rate limit มักจะ reset หลังจากผ่านไป 1 นาที

# 2. ตั้งค่า retry logic
opencode config set api.retry.enabled true
opencode config set api.retry.maxAttempts 3
opencode config set api.retry.delay 5000  # 5 seconds

# 3. ตรวจสอบ usage ใน Dashboard
# เข้าไปที่ z.ai Dashboard > Usage เพื่อดูการใช้งาน

# 1. ลองใช้โมเดลที่ทรงพลังกว่า
opencode config set model.default "glm-4-plus"

# 2. ปรับ temperature
opencode config set model.temperature 0.3  # ต่ำลง = แม่นยำกว่า
opencode config set model.temperature 0.9  # สูงขึ้น = สร้างสรรค์กว่า

# 3. เพิ่ม context ในคำถาม
# แทนที่จะถาม: "เขียน function sort"
# ลองถาม: "เขียน function sort สำหรับ list ของ dictionaries
#          โดยเรียงตาม key 'name' แบบ case-insensitive"

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

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

ลิงก์ที่เป็นประโยชน์

• z.ai Dashboard: https://z.ai/dashboard
• GLM API Documentation: https://open.bigmodel.cn/dev/api
• OpenCode Documentation: https://opencode.ai/docs
• Support: https://z.ai/support

การติดต่อฝ่ายสนับสนุน

หากพบปัญหาที่ไม่สามารถแก้ไขได้จากคู่มือนี้:

• ส่ง email ไปที่: support@z.ai
• หรือใช้ live chat ที่ z.ai Dashboard
• แนบข้อมูลดังนี้:
  • Error message ที่แสดง
  • Screenshot ของปัญหา
  • OpenCode version (opencode --version)
  • OS และ version