# Antigravity CLI: praktische Anleitung für Googles agy

URL: https://agentvera.dev/de/blog/how-to-use-antigravity-cli/ · Veröffentlicht: 2026-11-05

Antigravity CLI Anleitung: agy installieren, anmelden, AGENTS.md schreiben, Modell und Effort wählen, Modi, Rechte, MCP und der Umstieg von Gemini CLI.

**Kurz gesagt:**

- Antigravity CLI (agy) ist Googles Terminal-Agent, der Gemini CLI am 18. Juni 2026 für Google AI Pro, Ultra und kostenlose Einzelnutzer abgelöst hat.
- Installation per Skript, agy im Projekt starten, mit dem Google-Konto anmelden; Projektregeln bleiben in AGENTS.md oder GEMINI.md, die agy unverändert liest.
- MCP-Server wandern aus settings.json in mcp_config.json, Extensions werden mit agy plugin import gemini zu Plugins, und --mode ersetzt --approval-mode.

Antigravity CLI ist Googles Coding-Agent fürs Terminal. Du installierst ihn mit einem Skript, startest ihn mit `agy` im Projektordner, meldest dich mit deinem Google-Konto an und beschreibst die Aufgabe. Er liest deine Dateien, schlägt Änderungen und Befehle vor und fragt im Standardmodus nach, bevor er etwas ändert.

