Gemini CLI пайдаланушы нұсқаулығы - Google AI терминалыңызда

Gemini CLI — Google ұсынатын ашық бастапқы кодты командалық жол AI құралы, ол Gemini мүмкіндіктерін тікелей терминалыңызға әкеледі. Ол Gemini-ге қол жеткізудің жеңілдетілген тәсілін ұсынады және сұраныстан модельге дейінгі ең қысқа жолды қамтамасыз етеді. Proxy баптау арқылы, сіз Gemini CLI қызметтерін желіге шектеу қойылған ортада да пайдалана аласыз.

Неліктен Gemini CLI?#

• Қуатты Gemini 2.5 Pro: 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

npm арқылы глобалды орнату#

npm install -g @google/gemini-cli

Homebrew арқылы орнату (macOS/Linux)#

brew install gemini-cli

Жүйелік талаптар#

• Node.js 20 нұсқасы немесе одан жоғары
• macOS, Linux немесе Windows

Proxy баптау#

Орта айнымалыларын орнату#

Proxy пайдаланбас бұрын келесі орта айнымалыларын баптаңыз:

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/"

Кеңес: Бұл орта айнымалыларын .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

Негізгі мүмкіндіктер#

Кодты түсіну және генерациялау#

• Үлкен код базаларын сұрау және түзету
• Көпмодальды мүмкіндіктер арқылы PDF, суреттер немесе эскиздер негізінде жаңа қосымшалар генерациялау
• Табиғи тіл арқылы қателерді табу және ақауларды жою

Автоматтандыру және интеграция#

• Pull request-терді сұрау немесе күрделі rebase орындау сияқты операциялық тапсырмаларды автоматтандыру
• MCP серверлері арқылы жаңа мүмкіндіктерді қосу
• Жұмыс процестерін автоматтандыру үшін скрипттерде интерактивті емес режимде іске қосу

Кеңейтілген мүмкіндіктер#

• Кіріктірілген Google Search арқылы нақты уақыттағы ақпарат алу
• Күрделі сессияларды сақтау және қалпына келтіру үшін әңгіме чекпоинттері
• Жобаңызға бейімделу үшін арнайы контекст файлдары (GEMINI.md)

Негізгі командалар мен мысалдар#

Код базасын зерттеу#

> 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

Жұмыс процестерін автоматтандыру#

> 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 жұмыс процестеріңізге тікелей біріктіру үшін Gemini CLI GitHub Action қолданыңыз:

• Pull Request Reviews: Контекстке негізделген кері байланыс және ұсыныстармен автоматтандырылған код шолулары
• Issue Triage: Контент талдау негізінде GitHub issue-лерін автоматты түрде таңбалау және басымдық беру
• On-Demand Help: Қателерді түзету, түсіндіру немесе тапсырмаларды делегирлеу бойынша көмек алу үшін issue немесе pull request ішінде @gemini-cli деп атап өтіңіз
• Custom Workflows: Тобыңыздың қажеттіліктеріне бейімделген автоматтандырылған, жоспарланған және сұрау бойынша жұмыс процестерін құру

Ақауларды жою#

Пайдалану кезінде мәселелер туындаса, келесілерді тексеріңіз:

1. Орта айнымалыларын тексеру#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Желі қосылымын тексеру#

curl -I https://crazyrouter.com/

3. Қате хабарламаларын тексеру#

Қате хабарламалары әдетте мәселені көрсетеді. Жиі кездесетін қателер:

• API кілтінің жарамсыз форматы
• Желіге қосылу мәселелері
• Proxy қате бапталған

4. SOCKS proxy форматы#

Егер SOCKS proxy қолдансаңыз, форматтың дұрыстығына көз жеткізіңіз:

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

5. Қателер туралы хабарлау#

Мәселелер туралы хабарлау үшін кіріктірілген команданы пайдаланыңыз:

/bug

Релиз нұсқалары#

Preview#

Жаңа preview-нұсқалар әр сейсенбіде UTC 23:59-де шығарылады:

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

Stable#

Жаңа stable-нұсқалар әр сейсенбіде UTC 20:00-де шығарылады:

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

Nightly#

Nightly-нұсқалар күн сайын UTC 00:00-де шығарылады:

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

MCP серверін пайдалану#

Gemini CLI-ді арнайы құралдармен кеңейту үшін ~/.gemini/settings.json ішінде MCP серверлерін баптаңыз:

> @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 құжаттамасын қараңыз.