Gemini CLI – kto może go dziś używać, instalacja i przejście na Antigravity CLI

Gemini CLI to otwartoźródłowy (Apache 2.0) agent AI od Google, który działa w terminalu po wpisaniu polecenia gemini – ale 18 czerwca 2026 roku Google zastąpił go Antigravity CLI dla kont bezpłatnych, użytkowników Google One i subskrybentów Google AI Pro i Ultra.

Gemini CLI nie zniknął: repozytorium jest aktywne, co tydzień wychodzą nowe wydania, a dostęp do modeli zachowały organizacje z licencją Gemini Code Assist Standard lub Enterprise oraz osoby z płatnym kluczem API. Od 9 października 2026 roku Google nie sprzedaje jednak nowych subskrypcji Code Assist Standard i Enterprise, więc nowy użytkownik ma dziś do Gemini CLI w praktyce jedną pewną drogę: płatny klucz API. Jeśli w starszym poradniku czytasz, że po zalogowaniu kontem Google dostajesz 1000 żądań dziennie za darmo, to opis stanu sprzed 18 czerwca 2026.

Poniżej znajdziesz: kto i na jakich zasadach może dziś korzystać z Gemini CLI, jak przenieść konfigurację do Antigravity CLI, polecenia instalacji i logowania z dokumentacji, limity, pierwsze polecenia, podłączanie MCP, mechanizmy bezpieczeństwa i warunki dla zespołów.

W skrócie:

• Konto Google bez płatnej licencji, Google One, Google AI Pro i Ultra: Gemini CLI już nie obsługuje tych kont, Google kieruje je do Antigravity CLI (polecenie agy).
• Licencje Code Assist Standard i Enterprise działają do końca umowy, ale nowych nie kupisz od 9 października 2026.
• Płatny klucz Gemini API działa z Gemini CLI według zapowiedzi Google; klucza bez płatności Google w zapowiedzi nie wymienia.
• Instalacja bez zmian: Node.js 20.0.0 lub nowszy i npm install -g @google/gemini-cli.

Czym jest Gemini CLI i do czego służy?

Gemini CLI to agent AI Google w wierszu poleceń: po uruchomieniu poleceniem gemini czyta pliki projektu, proponuje zmiany i uruchamia polecenia powłoki, ale domyślnie każde polecenie powłoki wykonuje dopiero po twojej zgodzie, a modele pracują w chmurze Google, więc potrzebne jest połączenie z internetem. Agent AI to program, który sam planuje kolejne kroki i korzysta z narzędzi, zamiast tylko odpowiadać na pytanie.

Co Gemini CLI potrafi według opisu w repozytorium Google:

• czytać i edytować duże bazy kodu,
• budować aplikacje na podstawie plików PDF, obrazów i szkiców,
• automatyzować pracę z repozytorium, na przykład obsługę pull requestów i rebase,
• działać nieinteraktywnie w skryptach, bez prowadzenia rozmowy.

Gemini CLI różni się od aplikacji Gemini w przeglądarce miejscem i sposobem pracy: działa w terminalu, bez interfejsu graficznego, i pracuje bezpośrednio na plikach w twoim katalogu. Na takiej pracy agenta opiera się vibe coding, w którym programista opisuje zmiany słowami, a agent wprowadza je w kodzie.

Czy Gemini CLI nadal działa po zastąpieniu go przez Antigravity CLI?

Tak, ale nie dla wszystkich: od 18 czerwca 2026 roku Gemini CLI nie obsługuje już kont bezpłatnych, użytkowników Google One ani subskrybentów Google AI Pro i Ultra, a dostęp zachowują organizacje z licencją Gemini Code Assist Standard lub Enterprise oraz użytkownicy płatnych kluczy API. Google ogłosił zmianę 19 maja 2026 roku we wpisie na blogu Google for Developers, a baner o zastąpieniu wisi dziś w README repozytorium i na stronach dokumentacji Gemini CLI. Dokumentacja Gemini Code Assist dodaje, że konta konsumenckie nie mogą już korzystać z opcji „Login with Google” w Gemini CLI.

Dokumentacja Google sama sobie tu przeczy. Strona limitów Gemini CLI nadal zawiera wiersze kont indywidualnych (1 000 żądań dla Code Assist for individuals, 1 500 dla Google AI Pro, 2 000 dla Google AI Ultra), a strona logowania wciąż poleca kontom indywidualnym „Sign in with Google”. Pierwszeństwo ma komunikat o zastąpieniu – te wiersze opisują ścieżki zamknięte 18 czerwca 2026. Wykupienie planu według cennika Google AI Pro i Ultra nie otwiera więc już dostępu do Gemini CLI przez logowanie kontem Google.

