Alt du trenger å vite om planmodus i Gemini CLI

Home » Python » Alt du trenger å vite om planmodus i Gemini CLI

Planleggingsmodus i Gemini CLI er i hovedsak et trygt, skrivebeskyttet cockpit hvor du kan tenke gjennom komplekse endringer før du berører en enkelt kodelinje. I stedet for å hoppe rett inn i redigeringen, går du og agenten gjennom research, design og planlegging sammen, mens Gemini går gjennom kodebasen, verktøyene og dokumentasjonen din, samtidig som prosjektet ditt beskyttes mot utilsiktede endringer.

Denne modusen er utviklet for utviklere som ønsker struktur, sikkerhet og klarhet før implementeringen starter, uten å ofre hastighet eller fleksibilitet. Du kan bruke den til å kartlegge databasemigreringer, nye funksjoner, refaktorering eller revisjoner, samtidig som du utnytter avanserte resonneringsmodeller, tilpassede policyer, agentferdigheter og til og med headless-arbeidsflyter i CI/CD. Tenk på det som en planleggingssandkasse der alt er gjennomtenkt og sporbart.

Hva er planmodus i Gemini CLI?

Planmodus er en skrivebeskyttet driftsmodus i Gemini CLI som begrenser agenten til et begrenset sett med sikre verktøy. Mens den er aktiv, kan Gemini utforske depotet ditt, inspisere filer, søke etter mønstre og lese dokumentasjon, men den kan ikke endre prosjektfilene dine eller kjøre vilkårlige kommandoer som kan endre tilstand. De eneste filene den har lov til å skrive er dens egne interne planartefakter.

Hovedideen bak planmodus er å skille tenkning fra handling. Først fokuserer Gemini på å forstå forespørselen din, analysere kodebasen, avhengigheter og miljø, og utarbeide en detaljert plan. Først etter at du eksplisitt godkjenner planen, går CLI-en over i en redigerings- eller utførelsesmodus for å utføre endringene.

Planleggingsmodus er aktivert som standard for nye brukere av Gemini CLI, noe som betyr at de fleste arbeidsflyter allerede starter med en forskningsfokusert tankegang. Du kan alltid slå den av eller fjerne den fra arbeidsflyten din, men standardvirkemåten er å behandle planlegging som en førsteklasses fase, spesielt for store eller risikable endringer.

Modusen er også tett integrert med andre Gemini-funksjoner som Agent Skills, policymotoren, MCP-verktøy og modellstyring. Dette gjør det ikke bare til en sikkerhetsmekanisme, men også til et kraftig miljø for å utvikle robuste og velbegrunnede løsninger.

Slik aktiverer og går du inn i planmodus

Planmodus er vanligvis slått på umiddelbart, men du kan kontrollere hvordan og når Gemini CLI starter i denne modusen. Det finnes flere måter å konfigurere eller gå inn i planleggingsmodus på, avhengig av om du vil ha det som standardoppførsel eller bare for bestemte økter.

Hvis du vil at Gemini CLI alltid skal starte i planmodus, kan du justere innstillingene dine fra innsiden av CLI-en. Kjør / innstillinger kommandoen, finn alternativet som heter «Standard godkjenningsmodus» og sett det til PlanFra det tidspunktet og utover vil hver nye økt starte i dette skrivebeskyttede planleggingsmiljøet.

For engangsøkter der du vil starte direkte i planleggingsmodus, kan du bruke et kommandolinjeflagg. Start CLI-en med gemini –godkjenningsmodus=plan og agenten vil umiddelbart operere under begrensningene i Planmodus uten at du trenger å aktivere noe interaktivt.

Når du allerede er inne i Gemini CLI, finnes det flere måter å bytte til planleggingsmodus på farten. Du kan trykke Skift + Tab For å bla gjennom de tilgjengelige godkjenningsmodusene (Standard → Automatisk redigering → Plan), bruk /plan kommandoen, eller ganske enkelt be agenten i naturlig språk om å «starte en plan for ...» et gitt mål. Bak kulissene påkaller Gemini enter_plan_mode verktøy for å endre moduser.

