Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Praxisorientierte Labs: Gemini CLI

1. Einführung

In diesem Codelab erfahren Sie mehr über die Gemini CLI, einen Open-Source-KI-Agenten, der die Leistungsfähigkeit von Gemini direkt in Ihr Terminal bringt.

Lerninhalte

Gemini CLI installieren und konfigurieren
Tools, integrierte Befehle und die Konfiguration von MCP-Servern in der Gemini CLI kennenlernen
Gemini CLI über die Datei GEMINI.md anpassen
Einige Anwendungsfälle mit der Gemini CLI

Voraussetzungen

Dieses Codelab kann vollständig in der Google Cloud Shell ausgeführt werden, wo die Gemini CLI vorinstalliert ist.

Wenn Sie lieber auf Ihrem eigenen Computer arbeiten möchten, finden Sie einen Abschnitt zur lokalen Installation der Gemini CLI.

Sie benötigen Folgendes:

Chrome-Webbrowser
Ein Gmail-Konto

Dieses Codelab richtet sich an Nutzer und Entwickler aller Erfahrungsstufen (auch Anfänger). Die Anwendungsfälle im Codelab wurden in Entwickler- und Nichtentwickleraufgaben unterteilt. Die Anwendungsfälle für Entwickler zeigen, wie Sie mit der Gemini CLI Code vibrieren und mit einem GitHub-Repository arbeiten können, um häufige Entwicklungsaufgaben wie Codeerklärung/Codeverständnis, Generieren von Dokumentation und Beheben von Problemen auszuführen. Wir empfehlen, diese Anwendungsfälle im Codelab durchzuarbeiten. Am Ende gibt es einen optionalen Abschnitt, in dem mehrere alltägliche Aufgaben behandelt werden, die nicht auf Entwickler ausgerichtet sind.

2. Hinweis

Projekt erstellen

Wählen Sie in der Google Cloud Console auf der Seite zur Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
Sie verwenden Cloud Shell, eine Befehlszeilenumgebung, die in Google Cloud ausgeführt wird und in der bq vorinstalliert ist. Klicken Sie oben in der Google Cloud Console auf „Cloud Shell aktivieren“.

Bild des Buttons „Cloud Shell aktivieren“

Sobald die Verbindung mit der Cloud Shell hergestellt ist, können Sie mit dem folgenden Befehl prüfen, ob Sie bereits authentifiziert sind und für das Projekt schon Ihre Projekt-ID eingestellt ist:

gcloud auth list

Führen Sie den folgenden Befehl in Cloud Shell aus, um zu prüfen, ob der gcloud-Befehl Ihr Projekt kennt.

gcloud config list project

Wenn Ihr Projekt nicht festgelegt ist, verwenden Sie den folgenden Befehl, um es festzulegen:

gcloud config set project <YOUR_PROJECT_ID>

3. Installation

Bevor Sie die Einrichtung vornehmen und die Gemini CLI ausführen, erstellen wir einen Ordner, der als Basisordner für alle Projekte dient, die wir darin erstellen. Dies ist ein Ausgangspunkt für die Arbeit mit der Gemini CLI. Bei Bedarf können Sie aber auch auf andere Ordner in Ihrem System verweisen.

Erstellen Sie einen Beispielordner (gemini-cli-projects) und wechseln Sie mit den unten gezeigten Befehlen zu diesem Ordner. Wenn Sie einen anderen Ordnernamen verwenden möchten, können Sie das tun.

mkdir gemini-cli-projects

Rufen wir diesen Ordner auf:

cd gemini-cli-projects

Sie können die Gemini CLI direkt über den Befehl gemini starten.

Fahren Sie direkt mit dem nächsten Abschnitt fort (Gemini CLI über settings.json konfigurieren).

Wenn Sie die Gemini CLI lokal installieren möchten, folgen Sie der Anleitung unten. Die Gemini CLI ist in Cloud Shell und Cloud Workstations vorinstalliert.

Als Erstes müssen Sie Node 20+ auf Ihrem Computer installieren. Sobald dies abgeschlossen ist, können Sie die Gemini CLI mit einer der folgenden Methoden installieren und ausführen:

Sie können die Gemini CLI zuerst global auf Ihrem System installieren. Möglicherweise benötigen Sie Administratorzugriff, um diesen Schritt auszuführen.

# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini

Führen Sie sie mit dem folgenden Befehl aus:

# option 2: run without installing Gemini CLI

npx https://github.com/google-gemini/gemini-cli

Mit dem folgenden Befehl können Sie prüfen, ob die CLI installiert ist:

gemini --version

Wenn Sie die Gemini CLI über eine der oben genannten Methoden gestartet haben, werden Sie beim ersten Start möglicherweise aufgefordert, ein Design auszuwählen. Wenn ja, können Sie entweder das Standarddesign verwenden oder ein Design Ihrer Wahl auswählen.

Als Nächstes ist die Authentifizierung wichtig. Sie werden nach der Authentifizierungsmethode gefragt. Es wird empfohlen, in diesem Lab Ihr privates Google-Konto und keine Konten zu verwenden, die nicht mit Google oder Google Workspace in Verbindung stehen.

Wenn Sie mit dem aktuellen kostenlosen Kontingent für Google-Konten an die Grenzen stoßen, können Sie den Gemini API-Schlüssel oder Google Cloud Vertex AI verwenden. Dazu benötigen Sie eine Projekt-ID und den Standortnamen für dieses Projekt. Wenn Sie andere Authentifizierungsmethoden verwenden möchten, lesen Sie den Abschnitt Authentifizierung in der Dokumentation.

Klicken Sie auf „Eingabe“. Daraufhin wird im Browser eine Google-Authentifizierungsseite geöffnet. Fahren Sie mit der Authentifizierung mit Ihrem Google-Konto fort, akzeptieren Sie die Nutzungsbedingungen und sobald Sie erfolgreich authentifiziert wurden, ist die Gemini CLI bereit für Ihre Befehle.

Hier ein Beispiel-Screenshot:

In diesem Fall haben wir die Vertex AI-Option ausgewählt. In Ihrem Fall kann es sich aber auch um das private Konto handeln. Wir haben das Gemini 2.5-Modell ausgewählt (unten rechts). Mit dem Befehl /model können Sie jederzeit ein bestimmtes Modell auswählen.

4. Gemini CLI über settings.json konfigurieren

Wenn Sie Gemini in der Cloud Shell ausführen, sind sowohl ein Standarddesign für die Gemini CLI als auch die Authentifizierungsmethode vorab ausgewählt und konfiguriert.

Wenn Sie die Gemini CLI auf Ihrem Computer installiert und zum ersten Mal gestartet haben, haben Sie ein Design und dann eine Authentifizierungsmethode ausgewählt.

Bei nachfolgenden Ausführungen der Gemini CLI werden Sie nicht mehr aufgefordert, ein Design und eine Authentifizierungsmethode auszuwählen. Das bedeutet, dass die Einstellungen irgendwo gespeichert werden. Die Datei, die dafür verwendet wird, heißt settings.json. Mit ihr lässt sich die Gemini CLI anpassen.

Einstellungen werden mit der folgenden Priorität angewendet (Cloud Shell stellt nur Nutzereinstellungen zur Verfügung):

System: /etc/gemini-cli/settings.json (gilt für alle Nutzer, überschreibt Nutzer- und Workspace-Einstellungen).
Workspace: .gemini/settings.json (überschreibt die Nutzereinstellungen).
Nutzer: ~/.gemini/settings.json.

Windows-Nutzer: %USERPROFILE%.gemini\settings.json (wird in der Regel zu C:\Users<IhrNutzername>.gemini\settings.json erweitert)

System: %ProgramData%\gemini-cli\settings.json (wird normalerweise zu C:\ProgramData\gemini-cli\settings.json erweitert)

Mac-Nutzer: ~/.gemini/settings.json (wird zu /Users/<IhrNutzername>/.gemini/settings.json erweitert)

System: /etc/gemini-cli/settings.json

Wenn Sie sich erinnern, haben Sie beim Auswählen des Designs festgelegt, dass die Einstellungen in den Nutzereinstellungen gespeichert werden sollen. Rufen Sie also ~/.gemini folder auf. Dort sehen Sie die Datei settings.json.

Meine settings.json-Datei ist unten zu sehen. Wenn Sie ein anderes Design ausgewählt hätten, würde der Name dort angezeigt.

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal" or "cloud-shell"
    }
  },
  "ui": {
    "theme": "Default"
  }
}

5. Erste Interaktion mit der Gemini CLI

