Przejdź do treści

Gemini CLI: instalacja, limity i ceny agenta AI w terminalu

Adam Marzec
Karta Gemini CLI z licznikiem zapytań dziennie i stawkami za milion tokenów

Gemini CLI to otwarty agent AI od Google, który siedzi w terminalu: czyta pliki projektu, uruchamia komendy, poprawia kod i odpowiada na pytania o repozytorium. Modele Gemini opisujemy szeroko w hubie Gemini. Kod jest publiczny pod licencją Apache 2.0, zebrał ponad 100 tys. gwiazdek na GitHubie i dostaje nowe wydanie co tydzień.

Starsze instrukcje milczą za to o dwóch rzeczach. Pierwsza: 18 czerwca 2026 Google wyłączył w Gemini CLI darmowe logowanie kontem Google i obsługę subskrypcji Pro oraz Ultra, a osoby z niepłatnych planów odesłał do nowego narzędzia Antigravity CLI. Druga: limit zapytań opisują raz 1000 dziennie, raz 1500. Agent nadal działa, dziś realnie na kluczu API albo firmowej licencji, i tu dostaje daty graniczne. Poradnik prowadzi przez instalację, trzy drogi logowania, stawki za tokeny i rozstrzyga spór o limity z odczytem obu stron Google.

Gemini CLI co to jest i jak pracuje

To agent, nie klient czatu. Po uruchomieniu w katalogu projektu widzi pliki, czyta i edytuje je, odpala komendy w powłoce, dociąga strony z sieci i na tym tle rozmawia w języku naturalnym. Google chwali się trzema obszarami: rozumieniem i generowaniem kodu, tworzeniem aplikacji z PDF-ów albo szkiców i automatyzacją typu odpytywanie pull requestów czy rebase’y.

Repozytorium powstało w kwietniu 2025. Narzędzie zrosło się w tym czasie z ekosystemem: tę samą pulę kwot dzieli tryb agentowy w rozszerzeniach Gemini Code Assist, trwały kontekst trzymasz w plikach GEMINI.md, rozmowy zapisujesz checkpointami, a możliwości rosną o serwery MCP, czyli zewnętrzne narzędzia podłączane przez konfigurację. Jeśli termin MCP jest ci obcy, mamy o nim osobny tekst. Do tego tryb nieinteraktywny: flaga -p i agent odpowiada jednym wynikiem, co otwiera drogę do skryptów i CI.

Gemini CLI GitHub: otwarte repozytorium i cotygodniowe wydania

Cały kod siedzi w repozytorium google-gemini/gemini-cli pod licencją Apache 2.0, do czytania, forkowania i własnych buildów. To wyróżnik na tle konkurentów: Claude Code od Anthropic jest zamknięty, a tu masz wgląd w to, jakie prompty wysyła agent i co dzieje się z twoimi plikami. Komunikat Google z maja 2026 chwali się ponad 100 tys. gwiazdek, 6000 scalonych pull requestów i setkami kontrybutorów; licznik GitHuba przy odczycie 16 października pokazywał 107 tys.

Wydania jeżdżą kalendarzowo. Stabilna wersja wychodzi we wtorek o 20:00 UTC, podglądowa tydzień wcześniej o 23:59 UTC tego samego dnia, nocna codziennie o 00:00 UTC prosto z gałęzi głównej.

Gemini CLI install: pięć dróg do pierwszego startu

Warunek wstępny: Node.js 20.0.0+, potwierdzony i w dokumentacji, i w polu engines pakietu npm. Interpreter omawiam przy Windows, dróg instalacji jest pięć.

Najszybsza to uruchomienie bez instalowania:

npx @google/gemini-cli

Klasyczna instalacja globalna przez npm:

npm install -g @google/gemini-cli

Na macOS i Linuxie zastępuje to Homebrew:

brew install gemini-cli

MacPorts oferuje wariant dla starszych konfiguracji:

sudo port install gemini-cli

Piąta droga, Anaconda, dla maszyn z ograniczeniami:

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

Kanał zmieniasz dopisując tag: latest to wydania stabilne, preview testowe z możliwymi regresjami, nightly nocne snapshoty. Dla ostrożnych jest flaga –sandbox zamykająca narzędzia agenta w kontenerze.

Gemini CLI Windows, macOS i Linux: wymagania

Oficjalne wymagania: macOS 15+, Windows 11 24H2+, Ubuntu 20.04+, 4 GB RAM dla krótkich sesji albo 16 GB przy dużych codebase’ach. Agent mówi przez Bash, Zsh albo PowerShell, więc na Windows nie potrzebujesz podkładu uniksowego: Node.js 20+ z nodejs.org, restart terminala i ta sama komenda npm co na Linuksie.

