Sådan ændrer du Gemini CLI-mappen

Googles open-source Gemini CLI—den terminalbaserede AI-agent, der bringer Gemini ind i din shell—er hurtigt modnet siden lanceringen og understøtter nu rig konfiguration, projektkontekstfiler (GEMINI.md / .gemini), brugerdefinerede slash-kommandoer og kontrol over arbejdsområdets mapper. Projektet udvikler sig aktivt på GitHub (officielt repo), er gået i offentlig preview med generøse kvoter og bliver integreret i andre udviklerværktøjer (editor-integrationer og CI/Actions). Men i takt med at teams skalerer, eller når du arbejder på tværs af drev eller i restriktive miljøer (containere, virksomhedsadministrerede laptops, Cloud Shell, Windows-systemer), støder du hurtigt på et praktisk spørgsmål: hvor gemmer Gemini sine filer, og hvordan kan du ændre hvilke mapper Gemini læser og skriver?

Hvad er Gemini CLI?

Gemini CLI er Googles open-source kommandolinje-AI-agent, der bringer kraften fra Gemini-modellerne direkte ind i din terminal. Den tilbyder interaktive agentfunktioner til kodehjælp, fil- og projektinspektion, udførelse af shell-kommandoer (med sikkerhedsforanstaltninger) samt integration af værktøjer som Google Search, Model Context Protocol (MCP)-udvidelser og mediegenereringsværktøjer leveret med Gemini. CLI’en er designet til at være letvægts, scriptbar og udvidelig; den er tilgængelig fra det officielle repository og pakket til nem installation. 

Hvorfor mappen er vigtig

Gemini CLI gemmer konfiguration (for eksempel settings.json), systemprompter eller kontekst (GEMINI.md), cachede legitimationsoplysninger, telemetri-id’er og anden vedvarende tilstand i en .gemini-mappe. Hvor denne mappe ligger, styrer:

• hvilke indstillinger CLI’en indlæser (globale vs. projekt-specifikke),
• hvilke “hukommelses”-filer agenten vil læse,
• hvor legitimationsoplysninger caches (påvirker loginadfærd),
• reproducerbarhed på tværs af maskiner eller CI, når du vil levere et brugerdefineret konfig-repo. 

At forstå og (om nødvendigt) ændre mappen hjælper i arbejdsgange med flere projekter, CI, containeriserede udrulninger og teams med centraliserede konfigurationslagre. 

Hvor gemmer Gemini CLI konfiguration som standard?

Som standard bruger CLI’en en .gemini-mappe. For de fleste brugerinstallationer svarer det til ~/.gemini (.gemini-mappen i din hjemmemappe). CLI’en understøtter også .gemini-filer på projektniveau (f.eks. .gemini/settings.json i projektets rod), som tilsidesætter brugerindstillinger, mens du arbejder fra den pågældende projektmappe. Indstillinger på systemniveau læses fra OS-specifikke placeringer (for eksempel /etc/ på Linux eller %PROGRAMDATA% på Windows), når det er relevant. Typiske stier:

• Linux / macOS: ~/.gemini/ (for eksempel /home/alice/.gemini eller /Users/alice/.gemini).
• Windows: %USERPROFILE%\.gemini (f.eks. C:\Users\Alice\.gemini).
  Inde i .gemini finder du typisk settings.json, GEMINI.md, commands/ og lokale caches. CLI’en læser også .gemini/-mapper pr. projekt (projektets rod) for indstillinger på projektniveau. 

Denne standard er vigtig: historisk set har konfigurationsmappen været hardkodet til .gemini i hjemmemappen

---

Hvordan kan jeg ændre eller omdirigere Gemini CLI’s konfigurationsmappe?

Der er flere praktiske måder — fra den enkleste (arbejd i den ønskede mappe) til de mere robuste (miljøvariabler eller filsystemomdirigeringer). Vælg en tilgang afhængigt af om du kontrollerer runtime-miljøet (lokal udviklingsmaskine vs. CI), hvilket OS du bruger, og om du foretrækker en midlertidig eller permanent ændring.

1) Brug en .gemini på projektniveau (anbefalet til indstillinger pr. projekt)

Hvis du vil have indstillinger pr. projekt, skal du oprette en .gemini-undermappe i din projekts rod og placere settings.json, GEMINI.md og andre projektfiler der. Gemini CLI foretrækker projektindstillinger, når du kører den fra den projektmappe:

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

