Developer Resources

Gemini CLI

Configureer Gemini CLI met de native Gemini-API van RunAPI, controleer verzoeken en herstel uw vorige instellingen.

Overzicht

Gemini CLI is een terminal-agent. Deze handleiding wijzigt de modelprovider naar de native Gemini-API van RunAPI; RunAPI-tools toevoegen via MCP is een aparte stap.

Voordat u begint

Volg de officiële installatiehandleiding. Maak een aparte standaard-API-sleutel via de authenticatiehandleiding en kopieer een Gemini-native model-ID uit de modelcatalogus. Neem uw sleutel nooit op in een commit.

SHELL

npm install -g @google/gemini-cli

RunAPI configureren

Begin met deze variabelen in uw huidige shell. De basis-URL is de HTTPS-API-root zonder /v1beta; de SDK voegt POST /v1beta/models/{model}:streamGenerateContent?alt=sse toe. HTTP is alleen toegestaan voor localhost.

SHELL

export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID

Sla voor blijvend gebruik dezelfde drie variabelen op in ~/.gemini/.env, buiten uw repositories. Beperk toegang met chmod 600 ~/.gemini/.env. Gemini CLI zoekt naar .env vanaf de huidige map naar de bovenliggende mappen en controleert daarna ~/.gemini/.env en ~/.env; controleer conflicterende bestanden.

Voeg deze twee instellingen samen in ~/.gemini/settings.json en behoud andere instellingen. Gebruik gemini-api-key voor API-sleutelauthenticatie, niet een opgeslagen Google-aanmelding. De sleutel wordt standaard verzonden in x-goog-api-key.

JSON

{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}

Een model kiezen

Gebruik GEMINI_MODEL, --model YOUR_RUNAPI_MODEL_ID of /model in een interactieve sessie. Vermijd auto, pro en flash: deze aliassen kunnen verwijzen naar Google-model-ID’s die RunAPI niet aanbiedt. Interne selectie, classificatie en lusdetectie kunnen ook flash- of flash-lite-hulpmodellen aanvragen; controleer hun beschikbaarheid apart.

Verifiëren

Voer dit uit in een vertrouwde repository. Controleer het model met /about of /stats in een interactieve sessie en bevestig een bijbehorend streamGenerateContent-verzoek in de RunAPI-gebruiksgegevens. Een succesvolle CLI-respons bewijst op zichzelf niet welk endpoint het verzoek ontving.

SHELL

gemini --version
gemini -p "Describe this repository in one sentence."

RunAPI-tools toevoegen

MCP voegt tools toe, geen modelprovider. Deze opdracht registreert de lokale server; volg Local MCP voor de aparte authenticatie en controle.

SHELL

gemini mcp add runapi npx -y @runapi.ai/mcp

Probleemoplossing

Gaan verzoeken nog naar Google, controleer dan conflicterende .env-bestanden, security.auth.selectedType, opgeslagen aanmeldingen en Google/Vertex-authenticatievariabelen. Kies bij Invalid auth method selected in de instellingen gemini-api-key in plaats van gateway en start opnieuw.

Controleer bij 401 de sleutel en eventuele wijzigingen aan GEMINI_API_KEY_AUTH_MECHANISM; standaard wordt x-goog-api-key gebruikt. Verwijder bij 404 de /v1beta uit de basis-URL en kopieer opnieuw een ondersteunde Gemini-native model-ID. Controleer bij een niet-beschikbaar hulpmodel de aangevraagde ID; een hoofdmodel garandeert niet alle CLI-functies.

RunAPI biedt geen countTokens of embedContent. Gemini CLI kan tokens lokaal schatten als countTokens mislukt; schattingen kunnen afwijken van de gebruiksgegevens. Gebruik HTTPS behalve voor localhost en schakel certificaatcontrole niet uit.

RunAPI verwijderen

Verwijder de drie variabelen uit uw shell en opgeslagen .env-bestanden, herstel de vorige security.auth.selectedType en modelinstelling en trek de aparte sleutel in RunAPI in. Verwijder de apart toegevoegde MCP-server alleen als u de tools niet meer nodig hebt.

SHELL

unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL

Volgende stappen

Ga verder met de LLM-API-snelstart, Gemini generateContent, streamGenerateContent, de modelcatalogus of Local MCP.