Udvikler

Installation af Aider og konfiguration af OmniProxy

Ønsker du et værktøj til at ændre kode, men er bekymret for, om ændringerne bliver svære at gennemgå? Aider udfører opgaver trinvis i terminalen og bruger Git til at registrere forskelle, så ændringer nemt kan inspiceres og fortrydes.

Dokumentation gennemgået
9. okt. 2026
Testet version
Aider v0.86.2

Aider er et værktøj, der hjælper med at ændre kode direkte fra terminalen. Det opbygger et kort over hele kodebasen, så modellen bedre kan forstå større projekter. Git er et versionsstyringsværktøj, der registrerer kodeændringer, hvilket gør det muligt at inspicere forskelle og gendanne tidligere versioner. Når du giver Aider en opgave, behandler den den trin for trin og skriver commit-beskeder. Hvis du ikke er tilfreds med ændringerne, kan du fortryde dem med /undo.

Før du begynder

Der er to almindelige installationsmuligheder:

  • Hvis din computer allerede har Python 3.8 til 3.13, skal du først installere aider-install. Python er det kørselsmiljø, som Aider kræver.
  • Hvis du ikke har en passende Python-version, kan du bruge installationskommandoen på én linje. Den opsætter også Python 3.12, når det er nødvendigt.

Mac og Linux

install.sh

  • Kør med sh efter curl
  • Installerer Python hvis nødvendigt
  • Brug wget hvis curl ikke er tilgængelig

Windows

install.ps1

  • Kør i PowerShell
  • Genåbn terminalen efter installation
  • Sæt miljøvariabler med setx

Python er allerede installeret

aider-install

  • Installer først denne pakke med pip
  • Kør derefter aider-install
  • Det opretter sit eget miljø
Installationsprogrammet på én linje opsætter Python 3.12, når det er nødvendigt. Direkte installation af aider-chat med pip er mindre pålidelig.

Sørg for, at OmniProxy kører. Efter installationen skal du gå til den projektmappe, du planlægger at ændre, før du starter Aider.

Installer og start for første gang

Hvis du allerede har Python 3.8 til 3.13

Kør disse kommandoer i rækkefølge:

python -m pip install aider-install
aider-install

aider-install installerer Aider i et separat Python-miljø, så det ikke forstyrrer andre Python-projekter på din computer. Når det er nødvendigt, installerer det også Python 3.12 til brug for Aider.

Installation på én linje

På Mac og Linux skal du køre:

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

Hvis curl ikke er installeret, skal du bruge:

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

I Windows PowerShell skal du køre:

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

Disse kommandoer på én linje er baseret på uv, et program til installation og styring af Python-værktøjer og -miljøer. Du kan også bruge følgende kommando:

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

Du kan også bruge pipx. Ved direkte installation med python -m pip install aider-chat er de understøttede Python-versioner 3.9 til 3.12. Dette er dog en alternativ installationsmetode, så foretræk de metoder, der er beskrevet ovenfor. Aider-pakker fra systemets pakkehåndteringer kan have afhængighedsproblemer, så de bør ikke være dit førstevalg.

Den 2026-10-09 installerede installationskommandoen på én linje Aider v0.86.2. Under installationen ser du muligvis en besked om, at cachen og destinationen er på forskellige diske, og at filer derfor vil blive kopieret i stedet. Installationen vil stadig blive fuldført.

Efter installationen skal du gå til projektmappen. Et kompatibelt API er en grænseflade, der kommunikerer med andre modeltjenester ved hjælp af OpenAI-formatet. Start Aider med dette mønster:

aider --model openai/<model-name>

Erstat <model-name> med det fulde model-ID, som du har kopieret fra OmniProxy i næste afsnit. Et model-ID er det navn, der bruges til præcist at identificere en model.

Hent forbindelsesindstillinger fra OmniProxy

Du skal indstille følgende to miljøvariabler. Miljøvariabler kan forstås som et sæt forbindelsesindstillinger, der læses af terminalprogrammer:

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

OPENAI_API_BASE er API-slutpunktet og skal indeholde /v1. OPENAI_API_KEY er den nøgle, der bruges til at få adgang til API’et.

På Windows skal du bruge setx til at gemme variablerne. Du skal genåbne terminalen bagefter:

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

Kopier hele modelnavnet fra den aktuelle OmniProxy-liste, inklusive eventuelle skråstreger i model-ID’et. Når du starter Aider, skal du tilføje openai/ foran det fulde ID.

Pr. 2026-10-09 er de to reference-ID’er i udbyderdokumentationen gemini-3.8-flash og grok-4.7. Hvis disse navne ikke findes på den aktuelle liste, må du ikke kopiere dem direkte. Brug et fuldt ID, der faktisk fremgår af listen.

Adresse

OPENAI_API_BASE

  • Ret den mod OmniProxy
  • Inkluder /v1
  • Gem den ikke i repositoriet

Nøgle

