Интеграция с Aider
Использование open-source AI-ассистента Aider с QCode.cc API
Интеграция с Aider¶
Aider — это популярный open-source AI-ассистент для программирования (39K+ звёзд на GitHub), работающий в терминале и поддерживающий более 100 языков программирования. Для подключения к QCode.cc API достаточно задать пару переменных окружения.
Почему Aider?¶
-
Полностью бесплатный и открытый: нужно платить только за API
-
Режим Architect: одна модель планирует, другая выполняет — повышается качество кода
-
Глубокая интеграция с Git: каждое AI-редактирование автоматически создаёт git commit
-
Repository Map: интеллектуальное индексирование всей кодовой базы на основе tree-sitter
-
Простейшая настройка: две строки переменных окружения — и вы подключены к QCode.cc
Установка¶
# Рекомендуется использовать pipx (изолированная установка)
pipx install aider-chat
# Или через pip
pip install aider-chat
Настройка QCode.cc¶
Способ 1: Переменные окружения (рекомендуется)¶
export OPENAI_API_BASE="https://asia.qcode.cc/claude/v1"
export OPENAI_API_KEY="cr_your_api_key"
Для постоянной настройки (добавьте в ~/.zshrc или ~/.bashrc):
echo 'export OPENAI_API_BASE="https://asia.qcode.cc/claude/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' >> ~/.zshrc
source ~/.zshrc
Способ 2: Параметры командной строки¶
aider --openai-api-base "https://asia.qcode.cc/claude/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
# Используйте Claude Opus (более мощный)
aider --model openai/claude-opus-4-6
Режим Architect (рекомендуется)¶
Режим Architect позволяет одной модели планировать, а другой — выполнять изменения кода:
# Opus планирует + Sonnet выполняет (рекомендуется)
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6
# Sonnet планирует + Haiku выполняет (экономичный вариант)
aider --architect --model openai/claude-sonnet-4-6 --editor-model openai/claude-haiku-4-5-20251001
Часто используемые команды¶
В сеансе Aider:
| Команда | Описание |
|---|---|
/add file.py |
Добавить файл в контекст чата |
/drop file.py |
Убрать файл из контекста |
/run pytest |
Выполнить команду и передать вывод AI |
/diff |
Показать все изменения |
/undo |
Отменить последнее AI-редактирование |
/commit |
Зафиксировать текущие изменения |
/help |
Показать справку |
Резервные узлы¶
# Гонконг
export OPENAI_API_BASE="http://103.218.243.5/claude/v1"
# Шэньчжэнь
export OPENAI_API_BASE="http://103.236.53.153/claude/v1"
Доступные модели¶
| Модель | Название в Aider | Описание |
|---|---|---|
| Claude Sonnet 4.6 | openai/claude-sonnet-4-6 |
Рекомендуется, оптимальное соотношение цена/качество |
| Claude Opus 4.6 | openai/claude-opus-4-6 |
Самая мощная модель |
| Claude Haiku 4.5 | openai/claude-haiku-4-5-20251001 |
Низкая стоимость, высокая скорость |
Примечание: перед названием модели необходимо указывать префикс
openai/, чтобы Aider использовал эндпоинт, совместимый с OpenAI.
Сравнение с Claude Code CLI¶
| Критерий | Aider | Claude Code CLI |
|---|---|---|
| Открытый код | Полностью открытый | Закрытый |
| Интеграция с Git | Автоматический commit при каждом редактировании | Ручной /commit |
| Режим Architect | Две модели: планирование + выполнение | Одна модель |
| Возможности инструментов | Редактирование файлов + Shell | Более богатый набор (LSP, поиск, браузер) |
| Управление контекстом | Repository Map с интеллектуальным индексированием | Окно от 200K до 1M токенов |
| Квота | Общая квота тарифа QCode.cc | Общая квота тарифа QCode.cc |
Рекомендуемая комбинация: Aider для быстрого редактирования кода и планирования в режиме Architect, Claude Code CLI для глубокого анализа проектов и автоматизации.
Часто задаваемые вопросы¶
Ошибка "Model not found"?¶
Убедитесь, что перед названием модели стоит префикс openai/:
# Правильно
aider --model openai/claude-sonnet-4-6
# Неправильно (нет префикса)
aider --model claude-sonnet-4-6
Таймаут API-вызова?¶
Попробуйте переключиться на резервный узел или увеличить таймаут:
aider --model openai/claude-sonnet-4-6 --timeout 120
Следующие шаги¶
-
Ознакомьтесь с интеграцией с Cline — графической альтернативой для VS Code
-
Изучите советы по CLI для продвинутого использования Claude Code
-
Посетите официальную документацию Aider для получения дополнительной информации