Przejdź do głównej treści

Instalacja i użycie Aider

Aider to narzędzie AI do parowego programowania w terminalu. AI-School zaleca Aider do kodowania z uczniami, ponieważ narzędzie jest jawne w działaniu i mniej agentyczne niż wiele innych agentów kodowania.

Uczeń otrzymuje pomoc w programowaniu, ale nadal widzi, które pliki są modyfikowane.

Więcej informacji znajdziesz na stronie Aider: Aider-website oraz w oficjalnej dokumentacji Aider.

Instalacja

Aby korzystać z Aider, najpierw potrzebujesz Pythona. Zainstaluj Pythona 3 przez python.org lub za pomocą menedżera pakietów, takiego jak Homebrew.

Najpierw sprawdź, czy Python jest dostępny.

macOS i Linux

python3 --version

Na macOS i wielu instalacjach Linuksa polecenie Python 3 nazywa się python3 zamiast python. Dlatego w instrukcji zawsze używaj python3.

Windows

py --version

W Windows Python zazwyczaj uruchamiany jest za pomocą py.

Instalacja Aider

Zalecana instalacja zgodnie z dokumentacją instalacji Aider przebiega przez aider-install.

macOS i Linux

python3 -m pip install aider-install
aider-install

Na macOS i Linux Aider może być również zainstalowany za pomocą skryptu instalacyjnego:

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

Na Windows można to zrobić za pomocą PowerShell:

py -m pip install aider-install
aider-install

Lub za pomocą skryptu instalacyjnego:

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

Aider działa najlepiej w katalogu będącym repozytorium git. Zainstaluj więc również git i pozwól uczniom pracować w projekcie z zarządzaniem wersjami.

Połączenie z Kodowaniem

Aider może pracować z interfejsami API zgodnymi z OpenAI. Użyj do tego punktu końcowego Kodowanie i klucza API z AI-School.

macOS i Linux

export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="twoj-klucz-api"

Windows

setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "twoj-klucz-api"

Następnie zamknij terminal i otwórz nowy terminal, aby Windows używał nowych zmiennych.

Uruchomienie Aider

Przejdź do katalogu swojego projektu:

cd ścieżka/do/twojego/projektu

Uruchom Aider z dozwolonym modelem. Dla uczniów sugerujemy gpt-5.4-mini.

aider --model openai/gpt-5.4-mini

Dla zaawansowanych użytkowników można wybrać silniejszy model:

aider --model openai/gpt-5.4

Praca z plikami

W Aider możesz dodawać pliki do kontekstu:

/add src/main.py

Następnie poproś o pomoc, na przykład:

Czy możesz wyjaśnić, dlaczego ta funkcja nie działa?

Lub:

Uczyń komunikat błędu bardziej zrozumiałym dla użytkownika.

Przydatne komendy

KomendaZnaczenie
/add plikDodaj plik do czatu
/askZadaj pytania bez bezpośredniej zmiany kodu
/codePoproś Aidera o zmianę kodu
/diffZobacz zmiany
/undoCofnij ostatnią zmianę AI
/exitZakończ Aider

Rada dla klasy

Pozwól uczniom używać Aidera jako pomocy programistycznej, a nie jako automatycznego rozwiązania.

Dobre zadania to na przykład:

  • „Wyjaśnij, co oznacza ten komunikat o błędzie.”
  • „Którego kroku powinienem teraz szukać?”
  • „Pomóż mi zmniejszyć tę funkcję.”
  • „Sprawdź, czy moje rozwiązanie jest spójne.”

Mniej odpowiednie dla początkujących:

  • „Zrób całe zadanie za mnie.”
  • „Zbuduj całą aplikację.”
  • „Rozwiąż wszystko automatycznie.”