Wie ändere ich das Gemini-CLI-Verzeichnis?

Googles Open-Source-Gemini CLI—der terminalbasierte KI-Agent, der Gemini in Ihre Shell bringt—hat sich seit dem Launch schnell weiterentwickelt und unterstützt inzwischen umfangreiche Konfiguration, Projektkontextdateien (GEMINI.md / .gemini), benutzerdefinierte Slash-Befehle sowie Steuerung von Workspace-Verzeichnissen. Das Projekt entwickelt sich aktiv auf GitHub (offizielles Repo), ist in die öffentliche Vorschau mit großzügigen Kontingenten eingetreten und wird in andere Entwickler-Tools integriert (Editor-Integrationen und CI/Actions). Doch wenn Teams skalieren oder Sie über Laufwerke bzw. in restriktiven Umgebungen arbeiten (Container, unternehmensverwaltete Laptops, Cloud Shell, Windows-Systeme), stoßen Sie schnell auf eine praktische Frage: Wo speichert Gemini seine Dateien, und wie können Sie ändern, welche Verzeichnisse Gemini liest und schreibt?

Was ist Gemini CLI?

Gemini CLI ist Googles Open-Source-Kommandozeilen-KI-Agent, der die Leistung der Gemini-Modelle direkt in Ihr Terminal bringt. Er bietet interaktive Agent-Funktionen für Codeunterstützung, Datei- und Projektinspektion, das Ausführen von Shell-Befehlen (mit Schutzmechanismen) sowie die Integration von Tools wie Google Search, Model Context Protocol (MCP)-Erweiterungen und von Gemini mitgelieferten Mediengenerierungstools. Die CLI ist leichtgewichtig, skriptfähig und erweiterbar; sie ist im offiziellen Repository verfügbar und für einfache Installation paketiert.

Warum das Verzeichnis wichtig ist

Gemini CLI speichert Konfiguration (zum Beispiel settings.json), Systemprompts oder Kontext (GEMINI.md), zwischengespeicherte Anmeldedaten, Telemetriekennungen und anderen persistenten Zustand in einem .gemini-Verzeichnis. Wo dieses Verzeichnis liegt, steuert:

• welche Einstellungen die CLI lädt (global vs. projektspezifisch),
• welche „Memory“-Dateien der Agent liest,
• wo Anmeldedaten zwischengespeichert werden (beeinflusst das Login-Verhalten),
• Reproduzierbarkeit über Maschinen hinweg oder in CI, wenn Sie ein benutzerdefiniertes Config-Repo bereitstellen möchten.

Das Verstehen und (falls nötig) Ändern des Verzeichnisses hilft in Multi-Projekt-Workflows, CI, containerisierten Deployments und Teams mit zentralisierten Konfigurationsspeichern.

Wo speichert Gemini CLI Konfiguration standardmäßig?

Standardmäßig verwendet die CLI ein .gemini-Verzeichnis. Für die meisten Benutzerinstallationen entspricht das ~/.gemini (der .gemini-Ordner im Home-Verzeichnis). Die CLI unterstützt auch projektspezifische .gemini-Dateien (z. B. .gemini/settings.json im Projektstamm), die Benutzereinstellungen überschreiben, während Sie aus diesem Projektordner arbeiten. Systemweite Einstellungen werden aus betriebssystemspezifischen Pfaden gelesen (zum Beispiel /etc/ unter Linux oder %PROGRAMDATA% unter Windows), sofern anwendbar. Typische Pfade:

• Linux / macOS: ~/.gemini/ (zum Beispiel /home/alice/.gemini oder /Users/alice/.gemini).
• Windows: %USERPROFILE%\.gemini (z. B. C:\Users\Alice\.gemini).
  Im .gemini-Verzeichnis finden Sie typischerweise settings.json, GEMINI.md, commands/ und lokale Caches. Die CLI liest außerdem pro Projekt .gemini/-Ordner (Projektstamm) für projektspezifische Einstellungen.

Diese Standardeinstellung ist wichtig: Historisch war das Konfigurationsverzeichnis im Home-Verzeichnis auf .gemini fest verdrahtet.

---

Wie kann ich das Konfigurationsverzeichnis der Gemini CLI ändern oder umleiten?

