Akademia · Narzędzia agentowe
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.
Ostatnia aktualizacja:
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).
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.
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.0Linux (Ubuntu/Debian):
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejsmacOS (Homebrew):
brew install nodePo instalacji zweryfikuj wersję:
node --versionnpm install -g @google/gemini-cliPo instalacji komenda gemini działa z dowolnego miejsca w systemie. Możesz też uruchomić CLI jednorazowo bez instalacji:
npx @google/gemini-cliWariant 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).
Daje pełną kontrolę nad modelem i rozliczeniami. Klucz pobierzesz z Google AI Studio:
export GEMINI_API_KEY="XXXX"
geminiScenariusz 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
geminiSubskrybenci 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.
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.
Linux i macOS (binarka trafia do ~/.local/bin/agy):
curl -fsSL https://antigravity.google/cli/install.sh | bashWindows (PowerShell):
irm https://antigravity.google/cli/install.ps1 | iexKreator 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.
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.
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. |
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.gitignore i plik .geminiignore w katalogu projektu, np. node_modules/ nie trafi do kontekstu.@"My Folder/file.ts" albo escaping ukośnikiem.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.
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 (dawne Ctrl+X jest 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).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.
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latestAlbo jako rozszerzenie Gemini CLI, które instaluje serwer MCP razem ze skillami:
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcpgemini mcp add -s user chrome-devtools npx chrome-devtools-mcp@latestKonfiguracja 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 jePodglą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.
Akademia to materiały. Wdrożenie to dwa kwartały na Waszym kodzie, z pomiarem efektu w DEVLens. Audyt 90 minut wystarczy, żeby sprawdzić, czy ma to u Was sens.