# Google Antigravity CLI einrichten > **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 | Punkt | Details | |---|---| | Nutzbare Modelle | Über QCode: Gemini ✅ (natives Protokoll, `GOOGLE_GEMINI_BASE_URL`) · Claude / GPT / chinesische Modelle ❌. Das ist eine Einschränkung des **Endpunkts**, nicht des Tools: Wenn sich agy mit einem Google-Konto anmeldet, listet die offizielle Modellseite auch andere Modellfamilien auf – diese laufen jedoch über das Kontingent von Google, nicht über uns | | Protokoll & Base-URL | Gemini: `https://api.qcode.cc/gemini` (Festlandchina: `asia.qcode.cc`) | | Konfigurationsort | `~/.gemini/antigravity-cli/settings.json` sowie die Umgebungsvariablen `GEMINI_API_KEY` / `GOOGLE_GEMINI_BASE_URL` | | Offizielle Dokumentation | [antigravity.google](https://antigravity.google) | > **⚠️ 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](/docs/ide/gemini) gefolgt sind, wechseln Sie zu dieser Seite. [Google Antigravity](https://antigravity.google/) 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. | Punkt | Wert | |---|---| | Konfigurationsdatei | `~/.gemini/antigravity-cli/settings.json` | | Wichtiges Feld | `"modelProvider": "gemini"` | | Zugangsdaten | Umgebungsvariable `GEMINI_API_KEY` (Ihr QCode-`cr_`-Key) | | Endpunkt überschreiben | Umgebungsvariable `GOOGLE_GEMINI_BASE_URL` | | Ignorierte Variablen | Laut offizieller Dokumentation gilt: agy **lädt keine `.env`-Dateien**, und `GOOGLE_API_KEY` hat keine Wirkung – die Zugangsdaten werden ausschließlich aus `GEMINI_API_KEY` in der Umgebung gelesen. Gemini CLI lädt `.env` dagegen sehr wohl, die beiden verhalten sich also gegensätzlich; wer in CI darauf stößt, vergisst es nie wieder | | Nutzbare Modelle | Über QCode: nur die Gemini-Familie | > Für Claude oder GPT verwenden Sie einen anderen Client – [Claude Code](/docs/getting-started/installation), > [Codex CLI](/docs/ide/codex), [Cline](/docs/ide/cline), [Zed](/docs/ide/zed). > Welches Protokoll welche Modelle bedient, ist unter > [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) 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](https://qcode.cc/dashboard) - Vertrautheit mit [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) ## Schritt 1: Antigravity CLI installieren Folgen Sie den [offiziellen Installationsdokumenten](https://antigravity.google/docs/cli/install):
```bash curl -fsSL https://antigravity.google/cli/install.sh | bash # installs to ~/.local/bin/agy ```
```bash curl -fsSL https://antigravity.google/cli/install.sh | bash # installs to ~/.local/bin/agy ```
PowerShell: ```powershell irm https://antigravity.google/cli/install.ps1 | iex # installs to C:\Users\\AppData\Local\agy\bin ``` CMD: ```bat 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 ` 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`: ```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 ```bash 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: ```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](/docs/getting-started/endpoints-and-api-paths) 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: ```bash # 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](https://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](/docs/usage/image-2). ## Fehlerbehebung | Symptom | Wahrscheinliche Ursache | Lösung | |---------|--------------|-----| | Die CLI startet nicht | `modelProvider: "gemini"` ist gesetzt, aber `GEMINI_API_KEY` fehlt | Fügen Sie die Umgebungsvariable hinzu oder entfernen Sie das Feld, um zur Kontoanmeldung zurückzukehren | | 401 | Key nicht übergeben oder falsch | Prüfen Sie `GEMINI_API_KEY` – Präfix `cr_`, keine überflüssigen Leerzeichen | | 404 | `GOOGLE_GEMINI_BASE_URL` enthält ein zusätzliches `/v1beta` oder das Pfadpräfix ist falsch | Hören Sie bei `/gemini` auf, wie im offiziellen Beispiel; das Verhalten beim abschließenden Schrägstrich ist nicht dokumentiert | | `model_not_available_on_endpoint` | Es wurde ein Claude- / GPT-Modell angefordert | Dieser Zweig bedient nur Gemini; wechseln Sie Client oder Modell | | Fehler beim Modellnamen | Eingestellte oder falsch geschriebene ID | Nutzen Sie den `curl`-Befehl aus Schritt 4, um die tatsächlich aufrufbaren Modelle aufzulisten | | Langsam / Timeouts aus China | Die `api`-Apex-Domain wird verwendet | Wechseln Sie zu `https://asia.qcode.cc/gemini` | | `/logout` bewirkt nichts | Sie haben sich mit einem API-Key authentifiziert | Erwartetes Verhalten – es gibt keine Sitzung, die beendet werden könnte | ## Weiter - [Endpoints & API Paths](/docs/getting-started/endpoints-and-api-paths) – Tabelle Protokoll × Modellfamilie - [Gemini CLI Integration](/docs/ide/gemini) – der Vorgänger (Enterprise-Keys funktionieren weiterhin) - [Subagents](/docs/advanced/subagents) – Orchestrierung von Hintergrund-Agents - [Automation & CI/CD](/docs/advanced/headless) – 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](https://qcode.cc/pricing) können Sie loslegen.