คู่มือการตั้งค่า

คู่มือการตั้งค่าผู้ให้บริการ

ดูขั้นตอนการตั้งค่าและการแก้ปัญหาตามเครื่องมือ

การแก้ไขปัญหา Gemini

อินเทอร์เฟซที่เข้ากันได้กับ OpenAI และ Gemini ไม่ใช่สิ่งเดียวกัน ให้กำหนดค่าตาม Gemini เฉพาะเมื่อผู้ให้บริการระบุไว้อย่างชัดเจนว่ารองรับอินเทอร์เฟซที่เกี่ยวข้องกับ Gemini / Google / Vertex หรือคู่มือระบุอย่างชัดเจนว่ารองรับ Gemini CLI

สิ่งที่ควรตรวจสอบก่อนเป็นอันดับแรกคืออะไร?

รายการตรวจสอบวิธีดูเหตุผล
เครื่องมือเป้าหมายยืนยันว่าคุณกำลังแก้ไขปัญหาสำหรับ Gemini CLIวิธีการยืนยันตัวตนสำหรับ Gemini CLI แตกต่างจาก Codex และ Claude Code
ผู้ให้บริการรองรับ Gemini หรือไม่มีรายการที่เกี่ยวข้องกับ Gemini / Google / Vertex ในแดชบอร์ดหรือคู่มืออินเทอร์เฟซที่เข้ากันได้กับ OpenAI ไม่เหมือนกับอินเทอร์เฟซของ Gemini
ประเภทของ Keyใช้ Key ที่สอดคล้องกับ Gemini หรือ Vertexหากประเภทของ Key ไม่ถูกต้อง คุณอาจพบข้อผิดพลาด 401, 403 หรือถูกขอให้เข้าสู่ระบบซ้ำๆ
ชื่อโมเดลกรอกตามรายชื่อโมเดลของ Geminiอย่าใส่ชื่อโมเดลของ OpenAI หรือ Claude ใน Gemini

ข้อผิดพลาดทั่วไป

อาการที่พบสิ่งที่ต้องตรวจสอบก่อนวิธีแก้ไข
ยังคงแจ้งเตือนให้เข้าสู่ระบบ Googleการยืนยันตัวตนของ Gemini CLI เองทำการยืนยันตัวตนตามที่ Gemini CLI แจ้งเตือนให้เสร็จสิ้นก่อน การกำหนดค่าของผู้ให้บริการไม่สามารถแทนที่กระบวนการเข้าสู่ระบบที่เครื่องมือเป้าหมายต้องการได้
401 / 403Gemini Key หรือสิทธิ์การใช้งานยืนยันว่า Key อยู่ในกลุ่ม Gemini / Google / Vertex และโปรเจกต์หรือบัญชีปัจจุบันมีสิทธิ์เข้าถึงโมเดลที่เกี่ยวข้อง
404 / ไม่พบโมเดล (model not found)ชื่อโมเดล Geminiกรอกตามรายชื่อโมเดล Gemini ในระบบแดชบอร์ดของผู้ให้บริการ อย่าใส่ชื่อโมเดลของ OpenAI หรือ Claude
การเชื่อมต่อล้มเหลวGemini Base URLอย่าใส่ Base URL ทั่วไปที่เข้ากันได้กับ OpenAI ใน Gemini ให้กำหนดค่าเฉพาะเมื่อระบบแดชบอร์ดระบุอย่างชัดเจนว่ารองรับ Gemini เท่านั้น
ไม่มีอะไรเปลี่ยนแปลงหลังสลับใน CC-Switchเครื่องมือเป้าหมายและสถานะของเทอร์มินัลยืนยันว่าเป้าหมายของแอปพลิเคชันคือ Gemini CLI จากนั้นกดบันทึก ปิดแล้วเปิดเทอร์มินัลใหม่ แล้วทดสอบอีกครั้ง

การทดสอบแบบง่ายที่สุด (Minimal test)

ขั้นแรก ให้ตรวจสอบว่า Gemini CLI สามารถส่งข้อความสั้นๆ ที่กำหนดกลับมาได้ จากนั้นจึงดำเนินการแก้ไขปัญหางานที่ซับซ้อนยิ่งขึ้นต่อไป

การทดสอบแบบง่ายที่สุดของ Gemini
gemini "Please reply only: Gemini configuration test successful"

เทมเพลตสำหรับส่งฟีดแบ็ก

เมื่อส่งฟีดแบ็กให้ผู้ให้บริการ ให้เขียนตามรูปแบบนี้
Tool: Gemini 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