Hvordan endre katalogen til Gemini CLI?

Googles åpne kildekode Gemini CLI—den terminalbaserte AI-agenten som bringer Gemini inn i skallet ditt—har raskt modnet siden lansering og støtter nå rik konfigurasjon, prosjektkontekstfiler (GEMINI.md / .gemini), egendefinerte slash-kommandoer og kontroll av arbeidsområdets kataloger. Prosjektet utvikles aktivt på GitHub (offisielt repo), har gått inn i offentlig forhåndsvisning med rause kvoter, og integreres i andre utviklerverktøy (redaktørintegrasjoner og CI/Actions). Men når team skalerer, eller når du jobber på tvers av disker eller restriktive miljøer (containere, firmastyrte bærbare, Cloud Shell, Windows-systemer), vil du raskt støte på et praktisk spørsmål: hvor lagrer Gemini filene sine, og hvordan kan du endre hvilke kataloger Gemini leser og skriver?

Hva er Gemini CLI?

Gemini CLI er Googles åpne kildekode, kommandolinjebaserte AI-agent som bringer kraften i Gemini-modellene direkte inn i terminalen din. Den tilbyr interaktive agentfunksjoner for kodeassistanse, fil- og prosjektinspeksjon, kjøring av skallkommandoer (med sikkerhetstiltak) og integrering av verktøy som Google Search, Model Context Protocol (MCP)-utvidelser og mediegenereringsverktøy som leveres med Gemini. CLI-en er ment å være lettvekts, skriptbar og utvidbar; den er tilgjengelig fra det offisielle repositoriet og pakket for enkel installasjon.

Hvorfor katalogen er viktig

Gemini CLI lagrer konfigurasjon (for eksempel settings.json), systemprompter eller kontekst (GEMINI.md), bufrede legitimasjoner, telemetri-identifikatorer og annen vedvarende tilstand i en .gemini-katalog. Hvor denne katalogen ligger styrer:

• hvilke innstillinger CLI-en laster (globale vs. prosjektspecifikke),
• hvilke “minne”-filer agenten vil lese,
• hvor legitimasjoner bufres (påvirker innloggingsadferd),
• reproduksjon på tvers av maskiner eller CI når du vil levere et egendefinert konfigurasjonsrepo.

Å forstå og (om nødvendig) endre katalogen hjelper i flerprosjektarbeidsflyter, CI, containeriserte utrullinger og team med sentraliserte konfigurasjonslagre.

Hvor lagrer Gemini CLI konfigurasjon som standard?

Som standard bruker CLI en .gemini-katalog. For de fleste brukerinstallasjoner tilsvarer det ~/.gemini (mappen .gemini i hjemmekatalogen din). CLI-en støtter også prosjektnivå .gemini-filer (f.eks. .gemini/settings.json i prosjektroten) som overstyrer brukerinnstillinger mens du opererer fra den prosjektmappen. Systemnivåinnstillinger leses fra OS-spesifikke lokasjoner (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).
  Inne i .gemini finner du typisk settings.json, GEMINI.md, commands/ og lokale cache-er. CLI-en leser også per-prosjekt .gemini/-mapper (prosjektrot) for innstillinger på prosjektnivå.

Denne standarden er viktig: historisk har konfigurasjonskatalogen vært hardkodet til .gemini i hjemmekatalogen

---

Hvordan kan jeg endre eller omdirigere konfigurasjonskatalogen til Gemini CLI?

Det finnes flere praktiske måter — fra den enkleste (arbeid i ønsket mappe) til den mer robuste (miljøvariabler eller filsystem-omdirigeringer). Velg en tilnærming avhengig av om du kontrollerer kjøremiljøet (lokal utviklingsmaskin vs. CI), hvilket OS du bruker, og om du foretrekker en midlertidig eller permanent endring.

1) Bruk en prosjektspesifikk .gemini (anbefalt for per-prosjektinnstillinger)

Hvis du vil ha innstillinger per prosjekt, opprett en .gemini-undermappe i prosjektroten og plasser settings.json, GEMINI.md og andre prosjektfiler der. Gemini CLI foretrekker prosjektinnstillinger når du kjører den fra den prosjektkatalogen:

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