Legen wir also mit der Gemini CLI los. Geben Sie die folgende Anfrage ein:

Give me a famous quote on Artificial Intelligence and who said that?

Die erwartete Antwort lautet:

 > Give me a famous quote on Artificial Intelligence and who said that?                 
✦ "The only way to do great work is to love what you do." - Steve Jobs (While not directly about AI, it's a famous quote related to technology and innovation, which underpins AI development.)
Alternatively:
  "The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking

Sie können sich schnell einen Überblick über die Gemini CLI und die verschiedenen unterstützten Befehle verschaffen, indem Sie /help (Schrägstrich) eingeben. Sie erhalten dann verschiedene Befehle und Tastenkombinationen.

Wir beenden die Gemini CLI jetzt. Sie können dies entweder über den Befehl /quit oder durch zweimaliges Drücken von Ctrl-C in der interaktiven Gemini CLI-Terminalsitzung tun. Wenn Sie die Gemini CLI beenden, werden Ihnen die Sitzungsstatistiken angezeigt, die Ihnen Einblicke in Ihre Sitzung, die Modellnutzung und andere Messwerte geben.

6. Gemini CLI – Befehlsparameter

Beim Starten der Gemini CLI können Sie einige Befehlszeilenparameter angeben. Eine vollständige Liste der Optionen erhalten Sie mit --help (siehe unten).

gemini --help

Dadurch sollten alle verfügbaren Optionen angezeigt werden. Hier finden Sie die Dokumentation.

Sehen wir uns einige davon an. Zuerst müssen Sie die Gemini CLI so konfigurieren, dass sie einen bestimmten Gemini-Modus verwendet. Zum Zeitpunkt der Aktualisierung dieses Labs wird diese Liste der Modelle unterstützt. Wenn Sie ein bestimmtes Modell verwenden möchten, können Sie dies beim Starten der Gemini CLI über den Parameter -m angeben, wie unten gezeigt:

gemini -m "gemini-2.5-flash"

Wenn Sie die Gemini CLI auf diese Weise starten, können Sie das jeweilige Modell unten rechts im Gemini CLI-Terminal nachsehen.

Sobald Sie sich in der Gemini CLI-Anwendung befinden, können Sie mit dem Befehl /model ein Dialogfeld öffnen, in dem Sie ein Modell auswählen können. Unten sehen Sie einen Beispiel-Lauf. Je nach Ihren Anforderungen und den gegebenen Anleitungen können Sie das Modell immer wieder wechseln, um das richtige für die Aufgabe auszuwählen. Berücksichtigen Sie dabei die Komplexität und die Notwendigkeit, die Kosten zu kontrollieren.

Nicht interaktiver Modus

Eine interessante Option ist die Ausführung der Gemini CLI im nicht interaktiven Modus. Das bedeutet, dass Sie den Prompt direkt eingeben und Gemini darauf antwortet, ohne dass sich das interaktive Terminal der Gemini CLI öffnet. Das ist sehr nützlich, wenn Sie die Gemini CLI automatisiert im Rahmen eines Skripts oder eines anderen Automatisierungsprozesses verwenden möchten. Sie verwenden den Parameter -p, um den Prompt für die Gemini CLI anzugeben, wie unten gezeigt:

gemini -p "What is the gcloud command to deploy to Cloud Run"

Beachten Sie jedoch, dass keine Möglichkeit besteht, die Unterhaltung mit weiterführenden Fragen fortzusetzen. In diesem Modus können Sie auch keine Tools (einschließlich WriteFile) autorisieren oder Shell-Befehle ausführen.

Wenn Sie den Parameter -p nicht angeben, sondern nur Folgendes, wird die Gemini CLI mit dem Prompt geöffnet und die Ausführung wird dort fortgesetzt.

gemini "What is the gcloud command to deploy to Cloud Run"

7. Gemini CLI – integrierte Tools

Die Gemini CLI enthält eine Reihe integrierter Tools. In der Dokumentation zu Tools heißt es: „Das Gemini-Modell verwendet diese Tools, um mit Ihrer lokalen Umgebung zu interagieren, auf Informationen zuzugreifen und Aktionen auszuführen. Diese Tools erweitern die Möglichkeiten der CLI, sodass sie nicht nur Text generieren, sondern auch bei einer Vielzahl von Aufgaben unterstützen kann.“

Mit dem Befehl /tools können Sie eine Liste der aktuell integrierten Tools aufrufen, wie unten gezeigt:

Available Gemini CLI tools:
  - Activate Skill (activate_skill)
  - Ask User (ask_user)
  - Edit (replace)
  - Enter Plan Mode (enter_plan_mode)
  - FindFiles (glob)
  - GoogleSearch (google_web_search)
  - Invoke Subagent (invoke_agent)
  - List Background Processes (list_background_processes)
  - Read Background Output (read_background_output)
  - ReadFile (read_file)
  - ReadFolder (list_directory)
  - SearchText (grep_search)
  - Shell (run_shell_command)
  - Update Topic Context (update_topic)
  - WebFetch (web_fetch)
  - WriteFile (write_file)

Eine der Fragen, die Ihnen sofort in den Sinn kommen sollten, ist, ob Gemini CLI diese Tools einfach aufrufen kann, wann immer es möchte. Die Standardantwort lautet nein, wenn es um sensible Vorgänge geht, bei denen beispielsweise an das lokale System geschrieben, aus einem externen System gelesen oder auf das externe Netzwerk zugegriffen wird.

Beim Starten der CLI ist zwar der Modus --yolo verfügbar (im Allgemeinen nicht empfohlen), aber die Gemini CLI fordert Sie möglicherweise auf, die Ausführung des von ihr ausgewählten Tools zu genehmigen. Sie können die Berechtigung entweder verweigern, einmalig zulassen oder dauerhaft erteilen. Sie haben die volle Kontrolle und sollten diese auch behalten.

Wir verwenden einen Prompt, mit dem die Gemini CLI eines der integrierten Tools auswählt und ausführt. So bekommen Sie einen guten Einblick in die Funktionsweise.

Nehmen wir an, Sie möchten Informationen zu aktuellen Nachrichten aus aller Welt für den Bereich Finanzen abrufen. Diese Informationen möchten Sie in dem lokalen Verzeichnis speichern, von dem aus Sie die Gemini CLI gestartet haben. Verwenden Sie den folgenden Prompt:

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

Stellen Sie sich vor, was es tun sollte. Idealerweise sollte es eine Google-Suche durchführen, um Nachrichten aus relevanten Informationsquellen zu erhalten, die Finanznachrichten liefern können. Anschließend muss eine Datei mit dem Namen finance-news-today.txt erstellt werden (ein Schreibvorgang auf Ihrem lokalen System, für den Ihre Berechtigung erforderlich ist).

Sehen wir uns an, was passiert (Sie sollten auf Ihrem Computer genauso vorgehen).

Zuerst wird das Tool GoogleSearch für die Suche im Web aufgerufen und die Ergebnisse werden abgerufen, wie unten dargestellt:

 Searching for Finance News: 
  I will first search for the latest finance headlines and then save them to a file.
  ✓  GoogleSearch  Searching the web for: "latest finance headlines"
   → Search results for "latest finance headlines" returned.
  Saving Finance News: I will now save the finance headlines to the file 'finance-news-today.txt'.

Sobald das erledigt ist, kann dies in die Datei geschrieben werden. Dazu wird das Tool WriteFile verwendet. Da dies ein sensibler Vorgang ist (Schreiben), werden Sie um Erlaubnis gebeten. Sie können den Berechtigungstyp auswählen, wie beispielsweise „Einmal zulassen“ oder „Immer zulassen“. Wählen Sie jetzt „Einmal zulassen“ aus.

Die Informationen werden in die Datei geschrieben und es wird eine Bestätigung angezeigt:

✦ I have saved the latest finance news to finance-news-today.txt.
  Finance News Saved: The task is complete.

Wie kann ich prüfen, ob die Datei geschrieben wurde? Sie können @file verwenden, um den Inhalt vorlesen zu lassen. Sobald Sie @ eingeben, wird eine Liste der Dateien im aktuellen Ordner angezeigt, einschließlich der gerade erstellten Datei. Wählen Sie diese Option aus und senden Sie den Prompt ab. Mein Prompt lautet:

read the contents of @finance-news-today.txt

Dadurch werden die erforderlichen Tools (ReadManyFiles, ReadFile) aufgerufen und die Inhalte werden wie unten dargestellt angezeigt:

  ✓  ReadManyFiles  Attempting to