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:
01 / Wprowadzenie · Czym jest
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.
02 / Instalacja · Windows, Linux, macOS
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.0Linux (Ubuntu/Debian):
curl -fsSL https://deb.nodesource.com/setup_20.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 https://github.com/google-gemini/gemini-cliNa 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
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.
04 / Antigravity CLI · Konta indywidualne
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, sama weryfikuje sumę kontrolną SHA512 i sama się aktualizuje.
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.
Limity: zamiast dziennego licznika zapytań obowiązuje tygodniowy limit obliczeniowy. Przy intensywnej pracy agentowej potrafi się wyczerpać przed końcem tygodnia — cięższe zadania planuj z głową albo rozważ płatny klucz API i pozostanie przy Gemini CLI.
05 / Komendy · Slash, kontekst, shell
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. |
/chat save | Zapis i wznowienie konwersacji. |
/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 ekran i kontekst (alias Ctrl+L). |
/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 GEMINI_IGNORE — 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+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).06 / MCP · Kontrola przeglądarki
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@latestgemini 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.
Wdrożenie u Was
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.