Der Betrieb von Antigravity in WSL2 unter Windows vereint das Beste aus beiden Welten — eine Linux-Entwicklungsumgebung mit Windows-Desktop-Integration. Doch das Setup läuft nicht von Haus aus reibungslos. Defekte Launcher, OAuth-Fehler, Sandbox-Konflikte und Speicherprobleme sind in der Community bestens dokumentiert. Dieser Guide bietet verifizierte Fixes für jedes Problem.
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
1. Voraussetzungen
# WSL-Version prüfen (muss WSL2 sein, nicht WSL1)
wsl --list --verbose
# Falls WSL2 nicht installiert ist:
wsl --install
# Nach der Installation neu starten
# Überprüfen, ob WSL2 läuft
wsl --list --verbose
# Sollte VERSION 2 für deine Distro anzeigen
2. Installationsschritte
Option 1: Unter Windows installieren (Verbindung zu WSL2 via Remote)
Lade Antigravity für Windows von der offiziellen Website herunter
Nutze Remote-SSH oder Remote-WSL, um dich mit deiner WSL2-Distro zu verbinden
Option 2: Antigravity CLI (agy) innerhalb von WSL2 installieren
# In deinem WSL2-Terminal:
curl -fsSL https://antigravity.dev/install.sh | bash
Option 3: Die Gemini CLI in WSL2 nutzen (am zuverlässigsten)
npm install -g @google/gemini-cli
gemini auth login
3. Fix: Defekter agy CLI Launcher
Die Antigravity CLI (agy) unter WSL schlägt oft direkt nach der Installation fehl, da einige Windows-Installer-Builds ohne die Skripte ausgeliefert werden, die Windows und WSL verbinden. Der schnellste Fix besteht darin, die fehlenden Skripte von VS Code zu kopieren:
# Prüfen, ob agy im PATH ist
which agy
# Falls nicht gefunden, manuell zum PATH hinzufügen:
export PATH="$PATH:/mnt/c/Users/YOU/AppData/Local/Programs/Antigravity/bin"
# Fix dauerhaft machen
echo 'export PATH="$PATH:/mnt/c/Users/YOU/AppData/Local/Programs/Antigravity/bin"' >> ~/.bashrc
# Falls agy weiterhin fehlschlägt, Launcher-Skripte von VS Code kopieren:
cp /mnt/c/Users/YOU/AppData/Local/Programs/"Microsoft VS Code"/bin/* \
/mnt/c/Users/YOU/AppData/Local/Programs/Antigravity/bin/
4. Fix: Authentifizierungs- / OAuth-Fehler
Googles OAuth 2.0 reagiert empfindlich auf Zeitabweichungen, und WSL2-Uhren driften häufig ab, wenn ein Laptop in den Energiesparmodus wechselt. Dies führt dazu, dass Tokens als abgelaufen abgelehnt werden, was plötzliche Authentifizierungsfehler zur Folge hat.
# Aktuelle WSL2-Zeit mit der tatsächlichen Zeit vergleichen
date
# Fix 1: Mit der Hardware-Uhr synchronisieren
sudo hwclock -s
# Fix 2: NTP-Synchronisierung erzwingen
sudo ntpdate time.google.com
# Fix 3: Dauerhafte Lösung — zur .bashrc hinzufügen
echo 'sudo hwclock -s 2>/dev/null' >> ~/.bashrc
# Anschließend erneut authentifizieren
antigravity auth login
Bei anderen Authentifizierungsproblemen siehe unseren Leitfaden zur Fehlerbehebung bei der Anmeldung.
5. Fix: Probleme mit dem Sandbox-Modus (v1.21.6)
Das v1.21.6-Update hat Linux-Sandboxing eingeführt, das User Namespaces erfordert. Einige gehärtete Linux-Distributionen (und WSL2-Konfigurationen) deaktivieren unprivilegierte User Namespaces, was zum Absturz des Renderers führt.
# Prüfen, ob User Namespaces aktiviert sind
sysctl kernel.unprivileged_userns_clone
# Wenn der Wert 0 ist, aktivieren:
sudo sysctl -w kernel.unprivileged_userns_clone=1
# Dauerhaft machen:
echo 'kernel.unprivileged_userns_clone=1' | sudo tee /etc/sysctl.d/99-userns.conf
# Alternative: Ohne Sandbox starten (weniger sicher)
antigravity --no-sandbox
Für alle Probleme mit v1.21.6 siehe unseren speziellen v1.21.6-Fix-Leitfaden.
6. Speicherverwaltung
WSL2 verbraucht so viel Speicher, wie der Windows-Host zulässt, was zu Antigravity-Abstürzen führen kann, wenn WSL zu viel RAM beansprucht. Legen Sie ein Speicherlimit fest in .wslconfig:
# %USERPROFILE%\.wslconfig erstellen/bearbeiten
# (z. B. C:\Users\NUTZER\.wslconfig)
[wsl2]
memory=8GB # WSL2 auf 8 GB RAM begrenzen
processors=4 # CPU-Kerne begrenzen
swap=4GB # Größe der Swap-Datei
localhostForwarding=true
# Änderungen übernehmen:
wsl --shutdown
# Danach das WSL2-Terminal neu öffnen
7. Performance-Optimierung
- Projekte im Linux-Dateisystem speichern: Dateien unter
~/projects/(natives Linux) sind deutlich schneller als/mnt/c/(cross-filesystem). Diese eine Änderung kann die Ladezeit des Agents um 50–70% reduzieren. - .antigravityignore aggressiv konfigurieren: Füge
node_modules/,.git/,dist/, undbuild/hinzu, um zu verhindern, dass der Agent umfangreiche Verzeichnisse indiziert. Siehe unseren Leitfaden zum Laden von Agents. - Echtzeitschutz von Windows Defender für Entwicklungsordner deaktivieren: Füge deine WSL2-Projektpfade zu den Defender-Ausschlüssen hinzu. Der Echtzeit-Scanner verursacht erheblichen I/O-Overhead.
- systemd für WSL2 verwenden: Aktiviere systemd in
/etc/wsl.confmit[boot] systemd=truefür eine bessere Dienstverwaltung. - WSL regelmäßig neu starten:
wsl --shutdownüber die PowerShell leert angesammelten Arbeitsspeicher und Prozess-Bloat.
8. Browser-Automatisierung unter WSL2
Die Browser-Automatisierungsfunktionen von Antigravity erfordern einen Display-Server. Unter WSL2 musst du entweder WSLg (Windows 11) verwenden oder einen X-Server installieren:
# Windows 11 mit WSLg (integrierte GUI-Unterstützung):
# Funktioniert einfach! WSLg stellt den Display-Server bereit.
# Windows 10 (X-Server installieren):
# VcXsrv oder X410 unter Windows installieren
# Dann in WSL2:
export DISPLAY=$(ip route show | grep -i default | awk '{print $3}'):0.0
echo 'export DISPLAY=$(ip route show | grep -i default | awk "{print $3}"):0.0' >> ~/.bashrc
# Browser-Abhängigkeiten installieren
sudo apt install -y chromium-browser