Powrót do bloga

Narzędzia i integracjePrzewodnik

Plik konfiguracyjny Aidera dla własnego klucza API: .aider.conf.yml i Windows setx

Trzymaj własny klucz API i bazowy URL w .aider.conf.yml, ustaw właściwą kolejność wczytywania i uniknij pułapki Windows setx, z szacunkowym kosztem sesji.

Autor: CheapTokens TeamOpublikowano 3 min czytania

Terminal z poleceniami, które podłączają Aidera do API zgodnego z OpenAI
Na tej stronie
  1. Windows: setx i nowy terminal
  2. Który model do jakich edycji
  3. Uruchom pierwszą edycję
  4. Przestań przepisywać: .aider.conf.yml
  5. Ile kosztuje sesja
  6. Jeśli to nie działa

Dwie zmienne, OPENAI_API_BASE i OPENAI_API_KEY, oraz argument modelu taki jak openai/<model id> wystarczą, aby wskazać Aiderowi CheapTokens. Podstawy krok po kroku (instalacja, pierwsze żądanie, 401/404/400/402) znajdują się w Jak podłączyć Aidera do CheapTokens; ta strona omawia to, czego brakuje w tamtym przewodniku: Windows setx, plik konfiguracyjny i jego kolejność wczytywania oraz szacunkowy koszt sesji.

Źródło: dokumentacja Aidera dla API zgodnych z OpenAI (strona sprawdzona 26 października 2026; dokumentacja nie podaje daty ani wersji, a najnowsza wersja aider-chat w PyPI tego dnia to 0.86.2).

Windows: setx i nowy terminal#

Na Macu i Linuksie export te dwie zmienne. W Windows (PowerShell lub cmd) użyj setx:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

W Windows jest pewien haczyk. setx zapisuje zmienne dla przyszłych sesji, a nie tej, w której aktualnie piszesz, więc zamknij terminal i otwórz nowy, zanim uruchomisz Aidera. Jeśli ustawisz zmienne, a Aider nadal prosi o klucz, to jest zwykle tego przyczyna.

Który model do jakich edycji#

Argument modelu to openai/ plus pełny identyfikator, więc dla CheapTokens ma dwa ukośniki:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 ma kontekst 180K i odpowiada do 8192 tokenów, co pasuje do małych i średnich edycji, gdzie odpowiedzi pozostają krótkie. Jeśli twoje edycje wracają jako długie diffy, drugim modelem wartym wypróbowania jest DeepSeek-V4-Flash: do 32 768 tokenów na odpowiedź, kontekst 380K i jedna cena o każdej porze dnia.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Skopiuj pełny identyfikator z dokumentacji CheapTokens lub z listy modeli na stronie cennika.

Uruchom pierwszą edycję#

Aider działa wewnątrz repozytorium git, więc zacznij w takim. Dodaj plik i poproś o coś małego:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Gdy Aider odpowie edycją pliku, klucz, bazowy URL i identyfikator modelu są prawidłowe.

Błędny identyfikator modelu obok pełnego identyfikatora, który działa, a następnie pierwsza edycja
Błędny identyfikator kontra pełny identyfikator i pierwsze żądanie

Przestań przepisywać: .aider.conf.yml#

Aider czyta .aider.conf.yml z katalogu domowego, potem z katalogu głównego repozytorium git, a następnie z bieżącego katalogu, przy czym późniejsze pliki wygrywają. Tak więc globalny plik może przechowywać klucz i bazowy URL, a plik repozytorium może wybierać model. Jeśli chcesz jeden konkretny plik i nic więcej, aider --config <file> wczytuje tylko ten jeden.

Plik w katalogu domowym (przykład, wstaw własny klucz):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Teraz samo aider uruchamia się z właściwym endpointem i modelem. Jeśli zatwierdzasz plik do repozytorium, pomiń klucz i trzymaj go w zmiennej środowiskowej lub w pliku .env; wiersze z kluczem są przeznaczone do twojego katalogu domowego.

Dla modelu, którego Aider nie zna, dokumentacja opisuje model-settings-file (.aider.model.settings.yml), gdzie możesz określić jego ustawienia.

Ile kosztuje sesja#

Aider ponownie wysyła dodane pliki i historię czatu przy każdej wiadomości, więc tokeny wejściowe rosną szybciej niż wyjściowe. Załóżmy, że sesja robocza około 20 wiadomości wysyła 400 000 tokenów wejściowych i otrzymuje 40 000 tokenów wyjściowych (założenie dla przykładu; wstaw własne liczby). W MiniMax-M2.7 to $0.026, taniej niż w OpenRouter łącznie, licząc wejście i wyjście razem. Poniższa tabela przedstawia tę samą sesję dla naszych modeli:

Model Koszt OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

400 000 tokenów wejściowych i 40 000 tokenów wyjściowych łącznie. Ceny za 1 mln tokenów są aktualne i zmieniają się wraz z naszymi taryfami; kolumna OpenRouter pokazuje ceny referencyjne dla tego samego obciążenia.

Jak utrzymać małą stronę wejściową (pliki tylko do odczytu, /drop, rozmiar mapy repozytorium) opisano w Ile kosztuje Aider. Aktualne ceny są zawsze na stronie cennika.

Jeśli to nie działa#

  • Aider prosi o klucz API lub łączy się z niewłaściwą usługą. Zmienne nie są widoczne dla procesu. W Windows zrestartuj terminal po setx; na Macu i Linuksie uruchom echo $OPENAI_API_BASE w tej samej powłoce.
  • Twoja konfiguracja wydaje się ignorowana. Pamiętaj o kolejności: katalog domowy, katalog główny repozytorium, bieżący katalog. Plik bliżej ciebie nadpisuje globalny.
  • Nie znaleziono modelu, 404 lub błąd uwierzytelniania. Są one omówione w Jak podłączyć Aidera do CheapTokens.

Ten sam adres zgodny z OpenAI działa w innych narzędziach; jeśli używasz także agenta edytora, zobacz podłączanie OpenCode lub przegląd gdzie podłączyć własny klucz API.

Tagi: