CC-Switch Gemini
หน้านี้จะอธิบายเกี่ยวกับการนำ Provider ที่เกี่ยวข้องกับ Gemini ไปใช้งานกับ Gemini CLI ผ่าน CC Switch เนื่องจากอินเทอร์เฟซและวิธีการยืนยันตัวตนของ Gemini แตกต่างจากอินเทอร์เฟซที่รองรับ OpenAI คุณจึงไม่สามารถนำ Base URL ทั่วไปของ OpenAI มากรอกแล้วใช้งานกับ Gemini ได้โดยตรง
ข้อมูลอย่างเป็นทางการ การดาวน์โหลดและเอกสารคู่มือให้อิงตามเว็บไซต์ทางการเป็นหลัก
สิ่งที่หน้านี้จะอธิบาย
แนะนำให้กำหนดค่า Gemini ใน CC Switch เฉพาะเมื่อ Provider มีอินเทอร์เฟซที่เกี่ยวข้องกับ Gemini / Google / Vertex อย่างชัดเจน หรือมีเอกสารที่ระบุอย่างชัดเจนว่ารองรับ Gemini CLI เท่านั้น
สิ่งที่ต้องตรวจสอบก่อนเริ่มต้น
| รายการที่ต้องตรวจสอบ | วิธีตรวจสอบ | เหตุผล |
|---|---|---|
| Gemini CLI สามารถเริ่มทำงานได้แล้ว | ขั้นแรก ให้ตรวจสอบก่อนว่าสามารถเปิดใช้งาน Gemini CLI บนเครื่องนี้ได้ | CC Switch ทำหน้าที่สลับการกำหนดค่าเท่านั้น |
| Provider รองรับ Gemini | มีรายการที่เกี่ยวข้องกับ Gemini / Google / Vertex ในระบบหลังบ้านหรือคู่มือการใช้งาน | อินเทอร์เฟซที่รองรับ OpenAI นั้นไม่เหมือนกับอินเทอร์เฟซของ Gemini |
| ประเภทของ Key ถูกต้อง | ตรวจสอบให้แน่ใจว่า Key สอดคล้องกับ Gemini หรือ Vertex | หากประเภทของ Key ไม่ถูกต้อง จะทำให้การยืนยันตัวตนล้มเหลว |
| ชื่อโมเดลมาจากรายการของ Gemini | คัดลอกชื่อโมเดล Gemini จากระบบหลังบ้านของ Provider | อย่าใช้ชื่อโมเดลของ Claude หรือ OpenAI ปะปนกัน |
วิธีกรอกข้อมูลในแต่ละช่อง
| การตั้งค่า | วิธีกรอก | ข้อควรระวังสำหรับมือใหม่ |
|---|---|---|
| Provider Name | ระบุวัตถุประสงค์ให้ชัดเจน | เช่น 'Gemini provider' หรือ 'Google Gemini' |
| Target Tool / Preset | เลือก Preset ที่เกี่ยวข้องกับ Gemini หรือ Google / Vertex | อย่าเลือก Preset ที่เข้ากันได้กับ OpenAI |
| Base URL | คัดลอกที่อยู่อินเทอร์เฟซที่ตรงกับ Gemini | หากระบบหลังบ้านให้มาเพียงที่อยู่ของ OpenAI อย่าเพิ่งฝืนกรอกลงไป |
| API Key | คัดลอก Key ที่ตรงกับ Gemini / Vertex | ประเภทของ Key จะต้องตรงกันกับ Base URL |
| Model Name | คัดลอกรายการโมเดลของ Gemini | ชื่อโมเดลมักจะแตกต่างจาก OpenAI และ Claude |
นำไปใช้กับ Gemini
- เปิด CC Switch แล้วไปที่ส่วนจัดการ Provider
- เพิ่ม Gemini Provider ใหม่ หรือเลือก Gemini Provider ที่กำหนดค่าไว้แล้ว
- เลือก Preset ที่เกี่ยวข้องกับ Gemini CLI เป็นเครื่องมือเป้าหมาย
- กรอก Base URL, API Key และชื่อโมเดลที่ตรงกับ Gemini
- หลังจากบันทึกแล้ว ให้กด Apply / Switch
- เปิดเทอร์มินัลใหม่อีกครั้ง จากนั้นทำการทดสอบเบื้องต้นโดยใช้ Gemini CLI
ทดสอบว่าใช้งานได้หรือไม่
สาเหตุที่พบบ่อยที่สุดที่ทำให้การกำหนดค่า Gemini ล้มเหลว คือการกรอกที่อยู่สำหรับ OpenAI ใน Gemini หรือประเภทของ Key ไม่ตรงกับที่อยู่อินเทอร์เฟซ
การทดสอบ Gemini เบื้องต้น
gemini "Please reply only: CC-Switch Gemini is active" หาก Gemini CLI ยังคงแจ้งให้เข้าสู่ระบบ Google ให้ทำตามคำแนะนำของ Gemini CLI ก่อน โดย CC Switch ทำได้เพียงซิงค์การกำหนดค่าของ Provider ที่รองรับเท่านั้น และไม่สามารถข้ามข้อกำหนดการเข้าสู่ระบบของตัวเครื่องมือเป้าหมายได้