Drobny bonus: na Google Cloud Shell i w Cloud Workstations agent jest preinstalowany, wystarczy przeglądarka i wpisanie gemini. Ciekawy trop: wymagania odsyłają do listy obsługiwanych lokalizacji współdzielonej z Gemini Code Assist, tylko że ten link prowadzi dziś do strony o wygaszaniu kont konsumenckich. Mówiący widok.

Gemini CLI download: instalatora nie znajdziesz

Fraza „download” pojawia się w autouzupełnianiu często, więc uporządkujmy: Gemini CLI nie ma instalatora exe ani dmg, dystrybucja idzie przez npm i Homebrew. Strona oferująca „GeminiCLI-Setup.exe” to złośliwość, nie produkt Google; podmiana instalatorów narzędzi developerskich to znany wzorzec ataków.

Instalator ma za to następca z porównania niżej: Antigravity CLI rozdaje binarkę agy skryptem curl albo paczkami na każdy system. Kto mówi, że „pobrał Gemini CLI jako program”, niemal na pewno miał do czynienia z Antigravity.

Logowanie: konto Google, klucz API i Vertex AI

Trzy ścieżki, a po czerwcowej zmianie każda znaczy co innego. Pierwsza to Sign in with Google, logowanie kontem osobistym. Komunikat Google z maja zapowiadał, że 18 czerwca 2026 CLI przestanie obsługiwać żądania „for Google AI Pro and Ultra, as well as those using it free of charge”, a strona o kontach konsumenckich potwierdza teraz wprost, że opcji Login with Google nie użyjesz już ani w rozszerzeniach IDE, ani w Gemini CLI.

Druga ścieżka to klucz API z Google AI Studio, dziś główna droga osoby prywatnej:

export GEMINI_API_KEY="TWOJ_KLUCZ_API"
gemini

W PowerShell zmienną ustawiasz przez $env:GEMINI_API_KEY=”TWÓJ_KLUCZ”. Zastrzeżenie z komunikatu: CLI pozostaje dostępny „via paid Gemini and Gemini Enterprise Agent Platform API keys”. Dokument limitów w repozytorium opisuje jeszcze darmowy tier klucza, o czym niżej, tylko traktuj to z ostrożnością, bo dokument nie łapie się na czerwiec.

Trzecia ścieżka to Vertex AI: GOOGLE_GENAI_USE_VERTEXAI=true, identyfikator projektu, lokalizacja i logowanie przez gcloud auth application-default login albo klucz service account. To droga dla zespołów na Google Cloud; konta Workspace i licencje firmowe wymagają GOOGLE_CLOUD_PROJECT, z datami granicznymi opisanymi przy limitach.

Limity: 1000 czy 1500 zapytań dziennie

Rozbieżność istnieje w materiałach Google, zastanawialiśmy się nad nią przy tekście o narzędziach vibe coding. Rozwiązanie jest proste, choć mało kto je podał: 1000 i 1500 opisywały dwa różne plany dostępu. Sprzeczności nie było, był skrót bez kontekstu.

Dokument limitów w repozytorium (ostatnia edycja zapisana 18 czerwca 2026) rozpisywał to tak: darmowe konto Google (tzw. individuals) 1000 zapytań modelu na dobę, subskrypcja Google AI Pro 1500, Ultra 2000, darmowy klucz API 250 zapytań dziennie wyłącznie na modelach Flash, Vertex AI Express 90 dni przed wymogiem płatności. Strona limitów Gemini Code Assist (odczyt 16 października) podaje same edycje płatne: licencja Standard 1500 zapytań na użytkownika dziennie, Enterprise 2000. Czyli 1500 nigdy nie dotyczyło darmowego konta, zawsze licencji Standard.

Po 18 czerwca tabela skróciła się do wierszy działających:

Droga dostępuLimit dziennyStan od 18.06
darmowe konto Google1000 zapytańwyłączona
Google AI Pro1500 zapytańwyłączona
Google AI Ultra2000 zapytańwyłączona
licencja Standard1500 zapytańw wygaszaniu
licencja Enterprise2000 zapytańw wygaszaniu
darmowy klucz API250 zapytań, Flashniepewna

Ruch z ostatnich dni, o którym polskie teksty jeszcze nie piszą: 9 października 2026 Google zamknął sprzedaż nowych subskrypcji Standard i Enterprise. Istniejące umowy działają do końca okresu kontraktowego, dodawanie licencji i odnawianie planów rocznych kończy się 31 stycznia 2027, planów miesięcznych 31 grudnia 2027, a pomoc w kodowaniu Google przenosi do Antigravity w pakiecie z edycjami Gemini Enterprise. Wszystkie ścieżki dostępu są dziś w jakimś stadium wygaszania, każda w innym tempie.