OPENAI_API_KEY

  • Brug den, der leveres af gatewayen
  • Genåbn Windows-terminaler efter ændring
  • Opbevar udbydernøgler i gatewayen

Start

openai/model

  • cd til projektmappen
  • Sæt openai/ foran modelnavnet
  • Brug navnet fra gateway-listen
De to miljøvariabler udgør sammen med et modelnavn med præfikset openai/ syntaksen for det kompatible API.

Indtast værktøjskonfigurationen

Du behøver ikke oprette en separat konfigurationsfil. Gå til projektmappen, start Aider, og erstat model-ID’et med et navn, der faktisk findes på den aktuelle OmniProxy-liste:

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

For at bruge den anden eksempelmodel skal du køre:

aider --model openai/grok-4.7

Når Aider støder på en ukendt model, vises en advarsel. Denne advarsel betyder ikke i sig selv, at slutpunktet er forkert. Tjek OmniProxys anmodningslogfiler for at bekræfte, om anmodningen er modtaget.

Aider tilføjer kun filer, der allerede spores af Git, til konteksten. Konteksten er den kode og information, som modellen kan læse under den aktuelle opgave. Hvis den aktuelle mappe endnu ikke er et Git-repositorium, opretter Aider et, men filer, som Git ikke sporer, kan stadig ikke læses. Brug git add til at tilføje filerne og committ’e dem, før du starter Aider.

Aider kan stadig ændre filer. --no-auto-commits deaktiverer kun automatiske commits; det forhindrer ikke filændringer. Når du bruger Aider for første gang, bør du vælge et uvigtigt repositorium og køre git diff efter opgaven for at gennemgå de faktiske ændringer.

Gem ikke ægte nøgler i projektfiler eller på offentlige sider. Opbevar kun udbydernøgler i OmniProxy. Hvis gatewayen ikke validerer nøgler, kan du sætte OPENAI_API_KEY til en pladsholder-streng, der kun bruges på din lokale computer.

Bekræft med en virkelig opgave

Sørg først for, at den fil, du vil have Aider til at læse, er blevet committ’et til Git. Kør derefter følgende kommando fra projektmappen. Erstat model-ID’et med et fuldt ID fra den aktuelle OmniProxy-liste:

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 opgave direkte til Aider, mens --no-auto-commits fortæller Aider, at den ikke skal oprette Git-commits automatisk under denne kørsel.

Den 2026-10-09 kunne Aider v0.86.2 uden problemer læse den første linje i en sporet fil. Hvis filen ikke spores af Git, vil Aider meddele, at den ikke kan se indholdet. Det betyder ikke, at API-slutpunktet er forkert. Efter at have fuldført forespørgslen skal du tjekke OmniProxys anmodningslogfiler for at verificere anmodningskilden og model-ID’et.

Start

aider starter

  • Kommandoen er tilgængelig
  • Miljøvariabler er aktive
  • I projektmappen

Opgave

Den inspicerede filen

  • Spørg om en specifik fil
  • Gennemgå dens forklaring
  • Ukendte modeller kan udløse en advarsel

Logfiler

Synlige i gatewayen

  • Kilden er Aider
  • Model-ID matcher
  • Nøglen blev ikke indtastet på siden
Bekræft, at miljøvariablerne er aktive, og at kommandoen er tilgængelig, og fuldfør derefter en virkelig forespørgsel.

Almindelige fejl

  • aider kan ikke findes: Genåbn terminalen først. Hvis du installerede det direkte med pip, så prøv python -m aider.
  • Windows forbinder stadig til det gamle slutpunkt efter ændring af variablerne: Du skal genåbne terminalen efter at have kørt setx. Kun et nyt vindue vil læse de opdaterede variabler.
  • Modelnavnet begynder ikke med openai/: Det kompatible API kræver formatet openai/<model-name>.
  • Der vises en advarsel om ukendt model: Dette er en normal advarsel og betyder ikke, at forbindelsen mislykkedes. Tjek, om OmniProxy modtog anmodningen.
  • Model-ID’et er ugyldigt: Kopier det komplette ID igen fra den aktuelle OmniProxy-liste. Behold præfikset openai/ og eventuelle skråstreger, der allerede findes i ID’et.
  • Aider siger, at der ikke er noget filindhold: Sørg for, at filen spores af Git. Filer i et tomt repositorium eller filer, der ikke spores, tilføjes ikke til konteksten.

Officielle referencer

For installationstrin, se Aider installation. For miljøvariabler og modelpræfikset, se OpenAI compatible APIs. Eksempel-model-ID’er kan findes i Gemini model list og på xAI models page.

Erstat alle pladsholdere med værdier fra din egen OmniProxy-konfiguration. Publicér aldrig en rigtig nøgle.

Et gemt resultat eller HTTP 200 alene beviser ikke fuld agentkompatibilitet. Tjek kilden og modellen i OmniProxys anmodningspost.

Officielle kilder · Aider ↗