Aider telepítése és OmniProxy konfigurálása

Az Aider egy olyan eszköz, amely segít a kód módosításában a terminálból. Térképet készít a teljes kódbázisról, hogy a modell megértse a nagyobb projekteket. A Git egy verziókezelő eszköz, amely rögzíti a kódváltozásokat, lehetővé téve a különbségek ellenőrzését és a korábbi verziók visszaállítását. Miután feladatot adott az Aidernek, az lépésről lépésre feldolgozza azt, és commit üzeneteket ír. Ha nem tetszenek a változtatások, visszavonhatja őket ezzel: /undo.

Mielőtt elkezdené

Két gyakori telepítési lehetőség létezik:

Ha a számítógépén már van Python 3.8 és 3.13 közötti verzió, telepítse aider-install először. A Python az Aider futtatásához szükséges környezet.

Mac és Linux

install.sh

Futtassa sh-val a curl után
Szükség esetén telepíti a Pythont
Használjon wget-et, ha a curl nem érhető el

Windows

install.ps1

Futtassa PowerShellben
Telepítés után indítsa újra a terminált
Állítsa be a környezeti változókat a setx-szel

A Python már telepítve van

aider-install

Először telepítse ezt a csomagot pip-pel
Majd futtassa az aider-install-t
Saját környezetet hoz létre

Az egysoros telepítő szükség esetén beállítja a Python 3.12-t. Az aider-chat közvetlen telepítése pip-pel kevésbé megbízható.

Győződjön meg róla, hogy az OmniProxy fut. A telepítés után lépjen be abba a projektkönyvtárba, amelyet módosítani szeretne, mielőtt elindítaná az Aidert.

Telepítés és első indítás

Ha már rendelkezik Python 3.8-3.13 verzióval

Futtassa ezeket a parancsokat sorrendben:

python -m pip install aider-install
aider-install

aider-install külön Python-környezetben telepíti az Aidert, így az nem zavarja a számítógépén lévő egyéb Python-projekteket. Szükség esetén telepíti a Python 3.12-t is az Aider számára.

Egysoros telepítés

Macen és Linuxon futtassa:

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

Ha a curl nincs telepítve, használja:

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

Windows PowerShellben futtassa:

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

Ezek az egysoros parancsok a uv-n alapulnak, amely egy program a Python-eszközök és -környezetek telepítésére és kezelésére. Használhatja a következő parancsot is:

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

Használhat pipx-et is. Amikor közvetlenül ezzel telepít: python -m pip install aider-chat, a támogatott Python-verziók a 3.9 és 3.12 közöttiek. Ez azonban egy alternatív telepítési mód, ezért részesítse előnyben a fent leírtakat. A rendszer csomagkezelőiből származó Aider-csomagok függőségi eltéréseket mutathatnak, ezért nem ezek legyenek az első választásai.

október 9-én az egysoros telepítési parancs az Aider v0.86.2-t telepítette. A telepítés során megjelenhet egy üzenet, miszerint a gyorsítótár és a célhely különböző lemezeken van, és a fájlok másolásra kerülnek. A telepítés ettől függetlenül befejeződik.

A telepítés után lépjen be a projektkönyvtárba. A kompatibilis API egy olyan interfész, amely az OpenAI formátumot használva kommunikál más modell-szolgáltatásokkal. Indítsa el az Aidert ezzel a mintával:

aider --model openai/<model-name>

Cserélje le a <model-name> részt az OmniProxyból kimásolt teljes modellazonosítóra a következő szakaszban. A modellazonosító az a név, amellyel pontosan azonosítható egy modell.

Csatlakozási beállítások beszerzése az OmniProxyból

A következő két környezeti változót kell beállítania. A környezeti változók olyan csatlakozási beállításokként értelmezhetők, amelyeket a terminálprogramok olvasnak:

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

OPENAI_API_BASE az API végpontja, és tartalmaznia kell a /v1. OPENAI_API_KEY az API eléréséhez használt kulcs.

Windows esetén használja a setx parancsot a változók mentéséhez. Ezt követően újra kell indítania a terminált:

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

Másolja ki a teljes modellnevet az aktuális OmniProxy-listából, beleértve a modellazonosítóban lévő esetleges perjeleket is. Az Aider indításakor adja hozzá az openai/ előtagot a teljes azonosító elé.

október 9-én a szolgáltatói dokumentációban szereplő két referencia-azonosító a gemini-3.8-flash és a grok-4.7. Ha ezek a nevek nem szerepelnek az aktuális listában, ne másolja őket közvetlenül. Használjon olyan teljes azonosítót, amely ténylegesen szerepel a listában.

Cím

OPENAI_API_BASE

Mutasson az OmniProxyra
Tartalmazza a /v1-et
Ne tegye a tárolóba

Kulcs

OPENAI_API_KEY

Használja az átjáró által biztosítottat
Módosítás után indítsa újra a Windows terminálokat
A szolgáltatói kulcsokat tartsa az átjáróban

Indítás

openai/modell

cd a projektkönyvtárba
A modellnév elé tegye az openai/ előtagot
Használja az átjáró listájában szereplő nevet

A két környezeti változó, valamint az openai/ előtaggal ellátott modellnév alkotja a kompatibilis API szintaxist.

Az eszköz konfigurálása

Nem kell külön konfigurációs fájlt létrehoznia. Lépjen be a projektkönyvtárba, indítsa el az Aidert, és cserélje le a modellazonosítót egy olyan névre, amely ténylegesen létezik az aktuális OmniProxy-listában:

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

A másik példamodell használatához futtassa:

aider --model openai/grok-4.7

Amikor az Aider ismeretlen modellel találkozik, figyelmeztetést jelenít meg. Ez a figyelmeztetés önmagában nem jelenti azt, hogy a végpont helytelen. Ellenőrizze az OmniProxy kérésnaplóit, hogy megerősítse, megjelent-e a kérés.

Az Aider csak a Git által már követett fájlokat adja hozzá a kontextushoz. A kontextus az a kód és információ, amelyet a modell az aktuális feladat során olvashat. Ha az aktuális könyvtár még nem Git-tárhely, az Aider létrehoz egyet, de a Git által nem követett fájlok továbbra sem olvashatók. Használja a git add parancsot a fájlok hozzáadásához és commitolásához az Aider indítása előtt.

Az Aider továbbra is módosíthat fájlokat. --no-auto-commits csak az automatikus commitokat tiltja le; nem akadályozza meg a fájlmódosításokat. Amikor először használja az Aidert, válasszon egy nem fontos tárolót, és futtassa a git diff parancsot a feladat után a tényleges változtatások áttekintéséhez.

Ne tegyen valódi kulcsokat projektfájlokba vagy nyilvános oldalakra. A szolgáltatói kulcsokat csak az OmniProxyban tárolja. Ha az átjáró nem érvényesíti a kulcsokat, beállíthatja a OPENAI_API_KEY változót egy csak a helyi számítógépen használt helyőrző karakterláncra.

Ellenőrzés valódi feladattal

Először győződjön meg róla, hogy a fájlt, amelyet az Aiderrel olvastatni szeretne, commitolta a Gitbe. Ezután futtassa a következő parancsot a projektkönyvtárból. Cserélje le a modellazonosítót az aktuális OmniProxy-listából származó teljes azonosítóra:

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 közvetlenül küld feladatot az Aidernek, míg a --no-auto-commits arra utasítja az Aidert, hogy ne hozzon létre automatikusan Git-commitokat a futtatás során.

október 9-én az Aider v0.86.2 sikeresen elolvasta egy követett fájl első sorát. Ha a fájlt nem követi a Git, az Aider azt fogja mondani, hogy nem látja a tartalmat. Ez nem jelenti azt, hogy az API-végpont helytelen. A lekérdezés befejezése után ellenőrizze az OmniProxy kérésnaplóit a kérés forrásának és a modellazonosítónak az ellenőrzéséhez.

Indítás

az aider elindul

A parancs elérhető
A környezeti változók aktívak
A projektkönyvtárban

Feladat

Átvizsgálta a fájlt

Kérdezzen egy adott fájlról
Tekintse át a magyarázatát
Az ismeretlen modellek figyelmeztetést válthatnak ki

Naplók

Látható az átjáróban

A forrás az Aider
A modellazonosító egyezik
A kulcs nem lett megadva az oldalon

Erősítse meg, hogy a környezeti változók aktívak és a parancs elérhető, majd hajtson végre egy valódi lekérdezést.

Gyakori hibák

aider nem található: Először indítsa újra a terminált. Ha közvetlenül pip-pel telepítette, próbálja meg a python -m aiderparancsot.
A Windows a változók módosítása után is a régi végponthoz csatlakozik: A setxfuttatása után újra kell indítania a terminált. Csak egy új ablak olvassa be a frissített változókat.
A modellnév nem a openai/előtaggal kezdődik: A kompatibilis API a openai/<model-name>formátumot igényli.
Ismeretlen modellre vonatkozó figyelmeztetés jelenik meg: Ez egy normál figyelmeztetés, és nem jelenti azt, hogy a kapcsolat meghiúsult. Ellenőrizze, hogy az OmniProxy megkapta-e a kérést.
A modellazonosító érvénytelen: Másolja ki újra a teljes azonosítót az aktuális OmniProxy-listából. Tartsa meg az openai/ előtagot és az azonosítóban már meglévő perjeleket.
Az Aider azt mondja, hogy nincs fájltartalom: Győződjön meg róla, hogy a fájlt követi a Git. Az üres tárolóban lévő fájlok vagy a nem követett fájlok nem kerülnek hozzáadásra a kontextushoz.

Hivatalos hivatkozások

A telepítési lépésekért lásd: Aider installation. A környezeti változókért és a modell-előtagért lásd: OpenAI compatible APIs. A példamodell-azonosítók megtalálhatók a Gemini model list és az xAI models page.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · Aider ↗