Gemini CLI Gebruikersgids - Google AI in je terminal

Gemini CLI is een open-source command-line AI-tool van Google die de kracht van Gemini direct naar je terminal brengt. Het biedt een lichtgewicht manier om toegang te krijgen tot Gemini, en vormt het meest directe pad van prompt naar model. Door een proxy te configureren, kun je Gemini CLI-diensten gebruiken, zelfs in netwerk-beperkte omgevingen.

Waarom kiezen voor Gemini CLI?#

• Krachtige Gemini 2.5 Pro: Toegang tot een contextvenster van 1 miljoen tokens
• Ingebouwde tools: Google Search-grounding, bestandsbewerkingen, Shell-commando's, web scraping
• Uitbreidbaar: Ondersteunt MCP (Model Context Protocol) voor aangepaste integraties
• Terminal-first: Ontwikkeld voor developers die in de command line werken
• Open source: Apache 2.0-licentie

Installatie#

Snelle installatie#

Direct uitvoeren met npx (geen installatie nodig)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Globale installatie met npm#

npm install -g @google/gemini-cli

Installeren met Homebrew (macOS/Linux)#

brew install gemini-cli

Systeemvereisten#

• Node.js versie 20 of hoger
• macOS, Linux of Windows

De proxy configureren#

Omgevingsvariabelen instellen#

Voordat je de proxy gebruikt, stel je de volgende omgevingsvariabelen in:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Tip: Voeg deze omgevingsvariabelen toe aan je .bashrc, .zshrc of shell-configuratiebestand zodat ze automatisch worden ingesteld telkens wanneer je de terminal start.

Snelstart#

Basisgebruik#

Starten in huidige directory#

gemini

Meerdere directories opnemen#

gemini --include-directories ../lib,../docs

Een specifiek model gebruiken#

gemini -m gemini-2.5-flash

Niet-interactieve scriptmodus#

Een eenvoudig tekstantwoord ophalen:

gemini -p "Explain the architecture of this codebase"

Gestructureerde JSON-output ophalen:

gemini -p "Explain the architecture of this codebase" --output-format json

Snelle voorbeelden#

Een nieuw project starten#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Bestaande code analyseren#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Belangrijkste functies#

Codebegrip en -generatie#

• Grote codebases bevragen en bewerken
• Nieuwe applicaties genereren vanuit PDF's, afbeeldingen of schetsen met behulp van multimodale mogelijkheden
• Problemen debuggen en troubleshooten met natuurlijke taal

Automatisering en integratie#

• Operationele taken automatiseren, zoals het opvragen van pull requests of het afhandelen van complexe rebases
• Nieuwe mogelijkheden koppelen via MCP-servers
• Niet-interactief draaien in scripts voor workflowautomatisering

Geavanceerde functies#

• Realtime informatie ophalen met ingebouwde Google Search
• Gespreks-checkpoints om complexe sessies op te slaan en te herstellen
• Aangepaste contextbestanden (GEMINI.md) om gedrag voor jouw project af te stemmen

Veelgebruikte commando's en voorbeelden#

Codebase verkennen#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Werken met bestaande code#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Workflows automatiseren#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Systeeminteractie#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

GitHub-integratie#

Gebruik de Gemini CLI GitHub Action om Gemini CLI rechtstreeks in je GitHub-workflows te integreren:

• Pull request reviews: Geautomatiseerde code-reviews met contextuele feedback en suggesties
• Issue-triage: GitHub-issues automatisch labelen en prioriteren op basis van inhoudsanalyse
• On-demand hulp: Noem @gemini-cli in issues en pull requests voor hulp bij debuggen, uitleg of taakdelegatie
• Aangepaste workflows: Geautomatiseerde, geplande en on-demand workflows bouwen die zijn afgestemd op de behoeften van je team

Problemen oplossen#

Als je problemen ondervindt tijdens het gebruik, kijk dan naar het volgende:

1. Controleer omgevingsvariabelen#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Controleer netwerkverbinding#

curl -I https://crazyrouter.com/

3. Controleer foutmeldingen#

Foutmeldingen geven meestal aan wat er mis is. Veelvoorkomende problemen zijn onder andere:

• Ongeldig API-sleutelformaat
• Netwerkconnectiviteitsproblemen
• Onjuiste proxyconfiguratie

4. SOCKS-proxyformaat#

Als je een SOCKS-proxy gebruikt, zorg dan dat het formaat correct is:

socks5://<user>:<pass>@<proxy>:<port>

5. Bugs rapporteren#

Gebruik het ingebouwde commando om problemen te melden:

/bug

Releaseversies#

Preview#

Nieuwe preview-versies worden elke dinsdag om 23:59 UTC uitgebracht:

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

Stable#

Nieuwe stabiele versies worden elke dinsdag om 20:00 UTC uitgebracht:

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

Nightly#

Nightly-versies worden elke dag om 00:00 UTC uitgebracht:

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

MCP-servergebruik#

Configureer MCP-servers in ~/.gemini/settings.json om Gemini CLI uit te breiden met aangepaste tools:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Prijzen via Crazyrouter#

Krijg toegang tot Gemini-modellen tegen gereduceerde tarieven:

Alle prijzen zijn inclusief een korting van 45% ten opzichte van de officiële tarieven.

Gerelateerde bronnen#

• Crazyrouter Prijspagina
• Gemini CLI GitHub Repository
• Google AI Documentatie

Hulp nodig? Neem contact op met support of bekijk de Crazyrouter-documentatie voor meer informatie.