Co to jest Antigravity CLI i jak przenieść konfigurację?

Antigravity CLI to nowy terminalowy agent Google (polecenie agy, napisany w Go), dostępny dla wszystkich od 19 maja 2026 roku, który przy pierwszym uruchomieniu wykrywa konfigurację Gemini CLI i pozwala ją zaimportować. Antigravity CLI jest częścią platformy Google Antigravity i przejmuje z Gemini CLI umiejętności agenta (Agent Skills), hooki, subagentów i rozszerzenia – te ostatnie jako wtyczki Antigravity. Google uprzedza, że na starcie nie ma pełnej zgodności funkcji 1:1.

Instalacja Antigravity CLI według dokumentacji Antigravity to jedno polecenie zależne od systemu. macOS i Linux:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Windows PowerShell:

irm https://antigravity.google/cli/install.ps1 | iex

Windows CMD:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Instalację sprawdzasz poleceniem agy --version, a sesję zaczynasz poleceniem agy w katalogu projektu. Jeśli zamiast konta Google chcesz używać w nim klucza Gemini API, dokumentacja Antigravity wymaga dwóch kroków: ustawienia "modelProvider": "gemini" w pliku ~/.gemini/antigravity-cli/settings.json i zmiennej GEMINI_API_KEY – sama zmienna nie wystarcza. Inaczej niż Gemini CLI, Antigravity CLI nie czyta klucza z plików .env ani ze zmiennej GOOGLE_API_KEY, więc klucz z ~/.gemini/.env trzeba wyeksportować w powłoce.

Co zmienia się w konfiguracji przy przejściu z Gemini CLI na Antigravity CLI, według przewodnika migracji w dokumentacji Antigravity:

Dokumentacja migracji mówi o częściowej zgodności: niektóre motywy terminala i eksperymentalne nakładki wizualne z Gemini CLI mogą nie działać. Antigravity CLI ma też własne plany i limity – z dokumentacji planów Antigravity wynika, że korzystasz z niego także bez płatnego planu, z limitem odnawianym co tydzień.

Czy Gemini CLI obsługuje najnowsze modele Gemini?

Nie w pełni: README Gemini CLI mówi wprost, że narzędzie nie zostało zoptymalizowane pod Gemini 4 Argon i że do tego modelu należy używać Antigravity, a sam Argon nie wchodzi do bezpłatnej puli Gemini API. Dokumentacja Google Cloud dodaje ogólniej, że Gemini CLI nie jest zoptymalizowany pod najnowsze modele Gemini i do najlepszej pracy z kodem poleca Antigravity CLI. Model, z którego korzystasz w danej sesji, sprawdzisz i zmienisz poleceniem /model.

Jak zainstalować Gemini CLI?

Gemini CLI wymaga Node.js w wersji 20.0.0 lub nowszej i instaluje się jednym poleceniem npm install -g @google/gemini-cli, po czym uruchamiasz go poleceniem gemini. Instalacja nie zależy od tego, czy masz dostęp do modeli – ten zależy od sposobu logowania opisanego niżej.

Polecenia instalacji z README repozytorium Gemini CLI na GitHubie, po jednym na metodę.

Uruchomienie bez instalacji (npx):

npx @google/gemini-cli

Instalacja globalna przez npm:

npm install -g @google/gemini-cli

Homebrew (macOS i Linux):

brew install gemini-cli

MacPorts (macOS):

sudo port install gemini-cli

Anaconda (środowiska z ograniczeniami):

conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

W Google Cloud Shell i Cloud Workstations Gemini CLI jest zainstalowany fabrycznie. Po instalacji uruchamiasz go w katalogu projektu:

gemini

Który kanał wydań wybrać i jak zaktualizować Gemini CLI?

Gemini CLI ma trzy kanały wydań: stabilny (tag latest) wychodzi co tydzień we wtorek o 20:00 UTC, preview (tag preview) w każdy wtorek o 23:59 UTC, a nightly (tag nightly) codziennie o 00:00 UTC; aktualizujesz, instalując ponownie pakiet z wybranym tagiem.

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

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

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

Wersja stabilna to promocja preview z poprzedniego tygodnia z poprawkami. Preview według README „nie jest w pełni sprawdzone” i może zawierać regresje, a nightly zawiera wszystkie zmiany z głównej gałęzi z niezakończoną walidacją – do pracy na produkcyjnym kodzie wybierz latest.

Jak zalogować się do Gemini CLI?

