CLI-агентGitPython

Aider + TokenTool

Настройте Aider — терминальный ассистент, который редактирует файлы и коммитит в git — через TokenTool API.

Параметры подключения

Base URL

https://api.tokentool.ru/api/v1

API Key

не хранить в коде— env или хранилище credential приложения

Проверить Python 3.8–3.13

Aider написан на Python — нужна версия 3.8 или выше:

bash

python --version

Если Python не установлен — скачай с python.org → Downloads → выбери последнюю стабильную версию.

Также убедись что pip работает: python -m pip --version

Установить Aider

Официальный установщик создаст Aider отдельное Python-окружение и не перемешает его зависимости с проектом:

bash

python -m pip install aider-install
aider-install

Проверь установку:

bash

aider --version

Если aider не найден — убедись что папка с pip-пакетами есть в PATH, или перезапусти терминал.

Передать ключ без строки в истории команд

Не вставляй ключ прямо во флаг запуска: терминал может сохранить его в истории. Введи ключ отдельно, затем запусти Aider.

Windows PowerShell

powershell

$env:OPENAI_API_KEY = Read-Host "TokenTool API key"
$env:OPENAI_API_BASE = "https://api.tokentool.ru/api/v1"
aider --model openai/<MODEL_ID_ИЗ_КАТАЛОГА> файл.py

macOS / Linux

bash

read -rsp "TokenTool API key: " OPENAI_API_KEY; export OPENAI_API_KEY; echo
export OPENAI_API_BASE="https://api.tokentool.ru/api/v1"
aider --model openai/<MODEL_ID_ИЗ_КАТАЛОГА> файл.py

Префикс openai/ обязателен: так Aider понимает, что модель находится за OpenAI-совместимым endpoint.

💡 Выпусти для Aider отдельный ключ TokenTool и поставь ему лимит. После закрытия терминала переменная текущей сессии исчезнет.

Способ B: сохранить настройки через конфиг (рекомендуется)

Создай файл ~/.aider.conf.yml в домашней директории:

bash

nano ~/.aider.conf.yml

В конфиг запиши адрес и модель. Сам ключ оставь в переменной окружения:

yaml

openai-api-base: https://api.tokentool.ru/api/v1
model: openai/<MODEL_ID_ИЗ_КАТАЛОГА>

Сохрани: Ctrl+O → Enter → Ctrl+X.

Скопируй доступный ID из актуального каталога моделей.

Теперь запускай просто:

bash

aider файл.py

Aider сам подхватит настройки из конфига.

Использование с git и проверка

Запусти Aider в папке с git-репозиторием:

bash

cd ~/my-project
aider src/app.py

Aider откроется в интерактивном режиме и покажет загруженные файлы. Описывай задачи на русском или английском:

text

> Добавь обработку ошибок в функцию fetch_data
> Напиши тесты для класса UserManager
> Отрефактори этот код, убери дублирование

После каждого изменения Aider спросит подтверждение git-коммита. Флаг --no-auto-commits отключает авто-коммиты.

Проверочный тест:

Запусти Aider и напиши: Привет, ты работаешь? — если ответил, всё настроено ✓

Частые ошибки:

✗«invalid_api_key» — проверь ключ, он должен начинаться с sk-tt-.
✗«Model not available» — проверь идентификатор модели в конфиге.
✗«Not a git repo» — запусти git init в папке проекта.

Готово к работе?

Зарегистрируйтесь на TokenTool, получите API-ключ и подключите Aider + TokenTool за пару минут.

Получить API-ключ TokenTool →← Все инструкции