Aiderin asennus ja OmniProxy-määritykset

Aider on työkalu, joka auttaa koodin muokkaamisessa suoraan päätteestä. Se luo kartan koko koodikannasta auttaakseen mallia ymmärtämään laajempia projekteja. Git on versionhallintatyökalu, joka tallentaa koodimuutokset, mahdollistaen erojen tarkastelun ja aiempien versioiden palauttamisen. Kun annat Aiderille tehtävän, se käsittelee sen vaiheittain ja kirjoittaa commit-viestit. Jos et pidä muutoksista, voit perua ne komennolla /undo.

Ennen kuin aloitat

Asennukseen on kaksi yleistä vaihtoehtoa:

• Jos tietokoneellasi on jo Python 3.8–3.13, asenna aider-install ensin. Python on Aiderin vaatima suoritusympäristö.

Mac ja Linux

install.sh

• Suorita sh-komennolla curlin jälkeen
• Asentaa Pythonin tarvittaessa
• Käytä wgetiä, jos curl ei ole käytettävissä

Windows

install.ps1

• Suorita PowerShellissä
• Avaa pääte uudelleen asennuksen jälkeen
• Aseta ympäristömuuttujat setx-komennolla

Python on jo asennettu

aider-install

• Asenna tämä paketti ensin pipillä
• Suorita sitten aider-install
• Se luo oman ympäristönsä

Varmista, että OmniProxy on käynnissä. Asennuksen jälkeen siirry projektihakemistoon, jota aiot muokata, ennen kuin käynnistät Aiderin.

Asennus ja ensimmäinen käynnistys

Jos sinulla on jo Python 3.8–3.13

Suorita nämä komennot järjestyksessä:

python -m pip install aider-install
aider-install

aider-install asentaa Aiderin erilliseen Python-ympäristöön, jotta se ei häiritse muita tietokoneesi Python-projekteja. Tarvittaessa se asentaa myös Python 3.12:n Aiderin käyttöön.

Yhden rivin asennus

Suorita Macilla ja Linuxilla:

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

Jos curl ei ole asennettuna, käytä:

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

Suorita Windows PowerShellissä:

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

Nämä yhden rivin komennot perustuvat uv-työkaluun, joka on ohjelma Python-työkalujen ja -ympäristöjen hallintaan. Voit käyttää myös seuraavaa komentoa:

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

Voit käyttää myös pipxiä. Kun asennat suoraan komennolla python -m pip install aider-chat, tuetut Python-versiot ovat 3.9–3.12. Tämä on kuitenkin vaihtoehtoinen asennustapa, joten suosi edellä kuvattuja menetelmiä. Järjestelmän paketinhallinnasta tulevissa Aider-paketeissa voi olla riippuvuusristiriitoja, joten ne eivät ole ensisijainen valinta.

Tilanteessa 9.10.2026 yhden rivin asennuskomento asensi Aider v0.86.2:n. Asennuksen aikana saatat nähdä viestin, jonka mukaan välimuisti ja kohde ovat eri levyillä ja tiedostot kopioidaan. Asennus valmistuu silti.

Siirry asennuksen jälkeen projektihakemistoon. Yhteensopiva API on rajapinta, joka kommunikoi muiden mallipalveluiden kanssa OpenAI-muodossa. Käynnistä Aider tällä mallilla:

aider --model openai/<model-name>

Korvaa <model-name> koko mallitunnuksella (model ID), jonka kopioit OmniProxysta seuraavassa osiossa. Mallitunnus on nimi, jolla malli yksilöidään.

Hae yhteysasetukset OmniProxysta

Sinun on asetettava seuraavat kaksi ympäristömuuttujaa. Ympäristömuuttujat ovat pääteohjelmien lukemia yhteysasetuksia:

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

OPENAI_API_BASE on API-päätepiste ja sen on sisällettävä /v1. OPENAI_API_KEY on API-avain.

Käytä Windowsissa setx muuttujien tallentamiseen. Sinun on avattava pääte uudelleen tämän jälkeen:

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

Kopioi koko mallin nimi nykyisestä OmniProxy-listasta, mukaan lukien mahdolliset kauttaviivat. Kun käynnistät Aiderin, lisää openai/ ennen koko tunnusta.

Tilanteessa 9.10.2026 kaksi viitetunnusta palveluntarjoajan dokumentaatiossa olivat gemini-3.8-flash ja grok-4.7. Jos näitä nimiä ei ole nykyisessä listassa, älä kopioi niitä suoraan. Käytä listassa todellisuudessa näkyvää koko tunnusta.

Osoite

OPENAI_API_BASE

• Osoita se OmniProxyyn
• Sisällytä /v1
• Älä laita sitä arkistoon

Avain

OPENAI_API_KEY

• Käytä yhdyskäytävän tarjoamaa
• Avaa Windows-päätteet uudelleen muutoksen jälkeen
• Pidä palveluntarjoajan avaimet yhdyskäytävässä

