Aider — AI-напарник для программирования в терминале
Aider — open-source AI-напарник в терминале, который правит код и сам делает git-коммиты
Aider — open-source AI-напарник для программирования, который работает в терминале рядом с вашим репозиторием. Вы описываете задачу словами, а Aider сам находит нужные файлы, вносит правки и оформляет каждое изменение отдельным git-коммитом с понятным сообщением. Он строит карту репозитория, поэтому ориентируется даже в больших проектах, и работает с любым языком — от Python и TypeScript до Go и Rust.
Aider подключается к любому OpenAI-совместимому API, в том числе к AITUNNEL. Ниже — установка, конфиги для постоянной работы, настройки моделей и разбор типичных ошибок.
API-ключ для Aider
Aider обращается к моделям через API-ключ. Ключ AITUNNEL вида sk-aitunnel-... один для всех моделей из каталога: чтобы перейти с Claude на GPT или DeepSeek, достаточно сменить id модели.
- Зарегистрируйтесь на aitunnel.83.141.93.205.nip.io и пополните баланс (от 500₽).
- Откройте Ключи, нажмите «Новый», задайте имя и нажмите «Создать ключ».
- Скопируйте ключ. Его можно показать повторно в любой момент.
Aider ищет ключ в трёх местах. Если он задан в нескольких, приоритет такой: флаг --openai-api-key, затем переменная OPENAI_API_KEY (в том числе из файла .env в корне репозитория), затем параметр openai-api-key в .aider.conf.yml. Если ключ «не тот», почти всегда виноват забытый .env или старый export в профиле оболочки.
Aider работает с тремя моделями сразу: основной, слабой (коммиты и сжатие истории) и editor-моделью в режиме architect. Удобно разрешить ключу только эти модели в настройках ключа: тогда случайный /model на дорогую модель вернёт ошибку, а не спишет баланс.
Бюджет, ограничения по моделям и IP, сброс ключа — в документации по ключам.
Что понадобится
- Python 3.8–3.13 (установщик Aider при необходимости поставит отдельный Python 3.12 сам)
- git — Aider коммитит каждое изменение
- Ключ AITUNNEL
sk-aitunnel-...и положительный баланс
Установка
Рекомендуемый способ — установщик, который ставит Aider в изолированное окружение:
python -m pip install aider-install
aider-installИли одной командой:
# macOS / Linux
curl -LsSf https://aider.chat/install.sh | sh# Windows
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"Если пользуетесь uv:
uv tool install --force --python python3.12 --with pip aider-chat@latestПроверьте установку: aider --version.
Быстрый старт
Задайте адрес API и ключ, перейдите в папку проекта и запустите Aider:
export OPENAI_API_BASE="https://aitunnel.83.141.93.205.nip.io/__api/v1"
export OPENAI_API_KEY="sk-aitunnel-xxx"
cd ~/projects/my-app
aider --model openai/claude-sonnet-5.5На Windows вместо export используйте setx OPENAI_API_BASE ... и setx OPENAI_API_KEY ..., затем откройте новое окно терминала.
Префикс openai/ обязателен. Он говорит Aider, что модель нужно вызывать через OpenAI-совместимый API по адресу из OPENAI_API_BASE. Дальше идёт id модели из каталога AITUNNEL: openai/gpt-6.1-sol, openai/deepseek-v4.1-flash, openai/kimi-k2.7-code и так далее.
При первом запуске Aider предупредит, что не знает размер контекста и цену модели. Это нормально: ниже показано, как задать эти данные или отключить предупреждение.
Постоянная настройка: .aider.conf.yml
Чтобы не вводить параметры каждый раз, создайте ~/.aider.conf.yml (действует для всех проектов) или .aider.conf.yml в корне репозитория:
openai-api-base: https://aitunnel.83.141.93.205.nip.io/__api/v1
openai-api-key: sk-aitunnel-xxx
model: openai/claude-sonnet-5.5
weak-model: openai/gpt-6-luna
editor-model: openai/claude-sonnet-5.5
show-model-warnings: false
auto-commits: truemodel— основная модель, которая пишет кодweak-model— дешёвая модель для сообщений коммитов и сжатия истории чата. Без неё Aider использует для этих задач основную модель, и каждый коммит стоит как полноценный запрос к флагмануeditor-model— модель-исполнитель для режима architect (см. ниже)show-model-warnings: false— убирает предупреждения о незнакомых моделях
Если не хотите хранить ключ в YAML, положите его в .env в корне проекта — Aider читает этот файл автоматически:
OPENAI_API_BASE=https://aitunnel.83.141.93.205.nip.io/__api/v1
OPENAI_API_KEY=sk-aitunnel-xxx
AIDER_MODEL=openai/claude-sonnet-5.5
AIDER_WEAK_MODEL=openai/gpt-6-lunaДобавьте .env в .gitignore, чтобы ключ не попал в репозиторий.
Формат правок: самая важная настройка
Aider умеет вносить изменения в разных форматах:
| Формат | Как работает | Когда использовать |
|---|---|---|
whole | Модель присылает файл целиком | Маленькие файлы, слабые модели. Дорого на больших файлах |
diff | Блоки «найти → заменить» | Сильные модели — основной вариант |
diff-fenced | То же, но в другой разметке | Модели Gemini |
udiff | Унифицированный diff | Если модель путается в diff |
Для моделей, которые Aider знает по имени, формат выбирается автоматически. Модели с префиксом openai/ для него незнакомы, и по умолчанию он использует whole — модель переписывает каждый файл целиком, это медленно и в разы дороже. Поэтому задайте настройки моделей явно в ~/.aider.model.settings.yml:
- name: openai/claude-sonnet-5.5
edit_format: diff
use_repo_map: true
weak_model_name: openai/gpt-6-luna
editor_model_name: openai/claude-sonnet-5.5
editor_edit_format: editor-diff
- name: openai/claude-opus-5.5
edit_format: diff
use_repo_map: true
weak_model_name: openai/gpt-6-luna
editor_model_name: openai/claude-sonnet-5.5
editor_edit_format: editor-diff
- name: openai/gpt-6.1-sol
edit_format: diff
use_repo_map: true
weak_model_name: openai/gpt-6-luna
accepts_settings: ["reasoning_effort"]
- name: openai/gemini-3.8-flash
edit_format: diff-fenced
use_repo_map: true
weak_model_name: openai/gemini-3.8-flash
- name: openai/kimi-k2.7-code
edit_format: diff
use_repo_map: true
weak_model_name: openai/gpt-6-luna
- name: openai/deepseek-v4.1-flash
edit_format: diff
use_repo_map: true
weak_model_name: openai/deepseek-v4.1-flashuse_repo_map: true включает карту репозитория: Aider отправляет модели сжатое описание структуры проекта (классы, функции, сигнатуры), и она сама понимает, какие файлы нужно открыть.
Текущий формат виден в строке приветствия при запуске: Model: openai/claude-sonnet-5.5 with diff edit format.
Размер контекста: .aider.model.metadata.json
Чтобы Aider правильно показывал заполненность контекста и не ругался на неизвестную модель, опишите лимиты в ~/.aider.model.metadata.json:
{
"openai/claude-sonnet-5.5": {
"max_input_tokens": 1000000,
"max_output_tokens": 128000,
"input_cost_per_token": 0,
"output_cost_per_token": 0,
"litellm_provider": "openai",
"mode": "chat"
},
"openai/deepseek-v4.1-flash": {
"max_input_tokens": 1048576,
"max_output_tokens": 384000,
"input_cost_per_token": 0,
"output_cost_per_token": 0,
"litellm_provider": "openai",
"mode": "chat"
}
}Цены здесь можно оставить нулевыми: Aider считает стоимость в долларах, а реальный расход в рублях по каждому запросу виден в личном кабинете AITUNNEL.
Работа в Aider
Добавьте в чат файлы, с которыми нужно работать, и опишите задачу:
aider src/api/payments.py tests/test_payments.py> Добавь повторную попытку при таймауте платёжного шлюза, максимум три раза, и тест на этоAider покажет изменения, применит их и сделает коммит. Основные команды:
| Команда | Что делает |
|---|---|
/add файл | Добавить файл в чат — Aider сможет его менять |
/read-only файл | Добавить файл только для чтения, как справку |
/drop файл | Убрать файл из чата, чтобы не тратить контекст |
/ask вопрос | Обсудить код без изменений |
/code | Вернуться в режим правок |
/architect | Режим «архитектор + исполнитель» |
/run команда | Выполнить команду и при желании отправить вывод в чат |
/test | Запустить тесты и попросить исправить упавшие |
/undo | Откатить последний коммит Aider |
/diff | Показать изменения с прошлого сообщения |
/model openai/... | Сменить модель прямо в сессии |
/tokens | Сколько токенов занимает текущий контекст |
/clear | Очистить историю чата |
Хороший рабочий цикл — чередовать /ask и /code: сначала обсудить подход в режиме вопросов, затем коротко написать «делай» в режиме правок.
Режим architect: две модели вместо одной
В режиме architect задачу решают две модели: сильная продумывает решение, а более дешёвая и аккуратная превращает его в правки файлов. Это даёт качество флагмана за меньшие деньги:
aider --architect \
--model openai/claude-opus-5.5 \
--editor-model openai/claude-sonnet-5.5Другие удачные пары:
openai/gpt-6.1-sol+openai/kimi-k2.7-codeopenai/deepseek-v4-pro+openai/deepseek-v4.1-flash— самый бюджетный вариант
Рассуждения
Для моделей с настраиваемой глубиной рассуждений используйте --reasoning-effort:
aider --model openai/gpt-6.1-sol --reasoning-effort highВнутри сессии — команда /reasoning-effort low. Aider передаёт этот параметр только моделям, у которых в .aider.model.settings.yml указано accepts_settings: ["reasoning_effort"], — для остальных он предупредит и пропустит настройку.
Aider из любой IDE
Запустите Aider с флагом --watch-files в отдельном терминале и продолжайте работать в привычном редакторе — VS Code, JetBrains, Vim:
aider --watch-filesОставьте в коде комментарий, который заканчивается на AI!, и сохраните файл — Aider выполнит задачу:
# Добавь валидацию email и понятное сообщение об ошибке AI!
def register_user(email: str, password: str):
...Комментарий с AI? на конце — вопрос: Aider ответит в терминале, не меняя код.
Какую модель выбрать
| Задача | Модель | Почему |
|---|---|---|
| Основная работа | claude-sonnet-5.5 | Точные правки в формате diff, контекст 1M |
| Сложный рефакторинг, архитектура | claude-opus-5.5, gpt-6.1-sol | Лучшие рассуждения |
| Специализированная для кода | kimi-k2.7-code | Дешевле флагманов, хорошо держит формат правок |
| Длинный контекст, скорость | gemini-3.8-flash | Быстрая, с форматом diff-fenced |
| Максимальная экономия | deepseek-v4.1-flash | В десятки раз дешевле флагманов |
| Слабая модель для коммитов | gpt-6-luna | Копейки за сообщение коммита |
Цены в рублях — на странице моделей.
Устранение неполадок
Ошибка 404 или «model not found»
OPENAI_API_BASEдолжен бытьhttps://aitunnel.83.141.93.205.nip.io/__api/v1— с/v1- Перед id модели нужен префикс
openai/, а сам id должен совпадать с каталогом посимвольно:openai/claude-sonnet-5.5, а неopenai/claude-sonnet-5-5
Ошибка 401
Проверьте ключ: echo $OPENAI_API_KEY. Если ключ задан и в переменной, и в .aider.conf.yml, убедитесь, что оба одинаковые. Ключ должен быть активен в личном кабинете, баланс — положительным.
Aider переписывает файлы целиком и тратит много токенов
Модель работает в формате whole. Добавьте её в .aider.model.settings.yml с edit_format: diff — проверить можно по строке приветствия.
«The LLM did not conform to the edit format»
Модель не справилась с форматом правок. Попробуйте diff-fenced или udiff вместо diff, либо более сильную модель. Для Gemini используйте diff-fenced.
Команда aider не найдена
Перезапустите терминал после установки или запустите через python -m aider.
Частые вопросы
Чем Aider отличается от Claude Code и Cursor?
Aider — консольный инструмент без собственного редактора: он работает с вашим git-репозиторием и делает аккуратные коммиты, которые легко отменить через /undo или git revert. Он полностью open-source и не привязан к конкретной модели — через AITUNNEL можно переключаться между Claude, GPT, DeepSeek и другими одной командой /model.
Сколько стоит работа в Aider?
Вы платите только за токены. Основная статья расходов — контекст: файлы в чате и карта репозитория отправляются с каждым запросом. Держите в чате только нужные файлы (/drop для лишних) и вынесите коммиты на слабую модель — это снижает расходы в разы.
Можно ли использовать Aider без git?
Можно, но не стоит. Если в папке нет репозитория, Aider предложит его создать. Без git теряется главная страховка — возможность откатить любое изменение.
Почему это выгодно
- Без VPN — российский endpoint
api.aitunnel.83.141.93.205.nip.io - Один API-ключ на все модели — архитектор, исполнитель и слабая модель работают по одному ключу
- Оплата в рублях — карты МИР, СБП, от 500₽
- Расходы по каждому запросу — в личном кабинете, с разбивкой по моделям
- Для бизнеса — счёт в кабинете, закрывающие документы через ЭДО
Ключевые возможности
- Один API-ключ AITUNNEL на все модели
- Правки в формате diff и автоматические git-коммиты
- Карта репозитория для больших проектов
- Режим architect: сильная модель планирует, дешёвая пишет
- Работа из любой IDE через --watch-files
- Без VPN, оплата в рублях
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.