Dwie uwagi mechaniki. Limit dzienny liczy requesty modelu, nie prompty: jeden prompt agenta potrafi wygenerować kilka requestów przez wywołania narzędzi. Kwota jest wspólna z trybem agentowym w rozszerzeniach edytorów, więc CLI i IDE zjadają ten sam budżet. Zużycie i limity sprawdzisz komendą /stats model.

Gemini CLI pricing: stawki klucza API

Jeśli zostajesz przy kluczu, cennik jest tokenowy i siedzi na stronie cennika Gemini API. Modele Flash, po których jeździ agent, mają darmowy tier: Gemini 3.8 Flash i 3.6 Flash kosztują zero, ale treść promptów może wtedy służyć do trenowania produktów Google. Na planie płatnym trenowanie jest wyłączone.

Płatne stawki za milion tokenów: Gemini 3.8 Flash kosztuje 0,75 USD za wejście i 3,75 USD za wyjście do końca 2026 roku, od 1 stycznia 2027 podwaja się do 1,50 i 7,50 USD, w trybie batch spadając o połowę. Flaga wagi: Gemini 4 Argon, flagowy model rozumujący, nie jest dostępny ani w darmowym tierze, ani w planie Google AI Pro, a jego stawka standardowa to 2 USD za wejście i 10 USD za wyjście do 30 listopada 2026, potem 4 i 20 USD. Pisaliśmy o nim osobno przy premierze Gemini 4 Argon.

Konto z kluczem rośnie przy tym przez poziomy użycia. Free nie ma limitu wydatków, Tier 1 odblokowuje podpięcie płatności z limitem rozliczeniowym 250 USD, Tier 2 przychodzi po 100 USD i trzech dniach, Tier 3 po 1000 USD i trzydziestu dniach. Do tego tempo wydatków: 10, 50 albo 200 USD na dziesięć minut zależnie od poziomu. Limity dzienne liczą się per projekt, nie per klucz, i resetują o północy czasu pacyficznego.

Podstawy użycia: tryb interaktywny, one-shot, /model i MCP

Start jest banalny: wchodzisz w katalog projektu i wpisujesz gemini. Otwiera się czat, w którym opisujesz zadania naturalnym językiem, a agent pyta o zgodę przed każdą operacją zapisu albo komendą. Do jednorazowych zadań służy flaga -p, a do skryptów –output-format json albo stream-json, czyli wyniki do parsowania.

Wybór modelu kontroluje komenda /model: tryby Auto dla rodzin Gemini 3 (gemini-3-pro-preview i gemini-3-flash-preview) oraz Gemini 2.5 (gemini-2.5-pro i gemini-2.5-flash), plus tryb ręczny, a flaga -m robi to samo przy starcie. Jedna uwaga z notki na górze repozytorium: Gemini CLI nie został zoptymalizowany pod Gemini 4 Argon, więc najnowszego modelu rodziny tu nie uruchomisz, do tego służy Antigravity.

Serwery MCP podłączasz w pliku ~/.gemini/settings.json i wołasz przez nazwę z małpy, na przykład @github lista moich otwartych pull requestów.

Gemini CLI vs Antigravity CLI: dwa terminale jednej firmy

W maju 2026 Google ogłosił, że stawia na jedno narzędzie i przenosi energię do Antigravity, platformy agentowej z nowym interfejsem terminalowym. Uzasadnienie: użytkownicy chcą kilku agentów rozmawiających ze sobą i wspólnego zaplecza z resztą workflow. Darmowy tier wygasł więc w starym CLI, a nowi użytkownicy dostają Antigravity CLI.

Nowy agent jest napisany w Go, stąd obietnica szybkości, i przenosi najważniejsze koncepty: Agent Skills, Hooks i Subagenty przetrwały, rozszerzenia stały się pluginami, serwery MCP działają jak wcześniej. Panel /agents pokazuje równoległe sesje subagentów, kontrola k zatwierdza narzędzia. Instalacja idzie skryptem curl albo wariantem PowerShell, binarka nazywa się agy. Cennik ma plan bez subskrypcji z podstawowymi tygodniowymi limitami, liczb się tam nie podaje, a tło platformy opisujemy w tekście o Google Antigravity. Dla firm z licencjami przygotowano osobny przewodnik migracji.

Który wybrać? Na darmowym koncie wybór nie istnieje: starą drogę zamknięto, miejsce jest w Antigravity CLI. Gemini CLI broni się przy otwartym kodzie i automatyzacji na własnym kluczu API, a w firmach z licencjami trwa praca do końca umowy.

Gemini CLI vs Claude Code

