Akademia · Narzędzia agentowe

Gemini CLI — model Google w terminalu.

Open-source narzędzie wiersza poleceń, które przenosi modele Gemini wprost do terminala: do 1M tokenów kontekstu, wbudowane wyszukiwanie Google i obsługa Model Context Protocol. Poniżej instalacja, autoryzacja i komendy, których używamy na co dzień.

Ostatnia aktualizacja:

1M tokenówkontekstu w modelu Gemini
Darmowy startonboarding indywidualny przez Antigravity CLI
MCP i shellrozszerzasz o własne narzędzia

Aktualizacja: 18.06.2026 Gemini CLI przestał obsługiwać użytkowników indywidualnych (darmowych) oraz plany Google AI Pro i Ultra. Następcą dla tych odbiorców jest Antigravity CLI (napisany w Go, binarka agy) — instalujesz go jedną komendą: curl -fsSL https://antigravity.google/cli/install.sh | bash (na Windows odpowiednikiem jest skrypt PowerShell). Dostęp do Gemini CLI zachowują konta Code Assist Standard/Enterprise oraz płatne klucze API.

01 / Wprowadzenie · Czym jest

Asystent AI od Google bez wychodzenia z terminala.

Gemini CLI to open-source narzędzie wiersza poleceń, które daje dostęp do modeli Gemini bezpośrednio w terminalu. Oferuje do 1M tokenów kontekstu, wbudowane narzędzia (m.in. wyszukiwarkę Google) oraz obsługę Model Context Protocol (MCP). Sprawdza się u osób, które pracują głównie w terminalu i chcą szybkiego dostępu do AI bez przełączania się między aplikacjami.

  • Tryb Auto (domyślny) — CLI samo dobiera model z rodziny Gemini 3 lub 2.5 zależnie od złożoności zadania. Flagowy model to Gemini 3 Pro; Gemini 2.5 Pro pozostaje dostępnym wariantem (1M tokenów kontekstu).
  • Google Search — wbudowana integracja z wyszukiwarką.
  • MCP — rozszerzanie o własne narzędzia i serwery.
  • Szybkie odpowiedzi — interaktywny tryb czatu wprost z terminala.

Szybki start: zainstaluj Node.js 20+, uruchom npm install -g @google/gemini-cli, a następnie polecenie gemini i zaloguj się kontem Google.

02 / Instalacja · Windows, Linux, macOS

Node.js 20+, a potem jedna komenda npm.

Wymagania systemowe

  • Node.js 20+ — wymagana nowsza wersja, starsze nie zadziałają.
  • npm lub npx (instalowane razem z Node.js).
  • System: Windows 10 (21H2+), Windows 11, macOS lub Linux.
  • Konto Google (darmowe) albo klucz API Gemini.

1. Instalacja Node.js

Windows: pobierz wersję LTS (20+ lub 22 LTS) ze strony nodejs.org/en/download. Jeśli używasz menedżera wersji (nvm-windows):

nvm install 22.11.0
nvm use 22.11.0

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

macOS (Homebrew):

brew install node

Po instalacji zweryfikuj wersję:

node --version

2. Instalacja Gemini CLI

npm install -g @google/gemini-cli

Po instalacji komenda gemini działa z dowolnego miejsca w systemie. Możesz też uruchomić CLI jednorazowo bez instalacji:

npx https://github.com/google-gemini/gemini-cli

Na macOS/Linux dostępny jest też Homebrew: brew install gemini-cli. Kanały wydań: @latest (stabilny), @preview (nowe funkcje), @nightly (build z gałęzi main).

03 / Autoryzacja · Pierwsze uruchomienie

Logowanie kontem Google albo klucz API.

Najprostsza metoda to przeglądarkowy OAuth. Po uruchomieniu gemini wybierz „Login with Google", zaloguj się i potwierdź uprawnienia dla Gemini CLI — gotowe.

  1. Uruchom gemini i wybierz „Login with Google".
  2. Otworzy się przeglądarka — zaloguj się kontem Google.
  3. Potwierdź uprawnienia dla Gemini CLI.
  4. (Code Assist) ustaw zmienną: export GOOGLE_CLOUD_PROJECT="twoj-projekt".

Darmowe limity: dla użytkowników indywidualnych darmowy dostęp przez konto Google zakończył się 18.06.2026 — limity 60 zapytań na minutę i 1000 dziennie nie obowiązują już osób prywatnych. Zostają one dla kont Code Assist Standard/Enterprise oraz płatnych kluczy API. Darmowy onboarding indywidualny przeniósł się do Antigravity CLI. Vertex AI zależy od projektu i konta rozliczeniowego.

