Instalace Aider a konfigurace OmniProxy

Aider je nástroj, který pomáhá upravovat kód z terminálu. Vytváří mapu celého projektu, aby model lépe pochopil rozsáhlejší kódovou základnu. Git je nástroj pro správu verzí, který zaznamenává změny v kódu a umožňuje vám kontrolovat rozdíly a obnovovat předchozí verze. Poté, co Aideru zadáte úkol, zpracuje jej krok za krokem a vytvoří zprávy o commitech. Pokud se vám změny nelíbí, můžete je vrátit zpět pomocí /undo.

Než začnete

Existují dvě běžné možnosti instalace:

• Pokud již v počítači máte Python 3.8 až 3.13, nainstalujte aider-install jako první. Python je běhové prostředí vyžadované Aiderem.
• Pokud nemáte vhodnou verzi Pythonu, použijte instalační příkaz na jeden řádek. V případě potřeby také nastaví Python 3.12.

Mac a Linux

install.sh

• Spusťte pomocí sh po curl
• Nainstaluje Python, pokud je potřeba
• Pokud není k dispozici curl, použijte wget

Windows

install.ps1

• Spusťte v PowerShellu
• Po instalaci znovu otevřete terminál
• Nastavte proměnné prostředí pomocí setx

Python již nainstalován

aider-install

• Nejprve nainstalujte tento balíček pomocí pip
• Poté spusťte aider-install
• Vytvoří si vlastní prostředí

Ujistěte se, že OmniProxy běží. Po instalaci přejděte do adresáře projektu, který chcete upravit, a teprve poté spusťte Aider.

Instalace a první spuštění

Pokud již máte Python 3.8 až 3.13

Spusťte tyto příkazy v pořadí:

python -m pip install aider-install
aider-install

aider-install nainstaluje Aider do samostatného prostředí Pythonu, aby neovlivňoval ostatní projekty v počítači. V případě potřeby také nainstaluje Python 3.12, který Aider využije.

Instalace na jeden řádek

Na Macu a Linuxu spusťte:

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

Pokud není nainstalován curl, použijte:

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

Ve Windows PowerShellu spusťte:

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

Tyto příkazy na jeden řádek jsou založeny na uv, programu pro instalaci a správu nástrojů a prostředí Pythonu. Můžete také použít následující příkaz:

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

Můžete také použít pipx. Při instalaci přímo pomocí python -m pip install aider-chat, jsou podporovány verze Pythonu 3.9 až 3.12. Toto je však alternativní metoda instalace, proto upřednostněte výše popsané metody. Balíčky Aider ze systémových správců balíčků mohou mít neshody v závislostech, proto by neměly být vaší první volbou.

K 9. 10. 2026 nainstaloval instalační příkaz na jeden řádek Aider v0.86.2. Během instalace se může zobrazit zpráva, že mezipaměť a cílové umístění jsou na různých discích a že soubory budou zkopírovány. Instalace bude přesto dokončena.

Po instalaci přejděte do adresáře projektu. Kompatibilní API je rozhraní, které komunikuje s ostatními modelovými službami pomocí formátu OpenAI. Spusťte Aider pomocí tohoto vzoru:

aider --model openai/<model-name>

Nahraďte <model-name> úplným ID modelu zkopírovaným z OmniProxy v další části. ID modelu je název používaný k přesné identifikaci modelu.

Získání nastavení připojení z OmniProxy

Musíte nastavit následující dvě proměnné prostředí. Proměnné prostředí lze chápat jako sadu nastavení připojení, kterou čtou programy v terminálu:

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í obsahovat /v1. OPENAI_API_KEY je klíč používaný pro přístup k API.

Ve Windows použijte setx k uložení proměnných. Poté musíte znovu otevřít terminál:

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

Zkopírujte celý název modelu z aktuálního seznamu OmniProxy, včetně všech lomítek v ID modelu. Při spouštění Aideru přidejte openai/ před úplné ID.

K 9. 10. 2026 byla dvě referenční ID v dokumentaci poskytovatele gemini-3.8-flash a grok-4.7. Pokud tyto názvy nejsou v aktuálním seznamu, nekopírujte je přímo. Použijte úplné ID, které se skutečně v seznamu nachází.

Adresa

OPENAI_API_BASE

• Nasměrujte na OmniProxy
• Zahrňte /v1
• Nedávejte jej do repozitáře

Klíč

