Gemini API CLI: Google gibt Claude Code und Codex Bilder, Sprache und eigene Agenten. Was Firmen vorher regeln sollten

Google hat ein neues Werkzeug für Programmier-Agenten vorgestellt, die Gemini API CLI. Die Idee ist einfach. Wer schon mit Claude Code, Codex oder Cursor arbeitet, soll dafür nicht wechseln. Stattdessen bekommt der vorhandene Agent einen Befehl namens gemini-api und einen API-Schlüssel, und kann damit Gemini aufrufen, wann immer er es für nötig hält.

Das klingt nach einer kleinen Ergänzung. Für einen Betrieb ist es mehr: Der Agent bekommt einen neuen Weg nach draußen, auf dem er Dateien verschicken, Inhalte erzeugen und bei Google eigene Agenten mit Zeitplan einrichten kann. Wir haben das Werkzeug geladen und ausprobiert, ohne Netz und ohne Schlüssel, um zu sehen, was es tut, bevor es etwas tut.

Was die CLI kann

Laut Beschreibung im offiziellen Repository ist die Gemini API CLI eine einzelne, zustandslose Binärdatei. Sie plant nichts und schreibt keinen Code. Sie nimmt Befehle aus der Shell entgegen und reicht sie an die Gemini API weiter. Google nennt als Partner ausdrücklich Codex, Claude Code und Antigravity, dazu jeden anderen Agenten mit Shell-Zugang.

Die Befehle teilen sich in drei Gruppen. Zum Erzeugen gibt es Text, Bilder, Sprache, Musik und Video. Zum Verstehen gibt es analyze für PDFs, Bilder, Audio, Video, Tabellen und YouTube-Links und transcribe für Abschriften, auch als Untertiteldatei. Die dritte Gruppe ist die interessanteste: agent startet verwaltete Agenten bei Google im Hintergrund, environments legt Sandboxen an, credentials hinterlegt Zugangsdaten, dazu kommen webhooks und triggers für Cron-Auslöser.

Google bezeichnet das Werkzeug selbst als experimentell. Die aktuelle Fassung 0.4.4 ist vom 23. Oktober, davor gab es Fassungen am 12. und 19. Oktober. Für Anwendungen im Produktivbetrieb empfiehlt Google die normalen SDKs, die CLI ist für Terminal, Skripte und Agenten gedacht.

Unser Test: Was ein Agent sieht und was er schicken würde

Wir haben die Fassung 0.4.4 für Linux aus den GitHub-Releases geladen, nicht über das empfohlene Installationsskript, das per curl … | bash direkt in die Shell läuft. Die Prüfsumme stimmte mit der mitgelieferten Datei checksums.txt überein. Eine Build-Bescheinigung, mit der sich nachweisen ließe, dass das Archiv wirklich aus Googles Build stammt, gab es für diese Fassung nicht. Die Prüfsumme liegt auf derselben Release-Seite wie das Archiv. Wer die Seite austauscht, kann also auch die Prüfsumme austauschen.

Ausgeführt haben wir die Binärdatei in einem Container ohne Netz und mit leerem Home-Verzeichnis. Das geht, weil die CLI einen Probelauf kennt: --dry-run zeigt die fertige Anfrage, ohne sie zu senden.

Beim Befehl analyze mit einem Dokument und der Frage „Fasse zusammen“ zeigte der Probelauf eine Anfrage an generativelanguage.googleapis.com, also an die Gemini Developer API und nicht an Vertex AI in Google Cloud. Das Dokument steckte vollständig im Aufruf, als Datenblock mit seiner genauen Größe, dazu das Feld store auf false. Eine Region ließ sich in der Hilfe nirgends wählen.

Für einen Betrieb heißt das: Sobald ein Agent die CLI benutzt, um ein PDF auszuwerten, verlässt das ganze PDF das Haus. Das ist kein Fehler des Werkzeugs, es ist sein Zweck. Darüber sollte ein Mensch entscheiden. Der Agent sollte es nicht allein tun, nur weil die mitgelieferte Anweisung von Google ihn dazu einlädt.

Zugangsdaten und Zeitpläne bei Google

Spannender als die Mediendienste sind die verwalteten Agenten. Mit credentials create kann ein Agent bei Google Zugangsdaten ablegen. Die Hilfe zeigt als erstes Beispiel ausgerechnet ein GitHub-Token. Möglich sind Bearer-Tokens, Umgebungsvariablen und OAuth2 mit Client-Geheimnis und Refresh-Token. Laut Hilfe lassen sich die Werte nur schreiben, nie wieder auslesen.

Wie das zusammenspielt, steht im Schema der Agentendefinition. Eine Umgebung kann eine Liste erlaubter Ziele im Netz bekommen. Ein Proxy bei Google setzt für passende Ziele die hinterlegten Zugangsdaten als Header ein, der Agent selbst sieht sie also nicht. Ein Stern erlaubt alle Ziele, der Wert disabled sperrt das Netz ganz. Welche Regel gilt, wenn man gar nichts angibt, steht im Schema nicht.

Das ist im Kern ein gutes Design, denn Zugangsdaten, die ein Agent nicht sieht, kann er nicht weitergeben. Es verschiebt aber etwas, das Betriebe wissen sollten. Mit Webhooks und Cron-Auslösern entsteht eine Automatisierung, die bei Google läuft, mit Zugangsdaten, die bei Google liegen, und die ein Coding-Agent nebenbei anlegen kann. In der eigenen Infrastruktur taucht davon nichts auf. Das ist Schatten-IT in einer neuen Form.