Start gemini mens skallet ditt er i your-project/ og CLI-en vil plukke opp .gemini-filer fra det treet (den søker oppover for å finne prosjektkontekst). Dette er den tryggeste, eksplisitte metoden for konfigurasjon per prosjekt.

2) Bruk dokumenterte miljøvariabler (når støttet)

Kodebasen og dokumentasjonen til Gemini CLI refererer til flere miljøvariabler som brukes til å endre adferd. Noen av disse er ment for systeminnstillinger eller spesielle filoverstyringer:

• GEMINI_API_KEY, GEMINI_MODEL, etc. brukes ofte for autentisering og valg av modell.
• Det finnes referanser i kodebasen og dokumentasjonen til variabler som GEMINI_CLI_SYSTEM_SETTINGS_PATH (brukt til å overstyre systeminnstillingssti) og konstanter som GEMINI_CONFIG_DIR (det standard .gemini-navnet som brukes i kode). Noen forespørsler fra community og PR-er foreslår å legge til eller respektere en GEMINI_CONFIG_DIR-miljøvariabel for å la brukere flytte hele konfigurasjonskatalogen.

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

Viktig forbehold: per siste diskusjoner og saker i community-et har GEMINI_CONFIG_DIR blitt etterspurt og referert i koden enkelte steder — men plattformspesifikke feil og inkonsekvent adferd (særlig på Windows) er rapportert. Det betyr at miljøvariabelbasert omdirigering kanskje ikke er pålitelig på alle plattformer eller utgivelser. Sjekk Gemini CLI-utgivelsesnotater og repo-issues for din installerte versjon dersom du er avhengig av dette.

3) Legg til kataloger i Geminis arbeidsområde i en sesjon

Hvis du vil at Gemini skal være klar over ekstra kataloger (slik at den kan lese filer som kontekst), finnes det et interaktivt sett med /directory-kommandoer. For eksempel:

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

Dette flytter ikke konfigurasjonskatalogen, men lar agenten inkludere filer fra andre kataloger i arbeidsområde-konteksten. Dette er nyttig når du vil at agenten skal referere til andre repositorier uten å endre global konfigurasjon.

4) Opprett en symbolsk lenke eller bind mount i filsystemet (praktisk omvei)

Hvis CLI-en nekter å akseptere miljøoverstyringer eller du trenger en pålitelig løsning på tvers av prosesser, bruk en filsystem-omdirigering:

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 administrativt vindu):

# 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 tilnærmingen tvinger CLI-en til å lese fra ønsket lokasjon uten å kreve innebygd støtte i CLI-en. Merk: symlenker/junctions krever passende filsystemrettigheter og kan oppføre seg annerledes i containere eller Windows-miljøer. Bruk med varsomhet. (Se “Windows-spesifikke notater” nedenfor.)

5) Endre effektiv hjemmekatalog for prosessen (container/CI-triks)

Når du kjører i CI, containere eller flyktige miljøer, kan du endre $HOME (Unix) eller %USERPROFILE%-miljøvariabelen for gemini-prosessen slik at dens standard ~/.gemini løser 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 nyttig for reproduksjon i CI, men vær oppmerksom: å endre HOME kan påvirke andre verktøy og autentiseringsflyter (f.eks. Google OAuth-cache), så begrens denne teknikken til isolerte containere eller prosessnivå-innpakninger.

Hvordan kan jeg installere og bruke Gemini CLI via CometAPI?

Kort svar: du har to praktiske veier — (A) kalle Gemini-modeller direkte via CometAPI (anbefalt og enklest), eller (B) få den offisielle Gemini CLI til å snakke med CometAPI ved enten å bruke en Gemini-CLI-versjon som støtter en egendefinert base-URL (noen utgivelser / PR-er legger til dette), eller ved å kjøre en liten lokal proxy som oversetter Gemini-CLI-forespørsler til CometAPI/OpenAI-stil-kall.

Hva er CometAPI?

CometAPI er en API-aggregator/gateway som eksponerer hundrevis av tredjeparts modeller (inkludert Googles Gemini-familie) bak en OpenAI-stil HTTP-API. Du registrerer deg, får en bearer API-nøkkel, og kaller endepunkter som https://api.cometapi.com/v1/chat/completions . CometAPI bruker standard bearer-tokens i Authorization-headeren.