Start gemini, mens din shell er i your-project/, og CLI’en vil opfange .gemini-filer fra det træ (den søger opad for at finde projektkontekst). Dette er den sikreste, eksplicitte metode til konfiguration pr. projekt. 

2) Brug dokumenterede miljøvariabler (når de understøttes)

Kodebasen og dokumentationen for Gemini CLI henviser til flere miljøvariabler, der bruges til at ændre adfærd. Nogle af disse er beregnet til systemindstillinger eller særlige filtilsidesættelser:

• GEMINI_API_KEY, GEMINI_MODEL osv. bruges ofte til godkendelse og valg af model.
• Der er henvisninger i kodebasen og dokumenterne til variabler som GEMINI_CLI_SYSTEM_SETTINGS_PATH (brugt til at tilsidesætte stien til systemindstillinger) og konstanter som GEMINI_CONFIG_DIR (det standard .gemini-navn, der bruges i koden). Nogle community-forespørgsler og PR’er foreslår at tilføje eller respektere en GEMINI_CONFIG_DIR-miljøvariabel for at lade brugere flytte hele konfigurationsmappen. 

Eksempel (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

Vigtig forbehold: ifølge den seneste community-diskussion og -issues er GEMINI_CONFIG_DIR blevet efterspurgt og refereret i koden flere steder — men der er rapporteret platformspecifikke fejl og inkonsistent adfærd (især på Windows). Det betyder, at omdirigering baseret på miljøvariabler ikke nødvendigvis er ensartet på alle platforme eller udgivelser. Tjek Gemini CLI’s release notes og repo-issues for din installerede version, hvis du er afhængig af dette. 

3) Tilføj mapper til Geminis arbejdsområde i en session

Hvis du vil have Gemini til at kende til yderligere mapper (så den kan læse filer som kontekst), findes der et interaktivt /directory-kommandosæt. For eksempel:

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

Dette flytter ikke konfigurationsmappen, men det lader agenten inkludere filer fra andre mapper i sit arbejdsområde. Det er nyttigt, når du vil have agenten til at referere til andre repositories uden at ændre din globale konfiguration. 

4) Opret et symlink eller et filsystem-bind (praktisk workaround)

Hvis CLI’en ikke vil acceptere miljøtilsidesættelser, eller du har brug for en pålidelig løsning på tværs af processer, kan du bruge en filsystemomdirigering:

På Unix/macOS:

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

På Windows (PowerShell med administratorprompt):

# 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

Denne fremgangsmåde tvinger CLI’en til at læse fra din ønskede placering uden at kræve indbygget støtte i CLI’en. Bemærk: symlinks/junctions kræver passende filsystemrettigheder og kan opføre sig anderledes i container- eller Windows-miljøer. Brug med forsigtighed. (Se “Windows-specifikke noter” nedenfor.)

5) Ændr den effektive hjemmemappe for processen (container/CI-trick)

Når du kører i CI, containere eller flygtige miljøer, kan du ændre miljøvariablen $HOME (Unix) eller %USERPROFILE% (Windows) for gemini-processen, så dens standard ~/.gemini løses til en sti, du kontrollerer:

# 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

Dette er nyttigt for CI-reproducerbarhed, men vær opmærksom: at ændre HOME kan påvirke andre værktøjer og godkendelsesforløb (fx Google OAuth-caches), så begræns denne teknik til isolerede containere eller wrappers på procesniveau.

Hvordan kan jeg installere og bruge Gemini CLI via CometAPI?

Kort svar: Du har to praktiske veje — (A) kald Gemini-modeller direkte via CometAPI (anbefalet og simpleste), eller (B) få den officielle Gemini CLI til at tale med CometAPI enten ved at bruge en Gemini-CLI-udgivelse, der understøtter en brugerdefineret base-URL (nogle udgivelser/PR’er tilføjer dette), eller ved at køre en lille lokal proxy, der oversætter Gemini-CLI-anmodninger til CometAPI/OpenAI-stil kald.

Hvad er CometAPI?

CometAPI er en API-aggregator/gateway, der eksponerer hundredvis af tredjepartsmodeller (inklusive Googles Gemini-familie) bag en HTTP-API i OpenAI-stil. Du tilmelder dig, får en bearer-API-nøgle og kalder derefter endpoints som https://api.cometapi.com/v1/chat/completions. CometAPI bruger standard bearer-tokens i Authorization-headeren.

