Aider-installasjon og OmniProxy-konfigurasjon

Aider er et verktøy som hjelper deg med å endre kode direkte fra terminalen. Det bygger et kart over hele kodebasen for å hjelpe modellen med å forstå større prosjekter. Git er et versjonskontrollverktøy som registrerer kodeendringer, slik at du kan inspisere forskjeller og gjenopprette tidligere versjoner. Etter at du har gitt Aider en oppgave, behandler den oppgaven trinn for trinn og skriver commit-meldinger. Hvis du ikke er fornøyd med endringene, kan du angre dem med /undo.

Før du starter

Det finnes to vanlige installasjonsalternativer:

Hvis datamaskinen din allerede har Python 3.8 til 3.13, installer aider-install først. Python er kjøretidsmiljøet som kreves av Aider.
Hvis du ikke har en passende Python-versjon, bruk installasjonskommandoen for én linje. Den vil også sette opp Python 3.12 ved behov.

Mac og Linux

install.sh

Kjør med sh etter curl
Installerer Python ved behov
Bruk wget hvis curl ikke er tilgjengelig

Windows

install.ps1

Kjør i PowerShell
Åpne terminalen på nytt etter installasjon
Sett miljøvariabler med setx

Python er allerede installert

aider-install

Installer først denne pakken med pip
Kjør deretter aider-install
Den oppretter sitt eget miljø

Installasjonsprogrammet for én linje setter opp Python 3.12 ved behov. Å installere aider-chat direkte med pip er mindre pålitelig.

Sørg for at OmniProxy kjører. Etter installasjonen må du gå inn i prosjektkatalogen du planlegger å endre før du starter Aider.

Installasjon og første oppstart

Hvis du allerede har Python 3.8 til 3.13

Kjør disse kommandoene i rekkefølge:

python -m pip install aider-install
aider-install

aider-install installerer Aider i et separat Python-miljø slik at det ikke forstyrrer andre Python-prosjekter på datamaskinen din. Ved behov installerer den også Python 3.12 som Aider kan bruke.

Installasjon med én linje

På Mac og Linux, kjør:

curl -LsSf https://aider.chat/install.sh | sh

Hvis curl ikke er installert, bruk:

wget -qO- https://aider.chat/install.sh | sh

I Windows PowerShell, kjør:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Disse kommandoene for én linje er basert på uv, et program for å installere og administrere Python-verktøy og -miljøer. Du kan også bruke følgende kommando:

uv tool install --force --python python3.12 --with pip aider-chat@latest

Du kan også bruke pipx. Når du installerer direkte med python -m pip install aider-chat, er de støttede Python-versjonene 3.9 til 3.12. Dette er imidlertid en alternativ installasjonsmetode, så foretrekk metodene beskrevet ovenfor. Aider-pakker fra systemets pakkebehandlere kan ha avhengighetskonflikter, så de bør ikke være ditt førstevalg.

Per 2026-10-09 installerte installasjonskommandoen for én linje Aider v0.86.2. Under installasjonen kan du se en melding om at hurtigbufferen og destinasjonen er på forskjellige disker, og at filer vil bli kopiert i stedet. Installasjonen vil uansett fullføres.

Etter installasjonen, gå inn i prosjektkatalogen. Et kompatibelt API er et grensesnitt som kommuniserer med andre modelltjenester ved hjelp av OpenAI-formatet. Start Aider ved å bruke dette mønsteret:

aider --model openai/<model-name>

Erstatt <model-name> med den fullstendige modell-ID-en kopiert fra OmniProxy i neste del. En modell-ID er navnet som brukes for å identifisere en modell nøyaktig.

Hent tilkoblingsinnstillinger fra OmniProxy

Du må angi følgende to miljøvariabler. Miljøvariabler kan forstås som et sett med tilkoblingsinnstillinger som leses av terminalprogrammer:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE er API-endepunktet og må inkludere /v1. OPENAI_API_KEY er nøkkelen som brukes for å få tilgang til API-et.

På Windows, bruk setx for å lagre variablene. Du må åpne terminalen på nytt etterpå:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Kopier hele modellnavnet fra den gjeldende OmniProxy-listen, inkludert eventuelle skråstreker i modell-ID-en. Når du starter Aider, legg til openai/ før den fullstendige ID-en.

Per 2026-10-09 er de to referanse-ID-ene i leverandørdokumentasjonen gemini-3.8-flash og grok-4.7. Hvis disse navnene ikke er i den gjeldende listen, må du ikke kopiere dem direkte. Bruk en fullstendig ID som faktisk vises i listen.

Adresse

OPENAI_API_BASE

