Przewodnik użytkownika Gemini CLI - Google AI w Twoim terminalu

Gemini CLI to otwartoźródłowe narzędzie AI w wierszu poleceń udostępniane przez Google, które przenosi możliwości Gemini bezpośrednio do Twojego terminala. Oferuje lekki sposób dostępu do Gemini, zapewniając najkrótszą ścieżkę od promptu do modelu. Dzięki konfiguracji proxy możesz korzystać z usług Gemini CLI nawet w środowiskach z ograniczeniami sieciowymi.

Dlaczego warto wybrać Gemini CLI?#

• Potężny Gemini 2.5 Pro: Dostęp do okna kontekstu o rozmiarze 1 miliona tokenów
• Wbudowane narzędzia: Google Search grounding, operacje na plikach, komendy Shell, web scraping
• Rozszerzalność: Obsługa MCP (Model Context Protocol) do niestandardowych integracji
• Terminal-First: Zaprojektowany dla deweloperów pracujących w wierszu poleceń
• Open Source: Licencja Apache 2.0

Instalacja#

Szybka instalacja#

Uruchom natychmiast przez npx (bez instalacji)#

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

Globalna instalacja przez npm#

npm install -g @google/gemini-cli

Instalacja przez Homebrew (macOS/Linux)#

brew install gemini-cli

Wymagania systemowe#

• Node.js w wersji 20 lub wyższej
• macOS, Linux lub Windows

Konfiguracja proxy#

Ustaw zmienne środowiskowe#

Przed użyciem proxy skonfiguruj następujące zmienne środowiskowe:

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

Wskazówka: Dodaj te zmienne środowiskowe do swojego pliku .bashrc, .zshrc lub pliku konfiguracyjnego powłoki, aby były automatycznie ustawiane przy każdym uruchomieniu terminala.

Szybki start#

Podstawowe użycie#

Start w bieżącym katalogu#

gemini

Dołączanie wielu katalogów#

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

Użycie konkretnego modelu#

gemini -m gemini-2.5-flash

Tryb nieinteraktywny (skryptowy)#

Uzyskaj prostą odpowiedź tekstową:

gemini -p "Explain the architecture of this codebase"

Uzyskaj ustrukturyzowany wynik JSON:

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

Szybkie przykłady#

Rozpoczęcie nowego projektu#

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

Analiza istniejącego kodu#

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

Główne funkcje#

Zrozumienie i generowanie kodu#

• Zapytania i edycja dużych baz kodu
• Generowanie nowych aplikacji z plików PDF, obrazów lub szkiców dzięki możliwościom multimodalnym
• Debugowanie problemów i diagnozowanie usterek w języku naturalnym

Automatyzacja i integracja#

• Automatyzacja zadań operacyjnych, takich jak odpytywanie pull requestów czy obsługa złożonych rebase’ów
• Podłączanie nowych możliwości za pomocą serwerów MCP
• Działanie w trybie nieinteraktywnym w skryptach w celu automatyzacji przepływów pracy

Funkcje zaawansowane#

• Pozyskiwanie informacji w czasie rzeczywistym dzięki wbudowanemu Google Search
• Punkty kontrolne konwersacji pozwalające zapisywać i przywracać złożone sesje
• Niestandardowe pliki kontekstu (GEMINI.md) dostosowujące zachowanie do Twojego projektu

Popularne komendy i przykłady#

Eksploracja bazy kodu#

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

Praca z istniejącym kodem#

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

Automatyzacja przepływów pracy#

> 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

Interakcja z systemem#

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

Integracja z GitHub#

Użyj Gemini CLI GitHub Action, aby zintegrować Gemini CLI bezpośrednio z przepływami pracy GitHub:

• Przeglądy pull requestów: Zautomatyzowane code review z kontekstowymi opiniami i sugestiami
• Triage zgłoszeń: Automatyczne etykietowanie i priorytetyzacja zgłoszeń GitHub na podstawie analizy treści
• Pomoc na żądanie: Wspomnij @gemini-cli w zgłoszeniach i pull requestach, aby uzyskać pomoc w debugowaniu, wyjaśnieniach lub delegowaniu zadań
• Niestandardowe przepływy pracy: Budowa zautomatyzowanych, planowanych i wywoływanych na żądanie przepływów pracy dostosowanych do potrzeb Twojego zespołu

Rozwiązywanie problemów#

Jeśli napotkasz problemy podczas użytkowania, rozważ następujące kroki:

1. Sprawdź zmienne środowiskowe#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Sprawdź połączenie sieciowe#

curl -I https://crazyrouter.com/

3. Sprawdź komunikaty o błędach#

Komunikaty o błędach zazwyczaj wskazują problem. Typowe problemy obejmują:

• Nieprawidłowy format klucza API
• Problemy z łącznością sieciową
• Nieprawidłową konfigurację proxy

4. Format proxy SOCKS#

Jeśli używasz proxy SOCKS, upewnij się, że format jest prawidłowy:

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

5. Zgłaszanie błędów#

Użyj wbudowanego polecenia do zgłaszania problemów:

/bug

Wersje wydań#

Preview#

Nowe wersje preview są wydawane w każdy wtorek o 23:59 UTC:

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

Stable#

Nowe wersje stable są wydawane w każdy wtorek o 20:00 UTC:

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

Nightly#

Wersje nightly są wydawane codziennie o 00:00 UTC:

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

Użycie serwera MCP#

Skonfiguruj serwery MCP w ~/.gemini/settings.json, aby rozszerzyć Gemini CLI o niestandardowe narzędzia:

> @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

Cennik przez Crazyrouter#

Uzyskaj dostęp do modeli Gemini po obniżonych stawkach:

Wszystkie ceny zawierają 45% zniżki w porównaniu z oficjalnymi stawkami.

Powiązane zasoby#

• Strona z cennikiem Crazyrouter
• Repozytorium Gemini CLI na GitHub
• Dokumentacja Google AI

Potrzebujesz pomocy? Skontaktuj się z pomocą techniczną lub zajrzyj do dokumentacji Crazyrouter, aby uzyskać więcej informacji.