Source: https://aiprimetech.io/ru/learn/use-claude-api-with-aider/ [Главная](/ru/) / [Обучение](/ru/learn/) / Aider с Claude через шлюз: ANTHROPIC_API_BASE, файлы конфигурации, режим архитектора и устранение проблем # Aider с Claude через шлюз: ANTHROPIC_API_BASE, файлы конфигурации, режим архитектора и исправления Aider отправляет каждый вызов модели через LiteLLM, поэтому адрес шлюза задаётся в настройках LiteLLM, а не Aider. Для Claude это означает, что ANTHROPIC_API_BASE нужно задать корневой адрес хоста шлюза и использовать имя модели с префиксом anthropic/ . Не менее важны ещё две менее очевидные настройки: для новых идентификаторов Claude нужна запись в настройках модели, иначе Aider переходит к редактированию файлов целиком без карты репозитория. ## Установите Aider macOS / LinuxКопировать ``` python -m pip install aider-install aider-install # or the one-line installer (installs Python 3.12 if needed) curl -LsSf https://aider.chat/install.sh | sh ``` WindowsКопировать ``` powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex" ``` Если команда aider после этого не найдена, что часто бывает в Windows, python -m aider запускает ту же программу. ## Подключитесь к Claude через шлюз терминалКопировать ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsКопировать ``` setx ANTHROPIC_API_KEY your_gateway_key setx ANTHROPIC_API_BASE https://aiprimetech.io # open a new terminal, then: aider --model anthropic/claude-sonnet-5 ``` Используйте корневой адрес хоста: без /v1 и без завершающей косой черты. LiteLLM добавляет /v1/messages самостоятельно, поэтому https://aiprimetech.io/v1 превращается в /v1/v1/messages и возвращает 404, а завершающая косая черта приводит к двойной косой черте в пути. В документации самого Aider не описана настройка собственного базового URL Anthropic. Переменную считывает LiteLLM, который сначала проверяет ANTHROPIC_API_BASE а затем ANTHROPIC_BASE_URL— переменную, которую использует Claude Code. Подойдёт любая из них; если заданы обе, ANTHROPIC_API_BASE имеет приоритет. Сохраняйте anthropic/ в качестве префикса имени модели. Без префикса поставщика LiteLLM не знает, куда направить запрос с незнакомым именем, и завершается с ошибкой LLM Provider NOT provided. ## Сохраните настройки в файлах конфигурации Aider считывает .aider.conf.yml и .env из домашнего каталога, корня репозитория git и текущего каталога, именно в таком порядке; файлы, прочитанные позже, имеют приоритет. Файл в домашнем каталоге действует для всех проектов. ~/.aider.conf.ymlКопировать ``` model: anthropic/claude-sonnet-5 weak-model: anthropic/claude-haiku-4-5 set-env: - ANTHROPIC_API_BASE=https://aiprimetech.io model-settings-file: ~/.aider.model.settings.yml model-metadata-file: ~/.aider.model.metadata.json ``` ~/.envКопировать ``` ANTHROPIC_API_KEY=your_gateway_key ``` weak-model обрабатывает сообщения коммитов и сводки истории чата, поэтому недорогая модель для этой задачи позволяет экономить в каждом сеансе. set-env копирует переменную в окружение до любого вызова модели, благодаря чему базовый URL не нужно добавлять в профиль оболочки. ## Сохраните редактирование через diff и карту репозитория для новых моделей Aider выбирает формат редактирования по имени модели. Для знакомых ему имён, в том числе содержащих sonnet-4-, opus-4- или haiku-4-, используются diff для редактирования и карта репозитория. Незнакомое имя, например claude-sonnet-5, приводит к переходу на переписывание файлов целиком и отключению карты репозитория. Это делает редактирование медленнее и дороже. Запись в настройках восстанавливает правильное поведение: ~/.aider.model.settings.ymlКопировать ``` - name: anthropic/claude-sonnet-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 - name: anthropic/claude-opus-5-5 edit_format: diff use_repo_map: true weak_model_name: anthropic/claude-haiku-4-5 editor_model_name: anthropic/claude-sonnet-5 editor_edit_format: editor-diff ``` Неизвестные модели также вызывают предупреждение: Unknown context window size and costs, using sane defaults. Оно безвредно, но в этом случае Aider предполагает неограниченное контекстное окно и нулевую цену. Файл метаданных задаёт реальные значения: ~/.aider.model.metadata.jsonКопировать ``` { "anthropic/claude-sonnet-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000002, "output_cost_per_token": 0.00001, "litellm_provider": "anthropic", "mode": "chat" }, "anthropic/claude-opus-5-5": { "max_tokens": 64000, "max_input_tokens": 200000, "max_output_tokens": 64000, "input_cost_per_token": 0.000004, "output_cost_per_token": 0.00002, "litellm_provider": "anthropic", "mode": "chat" } } ``` Цены соответствуют прейскуранту Anthropic за токен, поэтому Aider показывает стоимость по прейскуранту; шлюз взимает меньшую плату. Лимит входных данных 200K — безопасный рабочий предел, даже если модель поддерживает больше. ## Режим архитектора: планирование с одной моделью, редактирование с другой терминалКопировать ``` aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5 ``` В режиме архитектора основная модель предлагает изменение, а модель-редактор превращает его в правки файлов. Использование более мощной модели для планирования и более дешёвой для редактирования обычно обходится дешевле, чем использование мощной модели для обеих задач. В рамках сеанса /architect переключает на неё для одного сообщения, а /chat-mode architect переключает на неё до конца сеанса. ## Подключение через OpenAI-совместимый API Шлюз также поддерживает формат OpenAI Chat Completions, через который можно использовать модели GPT в той же учётной записи. Для этого способа подключения базовый URL включает /v1, а имя модели получает openai/ в качестве префикса: терминалКопировать ``` export OPENAI_API_KEY=your_gateway_key export OPENAI_API_BASE=https://aiprimetech.io/v1 aider --model openai/claude-sonnet-5 ``` Для Claude предпочтительнее нативное подключение, описанное выше: метаданные модели и кеширование промптов соответствуют формату Anthropic. Если в окружении случайно задана переменная OPENAI_BASE_URL , LiteLLM использует её вместо OPENAI_API_BASE. ## Модели | Идентификатор модели | Для каких задач | claude-sonnet-5 | Основной выбор для программирования и работы с агентами: быстрая, мощная, со средней стоимостью. | claude-opus-5-5 | Более сложные рассуждения, масштабный рефакторинг, длительная работа агентов. | claude-fable-5-1 | Самая мощная и дорогая; используйте её для наиболее сложных задач. | claude-haiku-4-5 | Недорогая и быстрая: заголовки, краткие изложения, классификация, небольшие шаги. Короткие псевдонимы Aider (sonnet, opus, haiku) указывают на старые идентификаторы моделей, поэтому задавайте имя модели явно. Старые идентификаторы с датой, такие как claude-3-5-sonnet-20241022 , не обслуживаются. ## Устранение неполадок | Что вы видите | Причина | Решение | 404 / NotFoundError | /v1 в ANTHROPIC_API_BASE, поэтому путь становится /v1/v1/messages | Укажите корневой адрес хоста, https://aiprimetech.io, без завершающей косой черты | LLM Provider NOT provided | Имя модели без префикса провайдера | Используйте anthropic/claude-sonnet-5 | AuthenticationError: не удалось выполнить аутентификацию | Ключ отсутствует в оболочке, из которой запущен Aider, либо предназначен для другой конечной точки | echo $ANTHROPIC_API_KEY; в Windows откройте новый терминал после setx | Полная перезапись файлов, без карты репозитория | Aider не распознаёт имя модели | Добавьте .aider.model.settings.yml в качестве записи, приведённой выше | Unknown context window size and costs | Нет метаданных модели | Добавьте файл метаданных или проигнорируйте предупреждение | Ошибки превышения лимита токенов | В чате слишком много файлов или они слишком большие | /tokens для просмотра использования, /drop файлы, /clear историю | RateLimitError | Достигнут лимит параллельных запросов или частоты запросов | Aider повторяет попытки с увеличивающейся задержкой; избегайте запуска нескольких сеансов с одним ключом | Модель не поддерживается | Устаревший идентификатор модели или опечатка в нём | Используйте идентификатор из таблицы выше Если ошибка возникает на стороне модели, а не Aider, см. [руководстве по ошибкам Claude API](/ru/learn/claude-api-errors-troubleshooting/). ## Часто задаваемые вопросы Как использовать Aider с пользовательским базовым URL Anthropic? Задайте для ANTHROPIC_API_BASE корневой адрес хоста шлюза, например https://aiprimetech.io, без /v1 и завершающей косой черты, задайте ANTHROPIC_API_KEY и запустите aider --model anthropic/claude-sonnet-5. LiteLLM добавляет /v1/messages. Читает ли Aider ANTHROPIC_BASE_URL? Да, через LiteLLM, как запасной вариант. LiteLLM сначала проверяет ANTHROPIC_API_BASE, затем ANTHROPIC_BASE_URL. Почему Aider полностью переписывает файлы при использовании новой модели Claude? Aider не распознаёт имя модели и переключается на формат редактирования whole без карты репозитория. Добавьте запись с edit_format: diff и use_repo_map: true в .aider.model.settings.yml. Может ли Aider использовать OpenAI-совместимую конечную точку? Да: задайте для OPENAI_API_BASE адрес конечной точки, включая /v1, и задайте OPENAI_API_KEY, затем используйте префикс openai/, например aider --model openai/claude-sonnet-5. Начните использовать Claude за несколько минут Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.[Получить ключ API](/register) AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев. ## Другие руководства по Claude API [Как получить ключ Claude API](/ru/learn/how-to-get-a-claude-api-key/)[Как устроены цены Claude API](/ru/learn/claude-api-pricing-explained/)[Самый дешевый способ использования API Claude](/ru/learn/cheapest-way-to-use-claude-api/)[Безлимитный Cursor с API Claude](/learn/use-claude-api-with-cursor/)[Безлимитный доступ к Claude Code](/ru/learn/use-claude-api-with-claude-code/)[Шлюз API Claude и прямой доступ к Anthropic: сравнение](/ru/learn/claude-api-vs-anthropic-direct/)[Используйте Claude с OpenAI SDK: совместимая с OpenAI конечная точка, потоковая передача, инструменты и ограничения](/ru/learn/openai-compatible-claude-api/)[Объяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)](/ru/learn/claude-api-models-compared/)[Оплата API Claude криптовалютой](/ru/learn/claude-api-with-crypto-payment/)[Доступ к API Claude без листа ожидания](/ru/learn/claude-api-without-waitlist/)[Как сократить расход токенов Claude](/ru/learn/how-to-reduce-claude-token-usage/)[Безлимитный Cline с API Claude](/ru/learn/use-claude-api-with-cline/)[Безлимитный Roo Code с API Claude](/ru/learn/use-claude-api-with-roo-code/)[Безлимитный Claude в IDE JetBrains](/ru/learn/use-claude-api-with-jetbrains/)[Безлимитный Claude в VS Code](/ru/learn/use-claude-api-with-vscode/)[Конфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибки](/ru/learn/use-claude-api-with-opencode/)[Hermes Agent с Claude через шлюз: настройка пользовательского провайдера, контроль расходов и исправления](/ru/learn/run-hermes-agent-with-claude-api/)[Запуск OpenClaw с Claude без ограничений](/ru/learn/run-openclaw-with-claude-api/)[Что означает API, совместимый с Anthropic](/ru/learn/anthropic-compatible-api/)[Ключ API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token](/ru/learn/claude-code-api-key-setup/)[Расходы на API Claude Code — цены и способы их снизить](/ru/learn/claude-code-api-costs/)[Объяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из них](/ru/learn/claude-api-errors-troubleshooting/)[Как купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»](/ru/learn/buy-claude-api-credits/)[Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?](/ru/learn/claude-api-free-trial/)[API Claude или подписка Claude Pro/Max — что выбрать](/ru/learn/claude-api-vs-subscription/)[Codex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и исправления](/ru/learn/use-claude-api-with-codex/)[Подключение Claude к n8n](/ru/learn/use-claude-api-with-n8n/)[Маршрутизация LiteLLM к Claude](/ru/learn/use-claude-api-with-litellm/)[Использование Claude в Kilo Code](/ru/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat с Claude через шлюз: настройка Custom Endpoint, режим агента и исправления](/ru/learn/use-claude-api-with-github-copilot/)[Подключите Zed к Claude через шлюз](/ru/learn/use-claude-api-with-zed/)[Подключите Cherry Studio к Claude](/ru/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибки](/ru/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибок](/ru/learn/anthropic-python-sdk/)[Claude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблем](/ru/learn/use-claude-api-with-vercel-ai-sdk/)[Используйте Factory Droid с Claude](/ru/learn/use-claude-api-with-factory-droid/)[Как устроен API Claude Code](/ru/learn/claude-code-api/)[Интеграция API Claude в ваше приложение](/ru/learn/claude-api-integration/)[Как пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует](/ru/learn/get-unlimited-claude-usage/)