Po poleceniu gemini Gemini CLI pyta, jak chcesz się uwierzytelnić: kontem Google w przeglądarce, kluczem Gemini API ze zmiennej GEMINI_API_KEY albo przez Vertex AI ze zmiennymi Google Cloud – przy czym konta firmowe, szkolne i Workspace oraz licencje Code Assist wymagają dodatkowo zmiennej GOOGLE_CLOUD_PROJECT. Logowanie kontem Google (OAuth, czyli zgoda udzielana w przeglądarce bez podawania hasła w terminalu) działa dziś tylko dla kont objętych licencją Code Assist Standard lub Enterprise – konta konsumenckie tej opcji już nie mają.

Vertex AI to platforma Google Cloud do pracy z modelami Gemini w ramach projektu chmurowego – z jej rozliczeniami, uprawnieniami i lokalizacją zasobów. Projekt dla konta firmowego ustawiasz tak:

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

W PowerShellu zmienne ustawiasz składnią $env:VARIABLE="value", na przykład $env:GEMINI_API_KEY="YOUR_API_KEY".

Zasady pracy z kluczem i zmiennymi według dokumentacji Gemini CLI:

• zmienne zapisujesz na stałe w pliku startowym powłoki (~/.bashrc, ~/.zshrc, ~/.profile, w PowerShellu $PROFILE) albo w pliku ~/.gemini/.env (Windows: %USERPROFILE%\.gemini\.env),
• Gemini CLI szuka pliku .env w górę od bieżącego katalogu i ładuje pierwszy znaleziony – pliki się nie łączą,
• zmienną wyeksportowaną w pliku startowym powłoki odczyta każdy proces uruchomiony z tej powłoki,
• dokumentacja każe traktować klucze API jako poufne dane uwierzytelniające – nie wpisuj ich do plików projektu i nie wysyłaj do repozytorium.

Klucz Gemini API tworzysz w Google AI Studio. Od 28 maja 2026 roku nowe klucze z AI Studio są kluczami autoryzacji powiązanymi z kontem usługi, a API odrzuca nieograniczone klucze standardowe; Google nie podał, czy ta zmiana wpływa na pracę Gemini CLI z kluczem.

Ile kosztuje Gemini CLI i jakie są limity?

Sam Gemini CLI jest darmowy (Apache 2.0), a koszt i limit zależą od ścieżki dostępu: licencja Code Assist Standard daje 1 500 żądań dziennie na użytkownika, Enterprise 2 000, płatny klucz API rozlicza tokeny, a dla klucza bez płatności dokumentacja podaje 250 żądań dziennie tylko do modeli Flash – choć status tej ostatniej ścieżki po 18 czerwca 2026 nie jest potwierdzony.

W starszych poradnikach krąży limit „60 żądań na minutę i 1000 dziennie po zalogowaniu kontem Google”. Ta ścieżka (Gemini Code Assist for individuals) została zamknięta 18 czerwca 2026, a strona limitów Gemini CLI nie została po zmianie uporządkowana i nadal pokazuje dawne wiersze kont indywidualnych.

Pozostałe zasady limitów według dokumentacji Gemini CLI:

• Google AI Plus nie jest obsługiwany,
• limity minutowe istnieją, ale dokumentacja nie podaje ich wartości,
• zużycie w bieżącej sesji sprawdzisz poleceniem /stats model.

Jak zacząć pracę – pierwsze polecenia w Gemini CLI

Pierwszą sesję Gemini CLI zaczynasz w katalogu projektu poleceniem gemini, a potem prowadzisz rozmowę zwykłym językiem, dołączasz pliki przez @ścieżka, uruchamiasz polecenia powłoki przez !polecenie i korzystasz z poleceń ukośnikowych, takich jak /init, /model, /stats czy /help.

1. Przejdź do katalogu projektu w terminalu.
2. Uruchom gemini. Jeśli pracujesz na kilku katalogach naraz, dodaj je flagą: gemini --include-directories ../lib,../docs.
3. Wybierz sposób uwierzytelniania (przy pierwszym starcie możesz też wybrać motyw).
4. Wpisz /init – Gemini CLI przeanalizuje katalog i wygeneruje plik GEMINI.md z instrukcjami dla projektu.
5. Zadaj pierwsze pytanie o kod, na przykład: „Wyjaśnij architekturę tego repozytorium i wskaż, gdzie zaczyna się obsługa żądań HTTP”.
6. Sprawdź zużycie poleceniem /stats i zakończ sesję poleceniem /quit.