Pek den mot OmniProxy
Inkluder /v1
Ikke legg den i repositoriet

Nøkkel

OPENAI_API_KEY

Bruk den som er oppgitt av gatewayen
Åpne Windows-terminaler på nytt etter endring
Hold leverandørnøkler i gatewayen

Start

openai/model

cd til prosjektkatalogen
Legg til openai/ foran modellnavnet
Bruk navnet fra gateway-listen

De to miljøvariablene, sammen med et modellnavn med prefikset openai/, danner den kompatible API-syntaksen.

Angi verktøykonfigurasjon

Du trenger ikke å opprette en separat konfigurasjonsfil. Gå inn i prosjektkatalogen, start Aider, og erstatt modell-ID-en med et navn som faktisk finnes i den gjeldende OmniProxy-listen:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

For å bruke den andre eksempelmodellen, kjør:

aider --model openai/grok-4.7

Når Aider møter en ukjent modell, viser den en advarsel. Denne advarselen betyr ikke i seg selv at endepunktet er feil. Sjekk OmniProxys forespørselslogger for å bekrefte om forespørselen dukket opp.

Aider legger bare til filer som allerede spores av Git i konteksten. Konteksten er koden og informasjonen modellen kan lese under den gjeldende oppgaven. Hvis den gjeldende katalogen ennå ikke er et Git-repositorium, oppretter Aider ett, men filer som Git ikke sporer, kan fortsatt ikke leses. Bruk git add for å legge til filene og commit dem før du starter Aider.

Aider kan fortsatt endre filer. --no-auto-commits deaktiverer bare automatiske commits; det forhindrer ikke filendringer. Når du bruker Aider for første gang, velg et uviktig repositorium og kjør git diff etter oppgaven for å gjennomgå de faktiske endringene.

Ikke legg ekte nøkler i prosjektfiler eller på offentlige sider. Lagre leverandørnøkler kun i OmniProxy. Hvis gatewayen ikke validerer nøkler, kan du sette OPENAI_API_KEY til en plassholderstreng som kun brukes på din lokale datamaskin.

Bekreft med en reell oppgave

Først må du sørge for at filen du vil at Aider skal lese, er committet til Git. Kjør deretter følgende kommando fra prosjektkatalogen. Erstatt modell-ID-en med en fullstendig ID fra den gjeldende OmniProxy-listen:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message sender en oppgave direkte til Aider, mens --no-auto-commits ber Aider om ikke å opprette Git-commits automatisk under denne kjøringen.

Per 2026-10-09 leste Aider v0.86.2 den første linjen i en sporet fil. Hvis filen ikke spores av Git, vil Aider si at den ikke kan se innholdet. Dette betyr ikke at API-endepunktet er feil. Etter at spørringen er fullført, sjekk OmniProxys forespørselslogger for å verifisere forespørselskilden og modell-ID-en.

Start

Aider starter

Kommandoen er tilgjengelig
Miljøvariabler er aktive
I prosjektkatalogen

Oppgave

Den inspiserte filen

Spør om en spesifikk fil
Gjennomgå forklaringen
Ukjente modeller kan utløse en advarsel

Logger

Synlige i gatewayen

Kilden er Aider
Modell-ID samsvarer
Nøkkelen ble ikke skrevet inn på siden

Bekreft at miljøvariablene er aktive og at kommandoen er tilgjengelig, og fullfør deretter én reell spørring.

Vanlige feil

aider kan ikke finnes: Åpne terminalen på nytt først. Hvis du installerte den direkte med pip, prøv python -m aider.
Windows kobler fortsatt til det gamle endepunktet etter endring av variablene: Du må åpne terminalen på nytt etter at du har kjørt setx. Kun et nytt vindu vil lese de oppdaterte variablene.
Modellnavnet begynner ikke med openai/: Det kompatible API-et krever formatet openai/<model-name>.
En advarsel om ukjent modell vises: Dette er en normal advarsel og betyr ikke at tilkoblingen mislyktes. Sjekk om OmniProxy mottok forespørselen.
Modell-ID-en er ugyldig: Kopier den fullstendige ID-en på nytt fra den gjeldende OmniProxy-listen. Behold openai/-prefikset og eventuelle skråstreker som allerede finnes i ID-en.
Aider sier at det ikke er noe filinnhold: Sørg for at filen spores av Git. Filer i et tomt repositorium eller filer som ikke spores, legges ikke til i konteksten.

Offisielle referanser

For installasjonstrinn, se Aider-installasjon. For miljøvariabler og modellprefiks, se OpenAI-kompatible API-er. Eksempelmodell-ID-ene finner du i Gemini-modellisten og på xAI-modell-siden.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · Aider ↗