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. Od czerwca 2026 to narzędzie dla kluczy API i kont firmowych. Poniżej aktualna autoryzacja, komendy i ścieżka dla kont indywidualnych.
Autor: Tomek Wojciechowski · Ostatnia aktualizacja:
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, z wbudowanymi narzędziami (m.in. wyszukiwarką Google) i 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. Dziś korzystają z niego posiadacze płatnych kluczy API oraz konta Gemini Code Assist Standard/Enterprise; wcześniej wystarczyło darmowe konto Google, ale ten wariant wygasł 18.06.2026, a kontom indywidualnym Google wskazuje następcę: Antigravity CLI (opisujemy go niżej).
- Tryb Auto (domyślny): CLI samo dobiera model Pro albo Flash zależnie od złożoności zadania. Najmocniejszy Pro to dziś Gemini 3.1 Pro (preview), bo Gemini 3 Pro Preview wyłączono 9.03.2026. Wersja 0.62.0 z 29.09.2026 dodała do wyboru Gemini 3.8 Flash i 3.5 Flash-Lite.
- Google Search: wbudowana integracja z wyszukiwarką.
- MCP: rozszerzanie o własne narzędzia i serwery.
- Tryb shell: komendy systemowe wprost z sesji czatu.
Szybki start: mając Node.js (sekcja 02), uruchom npm install -g @google/gemini-cli, ustaw klucz z Google AI Studio w zmiennej GEMINI_API_KEY i odpal polecenie gemini.
Node.js 20+, a potem jedna komenda npm.
Wymagania systemowe
- Node.js 20+: starsze nie zadziałają. Zalecany 22 albo 24, bo Node 20 nie dostaje już poprawek.
- npm lub npx (instalowane razem z Node.js).
- System (zalecany): macOS 15+, Windows 11 24H2+ lub Ubuntu 20.04+, powłoka Bash, Zsh albo PowerShell. RAM: 4 GB na krótkie sesje, 16 GB przy dużych repozytoriach i długim kontekście.
- Autoryzacja: klucz Gemini API albo konto firmowe (szczegóły w sekcji 03).
1. Instalacja Node.js
Windows: pobierz wersję LTS (22 albo 24; Node 20 nie dostaje poprawek od 30.04.2026) 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_22.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 @google/gemini-cli Wariant npx https://github.com/google-gemini/gemini-cli uruchamia kod prosto z gałęzi main. Przydaje się do testowania funkcji w trakcie rozwoju, nie do codziennej pracy.
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).
Klucz API, Vertex AI albo konto Code Assist.
Klucz Gemini API: podstawowa ścieżka
Daje pełną kontrolę nad modelem i rozliczeniami. Klucz pobierzesz z Google AI Studio:
export GEMINI_API_KEY="XXXX"
gemini 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 Gemini Code Assist Standard/Enterprise
Subskrybenci logują się bez zmian przez przeglądarkowy OAuth: uruchom gemini, wybierz „Login with Google”, potwierdź uprawnienia i wskaż projekt zmienną export GOOGLE_CLOUD_PROJECT="twoj-projekt". Metodę logowania przełączysz w każdej chwili komendą /auth.
Izolacja: flaga --sandbox uruchamia narzędzia w izolowanym środowisku — przydatne, gdy nie chcesz, by agent działał wprost na systemie hosta.
Konto indywidualne? Dla Ciebie jest sekcja 04: instalacja Antigravity CLI jedną komendą, logowanie i import dotychczasowej konfiguracji z Gemini CLI.
Binarka agy: następca dla planów indywidualnych.
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, bez zależności od Node.js i npm. Binarka nazywa się agy. Instalator sprawdza jej sumę kontrolną SHA512, a później CLI aktualizuje się samo w tle.
Instalacja
Linux i macOS (binarka trafia do ~/.local/bin/agy):
curl -fsSL https://antigravity.google/cli/install.sh | bash Windows (PowerShell):
irm https://antigravity.google/cli/install.ps1 | iex Pierwsze uruchomienie
Kreator przy pierwszym starcie agy pyta o trzy rzeczy: motyw terminala, metodę logowania i (najważniejsze) opcjonalny import konfiguracji z Gemini CLI, więc nie zaczynasz od zera. Logowanie odbywa się przez przeglądarkę, a sesja zapisuje się w systemowym pęku kluczy; przy pracy po SSH narzędzie wypisuje adres autoryzacyjny. Otwierasz go w przeglądarce i wklejasz kod z powrotem do terminala. Wylogowanie i wyczyszczenie zapisanych profili: komenda /logout.
Co przenosisz z Gemini CLI
Pliki GEMINI.md i AGENTS.md działają bez zmian, łącznie z globalnym ~/.gemini/GEMINI.md. Serwery MCP nie siedzą już w ~/.gemini/settings.json, tylko w osobnym ~/.gemini/config/mcp_config.json (dla projektu: .agents/mcp_config.json). Przy ręcznej migracji serwerów zdalnych klucze url i httpUrl zamieniasz na serverUrl. Rozszerzenia przerobisz na pluginy komendą agy plugin import gemini. Skille projektu trzeba przenieść ręcznie, z .gemini/skills/ do .agents/skills/, inaczej agent ich nie zobaczy.
Limity: zamiast dziennego licznika zapytań Antigravity liczy pulę obliczeniową. Na planie darmowym odnawia się ona raz w tygodniu, w Google AI Pro i Ultra co pięć godzin, ale tylko do tygodniowego limitu. Przy intensywnej pracy agentowej potrafi się skończyć przed końcem tygodnia. Wtedy zostaje klucz Gemini API: agy przyjmie go po ustawieniu "modelProvider": "gemini" w ~/.gemini/antigravity-cli/settings.json i wyeksportowaniu GEMINI_API_KEY, a płatny klucz nadal działa też w Gemini CLI.
Slash, znak małpy i wykrzyknik: trzy tryby pracy.
Komendy slash (/)
Zarządzają sesją CLI. Najważniejsze:
| Komenda | Działanie |
|---|---|
/init | Generuje GEMINI.md, plik konfiguracyjny projektu. |
/help | Pomoc i lista dostępnych komend. |
/tools | Lista dostępnych narzędzi CLI. |
/mcp | Lista serwerów Model Context Protocol. |
/memory | Zarządzanie kontekstem z GEMINI.md. |
/resume | Przeglądarka zapisanych sesji (alias /chat). Sesje zapisują się same, a /resume save <tag> tworzy nazwany punkt kontrolny. |
/compress | Kompresja kontekstu (oszczędność tokenów). |
/copy | Kopiuje ostatnią odpowiedź do schowka. |
/restore | Przywraca stan plików sprzed edycji. |
/stats | Wykres tokenów i limitów sesji. |
/auth | Przełączanie metod logowania (OAuth / klucz API / Vertex). |
/vim | Tryb vim w polu input. |
/clear | Czyści kontekst i zaczyna nową sesję. Samo Ctrl+L tylko odświeża ekran, rozmowa zostaje. |
/quit | Wyjś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
.gitignorei plik.geminiignorew katalogu projektu, 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+G: otwórz prompt w edytorze zewnętrznym (dawneCtrl+Xjest przestarzałe).Ctrl+C/Ctrl+D: anuluj zapytanie lub wyjdź (dwuklik).Shift+Tab: przełącza tryby zatwierdzania (domyślny,auto_edit,plan) ·F12: konsola debug (przydatne przy MCP).
ChromeDevTools MCP: agent steruje przeglądarką.
Model Context Protocol pozwala agentom AI bezpiecznie korzystać z zewnętrznych narzędzi i danych. Czym jest i jak działa, rozbieramy w osobnym szkoleniu o serwerach MCP. Tutaj konkret: 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 Albo jako rozszerzenie Gemini CLI, które instaluje serwer MCP razem ze skillami:
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp 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.
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. Krótka rozmowa wystarczy, żeby sprawdzić, czy ma to u Was sens. Odpowiadamy w 24 h.