Alternatywa: klucz Gemini API

Daje pełną kontrolę nad modelem i rozliczeniami. Klucz pobierzesz z Google AI Studio:

export GEMINI_API_KEY="XXXX"
gemini

Alternatywa: Vertex AI

Scenariusz enterprise z pełnym nadzorem GCP — limity i ceny wynikają z konta rozliczeniowego w Google Cloud:

export GOOGLE_API_KEY="XXXX"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

Izolacja: flaga --sandbox uruchamia narzędzia w izolowanym środowisku — przydatne, gdy nie chcesz, by agent działał wprost na systemie hosta.

04 / Komendy · Slash, kontekst, shell

Slash, znak małpy i wykrzyknik — trzy tryby pracy.

Komendy slash (/)

Zarządzają sesją CLI. Najważniejsze:

KomendaDziałanie
/initGeneruje GEMINI.md — plik konfiguracyjny projektu.
/helpPomoc i lista dostępnych komend.
/toolsLista dostępnych narzędzi CLI.
/mcpLista serwerów Model Context Protocol.
/memoryZarządzanie kontekstem z GEMINI.md.
/chat saveZapis i wznowienie konwersacji.
/compressKompresja kontekstu (oszczędność tokenów).
/copyKopiuje ostatnią odpowiedź do schowka.
/restorePrzywraca stan plików sprzed edycji.
/statsWykres tokenów i limitów sesji.
/authPrzełączanie metod logowania (OAuth / klucz API / Vertex).
/vimTryb vim w polu input.
/clearCzyści ekran i kontekst (alias Ctrl+L).
/quitWyjście z Gemini CLI.

Kontekst plików (znak małpy)

Dołączaj pliki i katalogi do kontekstu znakiem małpy:

@./src/main.js      # pojedynczy plik
@./image.png        # obrazek do analizy
@./src/            # cały katalog rekurencyjnie
  • CLI respektuje .gitignore i GEMINI_IGNORE — np. node_modules/ nie trafi do kontekstu.
  • Ścieżki ze spacjami: @"My Folder/file.ts" albo escaping ukośnikiem.
  • Wielkie katalogi i pliki binarne mogą zostać pominięte — CLI pokaże listę pominiętych plików.

Tryb shell (wykrzyknik)

Wykonuj komendy systemowe wprost z Gemini CLI:

!git status         # pojedyncza komenda shell
!                   # wejście w tryb shell (! ponownie aby wyjść)

Bezpieczeństwo: komendy z trybu shell działają z takimi samymi uprawnieniami jak Twój terminal (bash na macOS/Linux, PowerShell na Windows). CLI ustawia zmienną GEMINI_CLI=1, więc skrypty mogą wykryć uruchomienie z Gemini.

Skróty klawiszowe

  • Ctrl+L — wyczyść ekran · Ctrl+V — wklej tekst lub obrazek.
  • Ctrl+Y — YOLO mode (auto-zatwierdzanie) · Ctrl+X — otwórz edytor zewnętrzny.
  • Ctrl+C / Ctrl+D — anuluj zapytanie lub wyjdź (dwuklik).
  • Shift+Tab — auto-accept edycji narzędzi · F12 — konsola debug (przydatne przy MCP).

05 / MCP · Kontrola przeglądarki

ChromeDevTools MCP — agent steruje przeglądarką.

Model Context Protocol to otwarty standard stworzony przez Anthropic, który pozwala agentom AI na bezpieczną integrację z narzędziami zewnętrznymi. ChromeDevTools MCP daje Gemini pełną kontrolę przeglądarki Chrome — nawigację po stronach, wypełnianie formularzy, testowanie UI, screenshoty, debugowanie i wykonywanie JavaScript.

Instalacja dla bieżącego projektu

gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest

Instalacja globalna (wszystkie projekty)

gemini mcp add -s user chrome-devtools npx chrome-devtools-mcp@latest

Konfiguracja globalna zapisuje się w ~/.gemini/settings.json. Po instalacji możesz dawać komendy w języku naturalnym, np.:

Otworz localhost:3000, sprawdz czy sa bledy w konsoli i pokaz mi je

Podgląd: komenda /mcp pokazuje listę zainstalowanych serwerów MCP, a /tools — wszystkie dostępne narzędzia (łącznie z MCP). Pełną listę serwerów MCP znajdziesz na github.com/modelcontextprotocol/servers.

Wdrożenie u Was

Chcecie tak pracować całym zespołem?

Akademia to materiały. Wdrożenie to dwa kwartały na Waszym kodzie — z pomiarem efektu w DEVLens. 30 minut wystarczy, żeby sprawdzić, czy ma to u Was sens.