aid
CLI-агентGitPython

Aider + TokenTool

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

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

Base URL

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

API Key

sk-tt-xxxxxxx— в личном кабинете
1

Проверить Python 3.8+

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

bash
python3 --version

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

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

2

Установить Aider

Установи через pip:

bash
pip install aider-chat

Или через pipx (для изоляции зависимостей — рекомендуется если используешь несколько Python-инструментов):

bash
pipx install aider-chat

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

bash
aider --version

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

3

Способ A: запустить с флагами (быстрый старт)

Самый простой способ — передать параметры напрямую при запуске:

bash
aider \
  --openai-api-key sk-tt-ваш-ключ \
  --openai-api-base https://api.tokentool.ru/api/v1 \
  --model anthropic/claude-3-5-sonnet \
  файл.py

Замени файл.py на нужный файл, или не указывай — Aider предложит добавить файлы сам.

Можно передать несколько файлов: aider src/app.py src/utils.py --openai-api-key ...

💡 Этот способ удобен для одноразового запуска. Если используешь Aider регулярно — смотри Способ B.
4

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

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

bash
nano ~/.aider.conf.yml

Вставь содержимое (замени ключ на свой):

yaml
openai-api-key: sk-tt-ваш-ключ
openai-api-base: https://api.tokentool.ru/api/v1
model: anthropic/claude-3-5-sonnet

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

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

bash
aider файл.py

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

5

Использование с 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 за пару минут.