Es gibt mehrere praktische Wege — vom einfachsten (im gewünschten Ordner arbeiten) bis zum robusteren (Umgebungsvariablen oder Dateisystem-Redirects). Wählen Sie je nach Kontrolle über die Laufzeitumgebung (lokale Entwicklungsmaschine vs. CI), Ihrem Betriebssystem und ob Sie eine temporäre oder dauerhafte Änderung bevorzugen.

1) Projektspezifisches .gemini verwenden (empfohlen für Projekteinstellungen)

Wenn Sie projektspezifische Einstellungen wünschen, erstellen Sie ein .gemini-Unterverzeichnis in Ihrem Projektstamm und platzieren Sie settings.json, GEMINI.md und andere Projektdateien dort. Die Gemini CLI zieht Projekteinstellungen vor, wenn Sie sie aus diesem Projektverzeichnis starten:

your-project/├─ .gemini/│  ├─ settings.json│  └─ GEMINI.md└─ src/

Starten Sie gemini, während Ihre Shell auf your-project/ steht, und die CLI übernimmt .gemini-Dateien aus diesem Baum (sie sucht in übergeordneten Verzeichnissen nach Projektkontext). Dies ist die sicherste, explizite Methode für projektspezifische Konfiguration.

2) Dokumentierte Umgebungsvariablen verwenden (sofern unterstützt)

Im Code und in der Dokumentation der Gemini CLI werden mehrere Umgebungsvariablen erwähnt, die das Verhalten ändern. Einige sind für Systemeinstellungen oder spezielle Dateiüberschreibungen gedacht:

• GEMINI_API_KEY, GEMINI_MODEL etc. werden üblicherweise für Authentifizierung und Modellauswahl verwendet.
• In Code und Docs gibt es Hinweise auf Variablen wie GEMINI_CLI_SYSTEM_SETTINGS_PATH (zum Überschreiben des Systemsettings-Pfads) und Konstanten wie GEMINI_CONFIG_DIR (der standardmäßige .gemini-Name im Code). In der Community wurden Anfragen und PRs eingebracht, eine GEMINI_CONFIG_DIR-Umgebungsvariable zu ergänzen bzw. zu beachten, um das gesamte Konfigurationsverzeichnis verlagern zu können.

Beispiel (bash / macOS / Linux):

# Temporary for this shell sessionexport GEMINI_CONFIG_DIR="$HOME/custom_gemini_dir"​# Or override system settings path if your install supports it:export GEMINI_CLI_SYSTEM_SETTINGS_PATH="/etc/my-gemini/system.settings.json"​# Then rungemini

PowerShell (Windows):

$env:GEMINI_CONFIG_DIR = 'C:\Users\you\CustomGemini'gemini

Wichtiger Vorbehalt: Nach den neuesten Community-Diskussionen und Issues wurde GEMINI_CONFIG_DIR angefragt und an einigen Stellen im Code referenziert — doch es wurden plattformspezifische Bugs und inkonsistentes Verhalten (insbesondere unter Windows) gemeldet. Das bedeutet, dass eine Umleitung per Umgebungsvariable nicht auf jeder Plattform oder in jedem Release durchgängig zuverlässig ist. Prüfen Sie die Release Notes der Gemini CLI und die Issues im Repo für Ihre installierte Version, wenn Sie sich darauf verlassen.

3) Verzeichnisse innerhalb einer Sitzung zum Gemini-Workspace hinzufügen

Wenn Sie möchten, dass Gemini zusätzliche Verzeichnisse kennt (damit es Dateien als Kontext lesen kann), gibt es ein interaktives /directory-Befehlssatz. Zum Beispiel:

/directory add path/to/another/project/directory list

Dies verschiebt das Konfigurationsverzeichnis nicht, ermöglicht dem Agent jedoch, Dateien aus anderen Verzeichnissen in seinen Workspace-Kontext einzubeziehen. Das ist hilfreich, wenn der Agent andere Repositories referenzieren soll, ohne Ihre globale Konfiguration zu ändern.

4) Symlink oder Filesystem-Bind erstellen (praktischer Workaround)

Wenn die CLI Umgebungsüberschreibungen nicht akzeptiert oder Sie eine zuverlässige, prozessübergreifende Lösung benötigen, verwenden Sie eine Dateisystem-Umleitung:

Unter Unix/macOS:

# move the original config foldermv ~/.gemini ~/gemini_backup​# create a symlink to your desired locationln -s /path/to/central/gemini-config ~/.gemini

