Instalacja Gemini CLI na Macu lub w Windowsie

Gemini CLI to asystent AI od Google, który działa w terminalu. Terminal to okno, w którym wpisujesz komendy zamiast klikać. Gemini CLI potrafi czytać i zmieniać pliki, uruchamiać komendy i szukać w internecie.

Zanim zaczniesz, sprawdź trzy rzeczy:

• Konto. Wystarczy osobiste konto Google. Strona Google o limitach podaje do 1000 darmowych zapytań dziennie, gdy logujesz się kontem Google. Płatne plany Google dają wyższe limity. Jeśli płacisz, płacisz bezpośrednio Google.
• Komputer. Google zaleca macOS 15 lub nowszy albo Windows 11 (24H2) lub nowszy, z co najmniej 4 GB pamięci RAM.
• Node.js 20 lub nowszy. Node.js to darmowy program, na którym działa Gemini CLI. Zawiera npm, czyli narzędzie do instalowania programów, takich jak Gemini CLI.

Terminal to dla Ciebie nowość? Najpierw przeczytaj Jak otworzyć terminal.

Zainstaluj Node.js

Wejdź na nodejs.org/en/download. Pobierz wersję LTS dla swojego komputera. LTS oznacza „długoterminowe wsparcie”: to wersja stabilna. Otwórz pobrany plik i przejdź przez instalator, zostawiając domyślne opcje.

Otwórz terminal

• Mac: naciśnij Command + Space, wpisz Terminal, a potem naciśnij Return.
• Windows: naciśnij klawisz Windows, wpisz PowerShell, a potem naciśnij Enter.

Jeśli terminal był otwarty przed instalacją Node.js, zamknij go i otwórz nowy.

Zainstaluj Gemini CLI

Wklej tę komendę i naciśnij Return lub Enter:

$ npm install -g @google/gemini-cli

-g oznacza „zainstaluj dla wszystkich folderów na tym komputerze”. Poczekaj, aż wróci wiersz poleceń.

Jeśli używasz Homebrew (instalatora aplikacji na Maca), możesz pominąć Node.js i npm i zamiast tego użyć tej komendy:

$ brew install gemini-cli

Sprawdź, czy się udało

Zamknij terminal, otwórz nowy i wpisz:

$ gemini --version

Zobaczysz numer wersji. Jeśli zamiast tego pojawi się błąd, przejdź niżej do Jeśli coś nie działa.

Uruchom Gemini CLI i zaloguj się

$ gemini

Gdy Gemini zapyta, jak chcesz się zalogować, wybierz Sign in with Google. Otworzy się okno przeglądarki. Wybierz swoje konto Google i kliknij Sign in. Gemini CLI zapamięta logowanie na kolejne sesje.

Konta firmowe, szkolne i Google Workspace wymagają dodatkowej konfiguracji. Zobacz stronę Google o logowaniu.

Potem przeczytaj Pierwsza sesja z Gemini CLI.

Jeśli coś nie działa

zsh: command not found: gemini (Mac)

Instalacja się skończyła, ale terminal nie widzi programu. Zamknij terminal, otwórz nowy i spróbuj jeszcze raz. Możesz też uruchomić Gemini CLI bez instalacji:

$ npx @google/gemini-cli

npm error Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@google' (Mac)

npm może nie mieć prawa zapisu w folderze systemowym. Nie dodawaj sudo (komendy, która uruchamia inne komendy jako administrator), chyba że wiesz, po co. Jeśli używasz Homebrew, zainstaluj zamiast tego komendą brew install gemini-cli.

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. (Windows)

Zabezpieczenie Windowsa blokuje w PowerShell pomocniczy skrypt npm. Pomoc Anthropic przy instalacji opisuje ten sam błąd npm. Jej rozwiązanie zezwala na skrypty, które powstały na własnym komputerze, tylko dla Twojego użytkownika. Uruchom poniższą komendę, a potem jeszcze raz komendę instalacji:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser