Inštalácia Aider a konfigurácia OmniProxy

Aider je nástroj, ktorý pomáha upravovať kód priamo z terminálu. Vytvára mapu celého projektu, aby model lepšie pochopil rozsiahlejšie kódové základne. Git je nástroj na správu verzií, ktorý zaznamenáva zmeny v kóde, čo vám umožňuje kontrolovať rozdiely a obnovovať predchádzajúce verzie. Keď Aideru zadáte úlohu, spracuje ju krok za krokom a napíše správy k commitom. Ak sa vám zmeny nepáčia, môžete ich vrátiť pomocou /undo.

Skôr než začnete

Existujú dve bežné možnosti inštalácie:

Ak už máte v počítači nainštalovaný Python 3.8 až 3.13, nainštalujte aider-install ako prvý. Python je runtime prostredie, ktoré Aider vyžaduje.

Mac a Linux

install.sh

Spustite pomocou sh po curl
V prípade potreby nainštaluje Python
Ak nie je k dispozícii curl, použite wget

Windows

install.ps1

Spustite v PowerShell
Po inštalácii znova otvorte terminál
Nastavte premenné prostredia pomocou setx

Python je už nainštalovaný

aider-install

Najprv nainštalujte tento balík pomocou pip
Potom spustite aider-install
Vytvorí si vlastné prostredie

Jednoriadkový inštalátor v prípade potreby nastaví Python 3.12. Priama inštalácia aider-chat pomocou pip je menej spoľahlivá.

Uistite sa, že OmniProxy beží. Po inštalácii pred spustením Aidera prejdite do adresára projektu, ktorý plánujete upravovať.

Prvá inštalácia a spustenie

Ak už máte Python 3.8 až 3.13

Spustite tieto príkazy v poradí:

python -m pip install aider-install
aider-install

aider-install nainštaluje Aider do samostatného prostredia Pythonu, aby nezasahoval do iných projektov v počítači. V prípade potreby nainštaluje aj Python 3.12, ktorý Aider použije.

Jednoriadková inštalácia

Na systémoch Mac a Linux spustite:

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

Ak nemáte nainštalovaný curl, použite:

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

V systéme Windows v PowerShell spustite:

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

Tieto jednoriadkové príkazy sú založené na uv, programe na inštaláciu a správu nástrojov a prostredí Pythonu. Môžete použiť aj nasledujúci príkaz:

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

Môžete použiť aj pipx. Pri priamej inštalácii pomocou python -m pip install aider-chat, sú podporované verzie Pythonu 3.9 až 3.12. Ide však o alternatívny spôsob inštalácie, preto uprednostnite vyššie uvedené metódy. Balíky Aider zo systémových správcov balíkov môžu mať nezhody v závislostiach, preto by nemali byť vašou prvou voľbou.

K 9. 10. 2026 nainštaloval jednoriadkový inštalačný príkaz Aider v0.86.2. Počas inštalácie sa môže zobraziť správa, že vyrovnávacia pamäť a cieľ sú na rôznych diskoch a súbory sa budú kopírovať. Inštalácia sa napriek tomu dokončí.

Po inštalácii prejdite do adresára projektu. Kompatibilné API je rozhranie, ktoré komunikuje s ostatnými modelovými službami pomocou formátu OpenAI. Spustite Aider pomocou tohto vzoru:

aider --model openai/<model-name>

Nahraďte <model-name> úplným ID modelu skopírovaným z OmniProxy v nasledujúcej časti. ID modelu je názov používaný na presnú identifikáciu modelu.

Získanie nastavení pripojenia z OmniProxy

Musíte nastaviť nasledujúce dve premenné prostredia. Premenné prostredia možno chápať ako súbor nastavení pripojenia, ktoré čítajú programy v termináli:

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

OPENAI_API_BASE je koncový bod API a musí obsahovať /v1. OPENAI_API_KEY je kľúč používaný na prístup k API.

Vo Windows použite setx na uloženie premenných. Potom musíte znova otvoriť terminál:

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

Skopírujte celý názov modelu z aktuálneho zoznamu OmniProxy vrátane lomiek v ID modelu. Pri spúšťaní Aidera pridajte openai/ pred úplné ID.

K 9. 10. 2026 boli dve referenčné ID v dokumentácii poskytovateľa gemini-3.8-flash a grok-4.7. Ak tieto názvy nie sú v aktuálnom zozname, nekopírujte ich priamo. Použite úplné ID, ktoré sa skutočne nachádza v zozname.

Adresa

OPENAI_API_BASE

Nasmerujte ju na OmniProxy
Zahrňte /v1
Nedávajte ju do repozitára

Kľúč

OPENAI_API_KEY