/plan-kommandoen lar deg også legge til et mål innebygd, noe som er nyttig når du både vil bytte modus og begynne å planlegge umiddelbart. For eksempel å skrive /plan implementere autentisering setter Gemini i planmodus og sender umiddelbart inn forespørselen din om autentiseringsdesign, slik at forskning og analyse starter med en gang.

Kjernearbeidsflyt: research, design, utkast, godkjenning

Planleggingsmodus strukturerer arbeidet ditt i en enkel, men kraftig flyt: definer målet, undersøk, design, utarbeid en plan, og godkjenn eller iterer deretter. Hver fase er bevisst atskilt, slik at du kan beholde kontrollen og unngå uventede redigeringer eller risikable handlinger.

Først setter du et tydelig mål. Du kan si «planlegg en ny varslingstjeneste ved hjelp av Redis» eller «undersøk hvordan du kan migrere denne databasen». Gemini bruker dette målet til å gå inn i planleggingsmodus (hvis den ikke allerede er aktiv) og begynner å utforske de relevante delene av kodebasen, infrastrukturen og dokumentasjonen på en strengt skrivebeskyttet måte.

I forskningsfasen bruker Gemini verktøy som fillisting, globbing, grep-søk og andre skrivebeskyttede funksjoner for å lage et mentalt kart over systemet ditt. I noen tilfeller kan den stole på spesialiserte underagenter, som f.eks. kodebase_etterforsker eller aktiver agentferdigheter skreddersydd for spesifikke domener for å bedre forstå avhengigheter og arkitektur.

Når agenten har nok kontekst, går den over til design- og diskusjonsfasen. Her foreslår Gemini strategier, avdekker avveininger og kan stille deg avklarende spørsmål ved hjelp av spør_bruker verktøy. Denne frem-og-tilbake-samtalen bidrar til å sikre at den valgte tilnærmingen er i samsvar med dine preferanser, begrensninger og eksisterende konvensjoner.

Etter at dere muntlig har blitt enige om en retning, utarbeider Gemini en formell implementeringsplan som en Markdown-fil lagret i din dedikerte plankatalog. Denne artefakten er detaljert og strukturert: den lister opp oppgaver, trinn, avhengigheter, potensielle risikoer og noen ganger alternative alternativer. Du kan lese, redigere eller kommentere den før noe utføres.

Det siste trinnet i prosessen er eksplisitt godkjenning. Gemini CLI vil presentere planen og tilby alternativer som «Ja, godta redigeringer automatisk» eller «Ja, godta redigeringer manuelt» for å starte implementeringen. Hvis noe føles rart, kan du sende tilbake tilbakemelding, redigere planfilen selv eller ganske enkelt avbryte planen med Esc og prøv en annen tilnærming.

Samarbeid om planen: diskusjon, redigeringer og kommentarer

En av de mest fremtredende fordelene med Plan-modus er at den behandler planen som en delt artefakt som du og Gemini kan redigere sammen. Dette samarbeidet kan være mer presist og raskere enn å beskrive komplekse endringer utelukkende i naturlige språklige ledetekster.

Når Gemini er ferdig med et utkast og presenterer planen for gjennomgang, kan du åpne den direkte i din foretrukne eksterne editor. Press Ctrl + X fra innsiden av CLI-en, og Markdown-planen åpnes i VS Code, Vim eller hvilken som helst editor du har konfigurert. Ingen manuell filsøking nødvendig.

Inne i redigeringsprogrammet kan du endre planen slik du vil. Du kan endre rekkefølgen på trinnene slik at de passer bedre til distribusjonsprosessen din, omskrive visse handlinger for klarhetens skyld, fjerne oppgaver du anser som unødvendige eller utvide deler som trenger mer informasjon. Du kan også legge til innebygde kommentarer, for eksempel «Bør vi bruke den eksisterende Logger-klassen på nytt her?» eller «Verifiser dette mot gjeldende SLO-er».

Når du lagrer og lukker redigeringsprogrammet, oppdager Gemini CLI automatisk endringene og kommentarene dine. Den analyserer det oppdaterte dokumentet, innlemmer tilbakemeldingene dine og forbedrer sin interne forståelse av strategien. Agenten genererer deretter en polert versjon av planen som du kan gjennomgå på nytt.

Denne løkken med rediger → avgrens → gjennomgå kan gjentas så mange ganger som nødvendig til du er fornøyd med planen. Når du er klar, gir du en klar godkjenning, og først da går Gemini ut av planleggingsmodus for å starte faktiske redigeringer eller kommandoutførelse basert på de avtalte trinnene.

Avslutte planmodus og bytte godkjenningsmodus

Du kan avslutte planleggingsmodus når som helst, enten du er ferdig med planleggingen eller bare vil bytte tilbake til en annen godkjenningsmodus. Det er ikke noe krav om å ferdigstille eller godkjenne en plan før man forlater dette miljøet.

Den vanligste måten planmodus avsluttes på er når du godkjenner en ferdigstilt plan. Så snart du bekrefter at Gemini skal starte implementeringen, avslutter CLI automatisk planleggingsmodus og går over til en mer tillatende modus der redigeringer og verktøykall som endrer status er tillatt, i henhold til godkjenningsinnstillingene dine.

Hvis du bare vil bytte til en annen modus uten å godkjenne noe, kan du bruke den samme hurtigtasten som brukes for å gå inn i planleggingsmodus. Press Skift + Tab for å gå fra Plan tilbake til Standard eller Automatisk redigering, avhengig av hva du foretrekker for aktivt utviklingsarbeid.

Naturlige språkkommandoer fungerer også for modusoverganger. Du kan skrive inn fraser som «avslutt planmodus» eller «stopp planlegging», så vil Gemini kalle det tilsvarende modusbytteverktøyet for å gjenopprette din tidligere oppførsel. Dette gjør det enkelt å hoppe inn og ut av planleggingskonteksten etter hvert som arbeidsflyten utvikler seg.

Sikkerhetsmodell og tillatte verktøy i planleggingsmodus

Planleggingsmodus håndheves av strenge sikkerhetsregler som garanterer at prosjektet ditt forblir i skrivebeskyttet tilstand under planlegging. Modusen støttes av Gemini CLI-policymotoren og en dedikert konfigurasjonsfil med navnet plan.toml, som definerer hvilke verktøy som er tillatt og hvordan de oppfører seg.

Den innebygde policyen for planleggingsmodus regnes som en nivå 1-policy og fokuserer alltid på å forhindre skriving eller destruktive handlinger. Bare verktøy som er iboende trygge – som fillesing, søking eller oppføring av filer – er tillatt som standard. Alt som kan mutere filer, kjøre kommandoer eller endre eksterne systemer blokkeres med mindre du eksplisitt overstyrer reglene.

Policymotoren behandler regler som ikke spesifiserer moduser som globalt aktive, noe som betyr at de også vil gjelde i planmodus. Hvis du vil at en regel bare skal gjelde i andre moduser og ikke i planleggingsmodus, må du eksplisitt liste opp målmodusene i den regelen. Hvis du for eksempel vil npm-test For å være tillatt i standard- og automatisk redigeringsmodus, men aldri i planmodus, må du konfigurere den med en modusliste som ekskluderer plan.

En annen viktig sikkerhetsfunksjon er måten vedvarende verktøygodkjenninger vurderes på. Godkjenninger gitt i mer tillatende moduser (som standard eller automatisk redigering) overføres ikke automatisk til planleggingsmodus. Dette forhindrer at verktøy du stoler på for implementering kjører stille mens du fortsatt er i forskningsfasen. Godkjenninger gitt i planleggingsmodus behandles imidlertid som bevisste og kan brukes globalt på andre moduser etterpå.

Totalt sett er planmodus sikker som standard, men fortsatt svært tilpassbar. Du kan skreddersy hvilke verktøy som er tilgjengelige, hvordan de krever godkjenning, og hva slags hooks eller logging du ønsker rundt planoppretting og utførelsesoverganger.

Tilpassede retningslinjer, MCP-verktøy og kroker

Utover de innebygde nivå 1-policyene kan du tilpasse planleggingsmodus ytterligere til organisasjonen eller den personlige arbeidsflyten din ved å legge til dine egne policyfiler. Disse bor i ~/.gemini/policyer/ katalogen og regnes som nivå 2, slik at de kan forbedre eller utvide standardvirkemåten som er definert i plan.toml.