Znak @ dołącza do promptu plik lub katalog, na przykład @src/app.ts; pliki wymienione w .gitignore są domyślnie pomijane. Znak ! przed poleceniem uruchamia je w powłoce (!git status), a sam ! przełącza tryb powłoki. Model zmieniasz w trakcie pracy poleceniem /model albo przy starcie flagą -m w składni gemini -m <identyfikator-modelu> – aktualny identyfikator bierzesz z listy w /model.

Jak działa plik GEMINI.md?

GEMINI.md to plik z instrukcjami dla modelu (styl kodu, rola, zasady projektu), który Gemini CLI wczytuje z ~/.gemini/GEMINI.md, z katalogu roboczego i katalogów nadrzędnych oraz z katalogów plików, do których sięga narzędzie, łączy w całość i wysyła z każdym promptem. To ta sama idea co system prompty w ChatGPT, Claude i Gemini, tylko zapisana w pliku projektu.

Przykładowe reguły z dokumentacji Gemini CLI:

# Project rules

- Use 2 spaces for indentation.
- Always use strict equality (`===` and `!==`).

/memory show pokazuje połączoną zawartość wszystkich wczytanych plików, a /memory reload wymusza ponowne wczytanie po zmianach. Antigravity CLI nadal czyta GEMINI.md, więc plik nie przepada przy przejściu na nowe narzędzie.

Jak uruchomić Gemini CLI w skrypcie, bez rozmowy?

Flaga -p uruchamia Gemini CLI nieinteraktywnie: polecenie gemini -p "Explain the architecture of this codebase" zwraca odpowiedź i kończy działanie, a --output-format json albo stream-json daje wynik do dalszego przetwarzania w skrypcie.

gemini -p "Explain the architecture of this codebase"
gemini -p "Explain the architecture of this codebase" --output-format json
gemini -p "Run tests and deploy" --output-format stream-json

Format json zwraca jeden obiekt z polami response, stats i opcjonalnie error. Format stream-json wysyła zdarzenia w formacie JSONL (jedno zdarzenie w wierszu): init, message, tool_use, tool_result, error, result. Tryb nieinteraktywny włącza się także sam, gdy Gemini CLI działa w środowisku bez terminala (TTY).

Jak podłączyć MCP i rozszerzenia do Gemini CLI?

Serwery MCP dodajesz do Gemini CLI w pliku ~/.gemini/settings.json (albo .gemini/settings.json w projekcie) w bloku mcpServers i sprawdzasz poleceniem /mcp list, a rozszerzenia instalujesz poleceniem gemini extensions install <github-repo-url>. MCP (Model Context Protocol) to otwarty protokół, przez który agent korzysta z zewnętrznych narzędzi i danych, na przykład z GitHuba.

Przykład z dokumentacji Gemini CLI – serwer GitHub MCP uruchamiany w Dockerze:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server:latest"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

Ten przykład wymaga zainstalowanego Dockera i tokenu GitHub (fine-grained personal access token) z uprawnieniami: odczyt Metadata i Contents oraz odczyt i zapis Issues i Pull Requests. Token trafia do serwera ze zmiennej środowiskowej – nie wpisujesz go do pliku. Po zapisaniu konfiguracji /mcp list powinno pokazać serwer github ze statusem „Connected”, a /mcp reload ponownie pobiera listę narzędzi serwera. Potem możesz pisać polecenia w rodzaju @github List my open pull requests.

Rozszerzenia Gemini CLI pakują w jedną instalację prompty, serwery MCP, własne polecenia, motywy, hooki, subagentów i umiejętności agenta (Agent Skills). Instalacja i lista:

gemini extensions install https://github.com/gemini-cli-extensions/workspace
gemini extensions list

W trakcie sesji listę pokazuje też /extensions list. Katalog rozszerzeń prowadzi Google pod adresem geminicli.com/extensions/browse/. Przy przejściu na Antigravity CLI serwery MCP przenosisz do osobnego pliku mcp_config.json, a rozszerzenia importujesz jako wtyczki (tabela migracji wyżej).

Czy Gemini CLI jest bezpieczne – zgody, piaskownica i zaufane foldery

Gemini CLI domyślnie prosi o twoją zgodę na każde polecenie powłoki („Allow once”, „Allow always” do końca sesji albo „Deny”), a piaskownicę (--sandbox) i tryb zaufanych folderów włączasz w ustawieniach – zaufane foldery są domyślnie wyłączone. Dokumentacja Gemini CLI ostrzega, że dostęp AI do powłoki daje dużo możliwości, ale niesie ryzyko, i zaleca piaskownicę, czyli izolowane środowisko, w którym polecenia agenta nie sięgają poza wyznaczony obszar.

