คู่มือผู้ใช้ Gemini CLI - Google AI ในเทอร์มินัลของคุณ

Gemini CLI เป็นเครื่องมือ AI แบบบรรทัดคำสั่งโอเพ่นซอร์สจาก Google ที่นำพลังของ Gemini มาสู่เทอร์มินัลของคุณโดยตรง มันเป็นวิธีที่เบาและรวดเร็วในการเข้าถึง Gemini ช่วยให้คุณไปจาก prompt ถึงโมเดลได้โดยตรงที่สุด โดยการตั้งค่า proxy คุณสามารถใช้บริการ Gemini CLI ได้แม้ในสภาพแวดล้อมที่มีข้อจำกัดด้านเครือข่าย

ทำไมต้องเลือก Gemini CLI?#

• Gemini 2.5 Pro ที่ทรงพลัง: ใช้งาน context window ได้สูงสุด 1 ล้านโทเค็น
• เครื่องมือในตัว: Google Search grounding, การจัดการไฟล์, คำสั่ง Shell, การดึงข้อมูลจากเว็บ (web scraping)
• ขยายความสามารถได้: รองรับ MCP (Model Context Protocol) สำหรับการเชื่อมต่อแบบกำหนดเอง
• เน้นเทอร์มินัลเป็นหลัก: ออกแบบมาสำหรับนักพัฒนาที่ทำงานบนบรรทัดคำสั่ง
• โอเพ่นซอร์ส: ใช้สัญญาอนุญาตแบบ Apache 2.0

การติดตั้ง#

การติดตั้งแบบรวดเร็ว#

รันทันทีด้วย npx (ไม่ต้องติดตั้ง)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

ติดตั้งแบบ Global ด้วย npm#

npm install -g @google/gemini-cli

ติดตั้งด้วย Homebrew (macOS/Linux)#

brew install gemini-cli

ข้อกำหนดของระบบ#

• Node.js เวอร์ชัน 20 ขึ้นไป
• macOS, Linux หรือ Windows

การตั้งค่า Proxy#

ตั้งค่า Environment Variables#

ก่อนใช้งาน proxy ให้ตั้งค่า environment variables ต่อไปนี้:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

เคล็ดลับ: เพิ่ม environment variables เหล่านี้ลงใน .bashrc, .zshrc หรือไฟล์ตั้งค่า shell ของคุณ เพื่อให้ถูกตั้งค่าอัตโนมัติทุกครั้งที่เปิดเทอร์มินัล

เริ่มต้นแบบรวดเร็ว#

การใช้งานพื้นฐาน#

เริ่มในไดเรกทอรีปัจจุบัน#

gemini

รวมหลายไดเรกทอรี#

gemini --include-directories ../lib,../docs

ใช้โมเดลที่ระบุ#

gemini -m gemini-2.5-flash

โหมดสคริปต์แบบไม่โต้ตอบ#

ให้ผลลัพธ์เป็นข้อความธรรมดา:

gemini -p "Explain the architecture of this codebase"

ให้ผลลัพธ์แบบ JSON ที่มีโครงสร้าง:

gemini -p "Explain the architecture of this codebase" --output-format json

ตัวอย่างแบบรวดเร็ว#

เริ่มโปรเจกต์ใหม่#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

วิเคราะห์โค้ดที่มีอยู่แล้ว#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

ฟีเจอร์หลัก#

การทำความเข้าใจและการสร้างโค้ด#

• สอบถามและแก้ไข codebase ขนาดใหญ่
• สร้างแอปพลิเคชันใหม่จาก PDF รูปภาพ หรือสเก็ตช์ โดยใช้ความสามารถแบบ multimodal
• ดีบักปัญหาและแก้ไขข้อขัดข้องด้วยภาษาธรรมชาติ

ระบบอัตโนมัติและการเชื่อมต่อ#

• ทำงานปฏิบัติการแบบอัตโนมัติ เช่น การ query pull request หรือจัดการ rebase ที่ซับซ้อน
• เชื่อมต่อความสามารถใหม่ผ่าน MCP servers
• รันแบบไม่โต้ตอบในสคริปต์เพื่อทำ workflow automation

