🚀 Подключение Aider к пользовательским моделям CodingPlanX

> Введение: В этом руководстве показано, как использовать Aider, популярного ИИ-напарника по программированию с открытым исходным кодом, с API CodingPlanX.ai для первоклассного опыта написания кода прямо в терминале.

Aider — это ведущий ИИ-ассистент для программирования в CLI (более 39 тыс. звезд на GitHub). Он работает в вашем терминале и поддерживает более 100 языков. Задав простые переменные окружения, вы можете подключить Aider к CodingPlanX.ai.

✨ Почему стоит выбрать Aider?

🆓 Полностью открытый исходный код: Платите только за использование API через CodingPlanX.ai.
🧠 Режим "Архитектор" (Architect Mode): Система из двух моделей, где одна модель планирует, а другая пишет код.
🌳 Карта репозитория: Использует tree-sitter для понимания структуры всей вашей кодовой базы.
🔗 Интеграция с Git: Автоматически создает описательные Git-коммиты для каждого изменения, сделанного ИИ.
⚡ Минимальная настройка: Подключение за секунды с помощью всего двух переменных окружения.

🛠️ Установка

1. Предварительные требования

Установлен Python 3.8+.
API-ключ CodingPlanX.ai (начинается с cr_).

2. Установка Aider

# Рекомендуется: Установка через pipx
pipx install aider-chat

# Альтернатива: Стандартный pip
pip install aider-chat

⚙️ Настройка

Способ 1: Переменные окружения (🌟 Рекомендуется)

Временно (для текущего сеанса терминала):

export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_your_api_key"

Постоянно (добавление в файл конфигурации): Добавьте их в ваш ~/.zshrc или ~/.bashrc:

echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' &gt;&gt; ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' &gt;&gt; ~/.zshrc
source ~/.zshrc

Способ 2: Аргументы командной строки

aider --openai-api-base "https://api.codingplanx.ai/v1" \
      --openai-api-key "cr_your_api_key" \
      --model openai/claude-sonnet-4-6

💻 Начало работы

Базовое использование

cd /path/to/your/project

# Запуск Aider с Claude Sonnet
aider --model openai/claude-sonnet-4-6

Режим "Архитектор" (🌟 Настоятельно рекомендуется)

В режиме "Архитектор" используется модель "планировщик" (например, Opus) и модель "редактор" (например, Sonnet) для повышения качества при сохранении контроля над расходами.

# Фокус на качестве: Opus планирует + Sonnet редактирует
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6

⌨️ Основные Slash-команды

Команда	Описание
`/add file.py`	Добавить файл в контекст ИИ
`/drop file.py`	Удалить файл из контекста для экономии токенов
`/run pytest`	Запустить тесты и передать ошибки обратно ИИ для исправления
`/undo`	Отменить последнее изменение кода, сделанное ИИ

⚖️ Aider против Claude Code CLI

Функция	🤖 Aider	💻 Claude Code CLI
Открытый исходный код	Да	Нет (Проприетарный)
Интеграция с Git	Авто-коммит	Ручной коммит
Рабочий процесс	Многомодельный (Архитектор)	Одномодельный
Контекст	Карта репозитория (AST)	Огромное окно токенов

❓ Устранение неполадок (FAQ)

В: Ошибка "Model not found" (Модель не найдена)? О: Убедитесь, что вы включили префикс openai/.

✅ Правильно: openai/claude-sonnet-4-6

В: Тайм-аут API? О: Увеличьте лимит времени ожидания:

aider --model openai/claude-sonnet-4-6 --timeout 120