การแก้ปัญหา Claude Code
จุดสำคัญของการแก้ปัญหา Claude Code คือการตรวจสอบว่าได้รับค่าการกำหนดค่า Claude / Anthropic ถูกต้องหรือไม่ อย่าใส่ที่อยู่ OpenAI-compatible, ชื่อโมเดล Codex หรือ Gemini Key ปะปนเข้ามาใน Claude Code
สิ่งที่ควรตรวจสอบเป็นอันดับแรกคืออะไร?
| รายการตรวจสอบ | วิธีดู | เหตุผล |
|---|---|---|
| เครื่องมือเป้าหมาย | ตรวจสอบให้แน่ใจว่าคุณกำลังแก้ปัญหา Claude Code ไม่ใช่ Codex หรือ Gemini CLI | ไฟล์การกำหนดค่า โปรโตคอล และชื่อโมเดลของแต่ละเครื่องมือนั้นแตกต่างกัน |
| ข้อตกลงของ Provider | มีการระบุ Claude, Anthropic และ Claude Code ไว้อย่างชัดเจนในแดชบอร์ดหลังบ้านหรือคู่มือ | Provider ที่ให้บริการเฉพาะอินเทอร์เฟซ OpenAI-compatible อาจไม่รองรับ Claude Code เสมอไป |
| ประเภท Key | ใช้ Key ที่ตรงกับ Claude / Anthropic | หากประเภทของ Key ไม่ถูกต้อง จะส่งผลให้เกิดข้อผิดพลาด 401 หรือการยืนยันตัวตนล้มเหลวทันที |
| สถานะ Terminal | หลังจากสลับการกำหนดค่าแล้ว ให้ปิดแล้วเปิด Terminal ใหม่อีกครั้งเพื่อทดสอบ | Terminal เดิมอาจยังคงใช้ตัวแปรสภาพแวดล้อมหรือการกำหนดค่าจากก่อนที่จะสลับ |
ข้อผิดพลาดที่พบบ่อย
| อาการ | ลำดับความสำคัญในการตรวจสอบ | วิธีแก้ไข |
|---|---|---|
| เรียกใช้คำสั่งได้ แต่คำขอล้มเหลว | Claude Code ได้รับการกำหนดค่าใหม่แล้วหรือไม่ | ปิดหน้าต่าง Terminal ปัจจุบันแล้วเปิดใหม่ จากนั้นส่งคำถามทดสอบที่สั้นที่สุด หลังจากสลับผ่าน CC-Switch แล้ว อย่าแก้ไขการกำหนดค่าเดียวกันด้วยตนเองในเวลาเดียวกัน |
| 401 / Unauthorized | ประเภทและความสมบูรณ์ของ Key | ตรวจสอบให้แน่ใจว่าคุณใช้ Key ที่ตรงกับ Claude / Anthropic อย่ากรอก Key แบบ OpenAI-compatible ลงใน Claude Code และตรวจสอบช่องว่างหน้า-หลังเมื่อคัดลอกอีกครั้ง |
| 404 / model not found | ชื่อโมเดล Claude | กรอกชื่อโมเดล Claude ให้ตรงกับที่ระบุไว้ในแดชบอร์ดหลังบ้านของ Provider ทุกประการ อย่าเปลี่ยนตัวพิมพ์เล็ก-ใหญ่ เครื่องหมายขีดกลาง หรือหมายเลขเวอร์ชัน |
| Connection timeout หรือไม่มีการตอบสนอง | Base URL ของ Claude | ตรวจสอบที่อยู่ API ของ Claude / Anthropic ในแดชบอร์ดหลังบ้าน Provider ที่ให้เฉพาะที่อยู่ OpenAI-compatible อาจไม่รองรับ Claude Code |
| ยังคงใช้ Provider เดิมหลังจากสลับแล้ว | เซสชัน Terminal และแหล่งที่มาของการกำหนดค่า | เปิด Terminal ใหม่อีกครั้งแล้วทดสอบ หากยังคงไม่มีผล ให้ยืนยันว่า Provider ปัจจุบันใน CC-Switch ถูกนำไปใช้กับ Claude Code แล้ว |
การทดสอบขั้นต่ำ
เมื่อทดสอบ ให้ส่งคำถามสั้นๆ แบบคงที่ก่อนเพื่อยืนยันว่าสามารถตอบกลับได้ จากนั้นจึงค่อยดำเนินการกับโปรเจกต์จริง
การทดสอบขั้นต่ำของ Claude Code
claude "Please reply only: Claude Code configuration test successful"เทมเพลตสำหรับส่งฟีดแบ็ก
เมื่อส่งฟีดแบ็กไปยัง Provider ให้เขียนแบบนี้
Tool: Claude Code System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened