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

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

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

คู่มือการตั้งค่าผู้ให้บริการ/การกำหนดค่า Gemini CLI

การกำหนดค่า Gemini CLI

Gemini CLI คือเครื่องมือ AI บนเทอร์มินัลของ Google เหมาะสำหรับใช้ Gemini ในคอมมานด์ไลน์เพื่อถาม-ตอบ ทำความเข้าใจโค้ด และช่วยเหลือในการทำโปรเจกต์

ข้อมูลอย่างเป็นทางการ การดาวน์โหลดและเอกสารประกอบให้อิงตามเว็บไซต์ทางการเป็นหลัก
เอกสารประกอบอย่างเป็นทางการของ Gemini CLI การติดตั้ง คำสั่ง และการเข้าถึงการกำหนดค่า เอกสารประกอบเกี่ยวกับการยืนยันตัวตน การเข้าสู่ระบบด้วย Google, Gemini API Key และ Vertex AI GitHub คลังโค้ดโอเพนซอร์สและข้อมูลเวอร์ชัน

เครื่องมือนี้คืออะไรและใช้ทำอะไร

Google Geminiเครื่องมือเทอร์มินัลเข้าสู่ระบบด้วย GoogleGemini API Key

เลือกวิธีการยืนยันตัวตนก่อน

วิธีการเหมาะสำหรับใครคำอธิบาย
เข้าสู่ระบบด้วย Googleผู้ใช้ทั่วไปและผู้เริ่มต้นรัน Gemini และเข้าสู่ระบบตามที่ระบบแนะนำ
Gemini API Keyผู้ใช้ที่มีคีย์ Google AI Studio อยู่แล้วนำคีย์ไปใส่ใน GEMINI_API_KEY
Vertex AIผู้ใช้ระดับองค์กรหรือโปรเจกต์ Cloudกำหนดค่าตามโปรเจกต์และสิทธิ์ของ Google Cloud

วิธีทดสอบ API Key

การทดสอบชั่วคราวใน PowerShell
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" gemini

ขั้นตอนต่อไปหลังทดสอบสำเร็จ

  1. ขั้นแรก ให้รัน Gemini CLI ในไดเรกทอรีว่างเปล่า อย่าเพิ่งเปิดโปรเจกต์สำคัญโดยตรง
  2. ถามคำถามสั้นๆ เพียงคำถามเดียวก่อนเพื่อยืนยันว่าโมเดลสามารถตอบกลับได้ตามปกติ
  3. จากนั้นให้โมเดลอ่านไฟล์ทดสอบและระบุให้ชัดเจนว่าห้ามแก้ไขไฟล์ดังกล่าว
  4. หากต้องการใช้ API Key ในระยะยาว ให้บันทึกวิธียืนยันตัวตนลงในสภาพแวดล้อมหรือไฟล์การกำหนดค่าในเครื่องตามเอกสารประกอบทางการของ Gemini CLI
  5. หากมีการเปลี่ยนผู้ให้บริการ relay AI หรือ CC-Switch ให้เปิดเทอร์มินัลใหม่อีกครั้งแล้วทำการทดสอบซ้ำ
อาการที่พบสิ่งที่ควรตรวจสอบเป็นลำดับแรกวิธีจัดการ
ยังคงต้องเข้าสู่ระบบด้วย Googleวิธีการยืนยันตัวตนปัจจุบันเป็นกระบวนการเข้าสู่ระบบด้วย Google หรือไม่?ทำการยืนยันตัวตนให้เสร็จสิ้นก่อนตามคำแนะนำของ Gemini CLI เอง อย่าสับสนระหว่างการแก้ไขปัญหา API Key กับกระบวนการเข้าสู่ระบบ
คีย์ไม่ถูกต้องGEMINI_API_KEY มาจาก Google AI Studio / Gemini หรือไม่?อย่าใส่คีย์ของ OpenAI หรือ Claude ลงใน Gemini
โมเดลไม่พร้อมใช้งานชื่อโมเดลมาจากรายการของ Gemini หรือไม่?อย่าใส่ชื่อโมเดลของ OpenAI / Claude ลงใน Gemini CLI

ข้อควรระวังในการกำหนดค่าผู้ให้บริการ relay AI

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

อย่ากรอก Base URL ทั่วไปของ OpenAI ลงใน Gemini CLI เนื่องจาก OpenAI, Claude และ Gemini ใช้โพรโทคอลที่แตกต่างกัน หากผู้ให้บริการมีที่อยู่แยกต่างหากในระบบหลังบ้าน คุณจะต้องกรอกที่อยู่ที่ตรงกับเครื่องมือนี้เท่านั้น
เอกสารประกอบอย่างเป็นทางการของ Gemini CLI ดูการติดตั้ง คำสั่ง และจุดเริ่มต้นการกำหนดค่า
เอกสารประกอบการยืนยันตัวตนของ Gemini CLI ตรวจสอบการเข้าสู่ระบบด้วย Google, Gemini API Key และ Vertex AI