Google Gemini CLI installeren op Windows, Mac en Linux (juni 2026)

Je installeert Google Gemini CLI in één commando: npm install -g @google/gemini-cli. Dat vereist Node.js 20.0.0 of hoger en werkt identiek op Windows, macOS en Linux (geminicli.com, npm). Daarna typ je gemini in je projectmap om de terminal-agent te starten. Eén ding moet je vooraf weten: vanaf 18 juni 2026 stopt de gratis inlog met je persoonlijke Google-account, en draai je de setup voortaan op een eigen Gemini API-key of een Gemini Code Assist Standard/Enterprise-licentie (Google Developers Blog).

Gemini CLI is de open-source terminal-agent van Google die Gemini rechtstreeks naar je commandoregel brengt, onder de Apache 2.0-licentie (github.com/google-gemini/gemini-cli). Deze pagina is bewust smal: hij gaat over installeren en de eerste setup, niets meer. Wil je eerst weten wat zo'n agent precies doet en hoe Gemini CLI zich verhoudt tot Claude Code en Codex, begin dan bij de AI-CLI hubgids. Wil je doortikken naar de installatie, lees dan verder.

Stap 1: controleer Node.js (versie 20.0.0 of hoger)

Gemini CLI draait op Node.js. Het npm-pakket eist node >=20, en de officiële docs noemen Node.js 20.0.0+ als minimum (npm, geminicli.com). Controleer wat je hebt:

node --version

Zie je een nummer dat begint met v20, v22 of hoger, dan ben je klaar voor de volgende stap. Krijg je command not found of een lager versienummer, installeer dan eerst Node.js: via nodejs.org, via een versiemanager als nvm, of (op macOS) via Homebrew met brew install node. Een te oude Node-versie is de meest onderschatte oorzaak van een mislukte installatie.

Stap 2: installeer Gemini CLI met npm

Het officiële installatiecommando is identiek op alle platformen (geminicli.com):

npm install -g @google/gemini-cli

De vlag -g installeert globaal, zodat je gemini overal in je terminal kunt aanroepen. Standaard krijg je het stabiele kanaal; per juni 2026 is dat versie 0.45.1 (npm). Wil je expliciet een kanaal kiezen, dan kan dat met een tag:

npm install -g @google/gemini-cli@latest    # stabiel (standaard)
npm install -g @google/gemini-cli@preview    # wekelijkse preview
npm install -g @google/gemini-cli@nightly     # dagelijkse nightly

Het stabiele kanaal verschijnt wekelijks, de preview eveneens wekelijks maar ongetest, en de nightly draait dagelijks (geminicli.com). Voor productiegebruik blijf je bij het stabiele kanaal.

Werkt het al? Controleer de installatie

gemini --version

Komt er een versienummer terug, dan staat de CLI klaar. Krijg je gemini: command not found, sla dan even door naar de probleemoplossing verderop, dat is bijna altijd een PATH-kwestie en zo verholpen.

Platformspecifieke aandachtspunten

Het commando is overal hetzelfde, maar per besturingssysteem zijn er kleine verschillen. Officieel ondersteunt Gemini CLI macOS 15+, Windows 11 24H2+ en Ubuntu 20.04+ (geminicli.com).

• Windows: gebruik PowerShell of Windows Terminal, niet de oude opdrachtprompt. Installeer Node.js via het officiële .msi-pakket van nodejs.org; dat zet npm meteen goed in je PATH. Komt gemini daarna niet door, herstart dan je terminal zodat de PATH-wijziging wordt geladen.
• macOS: met node van nodejs.org of Homebrew werkt npm install -g direct. Loop je tegen een rechtenfout aan bij de globale installatie, kies dan de Homebrew-route hieronder, die vermijdt sudo op je npm-map.
• Linux (Ubuntu/Debian): installeer Node.js bij voorkeur via NodeSource of nvm in plaats van de verouderde apt-pakketten, die vaak een te lage versie leveren. Daarna werkt het npm-commando ongewijzigd.

Alternatieve installatiemethoden

Niet iedereen wil via npm werken. De docs bieden meerdere wegen (geminicli.com):