Použite ten, ktorý poskytuje brána
Po zmene znova otvorte terminály Windows
Kľúče poskytovateľa uchovávajte v bráne

Spustenie

openai/model

cd do adresára projektu
Pred názov modelu pridajte predponu openai/
Použite názov zo zoznamu brány

Dve premenné prostredia spolu s názvom modelu s predponou openai/ tvoria syntax kompatibilného API.

Zadanie konfigurácie nástroja

Nemusíte vytvárať samostatný konfiguračný súbor. Prejdite do adresára projektu, spustite Aider a nahraďte ID modelu názvom, ktorý skutočne existuje v aktuálnom zozname OmniProxy:

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

Ak chcete použiť druhý príklad modelu, spustite:

aider --model openai/grok-4.7

Keď Aider narazí na neznámy model, zobrazí varovanie. Toto varovanie samo osebe neznamená, že koncový bod je nesprávny. Skontrolujte protokoly požiadaviek OmniProxy, aby ste potvrdili, či sa požiadavka objavila.

Aider pridáva do kontextu iba súbory, ktoré už sleduje Git. Kontext je kód a informácie, ktoré model môže čítať počas aktuálnej úlohy. Ak aktuálny adresár ešte nie je repozitárom Git, Aider ho vytvorí, ale súbory, ktoré Git nesleduje, stále nebude možné čítať. Použite git add na pridanie súborov a ich commitnutie pred spustením Aidera.

Aider stále môže upravovať súbory. --no-auto-commits iba zakáže automatické commity; nezabráni úpravám súborov. Pri prvom použití Aidera vyberte nedôležitý repozitár a spustite git diff po úlohe, aby ste skontrolovali skutočné zmeny.

Nedávajte skutočné kľúče do súborov projektu ani na verejné stránky. Kľúče poskytovateľa ukladajte iba v OmniProxy. Ak brána neoveruje kľúče, môžete nastaviť OPENAI_API_KEY na zástupný reťazec používaný iba vo vašom lokálnom počítači.

Overenie skutočnou úlohou

Najprv sa uistite, že súbor, ktorý má Aider čítať, bol commitnutý do Gitu. Potom spustite nasledujúci príkaz z adresára projektu. Nahraďte ID modelu úplným ID z aktuálneho zoznamu OmniProxy:

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 odošle úlohu priamo do Aidera, zatiaľ čo --no-auto-commits povie Aideru, aby počas tohto spustenia automaticky nevytváral commity Git.

K 9. 10. 2026 Aider v0.86.2 úspešne prečítal prvý riadok sledovaného súboru. Ak súbor nie je sledovaný Gitom, Aider povie, že nevidí jeho obsah. To neznamená, že koncový bod API je nesprávny. Po dokončení dotazu skontrolujte protokoly požiadaviek OmniProxy, aby ste overili zdroj požiadavky a ID modelu.

Spustenie

aider sa spustí

Príkaz je k dispozícii
Premenné prostredia sú aktívne
V adresári projektu

Úloha

Skontroloval súbor

Opýtajte sa na konkrétny súbor
Skontrolujte jeho vysvetlenie
Neznáme modely môžu vyvolať varovanie

Protokoly

Viditeľné v bráne

Zdrojom je Aider
ID modelu sa zhoduje
Kľúč nebol zadaný na stránke

Potvrďte, že premenné prostredia sú aktívne a príkaz je k dispozícii, potom dokončite jeden skutočný dotaz.

Bežné chyby

aider nemožno nájsť: Najprv znova otvorte terminál. Ak ste ho nainštalovali priamo pomocou pip, skúste python -m aider.
Windows sa po zmene premenných stále pripája k starému koncovému bodu: Po spustení setx musíte znova otvoriť terminál. Iba nové okno načíta aktualizované premenné.
Názov modelu nezačína openai/: Kompatibilné API vyžaduje formát openai/<model-name>.
Zobrazí sa varovanie o neznámom modeli: Toto je bežné varovanie a neznamená, že pripojenie zlyhalo. Skontrolujte, či OmniProxy prijalo požiadavku.
ID modelu je neplatné: Znova skopírujte úplné ID z aktuálneho zoznamu OmniProxy. Ponechajte openai/ predponu a všetky lomky, ktoré sú už v ID prítomné.
Aider hovorí, že neexistuje žiadny obsah súboru: Uistite sa, že súbor je sledovaný Gitom. Súbory v prázdnom repozitári alebo nesledované súbory sa do kontextu nepridávajú.

Oficiálne referencie

Postup inštalácie nájdete v časti Inštalácia Aider. Informácie o premenných prostredia a predpone modelu nájdete v časti API kompatibilné s OpenAI. Príklady ID modelov nájdete v zozname modelov Gemini a na stránke modelov xAI.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · Aider ↗