ฟีเจอร์ขั้นสูง#

• รับข้อมูลแบบเรียลไทม์ด้วย Google Search ในตัว
• Conversation checkpoints เพื่อบันทึกและเรียกคืนเซสชันที่ซับซ้อน
• ไฟล์ context แบบกำหนดเอง (GEMINI.md) เพื่อปรับพฤติกรรมให้เหมาะกับโปรเจกต์ของคุณ

คำสั่งและตัวอย่างที่ใช้บ่อย#

สำรวจ Codebase#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

ทำงานกับโค้ดที่มีอยู่แล้ว#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

ทำงานอัตโนมัติใน Workflow#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

การโต้ตอบกับระบบ#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

การเชื่อมต่อกับ GitHub#

ใช้ Gemini CLI GitHub Action เพื่อเชื่อมต่อ Gemini CLI เข้ากับ GitHub workflows ของคุณโดยตรง:

• Pull Request Reviews: รีวิวโค้ดอัตโนมัติพร้อมคำแนะนำและข้อเสนอแนะตามบริบท
• Issue Triage: ติดป้ายและจัดลำดับความสำคัญ GitHub issues โดยอัตโนมัติจากการวิเคราะห์เนื้อหา
• On-Demand Help: พิมพ์ @gemini-cli ใน issues และ pull requests เพื่อขอความช่วยเหลือในการดีบัก อธิบายโค้ด หรือมอบหมายงาน
• Custom Workflows: สร้าง workflow แบบอัตโนมัติ ตามเวลา หรือแบบ on-demand ให้เหมาะกับความต้องการของทีมคุณ

การแก้ปัญหา#

หากคุณพบปัญหาระหว่างการใช้งาน ลองตรวจสอบหัวข้อต่อไปนี้:

1. ตรวจสอบ Environment Variables#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. ตรวจสอบการเชื่อมต่อเครือข่าย#

curl -I https://crazyrouter.com/

3. ตรวจสอบข้อความ Error#

ข้อความ Error มักจะบอกสาเหตุของปัญหา ปัญหาที่พบบ่อย ได้แก่:

• รูปแบบ API key ไม่ถูกต้อง
• ปัญหาการเชื่อมต่อเครือข่าย
• ตั้งค่า proxy ไม่ถูกต้อง

4. รูปแบบ SOCKS Proxy#

หากใช้ SOCKS proxy ให้แน่ใจว่ารูปแบบถูกต้อง:

socks5://<user>:<pass>@<proxy>:<port>

5. รายงานบั๊ก#

ใช้คำสั่งในตัวเพื่อรายงานปัญหา:

/bug

เวอร์ชันที่ปล่อยใช้งาน#

Preview#

เวอร์ชัน preview ใหม่จะปล่อยทุกวันอังคาร เวลา 23:59 ตามเวลา UTC:

npm install -g @google/gemini-cli@preview

Stable#

เวอร์ชัน stable ใหม่จะปล่อยทุกวันอังคาร เวลา 20:00 ตามเวลา UTC:

npm install -g @google/gemini-cli@latest

Nightly#

เวอร์ชัน nightly จะปล่อยทุกวัน เวลา 00:00 ตามเวลา UTC:

npm install -g @google/gemini-cli@nightly

การใช้งาน MCP Server#

ตั้งค่า MCP servers ใน ~/.gemini/settings.json เพื่อขยาย Gemini CLI ด้วยเครื่องมือแบบกำหนดเอง:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

ราคาใช้งานผ่าน Crazyrouter#

เข้าถึงโมเดล Gemini ด้วยราคาส่วนลด:

ราคาทั้งหมดรวมส่วนลด 45% จากราคาอย่างเป็นทางการแล้ว

แหล่งข้อมูลที่เกี่ยวข้อง#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

ต้องการความช่วยเหลือ? ติดต่อฝ่ายสนับสนุนหรือดู เอกสาร Crazyrouter สำหรับข้อมูลเพิ่มเติม