• Homebrew (macOS/Linux): brew install gemini-cli: handig als je je tooling toch al via Homebrew beheert; updaten gaat dan mee met brew upgrade.
• MacPorts (macOS): sudo port install gemini-cli voor wie MacPorts gebruikt in plaats van Homebrew.
• npx (tijdelijk draaien): npx @google/gemini-cli voert de CLI uit zónder globale installatie. Ideaal om te proberen of voor een eenmalige sessie, maar je hebt elke keer de download nodig.
• Docker/Podman: Google publiceert een sandbox-image, zodat je de agent in een geïsoleerde container draait: nuttig als je de agent geen directe toegang tot je hostsysteem wilt geven.
• Anaconda: voor afgeschermde omgevingen maak je eerst een geïsoleerde Node.js-omgeving via conda (conda create -y -n gemini_env -c conda-forge nodejs) en installeer je daarbinnen via npm.

Veelvoorkomende fout: command not found

De vaakst gemelde fout na een geslaagde installatie is gemini: command not found. De installatie zelf is dan goed gegaan, maar je shell weet niet waar de globale npm-binaries staan: de map waar npm globale pakketten neerzet, staat niet in je PATH.

Zoek eerst waar npm zijn globale binaries plaatst:

npm config get prefix

Voeg de bijbehorende bin-map toe aan je PATH (op macOS/Linux in je ~/.zshrc of ~/.bashrc, op Windows via de omgevingsvariabelen). Op macOS en Linux komt dat meestal neer op een regel als:

export PATH="$(npm config get prefix)/bin:$PATH"

Open daarna een nieuwe terminal en test opnieuw met gemini --version. In de praktijk lost dit het overgrote deel van de "command not found"-meldingen op. Een alternatief zonder PATH-gedoe is de Homebrew-installatie, die de binary op een plek zet die meestal al in je PATH staat.

Setup: inloggen verandert op 18 juni 2026

Hier wijkt Gemini CLI in 2026 af van een rustige Claude Code-installatie, waar je na installeren simpelweg inlogt en doorwerkt. Tot voor kort kon je Gemini CLI gratis gebruiken door in te loggen met je persoonlijke Google-account (de gratis Gemini Code Assist-route voor individuen). Die route verdwijnt.

Updatebaar feit (stand juni 2026): op 18 juni 2026 stoppen Gemini CLI en de Gemini Code Assist IDE-extensies met het bedienen van verzoeken voor Google AI Pro, Ultra én de gratis gebruikers. In de woorden van Google: "On June 18, 2026, Gemini CLI and Gemini Code Assist IDE extensions will stop serving requests for Google AI Pro and Ultra, as well as those using it free of charge" (Google Developers Blog).

Wat betekent dat concreet voor je setup na die datum? Er blijven twee werkende routes:

• Eigen Gemini API-key. Je haalt een sleutel op in Google AI Studio en zet die als omgevingsvariabele, zodat de CLI op jouw API-toegang draait. Google bevestigt dat Gemini CLI bereikbaar blijft via betaalde Gemini-API-keys (Google Developers Blog).
• Standard- of Enterprise-licentie. Gebruikt je organisatie Gemini CLI via een Gemini Code Assist Standard- of Enterprise-licentie, dan blijft de toegang ongewijzigd: "your access remains unchanged" (Google Developers Blog).

De gratis consumentenfunctionaliteit verhuist naar de closed-source Antigravity CLI, de opvolger die Google parallel uitrolt. De repository van Gemini CLI zelf blijft open source onder Apache 2.0 (github.com/google-gemini/gemini-cli), maar voor de gratis persoonlijke login is 18 juni 2026 het kantelpunt. Plan je setup daar dus op: regel een eigen API-key of een licentie als je na die datum wilt blijven werken.

Klaar, wat nu?

Je hebt Node.js gecontroleerd, Gemini CLI geïnstalleerd, de installatie geverifieerd en je weet hoe je inlog-setup vanaf 18 juni 2026 verandert. De logische volgende stap is je projectcontext goed inrichten: net als Claude Code zijn CLAUDE.md heeft, instrueer je Gemini via een eigen contextbestand, GEMINI.md, zodat de agent bij elke sessie de conventies van jouw project kent.

Wil je breder kijken: wat een terminal-agent precies is, hoe Gemini CLI zich verhoudt tot de andere grote spelers, en welke tool past bij jouw team, werk dan verder vanuit de AI-CLI hubgids. En twijfel je nog tussen Gemini CLI en een alternatief, dan helpt De juiste AI-CLI kiezen je bij die afweging.

Bronnen

• Gemini CLI: Installation docs (geminicli.com)
• Gemini CLI: GitHub repository (Apache 2.0)
• @google/gemini-cli: npm package
• Gemini CLI: GitHub releases
• Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI
• Gemini CLI: Antigravity-transitie (discussion #27274)