Gemini CLI 2026 — za darmo? Instalacja i co zamiast

Wpisałeś gemini, kliknąłeś „Sign in with Google” i dostałeś błąd? To nie Twoja pomyłka. Od 18 czerwca 2026 Google wyłączył w Gemini CLI logowanie kontem Google dla kont prywatnych, także z planem Google AI Pro i Ultra — mówi o tym baner w oficjalnym repozytorium Gemini CLI. Masz dwie drogi: darmowy klucz API z małym limitem albo następcę, Antigravity CLI, z darmowym planem dla kont prywatnych. Poniżej obie.

Gemini CLI to agent Google, który pracuje w terminalu: czyta pliki w folderze, proponuje zmiany i uruchamia polecenia. Instalujesz go jednym poleceniem, npm install -g @google/gemini-cli (potrzebny Node.js 20 lub nowszy), a na Macu i w Linuksie także przez brew install gemini-cli. Działa dalej z kluczem API z Google AI Studio i w planach firmowych. Większość poradników z 2025 roku, które obiecują „1000 darmowych zapytań dziennie z kontem Gmail”, jest więc dziś nieaktualna.

Na skróty: kto może używać Gemini CLI i z jakim limitem, instalacja na Windows, Macu i Linuksie, tabela błędów i przejście na Antigravity CLI. Wszystko sprawdziliśmy w oficjalnej dokumentacji Google 17 października 2026, przy wersji 0.64.0, a zasady logowania i limity ponownie 19 października.

Co się zmieniło 18 czerwca 2026

W maju 2026 Google ogłosił, że łączy swoje narzędzia dla programistów w jedną rodzinę: Google Antigravity. Ma ona aplikację na komputer i nowy program do terminala, Antigravity CLI, który przejmuje najważniejsze funkcje Gemini CLI. 18 czerwca 2026 Gemini CLI i rozszerzenia Gemini Code Assist do edytorów przestały obsługiwać trzy grupy kont: darmowe Gemini Code Assist dla osób prywatnych oraz płatne plany Google AI Pro i Google AI Ultra.

W praktyce oznacza to jedno: opcja „Sign in with Google”, którą polecają stare poradniki, na prywatnym koncie kończy się dziś błędem. Sam program nie zniknął — jest dalej rozwijany, ma cotygodniowe wydania i działa z kluczem API oraz w firmach, które kupiły licencję Gemini Code Assist Standard albo Enterprise. Google zaznacza też, że Gemini CLI nie jest dopasowany do najnowszego modelu Gemini 4 Argon — do niego kieruje do Antigravity.

Kto może dziś używać Gemini CLI i ile jest za darmo

Co wybrać? Chcesz zostać przy Gemini CLI i wystarczy Ci mały dzienny limit — przejdź do instalacji i logowania kluczem API. Chcesz darmowego agenta Google na dłużej — zainstaluj Antigravity CLI według poradnika Google Antigravity; tam są polecenia instalacji i pierwsze uruchomienie.

Darmowy limit po ludzku. 250 zapytań dziennie brzmi jak dużo, ale jedno Twoje polecenie to zwykle kilka zapytań: agent czyta plik, zapisuje zmianę, uruchamia polecenie, sprawdza wynik — i każdy z tych kroków liczy się osobno. Na naukę i małe ćwiczenia wystarczy, na dzień pracy nad projektem raczej nie. Limit dotyczy całego projektu w Google AI Studio, a nie pojedynczego klucza, i odnawia się o północy czasu pacyficznego, czyli u nas zwykle o 9:00 rano. Aktualny stan sprawdzisz w AI Studio, w widoku limitów, a zasady — na stronie limitów Gemini CLI.

Zanim zaczniesz: wymagania

Instalacja na Windows

Na Windows oficjalna droga to npm, czyli menedżer pakietów, który przychodzi razem z Node.js. Homebrew na Windows nie działa.

1. Zainstaluj Node.js

   Pobierz instalator wersji LTS ze strony nodejs.org i przeklikaj go z domyślnymi ustawieniami. Jeśli masz już Node.js, sprawdź wersję poleceniem node --version — potrzebujesz 20 lub nowszej.

2. Otwórz PowerShell

   Naciśnij Win + X i wybierz Terminal albo Windows PowerShell. Jeśli instalowałeś Node.js przed chwilą, otwórz nowe okno — stare nie wie jeszcze o nowym programie.

3. Wklej polecenie instalacji

   Wpisz polecenie z ramki poniżej i naciśnij Enter. Ostrzeżenia zaczynające się od npm WARN deprecated są według dokumentacji tylko informacyjne — możesz je zignorować.

4. Sprawdź, czy działa

   W nowym oknie wpisz gemini --version. Jeśli widzisz numer wersji, program jest zainstalowany.

