# การแก้ปัญหา

เริ่มต้นด้วย `/doctor` — มันตรวจสอบเวอร์ชันรันไทม์, ข้อมูลประจำตัวผู้ให้บริการ, ความสมบูรณ์ของการตั้งค่า, สถานะปลั๊กอิน/MCP, และ Sentry telemetry

## ปัญหาเริ่มต้น

### "command not found: clew"

พาธติดตั้ง global npm อาจไม่อยู่ใน `PATH` ใช้ `npx clew-code` หรือ `bun x clew-code` เป็นทางเลือก

### "Bun not found"

Clew ต้องใช้ Bun 1.3+ เป็นรันไทม์สำหรับแพ็กเกจ npm

## ปัญหาผู้ให้บริการ

### "No API key configured"

ตั้งค่าคีย์ API อย่างน้อยหนึ่งรายการเป็นตัวแปรสภาพแวดล้อม ดู ผู้ให้บริการ สำหรับรายการทั้งหมด

    export ANTHROPIC_API_KEY=sk-ant-...
    export DEEPSEEK_API_KEY=sk-...

รัน `/doctor` เพื่อตรวจสอบผู้ให้บริการที่ตั้งค่า

### "Rate limited" หรือ "Quota exceeded"

ตั้งค่าโมเดลสำรองผ่าน CLI: `--fallback-model <model>` หรือใช้ `/model` เพื่อสลับไปยังผู้ให้บริการอื่น

## ปัญหา Build

### ข้อผิดพลาด TypeScript ระหว่าง build

    bun run build
    # ข้อผิดพลาด TypeScript อาจอยู่ในโค้ดที่ยังไม่ได้ commit หรือโมดูลภายนอก
    # รันการตรวจสอบเป้าหมาย:
    bun x tsc --noEmit
    bun test

### ปัญหาเฉพาะ Windows

- ripgrep แถมมาที่ `src/utils/vendor/ripgrep/x64-win32/rg.exe`
- TTY polyfill อาจจำเป็นสำหรับ Ink compatibility
- PowerShell และ Bash อาจทำงานแตกต่างสำหรับการเรียกใช้เครื่องมือ

## ปัญหา MCP

### "MCP server connection failed"

ตรวจสอบว่าคำสั่งเซิร์ฟเวอร์มีอยู่และพาธถูกต้อง ตรวจสอบไวยากรณ์ JSON config ด้วยคำสั่ง `/mcp`

## ปัญหาปลั๊กอิน

### ปลั๊กอินไม่โหลด

ตรวจสอบรูปแบบและตำแหน่ง manifest ของปลั๊กอิน ใช้ `/plugin` และ `/reload-plugins` เพื่อรีเฟรช

## การขอความช่วยเหลือ

- การตรวจสอบในแอป: `/doctor` — ตรวจสอบสภาพแวดล้อมอย่างครอบคลุม
- ภาพรวมสถานะ: `/status` — เวอร์ชัน, โมเดล, การเชื่อมต่อ API
- GitHub Issues: รายงานบั๊กและขอฟีเจอร์
- โหมด Debug: รันด้วย `DEBUG=1` หรือ `DEBUG=provider:anthropic`