การแก้ปัญหา
เริ่มต้นด้วย /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