Unter Windows (PowerShell mit Administratorrechten):

# Move the original directoryMove-Item -Path $env:USERPROFILE\.gemini -Destination C:\GeminiConfigBackup​# Create a junction (administrator)New-Item -ItemType Junction -Path $env:USERPROFILE\.gemini -Target C:\CentralGeminiConfig

Dieser Ansatz zwingt die CLI, aus Ihrem gewünschten Ort zu lesen, ohne native Unterstützung in der CLI zu benötigen. Hinweis: Symlinks/Junctions erfordern entsprechende Dateisystemberechtigungen und können sich in Container- oder Windows-Umgebungen anders verhalten. Mit Vorsicht verwenden. (Siehe „Windows-spezifische Hinweise“ unten.)

5) Effektives Home-Verzeichnis für den Prozess ändern (Container-/CI-Trick)

Beim Ausführen in CI, Containern oder flüchtigen Umgebungen können Sie die Variable $HOME (Unix) bzw. %USERPROFILE% (Windows) für den gemini-Prozess ändern, sodass sein Standard-~/.gemini auf einen Pfad aufgelöst wird, den Sie kontrollieren:

# Run gemini with a custom HOME (bash)HOME=/ci/workspace/you gemini --some-command​# Or in a container DockerfileENV HOME=/app/userRUN mkdir -p /app/user/.geminiCOPY config /app/user/.gemini

Dies ist nützlich für die CI-Reproduzierbarkeit. Beachten Sie jedoch: Das Ändern von HOME kann andere Tools und Authentifizierungsabläufe beeinflussen (z. B. Google-OAuth-Caches); beschränken Sie diese Technik daher auf isolierte Container oder prozessbezogene Wrapper.

Wie kann ich Gemini CLI über CometAPI installieren und verwenden?

Kurzantwort: Es gibt zwei praktische Wege — (A) Gemini-Modelle direkt über CometAPI aufrufen (empfohlen und am einfachsten) oder (B) die offizielle Gemini CLI mit CometAPI sprechen lassen, entweder durch Verwendung einer Gemini-CLI-Version, die eine benutzerdefinierte Basis-URL unterstützt (einige Releases/PRs fügen dies hinzu), oder durch Betrieb eines kleinen lokalen Proxys, der Gemini-CLI-Anfragen in CometAPI-/OpenAI-ähnliche Aufrufe übersetzt.

Was ist CometAPI?

CometAPI ist ein API-Aggregator/Gateway, der Hunderte von Drittanbieter-Modellen (einschließlich der Gemini-Familie von Google) hinter einer OpenAI-ähnlichen HTTP-API bereitstellt. Sie melden sich an, erhalten einen Bearer-API-Schlüssel und rufen dann Endpunkte wie https://api.cometapi.com/v1/chat/completions auf. CometAPI verwendet Standard-Bearer-Tokens im Authorization-Header.

Warum CometAPI verwenden? Es bietet niedrigere API-Preise als die offizielle API, um die Integration zu erleichtern. Gemini CLI Installation and Usage Guide:

Wie kann ich Gemini-Modelle direkt über CometAPI aufrufen? (Empfohlen)

Wenn Ihr Ziel lediglich die Nutzung von Gemini-Modellen ist und Sie nicht zwingend Funktionen der Gemini CLI benötigen, sind direkte Aufrufe von CometAPI unkompliziert und zuverlässig.

export COMET_KEY="sk-xxxx"​curl -s -X POST "https://api.cometapi.com/v1/chat/completions" \  -H "Authorization: Bearer $COMET_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gemini-2.5-pro",    "messages": [      {"role": "system", "content": "You are a helpful assistant."},      {"role": "user", "content": "Summarize the 3 key benefits of unit tests."}    ],    "max_tokens": 300  }' | jq .

Diese direkten Aufrufe ermöglichen es, CometAPI in Skripte, Apps oder CI zu integrieren, ohne sich auf die Gemini CLI zu stützen.

Kann ich Gemini CLI mit CometAPI verwenden?

