Как направить Claude Code
на свой API-эндпоинт
На 2026-10-07, по документации Anthropic о шлюзах, хватает двух переменных: ANTHROPIC_BASE_URL — эндпоинт, ANTHROPIC_AUTH_TOKEN — учётные данные, которые уходят в заголовке Authorization: Bearer (если шлюз читает x-api-key, нужна ANTHROPIC_API_KEY); обе можно записать в блок env файла settings.json. С Claude Code 2.1.285 модели с окном 1M (Opus 4.7+, Sonnet 5+, Fable) за своим ANTHROPIC_BASE_URL работают с 1M, а если шлюз держит только 200K, официальный совет — выполнить /autocompact 200k. Облачные сессии не входят в развёртывание через шлюз, и заданные там переменные шлюза не применяются.
Обновлено 2026-10-08
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard / AMEX или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре вещи, которые надо знать
Минимальная конфигурация
ANTHROPIC_BASE_URL указывает на эндпоинт, ANTHROPIC_AUTH_TOKEN передаёт учётные данные. В большинстве случаев этого достаточно.
Куда попадают учётные данные
По документации на 2026-10-07: ANTHROPIC_AUTH_TOKEN уходит в Authorization: Bearer, ANTHROPIC_API_KEY — в x-api-key, apiKeyHelper — в оба; если положить данные не в ту переменную, они попадут в заголовок, который шлюз не читает, и запрос завершится 401.
Второе место настройки
Если не хотите переменные окружения, впишите те же ключи в блок env файла settings.json — форма соответствует один к одному.
Веб-версия и облачные сессии
По документации на 2026-10-07: облачные сессии не входят в развёртывание через шлюз, и переменные шлюза в настройках окружения облачной сессии не применяются; если трафик обязан идти через шлюз, не включайте эти поверхности таким пользователям.
Почему этих двух переменных достаточно
На 2026-10-07 ответ прежний: две переменные. Точка выхода трафика Claude Code настраивается: ANTHROPIC_BASE_URL решает, куда уходят запросы, а ANTHROPIC_AUTH_TOKEN — с какими учётными данными. Документация говорит про вторую прямо: именно эта переменная кладёт ключ в заголовок Authorization, а шлюз читает как раз этот заголовок. Поэтому, пока ваш эндпоинт говорит на протоколе Anthropic и авторизует по заголовку Authorization, интеграция работает без правок клиентского кода.
Задокументированные варианты и изменение 2.1.285 (проверено 2026-10-07)
Первая — переменные окружения: ANTHROPIC_BASE_URL со значением вашего эндпоинта и ANTHROPIC_AUTH_TOKEN с учётными данными. Вторая — блок env в settings.json с теми же именами ключей. Документация описывает и apiKeyHelper: команду, которую Claude Code выполняет, чтобы получить учётные данные, вместо чтения из статической переменной; это подходит там, где требуется ротация. Есть также разделы про добавление моделей шлюза в выбор моделей и про отключение трафика вне пути шлюза — их стоит прочитать при корпоративном внедрении. Дополнение 2026-10-07: запись в журнале изменений Claude Code 2.1.285 (выпуск 2026-09-29) звучит так: «Changed sessions behind a custom ANTHROPIC_BASE_URL to use the 1M context window of models that have one (Opus 4.7+, Sonnet 5+, Fable); run /autocompact 200k if your gateway stops at 200K». Страница настройки моделей добавляет, что Claude Code не может обнаружить более низкий лимит, который задаёт шлюз или сервер за ним.
Три шага подключения
Задайте две переменные: ANTHROPIC_BASE_URL с эндпоинтом и ANTHROPIC_AUTH_TOKEN с учётными данными. Сначала попробуйте в чистой оболочке, а не сразу в глобальной конфигурации.
Отправьте один минимальный запрос и проверьте, что возвращаемая модель совпадает с запрошенной — заодно узнаете, нет ли между вами переписывающего слоя.
Когда всё стабильно, закрепите: перенесите в блок env файла settings.json или в CI подставляйте из хранилища секретов (задокументированная схема передаёт учётные данные из секретов в ANTHROPIC_AUTH_TOKEN). Если нужна ротация — переходите на apiKeyHelper.
Что задокументировано у Anthropic vs что спрашивать у провайдера эндпоинта
Задокументировано у Anthropic
① Роль ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN. ② Что учётные данные передаются в заголовке Authorization. ③ Что блок env в settings.json — равнозначная вторая форма. ④ Что apiKeyHelper получает учётные данные командой вместо статической переменной. ⑤ Что облачные сессии (веб-версия) и Claude Code в Slack не входят в шлюзовое развёртывание, а переменные шлюза, заданные в окружении облачной сессии, не применяются. ⑥ С Claude Code 2.1.285 модели с окном 1M (Opus 4.7+, Sonnet 5+, Fable) за своим ANTHROPIC_BASE_URL работают с 1M, а при шлюзе до 200K советуют /autocompact 200k (формулировка журнала изменений, проверено 2026-10-07).
Спрашивать у провайдера эндпоинта
Нужен ли базовому URL суффикс пути, какие идентификаторы моделей обслуживаются, поддерживаются ли контекст 1M и кэш, каков потолок параллелизма — всё это зависит от эндпоинта, и документация Anthropic за него не отвечает. При 404 первым делом сверьте путь в базовом URL с документацией провайдера; при 401 убедитесь, что учётные данные едут именно в заголовке Authorization. Особенно уточните лимит контекста: с 2.1.285 Claude Code за своим эндпоинтом рассчитывает на 1M, но не видит более низкий лимит шлюза; если шлюз держит 200K, выполните /autocompact 200k, как советует документация.
Два места для настройки
Переменные окружения
Меняются быстрее всего и подходят для первой удачной попытки. Минус в том, что их легко потерять — другой терминал или другой CI-раннер, и их нет, — а учётные данные лежат в окружении процесса. Годится для проверки и разовых задач.
Блок env в settings.json
Едет вместе с конфигурацией и не зависит от состояния текущей оболочки, поэтому подходит для закрепления. Учётные данные при этом лежат на диске в открытом виде, так что при необходимости ротации или запрета на запись на диск используйте apiKeyHelper: команду, которую Claude Code вызывает за учётными данными.
Три типичные точки затыка
① Задано, но не действует: убедитесь, что переменная видна тому процессу, который вы реально запускаете, и что её не перекрывает одноимённый ключ в settings.json — когда есть и то и другое, решает фактический порядок загрузки. ② Не действует в веб-версии или облачных сессиях: это задокументированное поведение — в текущей документации по шлюзам сказано, что облачные сессии не входят в шлюзовое развёртывание и заданные там переменные шлюза не применяются. ③ Странно ведут себя функции, завязанные на личность аккаунта: в документации отмечено, что сессия, авторизованная через ANTHROPIC_AUTH_TOKEN, может получить результат проверки доступности, расходящийся с настройкой организации, потому что эта проверка требует входа на claude.ai или ключа Anthropic API.
Как это устроено в QCode
На 2026-10-07 документация QCode говорит, что для Claude Code нужны ровно эти две переменные: ANTHROPIC_BASE_URL = https://api.qcode.cc/api (без слеша в конце) и ANTHROPIC_AUTH_TOKEN = ключ, начинающийся с cr_; инструмент, который читает только ANTHROPIC_API_KEY, работает с тем же ключом cr_. Модели Claude работают только через эндпоинт с протоколом Anthropic. Эта страница ничего не обещает о лимите контекста моделей в QCode; при ошибке превышения контекста следуйте официальному совету Claude Code и снизьте порог через /autocompact. После подключения сразу сделайте две вещи: отправьте минимальный запрос и сверьте модель в ответе с запрошенной, затем один раз сверьте usage со списаниями. Оплата за токены, цены моделей — на /models.
Что меняется, когда ANTHROPIC_BASE_URL указывает на шлюз
Обе оговорки стоят в официальном пункте про ANTHROPIC_BASE_URL, и условие одно: значение указывает на хост не первой стороны. QCode — именно такой хост, значит обе верны и для этого маршрута.
Поиск инструментов MCP по умолчанию выключен
В официальном пункте всё прямо: если переменная указывает на хост не первой стороны, поиск инструментов MCP по умолчанию отключён; если прокси пересылает блоки tool_reference — выставьте ENABLE_TOOL_SEARCH=true и проверьте один раз. Где не пересылает, вы теряете только это ускорение, обычные вызовы инструментов и сообщения не затрагиваются. Проверено 2026-10-07.
Remote Control отключается
Тот же документ: начиная с v2.1.196 Remote Control не работает, если переменная указывает на хост, отличный от api.anthropic.com — ровно как на Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry. Если ведёте удалённые сессии с телефона, считайте это известной границей, а не поломкой. Проверено 2026-10-07.
Заголовок, с которым уходит ключ
Официальное разделение: если команда шлюза говорит bearer token или Authorization header — ставите ANTHROPIC_AUTH_TOKEN; если API key или x-api-key — ставите ANTHROPIC_API_KEY; если не сказали ничего, документ советует начать с ANTHROPIC_AUTH_TOKEN и проверить минимальным запросом, меняться ли. QCode принимает и то и другое — вопрос только в выбранной переменной. Проверено 2026-10-07.
Все три пункта взяты из записи про ANTHROPIC_BASE_URL и страницы подключения LLM-шлюза в документах Anthropic, проверено 2026-10-07; оба поведения следуют за версией Claude Code, поэтому авторитет — за живыми документами.
Частые вопросы
Какой минимальный набор переменных?
Две: ANTHROPIC_BASE_URL для эндпоинта и ANTHROPIC_AUTH_TOKEN для учётных данных. В документации сказано, что вторая — это как раз та переменная, что помещает ключ в заголовок Authorization.
Нужен ли базовому URL суффикс пути?
Зависит от эндпоинта; документация Anthropic за него не отвечает. Быстрее всего решить это, написав так, как указано в документации провайдера, и отправив один минимальный запрос: если пришёл 404, первым делом проверяйте путь. Для QCode в документации указано https://api.qcode.cc/api, без слеша в конце.
Можно ли обойтись без переменных окружения?
Да — впишите те же ключи в блок env файла settings.json. Если нужна ротация или вы не хотите держать учётные данные на диске в открытом виде, используйте apiKeyHelper: команду, которую Claude Code выполняет, чтобы их получить.
Почему в веб-версии настройка не действует?
Это задокументированное поведение. На 2026-10-07 в официальной документации по шлюзам сказано: Claude Code в Slack и облачные сессии (веб-версия) не входят в шлюзовое развёртывание, а переменные шлюза, заданные в конфигурации окружения облачной сессии, не применяются; если трафик обязан идти через ваш шлюз, не включайте эти поверхности для таких пользователей. В версии, полученной 2026-09-22, было ещё сказано, что оба always use Anthropic's API (всегда используют API Anthropic); в текущей документации этой части фразы нет.
Как настроить это в CI?
Задокументированная схема передаёт учётные данные из хранилища секретов в ANTHROPIC_AUTH_TOKEN, а базовый URL задаётся как обычно. Не кладите учётные данные в конфигурационный файл в репозитории — это ничем не отличается от вшивания их в код.
Что проверить первым делом после подключения?
Что возвращаемая в ответе модель — та, которую вы запросили. Если в ней появился префикс, суффикс или имя провайдера, которых не было в запросе, между вами есть переписывающий слой. Само по себе это не плохо, но определяет, как потом трактовать строки счёта.
Источники
Назначение двух переменных окружения, в каком заголовке уходят учётные данные, форма блока env в settings.json, определение apiKeyHelper и то, что облачные сессии не идут через шлюз: документация Anthropic «Connect Claude Code to an LLM gateway» (code.claude.com/docs/en/llm-gateway-connect, впервые получена 2026-09-02, перепроверена 2026-10-07). Запись ANTHROPIC_BASE_URL: страница переменных окружения Claude Code (получена 2026-10-07). 1M контекста и /autocompact 200k: журнал изменений Claude Code (CHANGELOG.md в репозитории anthropics/claude-code на GitHub, запись 2.1.285) и страница настройки моделей; дата выпуска — из GitHub Releases того же репозитория; всё получено 2026-10-07. Настройка QCode: страницы о переменных окружения и эндпоинтах на docs.qcode.cc (получены 2026-10-07). Форма пути, доступные модели и лимиты конкретного эндпоинта зависят от провайдера; эта страница не отвечает за него.
Две переменные — сначала в чистой оболочке
Как только заработало, проверьте эхо модели и сверьте usage, и только потом закрепляйте в конфигурации.
Читайте также
Cline с OpenAI-совместимым эндпоинтом
Как выглядит настройка своего эндпоинта в клиенте другого класса.
Ежемесячные API-кредиты Claude Max и Team
С 2026-10-07: $100 / $200 / до $500, получение через организацию Console, без Claude Code, без переноса.
Claude Code в Японии: практическое руководство
Способы оплаты (карта, Apple Pay, Google Pay, криптовалюта), документация на японском и настройка ANTHROPIC_BASE_URL.
Цитируемая официальная документация последний раз проверена 2026-10-07 и может обновляться; приоритет у страниц Anthropic. Форма пути, набор моделей и лимиты конкретного эндпоинта определяются документацией его провайдера; какие модели есть — смотрите на /models.