Google Antigravity CLI einrichten

Google Antigravity CLI (agy) mit einem QCode.cc-Key konfigurieren: modelProvider in der settings.json setzen und anschließend GEMINI_API_KEY und GOOGLE_GEMINI_BASE_URL auf den Gemini-Endpunkt von QCode verweisen lassen

Zuletzt geprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (Antigravity CLI 1.2.x (Auto-Updater-Manifest 1.2.6, geprüft 2026-09))

Auf einen Blick¶

⚠️ Umstieg von Gemini CLI? Laut dem offiziellen Beitrag vom 2026-05-19 werden Gemini CLI und die Gemini-Code-Assist-IDE-Erweiterungen ab 2026-06-18 wörtlich „will stop serving requests“ – und zwar für Google AI Pro und Ultra sowie für Personen, die sie kostenlos mit einem privaten Konto nutzen. Bezahlte Enterprise-Keys sind nicht betroffen: Im selben Beitrag heißt es, dass Gemini CLI weiterhin über kostenpflichtige Gemini- und Gemini-Enterprise-Agent-Platform-API-Keys zugänglich bleibt. An diesem Tag startete Antigravity CLI und Antigravity 2.0; die Antigravity IDE selbst erschien früher, am 2025-11-18. Wenn Sie bisher der Anleitung Gemini-CLI-Integration gefolgt sind, wechseln Sie zu dieser Seite.

Google Antigravity ist der Nachfolger von Gemini CLI für Anmeldungen von Privatnutzern. Es wird in drei Teilen ausgeliefert: einer Desktop-IDE, der Antigravity CLI (agy, in Go geschrieben) und einem SDK. Diese Seite behandelt nur die CLI: Sie richten sie so ein, dass sie QCode.cc als Modell-Anbieter nutzt.

🔴 Zuerst lesen: nur Gemini-Protokoll¶

Der benutzerdefinierte Endpunkt der Antigravity CLI ist Gemini-kompatibel und wird über die Umgebungsvariable GOOGLE_GEMINI_BASE_URL gesetzt. Die offizielle Fehlerbehebungstabelle nennt gemini wörtlich „the only accepted value“ für modelProvider – diese Route kann daher keinen OpenAI-kompatiblen Endpunkt verwenden und über QCode nur Modelle der Gemini-Familie bedienen.

Für Claude oder GPT verwenden Sie einen anderen Client – Claude Code, Codex CLI, Cline, Zed. Welches Protokoll welche Modelle bedient, ist unter Endpunkte & API-Pfade dokumentiert.

🔴 Die Antigravity IDE (2.0-Desktop-App) lässt sich nicht anbinden¶

Die Desktop-IDE von Antigravity bietet derzeit keinen offiziellen BYOK- oder Custom-Provider-Hook, sodass sich das integrierte Agent-Modell nicht gegen einen Endpunkt eines Drittanbieters austauschen lässt. Community-Projekte umgehen das mit einem lokalen abfangenden Proxy, doch das ist ein per Reverse Engineering entstandener Weg ohne offiziellen Support, und diese Seite empfiehlt ihn nicht.

Der Teil, der sich mit QCode verbinden lässt, ist die CLI (agy), nicht die IDE.

Voraussetzungen¶

• Ein QCode.cc API-Key (beginnt mit cr_), aus der Console
• Vertrautheit mit Endpunkte & API-Pfade

Schritt 1: Antigravity CLI installieren¶

Folgen Sie den offiziellen Installationsdokumenten:

curl -fsSL https://antigravity.google/cli/install.sh | bash
# installs to ~/.local/bin/agy

curl -fsSL https://antigravity.google/cli/install.sh | bash
# installs to ~/.local/bin/agy

irm https://antigravity.google/cli/install.ps1 | iex
# installs to C:\Users\<username>\AppData\Local\agy\bin

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Auf der offiziellen Installationsseite werden --skip-aliases und --skip-path erwähnt, dies betrifft aber das Windows-Verhalten: install.ps1 / install.cmd geben Argumente an agy install weiter, während install.sh auf macOS / Linux nur -d, --dir <path> und -h, --help akzeptiert und bei allem anderen abbricht. Übernehmen Sie diese beiden Flags nicht auf macOS / Linux.

Schritt 2: Auf API-Key-Authentifizierung umstellen (Google-Anmeldung überspringen)¶

Standardmäßig liest agy den Schlüsselbund des Betriebssystems oder öffnet einen Browser zur Anmeldung mit dem Google-Konto. Um stattdessen einen API-Key zu verwenden, bearbeiten (oder erstellen) Sie ~/.gemini/antigravity-cli/settings.json:

{
  "modelProvider": "gemini"
}

Mit dieser Einstellung überspringt agy den Anmeldebildschirm und öffnet direkt das Hauptinterface, wobei stattdessen die Umgebungsvariable GEMINI_API_KEY gelesen wird.