Käynnistys

openai/malli

• Siirry projektihakemistoon (cd)
• Lisää mallin nimen eteen openai/
• Käytä yhdyskäytävän listan nimeä

Syötä työkalun määritykset

Erillistä asetustiedostoa ei tarvitse luoda. Siirry projektihakemistoon, käynnistä Aider ja korvaa mallitunnus nimellä, joka todella löytyy nykyisestä OmniProxy-listasta:

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

Käytä toista esimerkkimallia suorittamalla:

aider --model openai/grok-4.7

Kun Aider kohtaa tuntemattoman mallin, se näyttää varoituksen. Tämä varoitus ei itsessään tarkoita, että päätepiste olisi väärä. Tarkista OmniProxyn pyyntölokit varmistaaksesi, näkyykö pyyntö.

Aider lisää kontekstiin vain Gitin seuraamat tiedostot. Konteksti on koodia ja tietoa, jota malli voi lukea tehtävän aikana. Jos nykyinen hakemisto ei ole vielä Git-arkisto, Aider luo sellaisen, mutta Gitin seuraamattomat tiedostot eivät silti ole luettavissa. Käytä git add lisätäksesi tiedostot ja tehdäksesi commitin ennen Aiderin käynnistämistä.

Aider voi silti muokata tiedostoja. --no-auto-commits poistaa käytöstä vain automaattiset commitit; se ei estä tiedostojen muokkaamista. Kun käytät Aideria ensimmäistä kertaa, valitse epäolennainen arkisto ja suorita git diff tehtävän jälkeen tarkistaaksesi todelliset muutokset.

Älä laita oikeita avaimia projektitiedostoihin tai julkisille sivuille. Säilytä palveluntarjoajan avaimet vain OmniProxyssa. Jos yhdyskäytävä ei validoi avaimia, voit asettaa OPENAI_API_KEY paikkamerkkimerkkijonoksi, jota käytetään vain paikallisella tietokoneellasi.

Vahvista todellisella tehtävällä

Varmista ensin, että tiedosto, jonka haluat Aiderin lukevan, on commitattu Gitiin. Suorita sitten seuraava komento projektihakemistosta. Korvaa mallitunnus koko tunnuksella nykyisestä OmniProxy-listasta:

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 lähettää tehtävän suoraan Aiderille, kun taas --no-auto-commits käskee Aideria olemaan luomatta Git-commiteja automaattisesti tämän ajon aikana.

Tilanteessa 9.10.2026 Aider v0.86.2 luki onnistuneesti seurattavan tiedoston ensimmäisen rivin. Jos Git ei seuraa tiedostoa, Aider ilmoittaa, ettei se näe sisältöä. Tämä ei tarkoita, että API-päätepiste olisi väärä. Tarkista kyselyn jälkeen OmniProxyn pyyntölokit varmistaaksesi pyynnön lähteen ja mallitunnuksen.

Käynnistys

Aider käynnistyy

• Komento on käytettävissä
• Ympäristömuuttujat ovat aktiivisia
• Projektihakemistossa

Tehtävä

Se tarkasti tiedoston

• Kysy tietystä tiedostosta
• Tarkista sen selitys
• Tuntemattomat mallit voivat laukaista varoituksen

Lokit

Näkyvissä yhdyskäytävässä

• Lähde on Aider
• Mallitunnus täsmää
• Avainta ei syötetty sivulla

Yleiset virheet

• aider ei löydy: Avaa pääte uudelleen. Jos asensit sen suoraan pipillä, kokeile python -m aider.
• Windows yhdistää edelleen vanhaan päätepisteeseen muuttujien muuttamisen jälkeen: Sinun on avattava pääte uudelleen komennon setxsuorittamisen jälkeen. Vain uusi ikkuna lukee päivitetyt muuttujat.
• Mallin nimi ei ala openai/: Yhteensopiva API vaatii muodon openai/<model-name>.
• Tuntemattomasta mallista tulee varoitus: Tämä on normaali varoitus, eikä se tarkoita yhteyden epäonnistumista. Tarkista, vastaanottiko OmniProxy pyynnön.
• Mallitunnus on virheellinen: Kopioi koko tunnus uudelleen nykyisestä OmniProxy-listasta. Säilytä openai/ etuliite ja mahdolliset kauttaviivat tunnuksessa.
• Aider sanoo, ettei tiedostosisältöä ole: Varmista, että Git seuraa tiedostoa. Tyhjän arkiston tiedostot tai seuraamattomat tiedostot eivät lisäänny kontekstiin.

Viralliset viitteet

Katso asennusvaiheet kohdasta Aider-asennus. Katso ympäristömuuttujat ja mallin etuliite kohdasta OpenAI-yhteensopivat API:t. Esimerkkimallitunnukset löytyvät Gemini-mallilistasta ja xAI-mallien sivulta.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · Aider ↗