Coding-Tools

Gemini CLI

Konfigurieren Sie das Google Gemini CLI für die Verwendung der TokenLab API

Überblick

Das Gemini CLI 0.60.0 dokumentiert GOOGLE_GEMINI_BASE_URL für die Authentifizierung mittels API-Key. Verwenden Sie den Gemini-nativen Endpunkt von TokenLab mit einem aktuellen Modell, das gemini_generate_content unterstützt. Siehe die offizielle Konfigurationsreferenz und den Authentifizierungsleitfaden. Dieses Setup leitet kein Google-Abonnement über TokenLab weiter.

Installation

Das Gemini CLI 0.60.0 benötigt Node.js 20 oder neuer.

npm install -g @google/gemini-cli@0.60.0
gemini --version

Konfiguration

Verwenden Sie die Schnellstart-Anweisungen im Terminal für macOS, Linux, WSL oder Windows PowerShell, um TOKENLAB_API_KEY zu setzen, ohne den Schlüssel im Befehlsverlauf zu speichern. Starten Sie das Gemini CLI aus diesem Terminal. Für eine dauerhafte Nutzung verwenden Sie Ihren lokalen Secret Manager; fügen Sie keinen Klartext-Schlüssel zu Ihrem Shell-Profil hinzu.

Behalten Sie Ihre aktuelle Google-Anmeldung und -Konfiguration bei. Wählen Sie für einen separaten TokenLab-Start ein ungenutztes Konfigurations-Root-Verzeichnis wie ~/.gemini-tokenlab ($HOME unter PowerShell) und erstellen Sie dessen .gemini-Verzeichnis. Kopieren Sie Ihre bestehende .gemini/settings.json sowie alle für Ihr Setup erforderlichen Richtliniendateien an die entsprechenden Orte, wobei Berechtigungen, Sandbox-Einstellungen und nicht zusammenhängende Konfigurationen beibehalten werden. Fügen Sie nur in dieser Kopie das folgende Authentifizierungsfeld hinzu; erstellen Sie eine Einstellungsdatei, falls keine existiert. Kopieren Sie keine OAuth-Caches und löschen Sie nicht Ihre ursprünglichen Anmeldedaten. Befolgen Sie die verwaltete Authentifizierungsrichtlinie, anstatt sie zu überschreiben.

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

Verwendung

Der unten stehende Startbefehl verwendet ~/.gemini-tokenlab/.gemini/settings.json. Passen Sie den Pfad an, falls Sie ein anderes Root-Verzeichnis gewählt haben. Bestätigen Sie das Arbeitsverzeichnis über die normale Vertrauensabfrage von Gemini; behalten Sie bestehende Richtlinien zur Tool-Genehmigung bei. Das Modell wird für diese Sitzung explizit ausgewählt.

GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.8-flash

Diese Variablen gelten nur für diesen Startvorgang; Ihr gespeichertes Konto, das Standardmodell und die Berechtigungseinstellungen bleiben erhalten. Starten Sie das Programm wie gewohnt ohne die Variablen, um Ihr vorheriges Setup zu verwenden. Speichern Sie diese nicht dauerhaft in Ihrem Shell-Profil.

Überprüfung

Das Speichern von Einstellungen oder das Auflisten von Modellen überprüft weder einen Schlüssel noch eine abgeschlossene Anfrage. Eine Eingabeaufforderung verbraucht TokenLab-Guthaben. Überprüfen Sie die Antwort und den dazugehörigen Anfragedatensatz, bevor Sie Tools ausprobieren; zusätzliche Anfragen können ebenfalls in Rechnung gestellt werden.

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

Generieren von Bildern und Videos im selben Agenten

Das Gemini CLI kann mit dem TokenLab MCP Server auch Bilder und kurze Videos erstellen. Jede Generierung wird vom selben TokenLab-Guthaben bezahlt. Fügen Sie diesen Eintrag in die TokenLab-Kopie der Einstellungen unter ~/.gemini-tokenlab/.gemini/settings.json ein. Das Gemini CLI liest $TOKENLAB_API_KEY aus der Startumgebung, sodass der Schlüssel nicht in die Datei geschrieben wird:

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
      }
    }
  }
}

Starten Sie das Gemini CLI mit dem oben genannten Startbefehl und führen Sie /mcp aus. Der tokenlab-Server muss als verbunden angezeigt werden; vertrauen Sie dem Arbeitsordner, falls dies nicht der Fall ist. Versuchen Sie dann:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video gibt eine Aufgaben-ID zurück. Der Agent ruft get_task_status auf, bis das Video fertig ist. Weitere Einstellungen finden Sie im Gemini CLI MCP-Leitfaden.

Auf dieser Seite