PS> node --version
PS> npm install -g @google/gemini-cli
PS> gemini --version

Jeśli chcesz najpierw tylko spróbować, bez instalowania, wpisz npx @google/gemini-cli. npx pobiera program i od razu go uruchamia, bez instalowania na stałe. Do regularnej pracy lepsza jest zwykła instalacja.

Instalacja na Macu

Najprościej przez Homebrew, jeśli go masz. Otwórz Terminal (Cmd + Spacja, wpisz „Terminal”, Enter) i wklej polecenie. Bez Homebrew użyj npm, tak jak na Windows — po wcześniejszej instalacji Node.js z nodejs.org.

$ brew install gemini-cli
# albo, jeśli masz Node.js 20+:
$ npm install -g @google/gemini-cli
$ gemini --version

Instalacja na Linuksie

Otwórz terminal — w większości dystrybucji Ctrl + Alt + T. Oficjalne drogi to npm (po instalacji Node.js 20+) albo Homebrew, który też działa na Linuksie. Zanim zaczniesz, sprawdź node --version.

$ node --version
$ npm install -g @google/gemini-cli
$ gemini --version

Logowanie kluczem API z Google AI Studio

Skoro konto Google na prywatnym koncie odpada, Gemini CLI uruchomisz kluczem API. Klucz to długi ciąg znaków, który mówi Google, czyje są zapytania — i do którego limitu się liczą.

1. Utwórz klucz

   Wejdź na aistudio.google.com/app/apikey, zaloguj się kontem Google i utwórz klucz. Skopiuj go od razu.

2. Przekaż klucz programowi

   W tym samym oknie terminala, w którym uruchomisz Gemini CLI, ustaw zmienną GEMINI_API_KEY — polecenia w ramce niżej. Tak ustawiona zmienna znika po zamknięciu okna. Żeby nie wpisywać jej za każdym razem, dokumentacja podpowiada plik .gemini/.env albo plik startowy powłoki.

3. Wybierz logowanie kluczem

   Uruchom gemini i na pytaniu o sposób logowania wybierz Use Gemini API key, a nie „Sign in with Google”. Sposób logowania zmienisz później poleceniem /auth.

# Windows (PowerShell):
PS> $env:GEMINI_API_KEY="TWOJ_KLUCZ"
# Mac i Linux:
$ export GEMINI_API_KEY="TWOJ_KLUCZ"
$ gemini

Pierwsze zadanie: bezpieczne ćwiczenie w pustym folderze

Gemini CLI pracuje na plikach w folderze, w którym go uruchomisz. Dlatego zaczynasz od nowego, pustego folderu — tam nie ma czego zepsuć. Nie uruchamiaj go w katalogu domowym ani na Pulpicie, gdzie leżą Twoje dokumenty.

$ mkdir pierwszy-projekt
$ cd pierwszy-projekt
$ gemini

Zrób stronę HTML w jednym pliku: pole z datą wystawienia
faktury i pole z terminem płatności w dniach (7, 14 albo 30).
Pokaż datę, do której klient ma zapłacić, i ile dni
zostało od dziś. Bez bibliotek z internetu. Nie twórz
innych plików. Na koniec napisz mi po polsku, jak otworzyć
tę stronę w przeglądarce.

Zanim agent utworzy plik albo uruchomi polecenie, zapyta o zgodę. Na początek wybieraj Allow once — zgoda na ten jeden krok — i czytaj, na co się zgadzasz. Gdy skończy, otwórz folder w eksploratorze plików, kliknij dwa razy nowy plik HTML i sprawdź wynik na fakturze, której termin znasz. /help pokazuje dostępne polecenia, /stats statystyki bieżącej sesji, a /quit zamyka program.

Prywatność: co Google robi z Twoimi danymi w darmowym planie

To ważne, zanim wkleisz agentowi cokolwiek prywatnego. Darmowy klucz API podlega regulaminowi Gemini API dla usług bezpłatnych. Mówi on, że Google używa wysłanych treści i odpowiedzi do ulepszania swoich produktów, a ludzie mogą je czytać i opisywać — po odłączeniu od Twojego konta i klucza. Google prosi wprost, żeby do usług bezpłatnych nie wysyłać danych wrażliwych, poufnych ani osobowych.

Jest jednak ważne zastrzeżenie dla Polski. Ten sam regulamin mówi, że w Europejskim Obszarze Gospodarczym, Szwajcarii i Wielkiej Brytanii zasady wykorzystania danych z usług płatnych obejmują wszystkie usługi, także darmowy limit Gemini API. Przy usługach płatnych Google nie używa promptów ani odpowiedzi do ulepszania produktów, a zapisuje je tylko na ograniczony czas, żeby wykrywać nadużycia. Regulamin zastrzega też, że Gemini API jest dla osób, które budują coś zawodowo albo w firmie — nie jako usługa konsumencka. Jeśli tekst w ogóle nie powinien opuszczać komputera, polski model Bielik uruchomisz lokalnie, bez wysyłania czegokolwiek do Google.