Hvorfor bruge CometAPI? Det tilbyder lavere API-priser end den officielle API for at lette integration. Gemini CLI installations- og brugervejledning:

Hvordan kan jeg kalde Gemini-modeller direkte via CometAPI? (Anbefalet)

Hvis dit mål blot er at bruge Gemini-modeller, og du ikke strengt taget har brug for Gemini CLI-funktioner, er det enkelt og pålideligt at kalde CometAPI direkte.

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 .

Disse direkte kald lader dig integrere CometAPI i scripts, apps eller CI uden at være afhængig af Gemini CLI.

Kan jeg få Gemini CLI til at bruge CometAPI?

Nogle versioner/PR’er af Gemini CLI tilføjer miljøvariabler til at tilsidesætte Gemini API’ens base-URL. Hvis din installerede gemini understøtter at konfigurere en brugerdefineret Gemini-base-URL og bruge CometAPI-nøglen, kan du pege den mod CometAPI og sætte CometAPI-nøglen som GEMINI_API_KEY (CLI’en forventer en nøglevariabel med navnet GEMINI_API_KEY til auth med Gemini API-nøglen).

Eksempel:

# 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

Fejlfinding: almindelige problemer og løsninger

Problem: Gemini kan ikke se filer i et andet repo

1. Prøv gemini --include-directories /path/to/repo ved start. Eller i sessionen: /directory add /path/to/repo. 
2. Hvis repoet ligger på et netværksmount, skal du tjekke tilladelser og at CLI-processens bruger kan læse filerne.
3. Hvis du brugte et symlink til at flytte .gemini, skal du verificere, at CLI’en følger symlinket for GEMINI.md og settings.json (nogle versioner følger ikke visse symlinks af sikkerhedshensyn). 

Problem: gemini kan ikke oprette ~/.gemini på Windows (EPERM)

Dette betyder typisk, at din proces ikke har tilladelse til at skrive til %USERPROFILE%. Løsninger:

• Kør terminalen som Administrator, eller justér mappe-tilladelser.
• Angiv en brugerdefineret konfigurationsplacering via symlink eller, når det understøttes, via miljøvariabel (hold øje med fremtidig støtte til GEMINI_CONFIG_DIR). 

Problem: cd ændrer ikke arbejdsmappe i shell-tilstand

Dette er et anerkendt problem på nogle platforme. Anbefaling: skift til at køre shell-kommandoer uden for Gemini CLI-processen eller tilføj mapper via /directory add.

Problem: CometAPI-modelnavne matcher ikke, hvad jeg forventer

Kald endpointet /v1/models og inspicér JSON’en. Model-ID’er indeholder ofte nøjagtige variantstrenge (fx gemini-2.5-flash-preview-04-17). Brug den nøjagtige streng i din anmodning.

Konklusion

Gemini CLI’s standarddesign favoriserer fornuftig, gennemskuelig adfærd: en global ~/.gemini til standarder på brugerniveau og en projekt-.gemini til tilsidesættelser pr. repo. Community’et har presset på for mere indbygget konfigurerbarhed (eksplicitte miljøvariabler eller flag) for at gøre værktøjet mere venligt i multi-bruger-, containeriserede og enterprise-miljøer.

Sådan ændrer du Gemini CLI-mappen: 

Oversigt: Gemini CLI gemmer brugerdækkende konfiguration og kontekstfiler i en .gemini-mappe (typisk ~/.gemini). Du kan påvirke, hvilken mappe CLI’en bruger, ved at (1) basere dig på en .gemini på projektniveau i den aktuelle arbejdsmappe, (2) bruge miljøvariabler eller CLI-optioner, hvor det understøttes, (3) tilføje arbejdsområdets mapper i en interaktiv session eller (4) bruge filsystemteknikker (symlinks, bind mounts eller ændring af home/profile-variabler), når indbyggede muligheder mangler.

Til at begynde med kan du udforske Gemini-modellernes (såsom Gemini 3 Pro) kapaciteter i Playground og konsultere API-guide for detaljerede instruktioner. Før adgang, sørg venligst for at du er logget ind på CometAPI og har fået API-nøglen. CometAPI tilbyder en pris, der er langt lavere end den officielle pris for at hjælpe dig med integrationen.

Klar til at komme i gang?→ Gratis prøve af Gemini-modeller !