Piaskownica na macOS (Seatbelt, sandbox-exec) używa domyślnie profilu permissive-open: blokuje operacje domyślnie i ogranicza zapis do katalogu projektu, przy szerokim odczycie i dostępie do sieci. Piaskownica w Dockerze lub Podmanie korzysta domyślnie z obrazu ghcr.io/google/gemini-cli:latest i montuje katalog projektu pod tą samą ścieżką co na komputerze.

W folderze oznaczonym jako niezaufany Gemini CLI działa w trybie ograniczonym:

• nie wczytuje projektowego .gemini/settings.json,
• nie wczytuje plików .env,
• nie uruchamia serwerów MCP z konfiguracji projektu,
• nie ładuje własnych poleceń z plików .toml,
• nie pozwala instalować rozszerzeń,
• wyłącza automatyczne zatwierdzanie narzędzi.

Zasada praktyczna: klucze API trzymaj w zmiennych środowiskowych lub w ~/.gemini/.env, a nie w plikach repozytorium, a tokeny dla serwerów MCP przekazuj zmiennymi, jak w przykładzie z GitHubem.

Gemini CLI w zespole – licencje, dane i automatyzacja

W zespole Gemini CLI działa w ramach istniejącej licencji Gemini Code Assist Standard lub Enterprise albo przez płatny klucz API, a to, na jakich warunkach Google traktuje twoje prompty, zależy od ścieżki dostępu. Od 9 października 2026 roku Google nie sprzedaje nowych subskrypcji Code Assist Standard i Enterprise – według harmonogramu wygaszania w dokumentacji Google Cloud istniejące subskrypcje działają do końca umowy, licencje można dokładać do 31 stycznia 2027, subskrypcje roczne odnawiać do 31 stycznia 2027, a miesięczne do 31 grudnia 2027. Następcą dla firm jest Antigravity w edycjach Gemini Enterprise.

Dokumentacja Gemini CLI nie rozstrzyga sama, czy prompty służą do trenowania modeli – odsyła do dokumentów z tabeli, więc pełne warunki trzeba przeczytać u Google przed wpuszczeniem narzędzia do firmowego kodu. Wysyłanie statystyk użycia do Google można wyłączyć w ustawieniach, a polecenie /privacy pokazuje informację o prywatności i pozwala ustawić zgodę na zbieranie danych.

Do automatyzacji w zespole Gemini CLI daje dwie rzeczy z dokumentacji:

• /setup-github konfiguruje GitHub Actions do triage zgłoszeń i przeglądu pull requestów z Gemini,
• tryb -p z formatem json i kodami wyjścia (opis wyżej, w sekcji o pracy w skrypcie) pozwala wpiąć Gemini CLI w skrypty.

Funkcje Preview w Gemini CLI na licencji Code Assist wymagają dwóch kroków: administrator ustawia kanał wydań Preview w panelu Admin for Gemini, a użytkownik włącza „Preview Features” w /settings.

FAQ

Źródła

• An important update: Transitioning Gemini CLI to Antigravity CLI, blog Google for Developers – ogłoszenie z 19.05.2026: od 18.06.2026 Gemini CLI nie obsługuje Google AI Pro, Ultra i kont bezpłatnych, a dostęp zostaje dla płatnych kluczy Gemini API i Gemini Enterprise Agent Platform
• Gemini Code Assist Standard and Enterprise subscriptions – harmonogram wygaszania, dokumentacja Google Cloud – brak nowych subskrypcji od 9.10.2026, dokładanie licencji i odnawianie rocznych do 31.01.2027, miesięcznych do 31.12.2027
• Quota and pricing, dokumentacja Gemini CLI – limity: 250 żądań dziennie dla klucza bez płatności (tylko Flash), 1 500 dla Code Assist Standard, 2 000 dla Enterprise, wciąż widoczne wiersze kont indywidualnych i informacja, że Gemini CLI nie jest zoptymalizowany pod Gemini 4 Argon
• Installation, dokumentacja Gemini CLI – wymagania: Node.js 20.0.0+, macOS 15+, Windows 11 24H2+, Ubuntu 20.04+, 4 GB / 16 GB RAM
• google-gemini/gemini-cli, README repozytorium na GitHubie – licencja Apache 2.0, polecenia instalacji (npm, Homebrew, MacPorts, npx) i harmonogram kanałów latest, preview i nightly

Ostatnia aktualizacja: 12 listopada 2026 · Zgłoś poprawkę