Перейти к содержанию
среда, 7 октября 2026 г.

ИИ Вестник

Главные новости о развитии искусственного интеллекта в России

Claude Code через сторонний шлюз: как подключить и какие модели выдержат агентный цикл

Источник: Все публикации в потоке Разработка
Developer at desk with code on screen, terminal window, dim office lighting.
Generated by Sourceful Riverflow (RouterAI)

Claude Code можно перенаправить на совместимый API-шлюз, сохранив привычный клиент, но сменив провайдера и модель. Разбираем, что именно уходит в API, какие требования предъявляются к прокси и с какими ограничениями сталкиваются альтернативные модели.

Claude Code перестал быть нишевым инструментом: по данным опроса JetBrains Developer Ecosystem Survey 2026, охватившего более 15 000 профессиональных разработчиков, 90% респондентов пользуются AI-агентами для кода хотя бы раз в неделю, а 68% — ежедневно. Сам Claude Code применяют 39% опрошенных, причём 31% называют его основным инструментом. Anthropic проанализировала около 400 тысяч сессий за полгода и выяснила, что после IT-специалистов вторая по величине группа пользователей — бизнес и финансы, а среди нетехнических профессий быстрее всего растёт доля менеджеров, продавцов и юристов. Программистом для работы в Claude Code быть уже не обязательно.

Когда такой инструмент становится частью командного процесса, всплывают вопросы оплаты, ключей, лимитов и доступа к моделям. Для Anthropic нужен один аккаунт, для Gemini — другой, для очередной открытой модели — третий, и в итоге команда получает набор секретов, счетов и несовместимых настроек. Часть этих задач можно вынести из клиента: через переменную окружения ANTHROPIC_BASE_URL Claude Code направляется на сторонний Anthropic-совместимый API. Тогда ключи, лимиты, маршрутизацию и оплату берёт на себя шлюз, а у разработчика остаётся привычный клиент. Однако совместимость с Anthropic API не означает, что за этим API можно без последствий поставить любую другую модель.

Claude Code работает агентным циклом: модель просит вызвать инструмент — прочитать файл, запустить команду, поискать по репозиторию, — клиент выполняет его и возвращает результат, и так до завершения задачи. Один запрос пользователя превращается в серию API-вызовов, и на каждом шаге клиент заново отправляет историю диалога, системные инструкции и описания инструментов. Отсюда два ключевых требования к шлюзу: совместимость должна сохраняться на каждом шаге цикла, а стоимость длинной сессии сильно зависит от кэширования повторяющегося контекста. Кроме того, Claude Code обращается к шлюзу по трём эндпоинтам, и в Caila эндпоинт подсчёта токенов реализован вместе с Anthropic Messages API, поэтому команда /context в сессии через шлюз показывает точные числа. Служебный трафик, в основном статистика использования, идёт напрямую в Anthropic, минуя шлюз, но на работу с моделью это не влияет.

Стриминг нельзя буферизовать: Claude Code читает ответ по мере поступления, и если шлюз сначала соберёт весь ответ, а потом отдаст его клиенту, агент будет выглядеть зависшим. Клиент учитывает SSE-события и обрывает поток, если долго не получает данные, поэтому шлюз обязан передавать SSE-пинги во время долгой генерации. Автообнаружение моделей включается переменной CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1: при старте Claude Code запрашивает у шлюза список моделей и добавляет их в /model. Здесь есть два ограничения: запрос должен уложиться в таймаут по умолчанию в три секунды, а редиректы считаются ошибкой, поскольку клиент не передаёт данные для авторизации на другой хост. Кроме того, Claude Code фильтрует полученный список — в меню попадают модели, в идентификаторе которых встречается claude или anthropic, поэтому, например, vertex_ai в список не попадёт.

Контекст для российских команд: прямая оплата Anthropic из России требует зарубежной карты и VPN, а привычный обходной путь через агрегатор может перестать работать — с 27 июня 2026 года OpenRouter не обслуживает российские аккаунты, приём платежей для учёток с регионом «Россия» прекратился ещё в мае. Шлюз решает и проблему ключей: без него каждый разработчик работает с ключом внешнего провайдера, и при уходе человека или утечке секрет приходится отзывать на стороне провайдера. Через шлюз внешние ключи остаются за ним, а разработчику выдаётся отдельный ключ платформы. Наконец, автономный агент способен сделать десятки запросов подряд, поэтому полезно ограничивать бюджет до первого запуска и видеть расходы по ключам, моделям и запросам.

В Just AI такой шлюз — Caila — реализован с Anthropic-совместимым эндпоинтом, и большая часть команды работает через него. Организовать оплату подписок Claude для всех сотрудников оказалось сложно, а для части команды она невыгодна: кто-то тратит на токены заметно меньше стоимости подписки, к тому же аккаунты с подписками периодически блокируют. По статистике расходов видно, кто тратит больше всего, и для таких сотрудников подписка оказывается выгоднее. Описанный контракт между Claude Code и шлюзом применим и к другому прокси, например к собственной установке LiteLLM или корпоративному API-шлюзу, — клиентская часть сценария от этого не меняется.

Главный открытый вопрос — какие альтернативные модели способны выдержать агентный цикл без потери качества. Совместимость на уровне API — необходимое, но не достаточное условие: модель должна корректно поддерживать вызов инструментов, сохранять контекст на каждом шаге и не разваливать длинную сессию. Для российского рынка это означает, что шлюз становится не просто прокси, а точкой контроля расходов и доступа, и от его реализации зависит, сможет ли команда предсказуемо использовать Claude Code с разными провайдерами. Дальнейшее развитие направления, вероятно, пойдёт по пути стандартизации подобных шлюзов и более гибкого выбора моделей под конкретные задачи.

Читайте также