tariel.ge › Полезное: бесплатные книги › Агент ИИ на своём компьютереБесплатно · автор Тариел Бежанидзе
← Агент ИИ ЛИСТ 13АгентыРЕВ. 1
Глава 13 · Агенты

Aider: правит ваши файлы и делает коммиты

Агент, который редактирует файлы вашего проекта и сам делает коммиты. Главное его свойство — любое изменение отменяется одной командой.

Чем отличается от предыдущего

Open InterpreterAider
Что делаетПишет и выполняет кодРедактирует файлы в вашем проекте
Работает сЧем угодно на компьютереТолько папкой проекта
История измененийНетКаждая правка — отдельный коммит git
Как откатитьНикак/undo, одна команда
РискВысокийНизкий — всё под контролем версий
Почему это безопаснее

Aider требует, чтобы проект был под git, и делает коммит после каждой своей правки. Испортил файл — вы возвращаетесь на шаг назад и ничего не потеряли. Это единственный агент в книге со встроенной кнопкой «отменить», и для начала работы он подходит лучше всех.

Требование: git

проверить
git --version
если не установлен
# macOS — предложит установить инструменты разработчика
xcode-select --install

# Windows
winget install Git.Git
первичная настройка, если git ещё не настроен
git config --global user.name "Ваше Имя"
git config --global user.email "you@example.com"

Установка

Ставьте в отдельное окружение, как в главе 12. Актуальная команда установки — на aider.chat; проект менял способ установки, поэтому сверьтесь с сайтом.

в активированном окружении
pip install aider-install
aider-install
проверить
aider --version

Подключение к локальной модели

Aider узнаёт адрес Ollama из переменной окружения, а модель — из ключа запуска.

Терминал
export OLLAMA_API_BASE=http://127.0.0.1:11434
aider --model ollama_chat/qwen2.5-coder:14b
PowerShell
$env:OLLAMA_API_BASE = "http://127.0.0.1:11434"
aider --model ollama_chat/qwen2.5-coder:14b
Префикс именно ollama_chat/

Не ollama/. Это разные режимы обращения, и с неправильным Aider работает заметно хуже — путается в формате правок. Мелочь, которая стоит людям часов.

Чтобы не набирать каждый раз

Создайте в папке проекта файл .aider.conf.yml:

.aider.conf.yml
model: ollama_chat/qwen2.5-coder:14b
auto-commits: true
gitignore: true

После этого достаточно набрать aider в папке проекта.

Первый запуск

в папке проекта
# Если проект ещё не под git
git init
git add .
git commit -m "before aider"

# Запуск
aider
Обязательный коммит до старта

Сделайте коммит до первого запуска, даже если проект уже под git. Так у вас будет гарантированная точка возврата к состоянию «до того, как я пустил сюда агента». Это тридцать секунд, которые однажды спасут вечер.

Как с ним работать

Ключевая идея: Aider видит только те файлы, которые вы ему дали. Это и защита, и необходимость — чем меньше файлов в работе, тем лучше результат на локальной модели.

типичная сессия
# Добавить файлы в работу
/add main.py utils.py

# Посмотреть, что сейчас в работе
/ls

# Дальше — просто пишите задачу словами:
Добавь в main.py обработку ошибки, если файл не найден — выведи понятное сообщение и заверши работу с кодом 1

# Aider покажет правку, применит и сделает коммит

# Посмотреть, что именно изменилось
/diff

# Не понравилось — отменить последнее
/undo

# Убрать файл из работы, чтобы не занимал контекст
/drop utils.py

Команды, которые стоит знать

КомандаЧто делает
/add файлДобавить файл в работу
/drop файлУбрать из работы
/lsПоказать файлы в работе
/diffЧто изменилось после последней правки
/undoОтменить последний коммит агента
/ask вопросСпросить, ничего не меняя
/code задачаЯвно попросить изменить код
/run командаВыполнить команду и показать вывод агенту
/test командаПрогнать тесты; при ошибке агент попробует починить
/commitЗакоммитить изменения, сделанные вами вручную
/tokensСколько контекста занято
/clearОчистить историю разговора, файлы оставить
/helpПолный список
Самая недооценённая команда

/ask. Спросить «что делает эта функция» или «почему здесь может упасть» без единого изменения файлов. Безопасный способ познакомиться с агентом и с чужим кодом одновременно.

Как формулировать задачи

ПлохоХорошоПочему
Исправь всёВ функции load_config добавь проверку, что файл существуетКонкретный файл и конкретное действие
Сделай красивоРазбей функцию main на три: чтение, обработка, выводПонятно, что считать результатом
ОптимизируйЗамени цикл в строках 40–55 на списковое включениеТочное место
Добавь тестыНапиши тесты pytest для parse_date: обычная дата, пустая строка, неверный форматНазваны случаи
Почини багПри пустом файле падает с IndexError. Вот вывод: [...]. Добавь обработкуДана ошибка целиком
Одна задача за раз

На локальной модели просьба «сделай A, потом B, потом C» почти наверняка закончится тем, что сделано A, наполовину B и сломано C. Давайте по одной задаче, проверяйте /diff, потом следующую. Это медленнее в моменте и быстрее в целом.

Реалистичные ожидания на локальной модели

МодельЧего ждать
7BМелкие правки в одном файле. Формат правок часто ломается
14B coderРабочий минимум: правки в одном-двух файлах, простые функции, тесты
32B coderПохоже на настоящего помощника. Рефакторинг, несколько файлов
Облако из главы 23Заметно лучше во всём, но это уже не локально

Если не работает

СимптомРешение
Not a git repositorygit init в папке проекта
Правки не применяются, «malformed response»Проверьте префикс ollama_chat/. Если верен — модель слабовата
Connection refusedOllama не запущен или переменная OLLAMA_API_BASE не задана в этом окне
Переписывает лишнееСлишком много файлов в работе. /drop ненужные
Забывает, о чём говорилиЗакончился контекст. /clear, затем увеличьте контекст (глава 08)
Всё сломал/undo. Если не помогло — git reset --hard к коммиту «before aider»

Чек-лист главы

Что дальше

То же самое, но внутри редактора кода, где каждое действие агента видно и подтверждается кнопкой.

Глава13 — Aider: правит ваши файлы и делает коммиты
БлокАгенты
Далее14 — Cline в VS Code: агент с терминалом и файлами
Ревизия1
↑ Оглавление Предыдущая глава← 12 · Open Interpreter: пишет и запускает код Следующая глава14 · Cline в VS Code: агент с терминалом и файлами →

Бесплатная книга · tariel.ge · команды и версии проверяйте в официальной документации проектов

Книга бесплатна для чтения. Автор — Тариел Бежанидзе, компьютерный мастер в Батуми · tariel.ge · все бесплатные книги. Копировать текст целиком на другие сайты — только со ссылкой на источник.