Installation av Aider och konfiguration av OmniProxy

Aider är ett verktyg som hjälper dig att ändra kod direkt från terminalen. Det bygger en karta över hela kodbasen för att hjälpa modellen att förstå större projekt. Git är ett versionshanteringsverktyg som loggar kodändringar, vilket gör att du kan inspektera skillnader och återställa tidigare versioner. När du ger Aider en uppgift bearbetar den uppgiften steg för steg och skriver commit-meddelanden. Om du inte är nöjd med ändringarna kan du ångra dem med /undo.

Innan du börjar

Det finns två vanliga installationsalternativ:

Om din dator redan har Python 3.8 till 3.13, installera aider-install först. Python är den körtidsmiljö som Aider kräver.
Om du inte har en lämplig Python-version, använd installationskommandot på en rad. Det sätter även upp Python 3.12 vid behov.

Mac och Linux

install.sh

Kör med sh efter curl
Installerar Python vid behov
Använd wget om curl saknas

Windows

install.ps1

Kör i PowerShell
Starta om terminalen efter installationen
Ställ in miljövariabler med setx

Python redan installerat

aider-install

Installera först detta paket med pip
Kör sedan aider-install
Det skapar en egen miljö

Installationsskriptet på en rad sätter upp Python 3.12 vid behov. Att installera aider-chat direkt med pip är mindre tillförlitligt.

Se till att OmniProxy körs. Efter installationen, gå till projektkatalogen du planerar att ändra innan du startar Aider.

Installation och första start

Om du redan har Python 3.8 till 3.13

Kör dessa kommandon i ordning:

python -m pip install aider-install
aider-install

aider-install installerar Aider i en separat Python-miljö så att den inte stör andra Python-projekt på din dator. Vid behov installerar den även Python 3.12 som Aider kan använda.

Installation på en rad

På Mac och Linux, kör:

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

Om curl inte är installerat, använd:

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

I Windows PowerShell, kör:

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

Dessa kommandon på en rad är baserade på uv, ett program för att installera och hantera Python-verktyg och miljöer. Du kan även använda följande kommando:

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

Du kan också använda pipx. När du installerar direkt med python -m pip install aider-chat är de Python-versioner som stöds 3.9 till 3.12. Detta är dock en alternativ installationsmetod, så föredra metoderna som beskrivs ovan. Aider-paket från systemets pakethanterare kan ha beroendekonflikter och bör därför inte vara ditt förstahandsval.

Den 2026-10-09 installerade installationskommandot på en rad Aider v0.86.2. Under installationen kan du se ett meddelande om att cachen och målplatsen finns på olika diskar och att filer kommer att kopieras istället. Installationen kommer ändå att slutföras.

Efter installationen, gå till projektkatalogen. Ett kompatibelt API är ett gränssnitt som kommunicerar med andra modelltjänster med OpenAI-formatet. Starta Aider med detta mönster:

aider --model openai/<model-name>

Ersätt <model-name> med det fullständiga modell-ID:t som du kopierat från OmniProxy i nästa avsnitt. Ett modell-ID är namnet som används för att identifiera en modell exakt.

Hämta anslutningsinställningar från OmniProxy

Du behöver ställa in följande två miljövariabler. Miljövariabler kan förstås som en uppsättning anslutningsinställningar som läses av terminalprogram:

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

OPENAI_API_BASE är API-slutpunkten och måste inkludera /v1. OPENAI_API_KEY är nyckeln som används för att få åtkomst till API:et.

På Windows, använd setx för att spara variablerna. Du måste starta om terminalen efteråt:

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

Kopiera hela modellnamnet från den aktuella OmniProxy-listan, inklusive eventuella snedstreck i modell-ID:t. När du startar Aider, lägg till openai/ före det fullständiga ID:t.

Per 2026-10-09 är de två referens-ID:na i leverantörsdokumentationen gemini-3.8-flash och grok-4.7. Om dessa namn inte finns i den aktuella listan, kopiera dem inte direkt. Använd ett fullständigt ID som faktiskt visas i listan.

Adress

OPENAI_API_BASE

Peka den mot OmniProxy
Inkludera /v1
Placera den inte i arkivet

Nyckel

OPENAI_API_KEY

Använd den som tillhandahålls av gatewayen
Starta om Windows-terminaler efter ändring
Behåll leverantörsnycklar i gatewayen

Starta

openai/modell