Gemini Code Assist — rozszerzenie do edytora

Gemini Code Assist to asystent Google w postaci rozszerzenia do edytora kodu — pracuje obok Twoich plików, a nie w osobnym oknie terminala. Z Gemini CLI dzielił dostęp: logowanie kontem Google w obu prowadziło do tego samego planu Gemini Code Assist. Dlatego zmiana z 18 czerwca 2026 objęła oba naraz: darmowa wersja dla osób prywatnych i plany Google AI Pro i Ultra przestały działać także w rozszerzeniach.

Code Assist zostaje w wersjach dla firm, Standard i Enterprise, kupowanych przez Google Cloud — ale i one mają według Google własny harmonogram wycofania. Jeśli zaczynasz sam, na własnym koncie, Code Assist nie jest dziś dla Ciebie — także w VS Code. Agenta Google w VS Code dostaniesz przez wtyczkę Antigravity (jest na stronie pobierania Antigravity, obok wtyczek do JetBrains i Visual Studio), a inne edytory z AI na darmowym planie — poza Google.

Przejście na Antigravity CLI

Dla prywatnych kont Google wskazuje jeden następca: Antigravity CLI. Uruchamia się poleceniem agy, w folderze projektu — tak samo jak wcześniej gemini. Instaluje się go własnym instalatorem, jednym poleceniem; polecenia dla Windows, Maca i Linuksa oraz pierwsze uruchomienie krok po kroku są w poradniku Google Antigravity — co to jest i jak zacząć. Tu zostaje to, co ważne przy przenosinach: przy pierwszym uruchomieniu agy sam wykrywa Twój folder z ustawieniami Gemini CLI i przenosi to, co się da (szczegóły w przewodniku migracji Google):

• Przechodzą: umiejętności (czym są skills), serwery MCP, profile agentów, rozszerzenia (jako wtyczki Antigravity, polecenie agy plugin import gemini) i podstawowe ustawienia.
• Działają bez zmian: pliki GEMINI.md i AGENTS.md z instrukcjami dla agenta — Antigravity CLI czyta je tak, jak są (ten sam AGENTS.md przeczyta też Claude Code — jak Claude Code czyta AGENTS.md).
• Zmieniają miejsce: umiejętności projektu trafiają do .agents/skills/, serwery MCP do osobnego pliku mcp_config.json.
• Mogą nie przejść: niektóre własne motywy terminala i eksperymentalne dodatki wizualne.

Jeśli dopiero zaczynasz i nie masz żadnych ustawień Gemini CLI, migracja Cię nie dotyczy — po prostu instalujesz Antigravity CLI od zera, według poradnika o Antigravity.

Typowe błędy i co z nimi zrobić

Komunikaty pochodzą z oficjalnej strony rozwiązywania problemów Gemini CLI i ze zgłoszeń w repozytorium projektu na GitHubie. Znajdź w tabeli początek tekstu, który widzisz.

Gemini CLI czy Claude Code

Oba to agenci w terminalu, którzy pracują na plikach projektu i pytają o zgodę przed ryzykownym krokiem. Różnią się dziś przede wszystkim dostępem: Gemini CLI dla osoby prywatnej to darmowy klucz API z małym limitem albo płacenie za zużycie, a Google sam kieruje nowych użytkowników do Antigravity CLI. Claude Code wymaga płatnego planu Claude od pierwszego dnia, ale za to w stałym miesięcznym abonamencie, z limitem odnawianym co kilka godzin. Jak go postawić na Windows, Macu i Linuksie, opisuję w poradniku Claude Code — instalacja krok po kroku. Jeśli płacisz za ChatGPT Plus, w tym samym abonamencie masz Codexa w terminalu.

Co dalej

• Nie wiesz jeszcze, które narzędzie wybrać? Zacznij od mapy: narzędzia AI do kodowania — od czego zacząć zestawia czat, edytor i terminal, z tym, co jest w nich za darmo.
• Zanim projekt urośnie: od czego zacząć vibe coding, żeby nie utknąć w drugim tygodniu.
• Każde z tych narzędzi prowadzisz zwykłym tekstem, więc swoboda pisania przekłada się wprost na jakość poleceń — ćwiczyć możesz za darmo w kursie pisania.
• Jak z modelem zbudować pierwsze własne narzędzie, od pomysłu do rzeczy, którą da się pokazać ludziom, pokazuję w kursie VIBE coding.