Claude API в Aider: как подключить и экономить
Aider обращается к Claude API через LiteLLM, а LiteLLM учитывает ANTHROPIC_API_BASE — поэтому две переменные окружения перенаправляют всю связку claude-api-aider на дисконтный шлюз. Те же модели, те же команды, тот же git-воркфлоу; каждый токен тарифицируется с единой скидкой 50% от официальных ставок и списывается с предоплаченного баланса.
·
Направьте Aider на эндпоинт шлюза
Да, Aider работает с кастомным эндпоинтом Claude, и настройка занимает меньше минуты. Под капотом Aider ведёт Anthropic-трафик через LiteLLM, а LiteLLM учитывает переменную окружения ANTHROPIC_API_BASE — ни конфиг-файлов, ни плагинов, ни патчей не нужно. Экспортируйте эндпоинт и ключ — и запускайте Aider как обычно.
export ANTHROPIC_API_KEY=sk-pool-••• export ANTHROPIC_API_BASE=https://router.apitoken.sale aider --model anthropic/claude-opus-4-8
Ключ берётся из дашборда apiToken.sale и выглядит как sk-pool-…; один ключ работает со всеми поддерживаемыми моделями, так что те же экспорты покроют и любую другую модель Claude, которую вы позже передадите в --model.
ANTHROPIC_API_BASE — не та переменная, которую читает Claude Code (там это ANTHROPIC_BASE_URL). Aider идёт через LiteLLM и ждёт именно написание API_BASE — если пользуете обоими инструментами на одном ключе, экспортируйте обе переменные: они не конфликтуют.
В Windows задайте те же две переменные в PowerShell вместо export: $env:ANTHROPIC_API_KEY и $env:ANTHROPIC_API_BASE — или используйте setx, чтобы сохранить их между сессиями. Aider ведёт себя одинаково — LiteLLM читает окружение процесса на любой платформе.
Читайте также: Используйте Claude API через LiteLLM
Сохраните настройку между сессиями шелла
Экспорты умирают вместе с шеллом, который их выставил. Пропишите их в профиле шелла (~/.zshrc, ~/.bashrc), чтобы каждый терминал стартовал готовым, а выбор моделей перенесите в собственный YAML-конфиг Aider — он читает .aider.conf.yml из домашней директории, корня git-репозитория или текущей директории, именно в этом порядке.
# ~/.aider.conf.yml model: anthropic/claude-sonnet-5 weak-model: anthropic/claude-haiku-4-5 cache-prompts: true
Секретов в этом файле быть не должно: ключ остаётся в окружении, а в конфиге — только поведение. Проектный .aider.conf.yml, закоммиченный в репозиторий, зафиксирует выбор модели для всей команды, не фиксируя ничей ключ.
Модель Claude под каждую роль Aider
Aider работает не с одной моделью, а сразу с тремя, и у каждой роли — своя точка оптимума по цене и качеству.
| Роль в Aider | Флаг | Модель | Для чего |
|---|---|---|---|
| Основная модель чата | --model | anthropic/claude-sonnet-5 | Повседневный выбор по умолчанию; качество кода, близкое к Opus, для большинства сессий |
| Основная модель, самые тяжёлые задачи | --model | anthropic/claude-opus-4-8 | Глубокие многофайловые рефакторинги и длинные агентные правки |
| Слабая модель | --weak-model | anthropic/claude-haiku-4-5 | Сообщения коммитов и сжатие истории чата |
| Модель-редактор (режим architect) | --editor-model | anthropic/claude-sonnet-5 | Превращает план модели-архитектора в конкретные диффы |
Слабая модель — тихая победа: Aider вызывает её при каждом коммите и каждом сжатии истории, так что перевод этой роли на Haiku удешевляет работу, которую вы всё равно не читаете. Все три модели работают на одном ключе и с той же скидкой — смена ролей никогда не означает смену аккаунта.
Почему длинные сессии Aider стоят столько, сколько стоят
Aider прожорлив по токенам by design, и прежде чем судить счёт, полезно понимать, куда уходят токены. Каждый ход заново отправляет карту репозитория, полное содержимое каждого файла, добавленного в чат, и историю переписки как входные токены; каждая правка возвращается выходными токенами. Двухчасовая сессия рефакторинга — это в реальности сотни тысяч токенов, а не пара сообщений в чате.
- Карта репозитория: сжатый конспект всего репозитория, пересылается по мере изменений.
- Добавленные файлы: всё, что вы передали через /add, целиком попадает в промпт при каждом запросе, пока вы не уберёте его через /drop.
- Формат правок: diff-форматы пересылают меньше кода, чем перезапись файла целиком.
- Многофайловые правки: каждый затронутый файл тарифицирует свои входные и выходные токены.
Именно здесь единая скидка 50% накапливается: сессия, которая по официальным потокенным ставкам стоила бы $10, здесь обходится в $5, и разрыв растёт с каждым часом работы. Поверх неё складываются две привычки: слабая модель на Haiku забирает постоянный ручеёк вызовов для коммит-сообщений и саммари, а diff-форматы правок держат выходные токены пропорциональными изменению, а не файлу. Ни то ни другое не меняет поведение Aider — только стоимость той же работы.
Режьте токены прямо в запущенной сессии
- 01Запускайте /tokens рано и часто — Aider показывает число токенов в текущем контексте и накопленный итог сессии, так что цену раздутого чата вы увидите до отправки.
- 02Убирайте через /drop каждый файл, который закончили править. Файлы остаются в промпте, пока их не удалить, и забытый большой файл — самая частая скрытая утечка токенов.
- 03Делайте /clear между несвязанными задачами. История чата пересылается с каждым сообщением; новая задача заслуживает чистого контекста.
- 04Переключайтесь вниз для дешёвых вопросов командой /model anthropic/claude-haiku-4-5, а потом возвращайтесь — смена модели посреди сессии не требует перезапуска.
- 05Запускайте Aider с --cache-prompts (или cache-prompts: true в конфиге), чтобы повторяющийся файловый контекст обслуживался промпт-кешированием Anthropic, а не тарифицировался как свежий ввод на каждом ходу.
Диагностика: Aider всё ещё ходит в Anthropic напрямую
- Экспорты сделаны в другом шелле — Aider читает окружение собственного процесса, поэтому экспортируйте переменные в том же шелле, который его запускает, или в профиле шелла.
- Старая версия Aider или LiteLLM — переопределение эндпоинта живёт в LiteLLM, поэтому прежде всего обновитесь: pip install -U aider-chat.
- 401 на первом запросе — ключ опечатан или отозван; с эндпоинтом всё в порядке, проблема в креде.
Чтобы отделить одну половину от другой, обойдите Aider и дёрните шлюз напрямую минимальным вызовом Messages:
curl https://router.apitoken.sale/v1/messages \
-H "x-api-key: sk-pool-•••" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'JSON в ответе доказывает, что эндпоинт и ключ здоровы, а проблема сидит в окружении Aider; ошибка здесь означает: чините экспорты, а не инструмент.
Частые вопросы
Работает ли Aider с кастомным эндпоинтом Claude?
Да. Aider использует LiteLLM для моделей Anthropic, а LiteLLM учитывает переменную окружения ANTHROPIC_API_BASE — укажите в ней https://router.apitoken.sale и запускайте Aider как обычно.
Какая модель Claude лучше в Aider?
claude-sonnet-5 — лучший вариант по умолчанию для большинства задач программирования; на самую тяжёлую многофайловую работу переключайтесь на claude-opus-4-8. Назначьте claude-haiku-4-5 слабой моделью, чтобы коммит-сообщения и саммари тарифицировались по ставкам Haiku — все три работают на одном ключе.
Насколько дешевле длинная сессия Aider?
Каждый запрос тарифицируется по официальным потокенным ставкам минус ваша единая скидка 50%, так что сессия, которая напрямую стоила бы $10, здесь обойдётся в $5.
ANTHROPIC_API_BASE — это то же самое, что ANTHROPIC_BASE_URL?
Нет. Aider обращается к Anthropic через LiteLLM, который читает ANTHROPIC_API_BASE; Claude Code читает ANTHROPIC_BASE_URL. Экспортировать обе безвредно, если вы пользуетесь обоими инструментами.
Можно ли смешивать модели Claude в одной сессии Aider?
Да. Передайте --model для основной модели чата, --weak-model для служебных задач и /model посреди сессии для переключения без перезапуска — один API-ключ покрывает все поддерживаемые модели.
Нужен ли конфиг-файл для старта?
Нет. Для первого запуска достаточно двух переменных окружения; .aider.conf.yml нужен только чтобы закрепить выбор моделей — cache-prompts и слабую модель — между шеллами и проектами.
Используйте Google или GitHub, чтобы получить ключ и бонус $5 на баланс платформы до пополнения.