Hvorfor bruke CometAPI? Det tilbyr lavere API-priser enn den offisielle API-en for å legge til rette for integrering. Gemini CLI Installation and Usage Guide:

Hvordan kan jeg kalle Gemini-modeller direkte via CometAPI? (Anbefalt)

Hvis målet ditt er å bruke Gemini-modeller og du ikke strengt trenger funksjonene til Gemini CLI, er direkte kall til CometAPI enkelt og pålitelig.

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 kallene lar deg integrere CometAPI i skript, apper eller CI uten å være avhengig av Gemini CLI.

Kan jeg få Gemini CLI til å bruke CometAPI?

Noen versjoner/PR-er av Gemini CLI legger til miljøvariabler for å overstyre Gemini API-base-URL. Hvis din installerte gemini støtter å konfigurere en egendefinert Gemini base-URL + bruke CometAPI-nøkkel, kan du peke den mot CometAPI og sette CometAPI-nøkkelen som GEMINI_API_KEY (CLI forventer en nøkkelvariabel kalt GEMINI_API_KEY for autentisering mot Gemini API).

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

Feilsøking: vanlige problemer og løsninger

Problem: Gemini kan ikke se filer i et annet repo

1. Prøv gemini --include-directories /path/to/repo ved oppstart. Eller i sesjon: /directory add /path/to/repo.
2. Hvis repoet ligger på en nettverksmontering, sjekk tillatelser og at CLI-prosessens bruker kan lese filene.
3. Hvis du brukte en symlink for å flytte .gemini, verifiser at CLI-en følger symlinken for GEMINI.md og settings.json (noen versjoner følger ikke visse symlinker av sikkerhetsgrunner).

Problem: gemini klarer ikke å opprette ~/.gemini på Windows (EPERM)

Dette betyr vanligvis at prosessen din mangler tillatelse til å skrive til %USERPROFILE%. Løsninger:

• Kjør terminalen som administrator eller juster mappetillatelser.
• Sett en egendefinert konfigurasjonslokasjon via symlink eller, når støttet, via miljøvariabel (følg med på framtidig støtte for GEMINI_CONFIG_DIR).

Problem: cd endrer ikke arbeidskatalog i skallmodus

Dette er et erkjent problem på noen plattformer. Anbefaling: gå over til å kjøre skallkommandoer utenfor Gemini CLI-prosessen eller legg til kataloger via /directory add.

Problem: CometAPI-modellnavn samsvarer ikke med det jeg forventer

Kall endepunktet /v1/models og inspiser JSON. Modell-ID-er inneholder ofte eksakte variantstrenger (f.eks. gemini-2.5-flash-preview-04-17). Bruk den eksakte strengen i forespørselen din.

Konklusjon

Gemini CLI sin standarddesign favoriserer fornuftig, lett å oppdage adferd: en global ~/.gemini for brukerstandarder og en prosjektspesifikk .gemini for overstyringer per repo. Community-et har presset på for mer innebygd konfigurerbarhet (eksplisitte miljøvariabler eller flagg) for å gjøre verktøyet mer vennlig for flerbruker-, containeriserte og bedriftsmiljøer.

Slik endrer du Gemini CLI-katalogen:

Oversikt: Gemini CLI lagrer brukernivå-konfigurasjon og kontekstfiler i en .gemini-katalog (typisk ~/.gemini). Du kan påvirke hvilken katalog CLI-en bruker ved å (1) stole på prosjektspesifikk .gemini i gjeldende arbeidskatalog, (2) bruke miljøvariabler eller CLI-valg der det støttes, (3) legge til arbeidsområdekataloger i en interaktiv sesjon, eller (4) bruke filsystem-teknikker (symlinker, bind mounts, eller endring av home/profile-variabler) når native alternativer mangler.

For å komme i gang, utforsk Gemini-modellenes (slik som Gemini 3 Pro) kapasiteter i Playground og se API-veiledningen for detaljerte instrukser. Før tilgang, må du sørge for at du er logget inn på CometAPI og har hentet API-nøkkelen. CometAPI tilbyr priser som er langt lavere enn den offisielle prisen for å hjelpe deg å integrere.

Klar til å starte?→ Gratis prøve av Gemini-modeller !