# Интеграция с Aider

> **Последняя проверка**: 2026-09-18 · 📄 По официальной документации (репозиторий апстрима; см. пометку о статусе ниже)

> **Активность апстрима**: последний коммит в Aider-AI/aider датирован 2026-05-22, релизов после него не было (проверено через GitHub API 2026-09-18). Способы подключения на этой странице работают; если нужна активно поддерживаемая альтернатива — [Cline](/docs/ide/cline) или [Kilo Code](/docs/ide/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](https://aider.chat) |

[Aider](https://github.com/paul-gauthier/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](/docs/getting-started/endpoints-and-api-paths).

## Почему Aider

- **Полностью открытый код**: вы платите только за использование API
- **Режим Architect**: одна модель планирует, другая правит — качество выше
- **Глубокая интеграция с Git**: каждая правка становится коммитом
- **Repository Map**: индексация всей кодовой базы на основе tree-sitter
- **Оба протокола**: Claude через Anthropic, GPT / китайские модели через OpenAI

## Установка

```bash
# рекомендуется pipx (изолированная установка)
pipx install aider-chat

# или pip
pip install aider-chat
```

## Настройка Claude (точка Anthropic)

```bash
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](https://aider.chat/).

Сохранить постоянно (добавить в `~/.zshrc` или `~/.bashrc`):

```bash
echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_ваш_ключ_QCode"' >> ~/.zshrc
source ~/.zshrc
```

## Настройка GPT и китайских моделей (OpenAI-совместимая точка)

```bash
export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_ваш_ключ_QCode"

aider --model openai/gpt-5.5
```

Четыре китайских семейства (`glm-5.2` / `kimi-k3` / `deepseek-v4-pro` / `qwen3.7-max` …) работают на обоих протоколах; идентификаторы — в [Китайских моделях](/docs/usage/cn-models).

## Использование

```bash
cd /path/to/your/project

# Повседневный вариант
aider --model anthropic/claude-sonnet-5

# Флагман
aider --model anthropic/claude-opus-5
```

### Режим Architect (рекомендуется)

Одна модель планирует, другая применяет правки:

```bash
# 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` |
| Европа | `https://eu.qcode.cc/api` | `https://eu.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 5.5 | `openai/gpt-5.5` | Флагман OpenAI |
| GLM 5.2 | `openai/glm-5.2` | Китайская, низкая цена |

> Модели 4.x, такие как `claude-sonnet-4-6` и `claude-opus-4-8`, всё ещё продаются (префикс тот же `anthropic/`). Актуальный список — на [qcode.cc/models](https://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 определяет провайдера по префиксу:

```bash
# верно
aider --model anthropic/claude-sonnet-5

# неверно (нет префикса)
aider --model claude-sonnet-5
```

### Таймауты при вызовах API

Переключитесь на другой узел или увеличьте таймаут:

```bash
aider --model anthropic/claude-sonnet-5 --timeout 120
```

## Дальше

- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths) — таблица «протокол × семейство моделей»
- [Интеграция с Cline](/docs/ide/cline) — графическая альтернатива в VS Code
- [Приёмы командной строки](/docs/usage/cli-tips) — продвинутое использование Claude Code
- [Документация Aider](https://aider.chat/)