OPENAI_API_KEY

• Použijte ten, který poskytuje brána
• Po změně znovu otevřete terminály Windows
• Klíče poskytovatele uchovávejte v bráně

Spuštění

openai/model

• cd do adresáře projektu
• Před název modelu přidejte openai/
• Použijte název ze seznamu brány

Zadání konfigurace nástroje

Nemusíte vytvářet samostatný konfigurační soubor. Přejděte do adresáře projektu, spusťte Aider a nahraďte ID modelu názvem, který skutečně existuje v aktuálním seznamu OmniProxy:

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

Chcete-li použít druhý příklad modelu, spusťte:

aider --model openai/grok-4.7

Když Aider narazí na neznámý model, zobrazí varování. Toto varování samo o sobě neznamená, že koncový bod je nesprávný. Zkontrolujte protokoly požadavků OmniProxy, abyste potvrdili, zda se požadavek objevil.

Aider přidává do kontextu pouze soubory již sledované Gitem. Kontext je kód a informace, které může model číst během aktuálního úkolu. Pokud aktuální adresář ještě není repozitářem Gitu, Aider jej vytvoří, ale soubory, které Git nesleduje, stále nelze číst. Použijte git add k přidání souborů a jejich commitu před spuštěním Aideru.

Aider stále může upravovat soubory. --no-auto-commits pouze zakáže automatické commity; nezabrání úpravám souborů. Při prvním použití Aideru zvolte nedůležitý repozitář a spusťte git diff po úkolu pro kontrolu skutečných změn.

Nedávejte skutečné klíče do souborů projektu nebo na veřejné stránky. Klíče poskytovatele ukládejte pouze v OmniProxy. Pokud brána klíče neověřuje, můžete nastavit OPENAI_API_KEY na zástupný řetězec používaný pouze ve vašem místním počítači.

Ověření pomocí skutečného úkolu

Nejprve se ujistěte, že soubor, který má Aider číst, byl commitnut do Gitu. Poté spusťte následující příkaz z adresáře projektu. Nahraďte ID modelu úplným ID z aktuálního seznamu 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 odešle úkol přímo Aideru, zatímco --no-auto-commits řekne Aideru, aby během tohoto běhu automaticky nevytvářel commity Gitu.

K 9. 10. 2026 Aider v0.86.2 úspěšně přečetl první řádek sledovaného souboru. Pokud soubor není sledován Gitem, Aider oznámí, že nevidí obsah. To neznamená, že koncový bod API je nesprávný. Po dokončení dotazu zkontrolujte protokoly požadavků OmniProxy pro ověření zdroje požadavku a ID modelu.

Spuštění

Aider se spustí

• Příkaz je k dispozici
• Proměnné prostředí jsou aktivní
• V adresáři projektu

Úkol

Soubor byl zkontrolován

• Zeptejte se na konkrétní soubor
• Zkontrolujte jeho vysvětlení
• Neznámé modely mohou vyvolat varování

Protokoly

Viditelné v bráně

• Zdroj je Aider
• ID modelu souhlasí
• Klíč nebyl zadán na stránce

Běžné chyby

• aider nelze nalézt: Nejprve znovu otevřete terminál. Pokud jste jej nainstalovali přímo pomocí pip, zkuste python -m aider.
• Windows se po změně proměnných stále připojuje ke starému koncovému bodu: Po spuštění příkazu setx musíte terminál znovu otevřít. Aktualizované proměnné načte až nové okno.
• Název modelu nezačíná openai/: Kompatibilní API vyžaduje formát openai/<model-name>.
• Objeví se varování o neznámém modelu: Toto je běžné varování a neznamená, že připojení selhalo. Zkontrolujte, zda OmniProxy požadavek přijalo.
• ID modelu je neplatné: Znovu zkopírujte úplné ID z aktuálního seznamu OmniProxy. Ponechte předponu openai/ a všechna lomítka, která jsou již v ID přítomna.
• Aider říká, že soubor nemá žádný obsah: Ujistěte se, že soubor je sledován Gitem. Soubory v prázdném repozitáři nebo nesledované soubory nejsou přidány do kontextu.

Oficiální reference

Pro kroky instalace viz Instalace Aider. Pro proměnné prostředí a předponu modelu viz API kompatibilní s OpenAI. Příklad ID modelů naleznete v seznamu modelů Gemini a na stránce modelů xAI.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · Aider ↗