🔴 Wenn "modelProvider": "gemini" gesetzt ist, aber GEMINI_API_KEY fehlt, startet die CLI nicht. Beide sind gemeinsam erforderlich.

Schritt 3: Key und Endpunkt auf QCode richten¶

export GEMINI_API_KEY="cr_your_qcode_key"
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"

Ergänzen Sie diese in ~/.zshrc / ~/.bashrc, damit sie dauerhaft wirksam sind. In der Windows PowerShell:

$env:GEMINI_API_KEY = "cr_your_qcode_key"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"

Lassen Sie GOOGLE_GEMINI_BASE_URL bei /gemini enden und lassen Sie /v1beta weg: Das offizielle Beispiel ist eine reine Adresse (export GOOGLE_GEMINI_BASE_URL="https://your-endpoint.example.com"), und der Client fügt das Versionssegment und den Anfragepfad selbst hinzu. agy ist ein Closed-Source-Go-Client — Google dokumentiert weder die Regel zur Zusammenführung noch ob ein abschließender / normalisiert wird (das SDK hinter Gemini CLI entfernt einen), daher folgen wir der dokumentierten Form, statt Randfälle zu erraten. Dies ist das Gegenteil von OpenCodes google-Anbieter (der /v1beta sehr wohl benötigt); der Unterschied wird in Endpunkte & API-Pfade erklärt.

Aus Festlandchina ersetzen Sie den Host durch https://asia.qcode.cc/gemini (Asien-Knoten, nächstgelegener von Korea / Taiwan / Hongkong); der API-Key bleibt unverändert. us funktioniert auf dieselbe Weise.

Bei der Authentifizierung mit GEMINI_API_KEY bewirkt /logout nichts — es gibt keine gespeicherte Sitzung, die gelöscht werden kann.

Schritt 4: Konnektivität prüfen¶

Testen Sie den QCode-Gemini-Endpunkt direkt, ohne das Tool zu verwenden:

# List the Gemini models you can currently call
curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: $GEMINI_API_KEY"

# Send a minimal request (use a model id from the list above)
curl -s "https://api.qcode.cc/gemini/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}],"generationConfig":{"maxOutputTokens":16}}'

• JSON mit candidates → Endpunkt und API-Key sind in Ordnung
• 401 → der Pfad ist korrekt; der API-Key fehlt oder ist falsch

Behandeln Sie die Live-Abfrage als maßgeblich dafür, welche Modelle verfügbar sind — übernehmen Sie keine feste Liste aus einem Dokument, auch nicht aus diesem hier. Die IDs, die der erste curl zurückgibt, sind das, was dieser QCode-Zweig bedienen kann; der vollständige Katalog und die Preise finden Sie auf qcode.cc/models.

Ein Hinweis: Das agy-/model-Panel und agy --model=... verwenden Produktdisplaynamen (in der Form Gemini 3.5 Flash). Google dokumentiert nicht, wie eine ID aus der API einem Paneleintrag zugeordnet wird, wenn ein benutzerdefinierter Endpunkt konfiguriert ist, noch ob diese Liste überhaupt von Ihrem Endpunkt stammt. Falls Ihr Modell im Panel fehlt, gibt es keine weitere offizielle Anleitung — wir haben dies nicht getestet und beschreiben es daher so, wie es ist.

Sobald der Endpunkt überprüft wurde, starten Sie eine Konversation in agy.

Vision-Eingabe vs. Bildgenerierung¶

Tools wie agy können Bilder lesen – geben Sie ihnen einen UI-Screenshot, einen Fehler-Screenshot oder ein Architekturdiagramm, und das Modell schreibt daraus Code oder debuggt damit. Das ist etwas anderes als das Generieren eines Bildes:

• Vision-Eingabe: Verweisen Sie in Ihrem Prompt auf einen Bilddateipfad oder fügen Sie ein Bild per Einfügen bzw. Drag-and-drop ein. Gemini-Modelle unterstützen Vision. Typische Einsatzfälle: eine UI anhand eines Designs nachbauen, einen Fehler anhand eines Fehler-Screenshots lokalisieren, ein Architekturdiagramm auslesen.

• Bildgenerierung: erfordert das dedizierte Modell gpt-image-2 am Bild-Endpunkt von QCode – siehe gpt-image-2 Image Generation.

Fehlerbehebung¶

Weiter¶

• Endpoints & API Paths – Tabelle Protokoll × Modellfamilie
• Gemini CLI Integration – der Vorgänger (Enterprise-Keys funktionieren weiterhin)
• Subagents – Orchestrierung von Hintergrund-Agents
• Automation & CI/CD – Headless-Modus und Skripting

Noch keinen QCode-Key? Ein cr_-Key deckt Claude-, GPT-, Gemini- und Bildmodelle ab (über verschiedene Protokolle – siehe die Tabelle oben). Unter Preise können Sie loslegen.