Разработчик копирует ключ от российского агрегатора, вставляет его в терминал, и Claude Code его принимает. Авторизация проходит успешно, интерфейс готов к работе. Но при первой же попытке задать вопрос или попросить прочитать локальный файл агент выдаёт ошибку. Начинаются долгие часы отладки. Вы проверяете баланс, перевыпускаете токены, меняете сети. Проблема кажется сетевой, но на самом деле ключ физически не может заработать. Причина кроется не в сетевых сбоях, а в формате, который ожидает CLI-агент.
Как устроен шлюз для CLI-агента Anthropic
Claude Code — это официальный CLI-агент от Anthropic, созданный для работы с кодовой базой напрямую из консоли. Это не веб-чат и не плагин для редактора. Он умеет самостоятельно читать файлы, вносить правки в исходники и запускать консольные команды.
Для связи с серверами агент использует строго определённый gateway-протокол. Согласно официальной документации на 28.08.2026, Claude Code принимает ровно три формата запросов. Каждый из них активируется своей переменной окружения.
Первый формат — Anthropic Messages. Он включается через переменную ANTHROPIC_BASE_URL и обращается к эндпоинту /v1/messages. Опционально шлюз использует /v1/messages/count_tokens для предварительного подсчёта объёма контекста перед отправкой.
Второй формат — Amazon Bedrock InvokeModel. Этот путь требует переменных ANTHROPIC_BEDROCK_BASE_URL и флага CLAUDE_CODE_USE_BEDROCK=1. Запрос стучится в /model/{model}/invoke.
Третий формат — Google Cloud Agent Platform. Он работает через переменную ANTHROPIC_VERTEX_BASE_URL и флаг CLAUDE_CODE_USE_VERTEX=1, используя эндпоинт :rawPredict. Два последних формата существуют для корпоративной инфраструктуры. Они нужны тем, чей трафик жёстко завязан на облака Amazon и Google.
Жёсткие требования к потоку и пингам
Протокол накладывает на промежуточный сервер жёсткие технические ограничения. Ответы обязательно должны идти стримом, то есть непрерывным потоком токенов. Если промежуточный шлюз агрегатора буферизует ответ и пытается отдать его целиком в конце генерации, клиент Claude Code просто зависает.
Кроме того, агент считает каждый переданный байт. Он принудительно обрывает соединение после 300 секунд тишины. На практике это значит, что провайдер обязан пробрасывать keep-alive пинги. Когда модель «размышляет» над объёмным куском кода или анализирует структуру директории, возникают длинные паузы. Сессия без регулярных пингов оборвётся по таймауту.
Заголовки anthropic-version и anthropic-beta должны передаваться сервером без изменений. Маршрутизация запросов на модели других вендоров через этот шлюз официально не поддерживается. Для наполнения списка доступных моделей агент использует опциональный запрос GET /v1/models?limit=1000. Если сервер его не отдаёт, ничего не ломается: список моделей просто откатывается на встроенный.
Почему ключ агрегатора не подходит для терминала
Главная причина, по которой Claude Code не подключается к подавляющему большинству российских сервисов, заключается в одном факте. В списке поддерживаемых форматов нет OpenAI-совместимого эндпоинта /v1/chat/completions.
Именно этот формат является стандартом де-факто для рынка агрегаторов. Большинство инструментов понимают структуру OpenAI. CLI-агент Anthropic идёт своим путём. Он не проверяет доступность нужного эндпоинта в момент ввода ключа. Агент падает не на этапе авторизации, а в момент отправки первого рабочего запроса. Он пытается отправить структуру данных Anthropic на сервер, который ожидает структуру OpenAI, либо стучится по несуществующему пути и получает ошибку.
Здесь кроется ключевой признак, по которому вы можете за десять секунд проверить любой сервис. Не нужно искать отзывы или тестировать ключи вслепую. Достаточно открыть документацию провайдера и посмотреть, есть ли у него эндпоинт /v1/messages. Если сервис отдаёт только /v1/chat/completions, Claude Code через него работать не будет.
Официальные тарифы и стоимость токенов
Чтобы понимать, ради чего разработчики пытаются настроить этот инструмент, посмотрим на официальные тарифы Anthropic. Данные актуальны на 28.08.2026.
Доступ к Claude Code привязан к уровню подписки. В бесплатный план Free он не входит. Тем, у кого есть подписка Pro за 20 долларов помесячно или 17 долларов при оплате за год, сторонний шлюз для агента не нужен. Они работают с официальным API.
Для команд есть тариф Max. Лимиты там в 5 или 20 раз выше, чем у Pro. Цена начинается от 100 долларов в месяц, точные цифры на странице цен не публикуются. Тариф Team обойдётся в 25 долларов за место помесячно, премиум-место стоит 125. План Enterprise self-serve просит 20 долларов за место плюс оплату за фактический расход токенов.
Если использовать API напрямую, официальные цены за миллион токенов выглядят так. Claude Opus 5 стоит 5 долларов на вход и 25 на выход. Claude Sonnet 5 обойдётся в 2 доллара за миллион входных токенов и 10 за выходные. Claude Haiku 4.5 оценивается в 1 доллар на вход и 5 на выход. Claude Fable 5 просит 10 долларов за вход и 50 за выход.
| Модель | Вход (за 1 млн токенов) | Выход (за 1 млн токенов) |
|---|---|---|
| Claude Opus 5 | $5 | $25 |
| Claude Sonnet 5 | $2 | $10 |
| Claude Haiku 4.5 | $1 | $5 |
| Claude Fable 5 | $10 | $50 |
Цены через маршрутизатор и наш отказ
Мы говорим об этом прямо: Claude Code через altrouter не подключается. У нас реализованы только маршруты /v1/chat/completions и /v1/images/generations. Эндпоинта /v1/messages у нас нет. Мы предоставляем доступ к самим моделям Claude со скидками, но оригинальный CLI-агент от Anthropic нашу задачу не решает. Если вам критически важен именно интерфейс Claude Code в терминале, наш сервис вам не подойдёт.
На 28.08.2026 цены на те же модели через altrouter позволяют экономить, если вы используете совместимые инструменты.
Claude Opus 4.8 стоит 4,50 на вход и 22,50 на выход, скидка 10 процентов. Claude Haiku 4.5 обойдётся в 0,771925 доллара на вход и 3,999975 на выход, скидка 20 процентов от цены Anthropic.
| Модель | Вход у нас | Выход у нас | Скидка от официальной |
|---|---|---|---|
| Claude Sonnet 5 | $1,6898 | $8,4987 | 15% |
| Claude Sonnet 4.6 | $2,6843 | $13,50045 | 10% |
| Claude Opus 4.8 | $4,50 | $22,50 | 10% |
| Claude Haiku 4.5 | $0,771925 | $3,999975 | 20% |
Как запустить модели Claude в редакторе кода
Если ваш провайдер не поддерживает формат Anthropic, запустить именно Claude Code не выйдет. Но сами модели Claude доступны. Чтобы использовать их в разработке, вам нужно сменить инструмент.
-
Убедитесь, какой формат отдаёт ваш сервис. Ищите в документации базовый URL и список эндпоинтов.
-
Если вы видите только
/v1/chat/completions, откажитесь от идеи использовать оригинальный Claude Code. -
Выберите любое расширение для IDE, которое позволяет вручную задать base_url — адрес, куда уходят запросы — в формате OpenAI.
-
Пропишите в настройках выбранного инструмента адрес вашего провайдера и вставьте ключ. Модели Claude будут работать через этот интерфейс.
FAQ
Как подключить Claude Code через OpenAI API?
Никак. Официальный шлюз Claude Code не поддерживает OpenAI-совместимый эндпоинт /v1/chat/completions. Он работает только через форматы Anthropic Messages, Amazon Bedrock или Google Cloud Vertex.
Почему Claude Code принимает ключ, но выдаёт ошибку при запросе?
Агент не проверяет наличие нужного эндпоинта в момент ввода ключа. Авторизация проходит локально. При первой попытке отправить задачу CLI-агент стучится по пути /v1/messages. Если сервис предоставляет только OpenAI-формат, запрос возвращает ошибку.
Входит ли Claude Code в бесплатную подписку?
Нет. На 28.08.2026 доступ к Claude Code отсутствует в тарифе Free. Для его использования требуется как минимум подписка Pro за 20 долларов в месяц или корпоративные тарифы.
Какой эндпоинт нужен для Claude Code?
Для успешного подключения стороннего сервиса через переменную ANTHROPIC_BASE_URL, провайдер обязан поддерживать маршрут /v1/messages. Также сервер должен корректно обрабатывать потоковую передачу и keep-alive пинги.
Не тратьте часы на отладку ключей, если терминал выдаёт ошибку при первом запросе. Проверьте документацию вашего API-провайдера на наличие нужного маршрута. Если его нет — используйте модели Claude через инструменты, поддерживающие универсальные форматы.
Узнайте больше о доступных моделях и форматах подключения на altrouter.ai. Полный список поддерживаемых нейросетей и актуальные цены доступны в разделе каталога моделей.