cd till projektkatalogen
Prefixa modellnamnet med openai/
Använd namnet från gateway-listan

De två miljövariablerna, tillsammans med ett modellnamn prefixat med openai/, bildar den kompatibla API-syntaxen.

Ange verktygskonfigurationen

Du behöver inte skapa en separat konfigurationsfil. Gå till projektkatalogen, starta Aider och ersätt modell-ID:t med ett namn som faktiskt finns i den aktuella OmniProxy-listan:

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

För att använda den andra exempelmodellen, kör:

aider --model openai/grok-4.7

När Aider stöter på en okänd modell visas en varning. Denna varning betyder inte i sig att slutpunkten är felaktig. Kontrollera OmniProxys begärandeloggar för att bekräfta om begäran dök upp.

Aider lägger endast till filer som redan spåras av Git i kontexten. Kontexten är den kod och information som modellen kan läsa under den aktuella uppgiften. Om den aktuella katalogen ännu inte är ett Git-arkiv skapar Aider ett, men filer som Git inte spårar kan fortfarande inte läsas. Använd git add för att lägga till filerna och committa dem innan du startar Aider.

Aider kan fortfarande ändra filer. --no-auto-commits inaktiverar endast automatiska commits; det förhindrar inte filändringar. När du använder Aider för första gången, välj ett oviktigt arkiv och kör git diff efter uppgiften för att granska de faktiska ändringarna.

Placera inte riktiga nycklar i projektfiler eller på offentliga sidor. Lagra endast leverantörsnycklar i OmniProxy. Om gatewayen inte validerar nycklar kan du ställa in OPENAI_API_KEY till en platshållarsträng som endast används på din lokala dator.

Verifiera med en verklig uppgift

Se först till att filen du vill att Aider ska läsa har committats till Git. Kör sedan följande kommando från projektkatalogen. Ersätt modell-ID:t med ett fullständigt ID från den aktuella OmniProxy-listan:

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 skickar en uppgift direkt till Aider, medan --no-auto-commits instruerar Aider att inte skapa Git-commits automatiskt under denna körning.

Den 2026-10-09 läste Aider v0.86.2 framgångsrikt den första raden i en spårad fil. Om filen inte spåras av Git kommer Aider att säga att den inte kan se innehållet. Detta betyder inte att API-slutpunkten är felaktig. Efter att ha slutfört frågan, kontrollera OmniProxys begärandeloggar för att verifiera begärandekällan och modell-ID:t.

Starta

Aider startar

Kommandot är tillgängligt
Miljövariabler är aktiva
I projektkatalogen

Uppgift

Den inspekterade filen

Fråga om en specifik fil
Granska dess förklaring
Okända modeller kan utlösa en varning

Loggar

Synliga i gatewayen

Källan är Aider
Modell-ID matchar
Nyckeln angavs inte på sidan

Bekräfta att miljövariablerna är aktiva och att kommandot är tillgängligt, slutför sedan en verklig fråga.

Vanliga fel

aider kan inte hittas: Starta om terminalen först. Om du installerade den direkt med pip, prova python -m aider.
Windows ansluter fortfarande till den gamla slutpunkten efter att ha ändrat variablerna: Du måste starta om terminalen efter att ha kört setx. Endast ett nytt fönster läser de uppdaterade variablerna.
Modellnamnet börjar inte med openai/: Det kompatibla API:et kräver formatet openai/<model-name>.
En varning om okänd modell visas: Detta är en normal varning och betyder inte att anslutningen misslyckades. Kontrollera om OmniProxy tog emot begäran.
Modell-ID:t är ogiltigt: Kopiera det fullständiga ID:t igen från den aktuella OmniProxy-listan. Behåll prefixet openai/ och eventuella snedstreck som redan finns i ID:t.
Aider säger att det inte finns något filinnehåll: Se till att filen spåras av Git. Filer i ett tomt arkiv eller ospårade filer läggs inte till i kontexten.

Officiella referenser

För installationssteg, se Aider installation. För miljövariabler och modellprefix, se OpenAI compatible APIs. Exempel på modell-ID:n finns i Gemini model list och på xAI models page.

Ersätt varje platshållare med värden från din egen OmniProxy-konfiguration. Publicera aldrig en riktig nyckel.

Ett sparat resultat eller HTTP 200 ensamt bevisar inte fullständig agentkompatibilitet. Kontrollera källa och modell i OmniProxys anropslogg.

Officiella källor · Aider ↗