Wer Gemini CLI mit einem privaten Konto genutzt hat, landet hier. Google hat im [Developer-Blog am 19. Mai 2026](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ "Übergang von Gemini CLI zu Antigravity CLI") angekündigt, dass Gemini CLI ab dem **18. Juni 2026** keine Anfragen von Google-AI-Pro- und -Ultra-Abonnenten sowie kostenlosen Nutzern von Gemini Code Assist für Einzelpersonen mehr bedient. Diese Anleitung behandelt Installation, Anmeldung, Projektanweisungen, Modelle und Effort, Modi und Rechte, MCP, die wichtigsten Befehle, den Umstieg von Gemini CLI und die Limits, die Google nennt. Alles folgt [Googles Antigravity-Dokumentation](https://antigravity.google/docs/getting-started?tab=cli "Antigravity Quickstart") mit Stand November 2026.

## Was Antigravity CLI ist und für wen

Antigravity CLI ist der Terminal-Client von Google Antigravity, Googles agentenorientierter Entwicklungsplattform. Laut Google ist er in Go geschrieben und teilt sich das Agent-Harness mit der Desktop-App Antigravity 2.0; Verbesserungen am Agenten kommen also in beiden an. Die bekannten Bausteine aus Gemini CLI bleiben: Agent Skills, Hooks, Subagents und Extensions, die jetzt Plugins heißen.

Er passt zu dir, wenn du:

- Gemini CLI mit privatem Google-Konto, Google AI Pro oder Ultra genutzt hast;
- einen [Coding-Agenten](/de/glossary/coding-agent/ "Was ist ein Coding-Agent") im Terminal willst, der Gemini-Modelle (und je nach Tarif weitere) nutzt;
- Antigravity schon am Desktop verwendest und denselben Agenten per SSH oder in Skripten brauchst.

Teams mit einer Lizenz für Gemini Code Assist Standard oder Enterprise oder einem bezahlten Gemini-API-Key können bei Gemini CLI bleiben; dafür gibt es unsere [Gemini-CLI-Anleitung](/de/blog/how-to-use-gemini-cli/ "Gemini CLI nutzen"). Google sagt offen, dass es zum Start keine 1:1-Funktionsgleichheit gibt.

## Installation

| System | Befehl |
| --- | --- |
| macOS, Linux | `curl -fsSL https://antigravity.google/cli/install.sh \| bash` |
| Windows (PowerShell) | `irm https://antigravity.google/cli/install.ps1 \| iex` |
| Windows (CMD) | `curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd` |

Unter macOS und Linux landet das Programm in `~/.local/bin/agy`, unter Windows in `AppData\Local\agy\bin`. Prüfen:

```bash
agy --version
```

## Anmelden

Wechsle ins Projekt und starte:

```bash
cd mein-projekt
agy
```

Beim ersten Start fragt agy nach Farbschema, Darstellungsmodus (Alt-Screen oder Inline) und ob du dem Ordner vertraust. Danach öffnet sich der Browser für die Anmeldung mit deinem Google-Konto. Private Konten im Free-, Pro- und Ultra-Tarif funktionieren, Business-Konten melden sich über Gemini Enterprise an. Das Token liegt im Schlüsselbund des Betriebssystems (Keychain, Secret Service oder Windows-Anmeldeinformationsverwaltung), spätere Starts kommen ohne Browser aus.

Weitere Wege:

- **Per SSH:** `agy` gibt eine URL aus. Öffne sie auf deinem eigenen Rechner, melde dich an und füge den Code im Terminal ein.
- **Gemini-API-Key:** setze `"modelProvider": "gemini"` in `~/.gemini/antigravity-cli/settings.json` und exportiere `GEMINI_API_KEY`. Ohne diese Einstellung bewirkt der Key allein nichts.
- **Google-Cloud-Anmeldedaten:** `gcloud auth application-default login` ausführen und `AGY_ADC_AUTH=true` setzen.

`/logout` löscht die gespeicherte Anmeldung.

## Die erste Aufgabe

```text
Erkläre, wie das Zahlungsmodul aufgebaut ist, ergänze dann eine
Eingabeprüfung am Refund-Endpoint und lass die Tests laufen.
```

Ein paar Abkürzungen helfen von Anfang an: `@` schlägt Dateipfade vor, `!` am Anfang eines Prompts führt einen Shell-Befehl aus, `?` zeigt die Hilfe mit den Slash-Befehlen. Für Skripte führt `agy -p "fasse README.md zusammen"` einen einzelnen Prompt ohne Oberfläche aus; mit `--output-format json` kann ein anderes Programm das Ergebnis lesen. `agy -i "Prompt"` öffnet die interaktive Oberfläche mit einem ersten Prompt.

## Projektanweisungen: AGENTS.md oder GEMINI.md

Antigravity liest `AGENTS.md` oder `GEMINI.md` im Ordner, in dem du `agy` startest, und in den Elternordnern bis zur Repo-Wurzel. Beide sind immer aktiv und brauchen kein Frontmatter. Globale Regeln gehören nach `~/.gemini/AGENTS.md` oder `~/.gemini/GEMINI.md`. Regeln addieren sich, statt sich zu ersetzen.

```markdown
# Projekt: billing-service

## Befehle
- Installieren: npm ci
- Testen: npm test (vor jedem "fertig" ausführen)

## Nicht
- Keine Dateien in src/generated ändern.
```

Feiner steuerst du mit Markdown-Dateien in `.agents/rules/`. Jede braucht Frontmatter mit einem `trigger`: `always_on`, `model_decision`, `glob` (greift, wenn der Agent passende Dateien anfasst) oder `manual`. Fehlt der Trigger oder ist er ungültig, wird die Regel stillschweigend verworfen; `manual`-Regeln funktionieren in der CLI nicht, weil sie keine Regel-Erwähnungen kennt. Halte die Dateien kurz: Jede wird nach 24.000 Byte abgeschnitten, und globale sowie `always_on`-Regeln teilen sich ein Budget von 20.000 Tokens.

Liest Codex oder ein anderer Agent schon deine `AGENTS.md`, nutzt Antigravity dieselbe Datei. Wie du einen Regelsatz mit Claude Code teilst, steht in [CLAUDE.md vs. AGENTS.md](/de/blog/claude-md-agents-md/ "CLAUDE.md und AGENTS.md").

## Modelle und Effort

Das Modell wählst du pro Lauf mit `--model` (`agy models` listet sie auf) oder in der Session mit `/model`. Googles Modellseite führt Gemini-Modelle wie Gemini 3.8 Flash und Gemini 3.1 Pro neben Claude- und GPT-OSS-Modellen; welche du siehst, hängt vom Tarif ab.

Effort legt fest, wie gründlich das Modell nachdenkt. `/effort` öffnet eine Skala und speichert die Wahl als Standard; `--effort low` gilt nur für einen Lauf. Die Stufen heißen `low`, `medium`, `high`, `xhigh` und `max`, die meisten Modelle bieten aber nur low bis high, und Modelle mit festem Budget ignorieren die Einstellung.

## Modi und Rechte

| Modus | Was passiert |
| --- | --- |
| `default` | Zeigt vor dem Anlegen oder Ändern von Dateien einen Diff und fragt vor Terminal-Befehlen |
| `accept-edits` | Genehmigt Änderungen im Workspace, fragt vor Befehlen weiterhin |
| `auto` | Genehmigt Änderungen und führt Befehle in der Terminal-Sandbox aus; riskante Aktionen fragen trotzdem |
| `plan` | Analysiert und skizziert Schritte, bevor Code entsteht |

Starte mit `--mode=accept-edits` (oder `auto`, `plan`), wechsle mit Shift+Tab oder setze `"agentMode"` in `~/.gemini/antigravity-cli/settings.json`. `auto` braucht die Sandbox und ein privates Konto (ab v1.3.5 unter macOS und Linux, ab v1.4.4 unter Windows); Business-Konten bekommen ihn nicht. `--sandbox` startet eine Session in der Terminal-Sandbox.

Feine Regeln stehen in derselben Datei als Listen `allow`, `ask` und `deny`, etwa `command(git)` oder `mcp(sql/execute_mutation)`. Deny schlägt Ask, Ask schlägt Allow. `/permissions` bearbeitet sie in der Oberfläche. `--dangerously-skip-permissions` genehmigt alles; nutze es nur in einer Wegwerf-Umgebung. Warum, erklärt [Sicherheit von KI-Coding-Agenten](/de/blog/ai-coding-agent-security/ "Sicherheit von KI-Coding-Agenten").

## MCP-Server

[MCP](/de/glossary/mcp/ "Was ist MCP")-Server stehen in einer eigenen Datei: `~/.gemini/config/mcp_config.json` für alle Projekte, `.agents/mcp_config.json` für einen Workspace.

```json
{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}
```

Remote-Server müssen Streamable HTTP nutzen; der alte HTTP+SSE-Transport und `httpUrl` werden nicht unterstützt. `/mcp` öffnet eine Verwaltung mit Status, Neuladen und Logs. Tools, die du nicht freigegeben hast, laufen im Ask-Modus.

## Wichtige Befehle

| Befehl | Funktion |
| --- | --- |
| `/model`, `/effort` | Modell und Denktiefe ändern |
| `/permissions` | Allow-, Ask- und Deny-Regeln verwalten |
| `/config` oder `/settings` | Einstellungen öffnen |
| `/mcp` | MCP-Server verwalten |
| `/plan` | Recherchieren, nachfragen, prüfbaren Plan entwerfen |
| `/resume` | Frühere Unterhaltung aus diesem Ordner wählen |
| `/rewind`, `/undo` | In der Unterhaltung zurückgehen |
| `/fork`, `/clear` | Unterhaltung abzweigen oder neu beginnen |
| `/usage`, `/credits` | Modellkontingente und AI-Credits |
| `/plugin` | Plugins installieren, aktivieren, auflisten |

In der Shell setzt `agy -c` die letzte Unterhaltung in diesem Ordner fort, `--conversation <id>` öffnet eine bestimmte. `--add-dir` nimmt einen weiteren Ordner in den Workspace auf.

## Umstieg von Gemini CLI

Startest du `agy` zum ersten Mal auf einem Rechner mit Gemini-CLI-Konfiguration, fragt eine Checkliste, was übernommen werden soll: Extensions, globale Einstellungen, Session-Tokens und Darstellung. Was laut Googles [Migrationsanleitung](https://antigravity.google/docs/cli/gcli-migration "Gemini-CLI-Migration") mitkommt und was nicht:

- **Unverändert:** `GEMINI.md` und `AGENTS.md` im Projekt, `~/.gemini/GEMINI.md` und globale Skills in `~/.gemini/skills/`.
- **Umgewandelt:** Extensions werden mit `agy plugin import gemini` zu Plugins, ihre Befehle zu Skills.
- **Von Hand verschieben:** Workspace-Skills von `.gemini/skills/` nach `.agents/skills/`; MCP-Server aus `~/.gemini/settings.json` in `mcp_config.json`, dabei `url` oder `httpUrl` in `serverUrl` umbenennen.
- **Nicht garantiert:** manche eigenen Themes und visuellen Overlays.
- **Flags:** `--approval-mode` gibt es nicht mehr, nimm `--mode`. Einen yolo-Modus gibt es nicht.

## Limits und Preise

Googles [Tarifseite](https://antigravity.google/docs/plans "Antigravity-Tarife") schließt die CLI in jeden Tarif ein und beschreibt Kontingente ohne Zahlen: Ultra hat das höchste Kontingent, alle fünf Stunden erneuert; Pro ein hohes, alle fünf Stunden erneuert bis zu einem Wochenlimit; andere Tarife ein wöchentlich erneuertes Kontingent. Die Limits richten sich danach, wie viel Arbeit der Agent erledigt. Bei Pro und Ultra können AI-Credits nach dem Kontingent einspringen, abgerechnet zu den Verbrauchspreisen von Gemini Enterprise; eine Einstellung schaltet das ab. `/usage` und `/credits` zeigen den Stand.

## Neben Claude Code und Codex

Antigravity ist oft nur einer von mehreren Agenten. Ein paar Gewohnheiten halten Ordnung:

- **Eine gemeinsame Regeldatei.** Antigravity und Codex lesen beide `AGENTS.md`; Claude Code liest `CLAUDE.md`, die darauf verweisen kann.
- **Ein Worktree pro Agent.** Gib jedem Agenten seinen eigenen [Git-Worktree](/de/blog/git-worktree-parallel-agents/ "Git-Worktrees für parallele Agenten"), damit sie nicht dieselben Dateien bearbeiten.
- **Überall dieselben MCP-Server.** Jedes Tool hat seine eigene Konfiguration, also trägst du denselben Server dreimal ein.

Wir bauen AgentVera, eine Desktop-App für macOS, Windows und Linux, die Antigravity CLI neben Claude Code, Codex, Gemini CLI und anderen Agenten ausführt, jeden in einem echten Terminal mit deiner eigenen Installation und Anmeldung. Für Antigravity im Einzelnen ([Details](/de/agents/antigravity/ "Antigravity in AgentVera")):

- **[Workspace](/de/features/workspace/ "Workspace"):** Antigravity ist eine Kachel im Agenten-Raster pro Projekt und kehrt nach einem Neustart in seine Unterhaltung zurück.
- **Rechte:** pro Agent Fragen, Auto (`--mode=accept-edits`) oder Vollzugriff (`--dangerously-skip-permissions`).
- **Modell und Effort:** beim Anlegen des Agenten ein Modell und low, medium oder high wählen.
- **Anweisungen:** agy hat kein Flag für zusätzliche Anweisungen, also bleiben Regeln in `AGENTS.md` oder `GEMINI.md`.
- **[MCP-Manager](/de/features/mcp-manager/ "MCP-Manager"):** einmal eingerichtete Server kommen beim Start zu Antigravity hinzu, neben deiner eigenen `mcp_config.json`.
- **Worktrees:** im [Git-Panel](/de/features/git-and-github/ "Git und GitHub") einen anlegen und Antigravity darin starten, Claude Code in einem anderen.

Raster, Worktrees, Code-Review und MCP-Manager gehören zum Free-Tarif. Wie Googles Agenten im Vergleich zu Anthropic abschneiden, steht in [Gemini CLI vs. Claude Code](/de/blog/gemini-cli-vs-claude-code/ "Gemini CLI vs. Claude Code"); oder du [lädst AgentVera herunter](/de/download/ "AgentVera herunterladen").

## Fazit

Per Skript installieren, `agy` starten, mit Google anmelden und die vorhandene `AGENTS.md` oder `GEMINI.md` behalten. MCP-Server nach `mcp_config.json` verschieben, Extensions mit `agy plugin import gemini` importieren, im Modus `default` oder `accept-edits` beginnen und vor langen Sessions `/usage` prüfen.

## Häufige Fragen

**Ist Antigravity CLI kostenlos?** Du kannst dich mit einem privaten Google-Konto im Free-, Pro- oder Ultra-Tarif anmelden. Laut Googles Tarifseite bekommen andere Tarife ein wöchentlich erneuertes Kontingent, Pro und Ultra ein größeres, das alle fünf Stunden erneuert wird. Konkrete Zahlen nennt Google nicht.

**Liest Antigravity CLI meine GEMINI.md?** Ja. agy liest AGENTS.md und GEMINI.md im Startordner und in den Elternordnern bis zur Repo-Wurzel, dazu globale Dateien wie ~/.gemini/GEMINI.md. Beim Umstieg von Gemini CLI musst du nichts ändern.

**Wo stehen MCP-Server in Antigravity CLI?** In einer eigenen mcp_config.json: ~/.gemini/config/mcp_config.json für alle Projekte oder .agents/mcp_config.json für einen Workspace. Remote-Server nutzen serverUrl und müssen Streamable HTTP sprechen.

**Was ersetzt --approval-mode und yolo?** Das Flag --mode mit default, accept-edits, auto und plan. Shift+Tab wechselt in der Session zwischen den Modi. Wer jede Rückfrage überspringen will, hat --dangerously-skip-permissions, sinnvoll nur in einer isolierten Umgebung.

**Kann ich bei Gemini CLI bleiben?** Ja, mit einer Lizenz für Gemini Code Assist Standard oder Enterprise oder einem bezahlten Gemini-API-Key. Nutzer von Google AI Pro, Ultra und kostenlose Einzelnutzer wurden am 18. Juni 2026 zu Antigravity CLI verschoben.

---

**Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/