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

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

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

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

  1. เปิด CC Switch แล้วไปที่ส่วนจัดการ Provider
  2. เพิ่ม Gemini Provider ใหม่ หรือเลือก Gemini Provider ที่กำหนดค่าไว้แล้ว
  3. เลือก Preset ที่เกี่ยวข้องกับ Gemini CLI เป็นเครื่องมือเป้าหมาย
  4. กรอก Base URL, API Key และชื่อโมเดลที่ตรงกับ Gemini
  5. หลังจากบันทึกแล้ว ให้กด Apply / Switch
  6. เปิดเทอร์มินัลใหม่อีกครั้ง จากนั้นทำการทดสอบเบื้องต้นโดยใช้ Gemini CLI

ทดสอบว่าใช้งานได้หรือไม่

สาเหตุที่พบบ่อยที่สุดที่ทำให้การกำหนดค่า Gemini ล้มเหลว คือการกรอกที่อยู่สำหรับ OpenAI ใน Gemini หรือประเภทของ Key ไม่ตรงกับที่อยู่อินเทอร์เฟซ

การทดสอบ Gemini เบื้องต้น
gemini "Please reply only: CC-Switch Gemini is active"
หาก Gemini CLI ยังคงแจ้งให้เข้าสู่ระบบ Google ให้ทำตามคำแนะนำของ Gemini CLI ก่อน โดย CC Switch ทำได้เพียงซิงค์การกำหนดค่าของ Provider ที่รองรับเท่านั้น และไม่สามารถข้ามข้อกำหนดการเข้าสู่ระบบของตัวเครื่องมือเป้าหมายได้