Gemini CLI

Übersicht

Das Google Gemini CLI ist ein Befehlszeilen-Tool zur Interaktion mit Gemini-Modellen. TokenLab bietet einen kompatiblen Endpunkt, der es Ihnen ermöglicht, das Gemini CLI mit Zugriff auf über 300 Modelle zu nutzen.

Dies ist nur eine experimentelle Kompatibilitätslösung: Gemini CLI dokumentiert derzeit keinen stabilen TokenLab-ähnlichen Custom-Base-URL-Workflow. Wenn Sie eine unterstützte TokenLab-Terminalintegration benötigen, verwenden Sie bevorzugt Codex CLI, Claude Code oder OpenCode.

Systemanforderungen

Node.js: Version 20.0+
Betriebssystem: Windows 10/11, macOS 10.15+, Ubuntu 20.04+ oder Debian 10+

Installation

npm install -g @google/gemini-cli

Installation überprüfen:

gemini --version

Konfiguration

Schritt 1: API-Key abrufen

Melden Sie sich im TokenLab Dashboard an
Navigieren Sie zu API Keys
Erstellen und kopieren Sie Ihren API-Key (Format: sk-...)

Schritt 2: Umgebungsvariablen festlegen

Temporär (aktuelle Sitzung):

export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"

Permanente Konfiguration: Fügen Sie dies zu Ihrer Shell-Konfigurationsdatei hinzu:

Bash
Zsh
Fish

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
source ~/.bashrc

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
source ~/.zshrc

set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"

Starten Sie Ihr Terminal nach der Konfiguration neu, damit die Änderungen wirksam werden.

Bekannte Einschränkung: In einigen Fällen ignoriert das Gemini CLI möglicherweise GOOGLE_GEMINI_BASE_URL, wenn eine Google-Sitzung im Cache gespeichert ist. Wenn Verbindungsprobleme auftreten, versuchen Sie, den CLI-Cache zu leeren oder eine neue Terminal-Sitzung zu starten.

Grundlegende Nutzung

Starten Sie das Gemini CLI aus Ihrem Projektverzeichnis:

cd your-project
gemini

Beim ersten Ausführen werden Sie:

Ein Theme auswählen
Den Sicherheitshinweis bestätigen
Dem Arbeitsverzeichnis vertrauen

Verfügbare Modelle

Modell	Beschreibung
`gemini-2.5-pro`	Leistungsfähigstes Gemini-Modell
`gemini-3.5-flash`	Schnell, effizient für die meisten Aufgaben
`gemini-3.1-flash-lite`	Aktuelles leichtgewichtiges Gemini-Modell

Häufige Befehle

Eine Frage stellen:

> What is the best way to structure a React app?

Code analysieren:

> Explain the code in src/main.ts

Code generieren:

> Create a Python function to parse JSON files

Änderungen überprüfen:

> Review the recent git changes and suggest improvements

Konfiguration überprüfen

# Umgebungsvariablen prüfen
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# Verbindung testen
gemini

Fehlerbehebung

Verbindungsfehler

Überprüfen Sie, ob GOOGLE_GEMINI_BASE_URL auf https://api.tokenlab.sh gesetzt ist
Hinweis: Kein /v1-Suffix für den Gemini-Endpunkt
Netzwerkverbindung prüfen

Authentifizierung fehlgeschlagen

Überprüfen Sie, ob die Umgebungsvariable GEMINI_API_KEY gesetzt ist
Prüfen Sie, ob der Key mit sk- beginnt
Stellen Sie sicher, dass der Key im TokenLab-Dashboard aktiv ist

Modell nicht verfügbar

Prüfen Sie die Verfügbarkeit der Gemini-Modelle unter tokenlab.sh/en/models
Versuchen Sie eine andere Gemini-Modellvariante

Bewährte Praktiken

Im Projektverzeichnis verwenden

Führen Sie das Gemini CLI immer aus dem Projekt-Root-Verzeichnis aus, um ein besseres Kontextverständnis zu ermöglichen.

Verzeichnissen vorsichtig vertrauen

Vertrauen Sie nur Verzeichnissen, die Ihnen gehören. Das Gemini CLI kann Dateien lesen und ändern.

Generierten Code überprüfen

Überprüfen Sie KI-generierten Code immer, bevor Sie ihn in Ihr Projekt übernehmen.

Kompatibilitätsmatrix

Coding-Tools

Native SDKs (nativ)

Frameworks & Plattformen

Chat-Apps

Übersicht

Systemanforderungen

Installation

Konfiguration

Schritt 1: API-Key abrufen

Schritt 2: Umgebungsvariablen festlegen

Grundlegende Nutzung

Verfügbare Modelle

Häufige Befehle

Konfiguration überprüfen

Fehlerbehebung

Bewährte Praktiken

​Übersicht

​Systemanforderungen

​Installation

​Konfiguration

​Schritt 1: API-Key abrufen

​Schritt 2: Umgebungsvariablen festlegen

​Grundlegende Nutzung

​Verfügbare Modelle

​Häufige Befehle

​Konfiguration überprüfen

​Fehlerbehebung

​Bewährte Praktiken

Übersicht

Systemanforderungen

Installation

Konfiguration

Schritt 1: API-Key abrufen

Schritt 2: Umgebungsvariablen festlegen

Grundlegende Nutzung

Verfügbare Modelle

Häufige Befehle

Konfiguration überprüfen

Fehlerbehebung

Bewährte Praktiken