Einige Gemini-CLI-Versionen/PRs ergänzen Umgebungsvariablen, um die Basis-URL der Gemini-API zu überschreiben. Wenn Ihre installierte gemini-Version die Konfiguration einer benutzerdefinierten Gemini-Basis-URL und die Verwendung des CometAPI-Schlüssels unterstützt, können Sie sie auf CometAPI zeigen und den CometAPI-Schlüssel als GEMINI_API_KEY setzen (die CLI erwartet eine Variable mit dem Namen GEMINI_API_KEY für die Authentifizierung des Gemini-API-Schlüssels).

Beispiel:

# example env — *check your gemini-cli docs for exact var names*export GEMINI_API_KEY="sk-xxxxx"                    # CometAPI keyexport GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com/v1"  # if supportedgemini   # run the CLI; it will use the configured base URL

Troubleshooting: häufige Probleme und Lösungen

Problem: Gemini kann Dateien in einem anderen Repo nicht sehen

1. Versuchen Sie beim Start gemini --include-directories /path/to/repo. Oder in der Sitzung: /directory add /path/to/repo.
2. Wenn sich das Repo auf einem Netzlaufwerk befindet, prüfen Sie die Berechtigungen und ob der CLI-Prozessbenutzer die Dateien lesen kann.
3. Wenn Sie einen Symlink verwendet haben, um .gemini zu verschieben, prüfen Sie, ob die CLI dem Symlink für GEMINI.md und settings.json folgt (einige Versionen folgen aus Sicherheitsgründen bestimmten Symlinks nicht).

Problem: gemini erstellt ~/.gemini unter Windows nicht (EPERM)

Dies bedeutet typischerweise, dass Ihrem Prozess die Berechtigung fehlt, in %USERPROFILE% zu schreiben. Lösungen:

• Starten Sie das Terminal als Administrator oder passen Sie die Ordnerberechtigungen an.
• Legen Sie einen benutzerdefinierten Konfigurationsort über Symlink fest oder — sofern unterstützt — über Umgebungsvariablen (achten Sie auf zukünftige Unterstützung von GEMINI_CONFIG_DIR).

Problem: cd ändert das Arbeitsverzeichnis im Shell-Modus nicht

Dies ist ein anerkanntes Problem auf einigen Plattformen. Empfehlung: Führen Sie Shell-Befehle außerhalb des Gemini-CLI-Prozesses aus oder fügen Sie Verzeichnisse über /directory add hinzu.

Problem: CometAPI-Modellnamen entsprechen nicht den Erwartungen

Rufen Sie den Endpunkt /v1/models auf und prüfen Sie das JSON. Modell-IDs enthalten häufig exakte Variantennamen (z. B. gemini-2.5-flash-preview-04-17). Verwenden Sie die exakte Zeichenfolge in Ihrer Anfrage.

Fazit

Das Standarddesign der Gemini CLI bevorzugt sinnvolles, gut auffindbares Verhalten: ein globales ~/.gemini für benutzerweite Defaults und ein projektbezogenes .gemini für per-Repo-Overrides. Die Community drängt auf mehr native Konfigurierbarkeit (explizite Umgebungsvariablen oder Flags), um das Tool für Multi-User-, containerisierte und Enterprise-Umgebungen freundlicher zu machen.

So ändern Sie das Verzeichnis der Gemini CLI:

Überblick: Gemini CLI speichert benutzerweite Konfigurations- und Kontextdateien in einem .gemini-Verzeichnis (typischerweise ~/.gemini). Sie können beeinflussen, welches Verzeichnis die CLI verwendet, indem Sie (1) auf projektspezifische .gemini-Ordner im aktuellen Arbeitsverzeichnis setzen, (2) Umgebungsvariablen oder CLI-Optionen nutzen, sofern unterstützt, (3) innerhalb einer interaktiven Sitzung Workspace-Verzeichnisse hinzufügen oder (4) Dateisystemtechniken verwenden (Symlinks, Bind-Mounts oder Änderung der Home/Profile-Variablen), wenn native Optionen fehlen.

Zum Einstieg: Entdecken Sie die Möglichkeiten der Gemini-Modelle (z. B. Gemini 3 Pro) im Playground und konsultieren Sie den API-Leitfaden für detaillierte Anweisungen. Bevor Sie zugreifen, stellen Sie bitte sicher, dass Sie sich bei CometAPI angemeldet und den API-Schlüssel erhalten haben. CometAPI bietet deutlich niedrigere Preise als die offizielle API, um die Integration zu unterstützen.

Bereit?→ Kostenloser Test der Gemini-Modelle !