Was die Bedingungen sagen

Für die Gemini API unterscheidet Google zwischen bezahlten und unbezahlten Diensten. Bei unbezahlten Diensten werden Eingaben und Antworten zur Verbesserung der Produkte genutzt, und menschliche Prüfer können sie lesen, getrennt vom Konto. Bei bezahlten Diensten nutzt Google Eingaben und Antworten nicht dafür und verarbeitet sie unter einem Data Processing Addendum, protokolliert sie aber eine begrenzte Zeit, um Missbrauch zu erkennen.

Für Europa gibt es eine wichtige Besonderheit. Für Nutzer im Europäischen Wirtschaftsraum, in der Schweiz und im Vereinigten Königreich gelten die Datenregeln der bezahlten Dienste für alle Dienste, auch für das freie Kontingent in AI Studio. Wer Anwendungen für Nutzer im EWR anbietet, darf dafür nur bezahlte Dienste verwenden. Die API ist ausdrücklich für berufliche Zwecke gedacht, nicht für Verbraucher.

Das beantwortet die Frage nach dem Training, aber nicht alles. Ob ein Auftragsverarbeitungsvertrag für Ihren Fall genügt, welche Daten überhaupt an einen Dienst außerhalb der EU gehen dürfen und wo verarbeitet wird, bleibt eine Entscheidung, die vor dem ersten Aufruf fallen sollte. Wer die Daten in der EU halten muss, schaut sich besser Vertex AI an, dort lassen sich Regionen wählen. Was das bei Google Cloud bedeutet, haben wir am Beispiel von GPT-6 in Vertex beschrieben.

Was Firmen vorher regeln sollten

Eigener Schlüssel, eigenes Projekt, feste Grenze. Der API-Schlüssel gehört in ein Google-Projekt, das nur für diesen Zweck da ist, mit Budgetgrenze und bezahltem Tarif. Kein privater Schlüssel aus einem Testkonto.

Regeln in die Anweisungen des Agenten. Google liefert einen Textblock für AGENTS.md oder CLAUDE.md mit, der dem Agenten erklärt, wie er die CLI benutzt. Was fehlt, ist, wann er sie nicht benutzen darf. Schreiben Sie dazu, welche Dateien nie an Gemini gehen, etwa Verträge, Personalakten oder Kundendaten, und dass verwaltete Agenten, Zugangsdaten und Auslöser nur nach Rückfrage angelegt werden.

Die heiklen Befehle sperren. Wer verwaltete Agenten gar nicht braucht, sollte credentials, triggers und webhooks technisch sperren, über die Rechte des Agenten oder eine Freigabe vor jedem Shell-Befehl, wie sie AgentGuard bietet. Eine Bitte in den Anweisungen reicht dafür nicht, das zeigt der Fall aus dem Börsenprospekt von Anthropic, den wir heute ebenfalls beschrieben haben.

Sauber installieren. Archiv aus den Releases laden, Prüfsumme prüfen, die Fassung festschreiben. Ein Skript aus dem Netz direkt in die Shell zu leiten, holt bei jedem Lauf, was gerade dort liegt. Warum das bei KI-Werkzeugen besonders wehtut, steht in unserem Beitrag zum LiteLLM-Lieferkettenangriff.

Den Probelauf nutzen. --dry-run zeigt vor dem Senden genau, was rausgeht. Das ist für einen ersten Test mit echten Firmendokumenten Gold wert und kostet nichts.

Einordnung

Die Gemini API CLI ist ein ehrlich gebautes Werkzeug. Der Probelauf ohne Netz, die nicht auslesbaren Zugangsdaten und die Liste erlaubter Ziele zeigen, dass Google an Sicherheit gedacht hat. Sie macht einen Agenten aber auch mächtiger, und zwar an einer Stelle, die in vielen Betrieben noch niemand im Blick hat: bei den Diensten, die ein Agent selbst aufruft.

Welche Werkzeuge Ihre Agenten heute schon benutzen dürfen, ist eine gute Frage für die nächste Teamrunde. Wie man das über Anbindungen regelt, beschreiben wir in MCP-Server und Claude Code Mods, das Gesamtbild auf der Seite zur KI-Agenten-Governance. Wenn Sie dabei Hilfe möchten, melden Sie sich bei uns.

Quellen

Alle abgerufen am 28.10.2026.

• Google: gemini-api-cli auf GitHub (README, Befehlsübersicht, Installation, Anweisungsblock für Agenten, Lizenz Apache-2.0), Releases v0.4.4 vom 23.10.2026, v0.4.3 vom 19.10.2026, v0.4.2 vom 12.10.2026
• Google AI Studio: Introducing the Gemini API CLI
• Google: Gemini API Additional Terms of Service, zuletzt geändert am 28.04.2026 (unbezahlte und bezahlte Dienste, Regel für EWR, Schweiz und Vereinigtes Königreich, nur berufliche Nutzung)
• Eigener Test vom 28.10.2026: gemini-api 0.4.4 (Linux x86_64), Prüfsumme gegen checksums.txt geprüft, gh attestation verify ohne Treffer, ausgeführt in einem Container ohne Netz mit leerem Home-Verzeichnis: --help der Befehle credentials und triggers, Schema von agent create, Probeläufe von analyze und generate mit --dry-run

Stand: 28. Oktober 2026. Die Gemini API CLI ist laut Google experimentell, Befehle und Standardwerte können sich mit jeder Fassung ändern.