Содержание
Как подключить DeepSeek к Aider
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 12 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Подключить DeepSeek к Aider можно за три шага: установить Aider, задать переменную окружения DEEPSEEK_API_KEY со своим ключом DeepSeek и запустить команду aider —model deepseek/deepseek-chat в каталоге проекта. Официальная документация aider.chat описывает именно этот порядок. Ключ берётся в личном кабинете DeepSeek. Мы скачали подборку результатов веб-поиска по запросу «Как подключить DeepSeek к Aider»: текст отдали 9 из 10.
Что понадобится для подключения
Документация проекта на aider.chat сообщает, что Aider умеет подключаться к API DeepSeek.com. Для работы с моделями DeepSeek нужно задать переменную окружения DEEPSEEK_API_KEY со своим ключом DeepSeek API. Там же указано, что модель DeepSeek Chat V3 имеет высший балл в бенчмарке Aider по редактированию кода.
Установка описана на отдельной странице aider.chat: если у вас уже стоит Python версий с 3.8 по 3.13, быстрый старт выполняется командой установщика. Установщик aider-install создаёт отдельное окружение Python и при необходимости сам ставит отдельную версию Python 3.12 для Aider. Это снимает конфликт с системными пакетами.
Свои реквизиты читатель получает у DeepSeek: ключ API выпускается в аккаунте на DeepSeek.com и вставляется в переменную окружения. При запуске Aider получает свой ключ DeepSeek из переменной окружения DEEPSEEK_API_KEY. Сравнение подходов к подключению моделей в редакторе описано в материале Как подключить DeepSeek к VSCode: три пути.
| Что нужно | Где взять | Куда попадает |
|---|---|---|
| Python 3.8–3.13 | Система или установщик Aider | Основа для запуска |
| Aider | Команда aider-install | Отдельное окружение Python |
| Ключ DeepSeek | Аккаунт на DeepSeek.com | Переменная DEEPSEEK_API_KEY |
| Каталог проекта | Ваш репозиторий | Аргумент cd перед запуском |
Установка Aider по первичной документации
Первичный документ на aider.chat даёт установку двумя строками. Сначала ставится установщик, затем он запускается:
python -m pip install aider-install
aider-install
Страница установки поясняет, что этот способ разворачивает Aider в отдельном окружении Python, а при необходимости aider-install дополнительно поставит отдельную версию Python 3.12. После установки документация упоминает необязательные шаги установки, которые можно пропустить на первом запуске.
Для тех, кто предпочитает однострочники, страница установки приводит команды на базе установщиков uv. В Mac и Linux это curl -LsSf https://aider.chat/install.sh | sh либо wget -qO- https://aider.chat/install.sh | sh. В Windows используется PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex". Однострочники ставят Aider вместе с Python 3.12, если он нужен.
Отдельные разделы документации описывают установку через uv, pipx и pip. uv ставится вашей текущей версией Python 3.8–3.13 и затем используется для установки Aider, автоматически подтягивая отдельный Python 3.12. pipx и pip работают с Python версий 3.9–3.12. Выбор способа влияет на изоляцию окружения.
Настройка ключа и запуск с моделью
Документация Aider по DeepSeek даёт настройку ключа двумя строками для разных систем. В Mac и Linux выполняется export DEEPSEEK_API_KEY=<key>. В Windows — setx DEEPSEEK_API_KEY <key>, причём документация просит перезапустить оболочку после setx, чтобы переменная стала видна.
Запуск описан так: нужно перейти в каталог проекта командой cd /to/your/project, затем запустить Aider с моделью DeepSeek Chat v3 командой aider --model deepseek/deepseek-chat. Страница установки Aider показывает вариант с ключом прямо в аргументах: aider --model deepseek --api-key deepseek=<key>.
Страница по моделям и ключам на aider.chat добавляет, что проще всего указать модель и ключ аргументами командной строки —model и —api-key. Там же приведён пример работы с DeepSeek Chat V3 через OpenRouter: aider --model openrouter/deepseek/deepseek-chat --api-key openrouter=your-key-goes-here. Этот путь использует ключ OpenRouter и другого провайдера.
| Способ запуска | Команда | Чей ключ |
|---|---|---|
| Прямо через DeepSeek | aider —model deepseek/deepseek-chat | DEEPSEEK_API_KEY |
| Ключ в аргументе | aider —model deepseek —api-key deepseek= |
DeepSeek |
| Через OpenRouter | aider —model openrouter/deepseek/deepseek-chat —api-key openrouter= |
OpenRouter |
Учебная проверка: правим файл в копии проекта
Проверку стоит делать на локальной учебной копии репозитория, чтобы не задеть рабочую ветку. В учебном каталоге сохраните исходную версию небольшого файла отдельно, чтобы после запроса сравнить её с изменённым файлом. При проверке через git создайте исходный коммит до запуска Aider. Затем перейдите в этот каталог и запустите Aider с моделью DeepSeek.
Внутри сессии попросите внести маленькую правку: переименовать функцию, добавить проверку аргумента, дописать строку документации. Aider предложит изменение и покажет diff. Критерий результата: в diff видно ровно ту правку, которую вы просили, файл сохранён, а git показывает изменение относительно исходного коммита. Если правка не применилась, diff пуст или затронуты лишние строки — это сигнал разбираться с моделью и ключом.
Второй критерий — повторный запуск. Закройте сессию, откройте заново и попросите ещё одну мелкую правку в том же файле. Стабильный результат на двух запусках подряд означает, что ключ и модель подхватываются корректно. Такой сценарий проверяет всю цепочку: установку, переменную окружения, выбор модели и запись файла.
Границы функций и отличие от веб-чата
Aider — это парный программист в терминале, как его описывает главная страница проекта. Документация перечисляет возможности: работа с облачными и локальными моделями, карта кодовой базы, поддержка более 100 языков программирования, интеграция с git, работа в IDE, изображения и веб-страницы, голосовой ввод, линтинг и тесты, копирование в веб-чат. README проекта на GitHub добавляет, что Aider лучше всего работает с Claude 3.7 Sonnet, DeepSeek R1 и Chat V3, OpenAI o1, o3-mini и GPT-4o, но подключается почти к любой LLM, включая локальные модели.
Веб-чат DeepSeek даёт переписку в браузере без доступа к вашему репозиторию. Aider читает файлы проекта, предлагает правки и фиксирует их через git. Разница проявляется в задачах: чат удобен для вопросов и черновиков, Aider — для изменений в коде с историей. Подключение через API оплачивается по условиям провайдера, и это отдельные условия по сравнению с бесплатным веб-чатом.
Отдельная граница — поддержка новых моделей. В issue №5255 на GitHub описана ситуация: Aider версии v0.86.2 не распознаёт новые модели DeepSeek V4 (deepseek-v4-flash, deepseek-v4-pro), и они не появляются в aider --list-models deepseek-v4, поскольку litellm их ещё не добавил. Автор issue просит добавить модели DeepSeek V4 во встроенный список litellm. Если вам нужен другой идентификатор модели, сверяйте доступные модели и совместимость, а конкретное имя подставляйте из проверенного источника.
Типичные сбои: ключ, провайдер, модель, сохранение
Первый сбой — ключ. Если Aider не видит DEEPSEEK_API_KEY, проверьте, что переменная задана в той же оболочке, из которой запускается Aider. В Windows после setx документация требует перезапуска оболочки. Быстрая проверка — запустить Aider с ключом в аргументе --api-key deepseek=<key> и сравнить поведение.
Второй сбой — провайдер. Команда aider --model deepseek/deepseek-chat идёт напрямую в DeepSeek, а aider --model openrouter/deepseek/deepseek-chat — через OpenRouter с ключом OpenRouter. Смешивание провайдера и ключа даёт ошибку авторизации. Сверьте префикс модели и имя переменной ключа.
Третий сбой — модель. Если имя модели не распознано, проверьте идентификатор и поддержку модели выбранным провайдером. Документация по моделям и ключам показывает формат аргумента —model, а issue №5255 описывает случай с моделями DeepSeek V4, которых нет в списке litellm. Проверьте доступные модели и совместимость перед запуском.
Четвёртый сбой — сохранение изменений. Правка может не примениться, если файл вне зоны отслеживания git или каталог не тот. Убедитесь, что вы в корне проекта и что файл добавлен в репозиторий. Diff в сессии и запись на диск — два разных шага, проверяйте оба. Диагностика похожих отказов разобрана в статье Алиса AI не работает: диагностика и решения.
Частые вопросы
Как подключить DeepSeek к Aider без ключа в командной строке?
Задайте переменную окружения DEEPSEEK_API_KEY и запустите Aider с моделью DeepSeek. В Mac и Linux это export, в Windows — setx с последующим перезапуском оболочки. Ключ хранится в окружении, а в команде остаётся только имя модели. Такой способ описан в документации Aider по DeepSeek.
Какая модель DeepSeek указана в документации Aider?
В разделе про DeepSeek на aider.chat приведена команда aider --model deepseek/deepseek-chat с пометкой DeepSeek Chat v3. Там же сказано, что эта модель имеет высший балл в бенчмарке Aider по редактированию кода. Другие идентификаторы моделей сверяйте с доступным списком и совместимостью.
Чем подключение через OpenRouter отличается от прямого?
Прямой запуск использует ключ DeepSeek и префикс deepseek/, а OpenRouter — ключ OpenRouter и префикс openrouter/. Документация по моделям и ключам приводит оба примера рядом. Условия оплаты и доступность моделей зависят от выбранного провайдера.
Почему Aider не видит новые модели DeepSeek?
В issue №5255 на GitHub описано, что Aider версии v0.86.2 не распознаёт модели DeepSeek V4, и они не появляются в списке моделей, поскольку litellm их ещё не добавил. Автор issue просит добавить их во встроенный список. До этого используйте идентификаторы, которые Aider уже знает.
Как проверить, что правка файла действительно применилась?
Запустите Aider в учебной копии проекта, попросите мелкую правку и посмотрите diff в сессии. Затем проверьте файл на диске и статус git. Критерий — в diff ровно запрошенное изменение, файл сохранён, git показывает разницу с исходным коммитом. Повторите на втором запуске для устойчивости.