Интеграция с Aider
Настройка Aider с QCode.cc: Claude через точку Anthropic (префикс anthropic/), GPT и китайские модели через OpenAI-совместимую точку
Содержание
Последняя проверка: 2026-09-18 · 📄 По официальной документации (репозиторий апстрима; см. пометку о статусе ниже)
Активность апстрима: последний коммит в Aider-AI/aider датирован 2026-05-22, релизов после него не было (проверено через GitHub API 2026-09-18). Способы подключения на этой странице работают; если нужна активно поддерживаемая альтернатива — Cline или Kilo Code.
Кратко¶
| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (префикс anthropic/ на эндпоинт Anthropic) · GPT ✅ · китайские модели ✅ (OpenAI-совместимый эндпоинт) · Gemini ❌ (этот путь здесь не описан) |
| Протокол и Base URL | Anthropic: https://api.qcode.cc/api · OpenAI: https://api.qcode.cc/openai/v1 |
| Профильные переменные окружения | ANTHROPIC_API_BASE и OPENAI_API_BASE указывают на две ветки соответственно |
| Где настраивается | Флаги CLI или ~/.aider.conf.yml |
| Официальная документация | aider.chat |
Aider — популярный открытый AI-помощник для программирования (39K+ звёзд на GitHub), работает в терминале и поддерживает 100+ языков. Маршрутизацию моделей он выполняет через LiteLLM, поэтому понимает оба протокола — Anthropic и OpenAI.
🔴 Сначала главное: для Claude нужна точка Anthropic¶
OpenAI-совместимая точка QCode не принимает модели Claude. Если направить OPENAI_API_BASE на QCode и указать имя модели вида openai/claude-…, вернётся model_not_available_on_endpoint.
| Нужная модель | Префикс модели в Aider | Переменная | Значение |
|---|---|---|---|
| Claude | anthropic/ |
ANTHROPIC_API_BASE |
https://api.qcode.cc/api |
| GPT / четыре китайских семейства | openai/ |
OPENAI_API_BASE |
https://api.qcode.cc/openai/v1 |
См. Точки доступа и форматы API.
Почему Aider¶
- Полностью открытый код: вы платите только за использование API
- Режим Architect: одна модель планирует, другая правит — качество выше
- Глубокая интеграция с Git: каждая правка становится коммитом
- Repository Map: индексация всей кодовой базы на основе tree-sitter
- Оба протокола: Claude через Anthropic, GPT / китайские модели через OpenAI
Установка¶
# рекомендуется pipx (изолированная установка)
pipx install aider-chat
# или pip
pip install aider-chat
Настройка Claude (точка Anthropic)¶
export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_ваш_ключ_QCode"
aider --model anthropic/claude-sonnet-5
LiteLLM сам добавляет /v1/messages к этому base, поэтому заканчивайте на /api без слеша в конце.
Имя переменной зависит от версии: в LiteLLM исторически встречались и
ANTHROPIC_API_BASE, иANTHROPIC_BASE_URL. Если одна не работает, попробуйте другую либо аргумент--anthropic-api-key. Ориентируйтесь на документацию Aider.
Сохранить постоянно (добавить в ~/.zshrc или ~/.bashrc):
echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_ваш_ключ_QCode"' >> ~/.zshrc
source ~/.zshrc
Настройка GPT и китайских моделей (OpenAI-совместимая точка)¶
export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_ваш_ключ_QCode"
aider --model openai/gpt-6-sol
Четыре китайских семейства (glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.7-max …) работают на обоих протоколах; идентификаторы — в Китайских моделях.
Использование¶
cd /path/to/your/project
# Повседневный вариант
aider --model anthropic/claude-sonnet-5
# Флагман
aider --model anthropic/claude-opus-5
Режим Architect (рекомендуется)¶
Одна модель планирует, другая применяет правки:
# Opus планирует + Sonnet правит (рекомендуется)
aider --architect --model anthropic/claude-opus-5 --editor-model anthropic/claude-sonnet-5
# Sonnet планирует + Haiku правит (дешевле)
aider --architect --model anthropic/claude-sonnet-5 --editor-model anthropic/claude-haiku-4-5
Обе модели должны находиться на одном протоколе. Смешение (например, планировщик
anthropic/и редакторopenai/claude-…) приведёт к отказу на стороне редактора.
Частые команды¶
Внутри сессии Aider:
| Команда | Действие |
|---|---|
/add file.py |
Добавить файл в контекст чата |
/drop file.py |
Убрать файл |
/run pytest |
Выполнить команду и отправить вывод модели |
/diff |
Показать все изменения |
/undo |
Отменить последнюю правку AI |
/commit |
Зафиксировать текущие изменения |
/help |
Показать справку |
Резервные узлы¶
Три домена функционально идентичны и различаются только сетевой маршрутизацией. Ключ один и тот же:
| Узел | Anthropic (Claude) | OpenAI (GPT / китайские) |
|---|---|---|
| Глобально | https://api.qcode.cc/api |
https://api.qcode.cc/openai/v1 |
| Азия (лучше из КНР) | https://asia.qcode.cc/api |
https://asia.qcode.cc/openai/v1 |
| Северная Америка / Европа | https://us.qcode.cc/api |
https://us.qcode.cc/openai/v1 |
Доступные модели¶
| Модель | Имя в Aider | Примечание |
|---|---|---|
| Claude Sonnet 5 | anthropic/claude-sonnet-5 |
Рекомендуется, лучшее соотношение цена/качество |
| Claude Opus 5 | anthropic/claude-opus-5 |
Максимальные возможности |
| Claude Haiku 4.5 | anthropic/claude-haiku-4-5 |
Дёшево и быстро |
| GPT-6 Sol | openai/gpt-6-sol |
Флагман OpenAI |
| GLM 5.2 | openai/glm-5.2 |
Китайская, низкая цена |
Модели 4.x, такие как
claude-sonnet-4-6иclaude-opus-4-8, всё ещё продаются (префикс тот жеanthropic/). Актуальный список — на qcode.cc/models.
Aider против Claude Code CLI¶
| Критерий | Aider | Claude Code CLI |
|---|---|---|
| Открытый код | Полностью открыт | Закрыт |
| Интеграция с Git | Автокоммит на каждую правку | Ручной /commit |
| Режим Architect | Две модели: план + правка | Одна модель |
| Инструменты | Правка файлов + shell | Богаче (LSP, поиск, браузер) |
| Работа с контекстом | Индексация Repository Map | Окно 200K–1M токенов |
| Квота | Общая с тарифом QCode.cc | Общая с тарифом QCode.cc |
Хорошая связка: Aider — для быстрых правок и планирования в режиме Architect, Claude Code CLI — для глубокого анализа проекта и автоматизации.
Частые вопросы¶
Ошибка model_not_available_on_endpoint¶
Вы отправили модель Claude на протокол OpenAI. Проверьте две вещи: префикс модели должен быть anthropic/, а не openai/; base должен быть ANTHROPIC_API_BASE=https://api.qcode.cc/api.
Ошибка "Model not found"¶
Aider определяет провайдера по префиксу:
# верно
aider --model anthropic/claude-sonnet-5
# неверно (нет префикса)
aider --model claude-sonnet-5
Таймауты при вызовах API¶
Переключитесь на другой узел или увеличьте таймаут:
aider --model anthropic/claude-sonnet-5 --timeout 120
Дальше¶
- Точки доступа и форматы API — таблица «протокол × семейство моделей»
- Интеграция с Cline — графическая альтернатива в VS Code
- Приёмы командной строки — продвинутое использование Claude Code
- Документация Aider