Instalacja Aider i konfiguracja OmniProxy

Aider to narzędzie pomagające modyfikować kod w terminalu. Tworzy mapę całej bazy kodu, aby ułatwić modelowi zrozumienie większych projektów. Git jest natomiast systemem kontroli wersji, który zapisuje zmiany w kodzie, umożliwiając przeglądanie różnic i przywracanie wcześniejszego stanu. Gdy przekażesz Aiderowi zadanie, narzędzie wykona je etapami i przygotuje opis commita. Jeśli zmiany Ci nie odpowiadają, możesz je cofnąć poleceniem /undo.

Przygotowanie przed instalacją

Dostępne są dwie typowe metody instalacji:

Jeśli na komputerze jest już Python w wersji od 3.8 do 3.13: najpierw zainstaluj aider-install. Python jest środowiskiem wymaganym do działania Aidera.
Jeśli nie masz odpowiedniej wersji Pythona: użyj jednowierszowego polecenia instalacyjnego, które w razie potrzeby przygotuje również Python 3.12.

Mac i Linux

install.sh

Wykonaj przez sh po curl
W razie potrzeby zainstaluje Python
Bez curl użyj wget

Windows

install.ps1

Wykonaj w PowerShell
Po instalacji otwórz ponownie terminal
Zmienne środowiskowe ustaw przez setx

Masz już Python

aider-install

Najpierw zainstaluj ten pakiet przez pip
Następnie uruchom aider-install
Sam utworzy środowisko

Instalacja jednowierszowa w razie potrzeby przygotuje Python 3.12. Bezpośrednia instalacja aider-chat przez pip jest mniej niezawodna.

Przygotuj działającą instancję OmniProxy. Po zakończeniu instalacji przejdź najpierw do katalogu projektu, który chcesz zmodyfikować, a następnie uruchom Aider.

Instalacja i pierwsze uruchomienie

Jeśli masz już Python w wersji od 3.8 do 3.13

Wykonaj kolejno:

python -m pip install aider-install
aider-install

aider-install zainstaluje Aider w osobnym środowisku Pythona, aby nie mieszał się z innymi projektami Python na komputerze. W razie potrzeby zainstaluje również Python 3.12 przeznaczony do użycia przez Aider.

Instalacja jednowierszowa

Na Macu i Linuksie wykonaj:

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

Jeśli na komputerze nie ma programu curl, możesz zamiast tego użyć:

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

W Windows PowerShell wykonaj:

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

Te jednowierszowe polecenia korzystają z uv — programu służącego do instalowania narzędzi i środowisk Pythona oraz zarządzania nimi. Możesz również użyć następującego polecenia:

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

Można też skorzystać z pipx. Przy bezpośredniej instalacji przez python -m pip install aider-chat obsługiwane są wersje Pythona od 3.9 do 3.12, ale jest to alternatywna metoda instalacji, dlatego zalecane jest użycie jednej z wcześniejszych metod. Aider dostępny w systemowych menedżerach pakietów może mieć niezgodne zależności, więc nie należy wybierać ich w pierwszej kolejności.

2026-10-09 instalacja przy użyciu polecenia jednowierszowego zainstalowała Aider v0.86.2. Jeśli podczas instalacji pojawi się komunikat, że pamięć podręczna i katalog docelowy nie znajdują się na tym samym dysku i pliki zostaną skopiowane, instalacja mimo to zostanie ukończona.

Po zakończeniu instalacji przejdź do katalogu projektu. Interfejs kompatybilny oznacza interfejs komunikujący się z innymi usługami modeli w formacie OpenAI. Aider uruchamia się w następujący sposób:

aider --model openai/<model-name>

Zastąp <model-name> pełnym identyfikatorem modelu skopiowanym z OmniProxy zgodnie z następną sekcją. Identyfikator modelu to nazwa służąca do jednoznacznego wskazania modelu.

Pobieranie parametrów połączenia z OmniProxy

Należy ustawić następujące dwie zmienne środowiskowe. Zmienne środowiskowe można rozumieć jako zestaw ustawień połączenia odczytywanych przez programy działające w terminalu:

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

OPENAI_API_BASE jest adresem interfejsu i musi kończyć się na /v1. OPENAI_API_KEY jest kluczem używanym do uzyskiwania dostępu do interfejsu.

W Windows zapisz zmienne za pomocą setx. Po wykonaniu poleceń należy ponownie otworzyć terminal:

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

Skopiuj całą nazwę modelu z aktualnej listy OmniProxy, zachowując również ukośniki w identyfikatorze modelu. Podczas uruchamiania Aidera dodaj przed pełnym identyfikatorem prefiks openai/.

2026-10-09 dwa porównawcze identyfikatory podane w dokumentacji dostawców to gemini-3.8-flash i grok-4.7. Jeśli aktualna lista nie zawiera tych nazw, nie kopiuj ich bezpośrednio — użyj pełnego identyfikatora, który rzeczywiście znajduje się na liście.

Adres

OPENAI_API_BASE

Wskaż OmniProxy
Zakończ adresem /v1
Nie zapisuj w repozytorium

Klucz

OPENAI_API_KEY

Użyj klucza otrzymanego od bramy
W Windows po zmianie otwórz terminal ponownie
Klucz dostawcy pozostaw w bramie

Uruchomienie

openai/model

Przejdź cd do katalogu projektu
Dodaj openai/ przed nazwą modelu
Kieruj się listą bramy

Dwie zmienne środowiskowe oraz nazwa modelu z prefiksem openai/ tworzą oficjalny zapis interfejsu kompatybilnego.

Wprowadzanie konfiguracji narzędzia

Nie trzeba tutaj tworzyć dodatkowego pliku konfiguracyjnego. Najpierw przejdź do katalogu projektu, a następnie uruchom Aider, zastępując identyfikator modelu nazwą, która rzeczywiście znajduje się na aktualnej liście OmniProxy:

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

Aby użyć drugiego przykładowego modelu, wykonaj:

aider --model openai/grok-4.7

Jeśli Aider nie rozpoznaje modelu, w interfejsie pojawi się ostrzeżenie. Samo ostrzeżenie nie oznacza, że adres jest nieprawidłowy. Sprawdź w rejestrze wywołań OmniProxy, czy pojawiło się to żądanie.

Aider umieszcza w kontekście wyłącznie pliki, które są już śledzone przez Git. Kontekst oznacza kod i informacje, które model może odczytać w ramach bieżącego zadania. Jeśli aktualny katalog nie jest jeszcze repozytorium Git, Aider utworzy je automatycznie, ale pliki nieśledzone przez Git nadal nie będą dostępne do odczytu. Najpierw dodaj pliki za pomocą git add i utwórz commit, a dopiero potem uruchom Aider.

Aider nadal może modyfikować pliki. Opcja --no-auto-commits wyłącza jedynie automatyczne tworzenie commitów i nie zapobiega modyfikowaniu plików. Przy pierwszym użyciu zaleca się wybranie mało ważnego repozytorium, a po zakończeniu zadania wykonanie git diff, aby sprawdzić rzeczywiste zmiany.

Nie zapisuj prawdziwego klucza w plikach projektu ani na publicznych stronach. Klucz dostawcy powinien znajdować się wyłącznie w OmniProxy. Jeśli brama nie weryfikuje klucza, jako OPENAI_API_KEY możesz podać ciąg znaków zastępczych używany tylko lokalnie.

Weryfikacja za pomocą rzeczywistego zadania

Najpierw upewnij się, że plik, który ma zostać odczytany, został dodany do Git i zapisany w commicie. Następnie wykonaj poniższe polecenie w katalogu projektu. Zastąp identyfikator modelu pełnym identyfikatorem z aktualnej listy OmniProxy:

aider --model openai/gemini-3.8-flash --message "Jaki jest pierwszy wiersz tego pliku? Nie modyfikuj pliku." --no-auto-commits

Opcja --message służy do bezpośredniego przekazania Aiderowi pojedynczego zadania, a --no-auto-commits oznacza, że podczas tego uruchomienia nie należy automatycznie tworzyć commitów Git.

2026-10-09 przy użyciu Aider v0.86.2 udało się odczytać pierwszy wiersz śledzonego pliku. Jeśli plik nie jest jeszcze śledzony przez Git, Aider odpowie, że nie widzi jego zawartości. Nie oznacza to, że adres interfejsu jest nieprawidłowy. Po zakończeniu zapytania sprawdź w rejestrze wywołań OmniProxy źródło żądania i identyfikator modelu.

Uruchomienie

aider działa

Polecenie jest dostępne
Zmienne środowiskowe działają
Pozostań w katalogu projektu

Zadanie

Przeczytał plik

Zapytaj o konkretny plik
Sprawdź jego opis
Nieznany model wyświetli ostrzeżenie

Rejestr

Brama go widzi

Źródło to Aider
Identyfikator modelu jest zgodny
Klucz nie trafił na stronę

Sprawdź, czy zmienne środowiskowe działają i polecenie jest dostępne, a następnie wykonaj rzeczywiste zapytanie.

Typowe błędy

Nie można znaleźć polecenia aider: najpierw ponownie otwórz terminal. Jeśli użyto bezpośredniej instalacji przez pip, możesz spróbować uruchomić python -m aider.
Po zmianie zmiennych Windows nadal łączy się ze starym adresem: po wykonaniu setx trzeba ponownie otworzyć terminal. Dopiero nowe okno odczyta zaktualizowane zmienne.
Brak openai/ przed nazwą modelu: interfejs kompatybilny wymaga zapisu openai/<model-name>.
Pojawia się ostrzeżenie o nierozpoznanym modelu: jest to zwykła informacja i nie oznacza nieudanego połączenia. Następnie sprawdź, czy OmniProxy otrzymało żądanie.
Nieprawidłowy identyfikator modelu: ponownie skopiuj pełny identyfikator z aktualnej listy OmniProxy, zachowując prefiks openai/ oraz wszystkie ukośniki obecne w identyfikatorze.
Aider informuje, że nie ma zawartości pliku: upewnij się, że plik jest już śledzony przez Git. Puste repozytorium ani nieśledzone pliki nie zostaną dodane do kontekstu.

Oficjalne materiały referencyjne

Instrukcje instalacji znajdziesz w Aider installation. Informacje o zmiennych środowiskowych i prefiksie modelu znajdują się w OpenAI compatible APIs. Przykładowe identyfikatory modeli można sprawdzić na stronach lista modeli Gemini oraz strona modeli xAI.

Zastąp każdy placeholder wartościami z własnej konfiguracji OmniProxy. Nigdy nie publikuj prawdziwego klucza.

Zapisany wynik lub HTTP 200 samo w sobie nie dowodzi pełnej kompatybilności Agenta. Sprawdź źródło i model w rejestrze połączeń OmniProxy.

Źródła oficjalne · Aider ↗