Gemini CLI i Claude Code rozwiązują to samo zadanie, agent programistyczny w terminalu, ale z dwóch stron rynku. Claude Code od Anthropic jest zamkniętym produktem w ramach subskrypcji albo API, pracuje w terminalu, rozszerzeniach do IDE, Slacku i w sieci, a w repozytoriach robi agentic search, sam znajdując kontekst.

Tabela w pigułce:

CechaGemini CLIClaude Code
Kod źródłowyotwarty, Apache 2.0zamknięty
ProducentGoogleAnthropic
Gdzie działaterminalterminal, IDE, web
Płatnośćtokeny APIsubskrypcja i API

W Gemini CLI widzisz każdy prompt w kodzie, przerobisz narzędzie pod siebie i uruchomisz je tam, gdzie Anthropic nie sięga, kosztem własnego klucza i pilnowania rachunku. Claude Code kupujesz jak abonament. O otwartych alternatywach pisaliśmy w porównaniu OpenCode vs Claude Code.

Dla kogo jest Gemini CLI w 2026 roku

Po czerwcowym czyszczeniu grono użytkowników się zawęziło. Automatyzatorzy: headless z flagą -p i wyjściem JSON pozwala wsadzić agenta do skryptu nocnego albo zadania CI, a płacisz tylko za tokeny. Firmy z licencjami Standard albo Enterprise pracują dalej do końca umowy z limitami 1500 i 2000 zapytań, ale nowych licencji nie dokupią. Entuzjaści open source czytają kod agenta, forkują go i podglądają, jak Google buduje prompt agentowy.

Hobbysta z darmowym kontem Google: drzwi zamknięto mu 18 czerwca, uczciwą radą jest Antigravity CLI, chyba że woli darmowy klucz API z modelem Flash i limitem 250 zapytań. Kto szuka najmocniejszego modelu do ciężkiego kodu, sięgnie gdzie indziej, bo Argon w CLI nie jeździ. Reszta dostaje narzędzie dojrzałe, cotygodniowo odświeżane i z pełnym wglądem we wnętrzności, z cichą wiedzą, że Google liczy jego dni po starcie.

Najczęstsze pytania

Gemini CLI co to jest, jednym zdaniem?

Otwarty agent AI od Google działający w terminalu: czyta i edytuje pliki projektu, wykonuje komendy, podłącza zewnętrzne narzędzia przez MCP i odpowiada na pytania o kod, zasilany modelami Gemini.

Czy Gemini CLI jest jeszcze darmowy?

Nie. Login with Google wyłączono 18 czerwca 2026 razem z obsługą subskrypcji Pro i Ultra. Z darmowych dróg zostaje klucz API z darmowym tierem, 250 zapytań dziennie na Flashach wg dokumentu limitów, choć komunikat o przejściu wymienia wprost tylko klucze płatne. Pełny darmowy terminal znajdziesz w Antigravity CLI.

Gemini CLI install bez npm, czy się da?

Tak: Homebrew, MacPorts, Anaconda oraz uruchomienie bez instalacji przez npx @google/gemini-cli. Node.js 20+ pozostaje wymagany, chyba że weźmiesz obraz sandboxa albo Cloud Shell.

Gemini CLI Windows: co przygotować?

Windows 11 24H2+, Node.js 20+ z nodejs.org, PowerShell do zmiennych. Instalacja ta sama: npm install -g @google/gemini-cli, klucz przez $env:GEMINI_API_KEY=”TWÓJ_KLUCZ”. Osobnego instalatora exe nie ma.

Gemini CLI pricing: co się stanie po przekroczeniu limitu?

Na licencji dostaniesz odmowę do resetu kwoty o północy czasu pacyficznego. Na kluczu API uderzasz w limity per projekt (RPM, TPM, RPD) i przychodzi błąd 429 RESOURCE_EXHAUSTED; rozwiązaniem jest odczekanie, wolniejsze tempo albo wyższy poziom, na który podnosi się automatycznie po spełnieniu progów wydatków.

Gemini CLI vs Antigravity CLI: od czego zacząć?

Od płatności. Darmowe konto Google oznacza Antigravity CLI, tam plan bez subskrypcji daje tygodniowe limity i instalację jednym skryptem. Płatny klucz API, licencja Standard albo Enterprise albo potrzeba otwartego kodu oznaczają Gemini CLI przez npm. Na starcie oba wyglądają podobnie: czat, narzędzia plikowe, MCP.

Gemini CLI GitHub: gdzie zgłaszać błędy i czytać kod?

Repozytorium: github.com/google-gemini/gemini-cli, licencja Apache 2.0. Błędy w zakładce issues albo komendą /bug, poprawki bezpieczeństwa jako security advisories.

Źródła

Powiązane artykuły