Et vanlig brukstilfelle er å kontrollere hvordan skrivebeskyttede MCP-verktøy (Model Context Protocol) oppfører seg i planmodus. Som standard kan Gemini kreve brukerbekreftelse før disse verktøyene aktiveres, selv når de ikke er destruktive. Med verktøyAnnotasjoner og mcpName Med jokertegn kan du definere spesifikke mønstre eller verktøysett som er automatisk godkjente eller krever færre ledetekster, noe som gjør planleggingen smidigere i miljøer som er sterkt avhengige av eksterne tjenester.

Du kan også legge til kroker som utløses når planleggingsmodus går over til implementering. Hvis organisasjonen din for eksempel trenger et revisjonsspor for hver godkjente plan, kan du legge til en Etterverktøyet en hook som kopierer de ferdigstilte planartefaktene til Google Cloud Storage eller et annet arkivsystem når Gemini avslutter planmodus for å begynne å utføre endringer.

En typisk hook kan være et skript som ~/.gemini/hooks/archive-plan.sh, som mottar kontekst om økten og planfilen. Dette lar deg håndheve samsvars- og sporbarhetskrav uten å endre den manuelle arbeidsflyten – hver gang en plan godkjennes, sikkerhetskopieres den automatisk for senere gjennomgang eller hendelsesanalyse.

Ved å kombinere tilpassede policyer og hooks kan team kode sine egne metoder direkte inn i planmodus. Enten du ønsker strengere godkjenninger, obligatorisk logging eller miljøspesifikke verktøyrestriksjoner, gir policymotoren deg innstillingene du trenger.

Agentferdigheter og spesialiserte planleggingsarbeidsflyter

Agentferdigheter er en nøkkelmekanisme for å skreddersy hvordan Gemini CLI planlegger spesifikke arbeidskategorier mens man forblir i planleggingsmodus. En ferdighet inneholder spesialiserte instruksjoner, prosedyretrinn og heuristikker som veileder hvordan agenten undersøker, designer og strukturerer en bestemt oppgave.

For eksempel kan en ferdighet for «Databasemigrering» håndheve at hver plan inkluderer sikkerhetskopieringsstrategier, datavalideringskontroller og tilbakestillingsprosedyrer. I stedet for å huske alle disse detaljene hver gang, kan du stole på ferdighetene til å sørge for at hver migreringsplan er trygg og i samsvar med standardene dine.

På samme måte kan en «sikkerhetsrevisjon»-ferdighet presse Gemini til aktivt å se etter sårbarheter eller feilkonfigurasjoner under kodebaseutforskning. Den kan instruere agenten til å skanne etter usikre standardverdier, manglende autentiseringskontroller eller ukrypterte hemmeligheter, og deretter oppsummere funn og utbedringstrinn i planartefakten.

På frontend-siden kan en «Frontend Design»-ferdighet styre agenten mot spesifikke UI-komponentbiblioteker og tilgjengelighetsretningslinjer. Planer generert under denne ferdigheten vil automatisk referere til designsystemet ditt, ARIA-praksiser eller ytelsesbegrensninger, noe som bidrar til å holde brukergrensesnittet konsistent og inkluderende.

For å bruke en ferdighet i planmodus, kan du eksplisitt be Gemini CLI om å «bruke ferdighet til å planlegge…” eller ganske enkelt beskrive oppgaven din på en måte som lar agenten aktivere en relevant ferdighet autonomt. Når ferdigheten er aktiv, omformer den hvordan planleggingsfasene oppfører seg, fra forskningsprioriteringer til strukturen i den endelige Markdown-planen.

Fordi ferdigheter integreres problemfritt med sikkerhetsmodellen i Plan Mode, drar selv svært spesialiserte arbeidsflyter nytte av skrivebeskyttede garantier og godkjenningsporter. Du får grundig, domenebevisst planlegging uten å utsette miljøet ditt for utilsiktede bivirkninger.

Modellruting: Pro for planlegging, Flash for utførelse

Gemini CLI inkluderer automatisk modellruting som utnytter planmodus for å balansere resonnementkvalitet og utførelseshastighet. Når du bruker en automatisk modellkonfigurasjon, velger CLI forskjellige Gemini-modeller avhengig av om du er i planleggings- eller implementeringsfasen.

Mens du er i planmodus, blir forespørsler rutet til en Pro-modell med høy resonnement, for eksempel Gemini 3.1 Pro. Denne modellen er optimalisert for kompleks analyse, arkitekturbeslutninger, langkontekstbasert resonnement og utarbeidelse av intrikate planer. Målet er å maksimere kvaliteten og robustheten til selve planen, selv om det krever mer beregning.

Når en plan er godkjent og du avslutter planmodus, oppdager CLI-en at en implementeringsfase har startet og bytter automatisk til en høyhastighets Flash-modell. Her er prioriteten responsivitet og kostnadseffektivitet: agenten utfører stort sett veldefinerte trinn i stedet for å ta store strategiske beslutninger, så en raskere modell er vanligvis tilstrekkelig.

Denne standardoppførselen gir en smart avveining: langsom og gjennomtenkt når du designer, rask og effektiv når du bygger. Hvis du av en eller annen grunn foretrekker et annet oppsett, kan du deaktivere automatisk bytte i innstillingene dine og konfigurere spesifikke modeller for hver modus manuelt.

Nyere modeller som Gemini 2.5 Flash og Gemini 2.5 Flash-Lite fortsetter å forbedre denne balansen. Med bedre verktøybruksmuligheter, lavere ventetid og forbedret instruksjonsoppfølging kan de utføre plantrinn mer pålitelig, samtidig som de holder tokenbruk og kostnader i sjakk.

Øktoppbevaring, opprydding og tilpassede plankataloger

For å holde utviklingsmiljøet ditt ryddig, administrerer Gemini CLI automatisk øktdata og tilhørende planfiler. Som standard beholdes hver økt – inkludert planer og oppgavesporere – i 30 dager før den ryddes opp.

Du kan endre denne oppbevaringsperioden ved å bruke /settings-kommandoen eller ved å redigere settings.json-konfigurasjonen direkte. Se etter innstillingen «Øktbevaring» og juster den etter behov. For langvarige prosjekter kan det være lurt med et lengre vindu, mens for kortvarige eksperimenter kan det være lurt med kortere oppbevaring.

I tillegg til automatisk opprydding kan du når som helst utløse manuell sletting av økter. Fra kommandolinjen, bruk gemini –slett-økt for å fjerne en bestemt økt og dens artefakter. Alternativt kan du åpne øktleseren med /oppsummerer, naviger ved hjelp av grensesnittet og trykk på x for å slette den valgte økten.

Hvis du har konfigurert en katalog for tilpassede planer, er det viktig å merke seg at automatisk sletting ikke fjerner disse planfilene. Du er ansvarlig for å administrere den katalogen manuelt, noe som kan være en fordel hvis du vil behandle planer som permanent dokumentasjon eller lagre dem i versjonskontroll sammen med koden din.

Denne tilnærmingen gir deg fleksibilitet: bruk kortvarige planer når du bare er interessert i umiddelbar utførelse, eller vedlikehold et kuratert arkiv med strategiske planer for fremtidig referanse og samsvar.

Ikke-interaktive og CI/CD-arbeidsflyter med planmodus

Planleggingsmodus er ikke bare for interaktive terminaløkter; den fungerer også fint med ikke-interaktive miljøer som skript og CI/CD-pipelines. I disse scenariene er policymotoren konfigurert til å godkjenne bestemte planleggingsverktøy automatisk, slik at arbeidsflyten ikke stopper opp mens den venter på brukerinndata.

Mer spesifikt, når Gemini CLI oppdager en ikke-interaktiv kontekst, godkjenner den automatisk verktøyene enter_plan_mode og exit_plan_mode. Dette betyr at pipelinen din programmatisk kan utløse planlegging, la Gemini generere en plan og deretter gå videre til utførelse uten manuelle bekreftelsesdialoger.

En annen viktig forskjell i ikke-interaktive arbeidsflyter er hva som skjer etter at planleggingsmodus er ferdig og implementeringen begynner. I stedet for å gå over til standardmodus, bytter CLI til YOLO-modus, som er utformet for å utføre trinn automatisk uten å bli sittende fast i godkjenninger av interaktive verktøy.

Denne automatiseringsvennlige virkemåten gjør det mulig å bygge fullstendig skriptede arbeidsflyter der planlegging og utførelse kjører ende til ende. Du drar fortsatt nytte av den strukturerte planleggingsfasen, men prosessen kan fortsette i maskinhastighet når planen er klar og godkjent i henhold til retningslinjene dine.

Modellstyring i planmodus

Modellstyring lar deg gi Gemini en dytte i sanntid mens de forsker eller utarbeider en plan, noe som kan stramme inn tilbakemeldingssløyfen betydelig og hjelpe. demp modellhallusinasjoner. I stedet for å vente på at en full syklus skal fullføres, kan du legge inn hint eller rettelser mens verktøyene kjører.

Tenk deg at du starter med en ledetekst som «/plan Jeg vil implementere en ny varslingstjeneste ved hjelp av Redis». Gemini går inn i planleggingsmodus, begynner å skanne kodebasen og begynner å utforske kataloger. Mens du ser på verktøykallene – kanskje det viser feil stier – kan du skrive noe sånt som «Ikke glem å sjekke pakker/felles/køer for den eksisterende Redis-konfigurasjonen».

Selv mens spinneren er aktiv, kan Gemini innlemme det hintet i sin nåværende forskning. Du vil da se den inspisere den foreslåtte katalogen på neste tur og justere forståelsen av hvor den nye tjenesten skal ligge.

Modellstyring er like nyttig i utformingsfasen. Hvis den opprinnelige planen heller mot en enkel køarkitektur, men du foretrekker et Pub/Sub-mønster, kan du si «La oss bruke et Publisher/Subscriber-mønster i stedet for en enkel kø for denne tjenesten.» Gemini vil pause, revurdere designet og begynne å utarbeide en ny versjon av planen som er i tråd med dine preferanser.

For å få mest mulig ut av styringen, prøv å være spesifikk og grip inn tidlig. Tydelige instruksjoner som «bruk den eksisterende Logger-klassen i src/utils» eller «vi planlegger å avvikle denne modulen neste måned» gir kontekst som kanskje ikke er åpenbar bare fra statisk kodeanalyse.

Utvidbarhet med Conductor og komplekse arbeidsflyter

For store prosjekter eller prosjekter med flere trinn viser Conductor-utvidelsen hvordan Plan Mode kan bli ryggraden i mer avanserte arbeidsflyter. Conductor er utviklet for kontekstdrevet utvikling, og fungerer som en orkestrator som veileder deg gjennom komplekse migreringer, funksjonsutrullinger eller refaktorering.

Ved å bruke planleggingsmodus kan Conductor kjøre omfattende kontroller før flyvning og grundige forskningspass i et helt trygt miljø. Den deler opp store oppgaver i milepæler, bruker spør_bruker verktøy for å validere kritiske beslutninger i hvert trinn, og sikrer at agenten aldri forhaster seg med endringer uten din godkjenning på høyt nivå.

Gjennom hele denne prosessen bruker Conductor Plan Mode sine skrivebeskyttede prinsipper og strukturerte planlegging for å generere deloppgaver og detaljerte trinn. Ved hvert kontrollpunkt bekrefter den antagelser, samler manglende informasjon og oppdaterer den overordnede utviklingen, slik at den endelige implementeringen er både grundig og i tråd med strategien din.

Utformingen av Plan Mode med verktøy som enter_plan_mode og exit_plan_mode ble bevisst gjort utvidbar, slik at løsninger som Conductor kan bygge oppå det. Målet er ikke bare å gi deg en trygg planleggingsfunksjon, men et grunnlag du kan bruke til dine egne tilpassede orkestreringslag og utviklingsmetoder.

Gemini CLI-teamet jobber med å bringe Conductor nærmere kjerneopplevelsen som en innebygd modus, noe som ytterligere visker ut grensen mellom planlegging, orkestrering og utførelse. Den retningen fremhever hvor sentral Plan Mode er for fremtiden til strukturert, AI-assistert utvikling.

Alt i alt er planleggingsmodus i Gemini CLI mer enn en enkel sikkerhetsbryter; det er et komplett planleggingsmiljø som blander skrivebeskyttet utforskning, rikt samarbeid, tilpassbare policyer, modeller med høy resonnement og automatiseringsvennlig oppførsel. Ved å omfavne denne modusen for din neste store funksjon, migrering eller revisjon, gir du deg selv et klart rom til å tenke, stille spørsmål og iterere før noen kodeendringer skjer, noe som til slutt fører til renere implementeringer og færre ubehagelige overraskelser.