Claude Code API — какой доступ не заменит подписка

По официальной документации Anthropic Claude Code, Anthropic API и подписка claude.ai — это три раздельных контура доступа, и смешивать их учётные данные небезопасно и для личного биллинга, и для командных политик организации. Дальше карта «поверхность / учётные данные / разрешённое использование», собранная из атомарных фактов документации, и объяснение, почему подмена происходит именно на уровне приоритета переменных окружения.

Вопрос оплаты моделей из России стоит отдельно от входа в Claude Code: к оплате вернёмся ниже, а начнём с путаницы учётных данных, которая ломает доступ ещё до денег.

Разберём распространённое допущение, которое кажется логичным и почти всегда неверно: любой оплаченный доступ Claude подходит Claude Code. Это не так. По документации Claude Code принимает несколько раздельных типов аккаунтов для входа: подписку Claude Pro/Max, аккаунт Claude for Teams/Enterprise, учётные данные Claude Console, облачных провайдеров (Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry) и сессию self-hosted шлюза Claude apps через корпоративный SSO. Это отдельные, невзаимозаменяемые классы учётных данных, а не один универсальный доступ к Claude.

Anthropic API устроен иначе. На platform.claude.com поддерживаются ровно два метода аутентификации: статический ключ вида sk-ant-api..., отправляемый в заголовке x-api-key, и Workload Identity Federation — короткоживущий bearer-токен, который обменивается у корпоративного IdP. Ни один из них не совпадает с потребительским логином подписки claude.ai (Pro/Max/Team). Протокол API и вход по подписке разведены на уровне запроса, даже если оплачены одной компанией.

Коммерчески они тоже не совпадают. Планы Claude Pro, Max и Team продаются как подписка с фиксированной ставкой и в описании указывают, что включают Claude Code. Anthropic API описан на platform.claude.com как метрический биллинг по токенам через ключ: абонемент против счётчика. Разработчик, который ищет api claude code, обычно ожидает единый вход, но получает два разных протокола с разной логикой оплаты.

Здесь начинается практическая часть. У Claude Code есть документированный порядок приоритета для случая, когда в окружении присутствует сразу несколько учётных данных. Сверху вниз: облачные переменные провайдеров (Bedrock, Vertex, Foundry), затем ANTHROPIC_AUTH_TOKEN, затем ANTHROPIC_API_KEY, затем вывод скрипта apiKeyHelper, затем CLAUDE_CODE_OAUTH_TOKEN из команды claude setup-token, и только на шестом месте OAuth-учётные данные подписки из /login, которые по умолчанию используются для Pro/Max/Team/Enterprise. Сессия шлюза Claude apps стоит вне этого списка, выше всех уровней.

Из этого порядка вытекает типичный сбой. Разработчик залогинен подпиской, но в окружении сохранился ANTHROPIC_API_KEY, например от прошлого проекта или общего dotfile. После подтверждения пользователем ключ перекрывает подписку, биллинг тихо переключается на тарифы API pay-as-you-go, а если организация этого ключа отключена или ключ просрочен, авторизация падает без видимой причины. Решение не в переустановке, а в проверке окружения:

Команда unset ANTHROPIC_API_KEY возвращает использование подписки, что подтверждается через /status. Поэтому при странном биллинге или внезапном отказе первый вопрос не «сломался ли инструмент», а что лежит в окружении и какой уровень приоритета сработал. Именно на этом шаге разработчик, который искал claude code api key, чтобы просто вставить ключ в проект, случайно переключает биллинг работавшей подписки: ключ подхватился по приоритету, а осознанного согласия на оплату по токенам никто не давал.

Разные поверхности читают эти переменные не одинаково. apiKeyHelper, ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN действуют на CLI и на то, что его оборачивает: расширение VS Code, Agent SDK, GitHub Actions. Claude Desktop и облачные сессии их не читают вовсе и авторизуются через OAuth. Значит, правила учётных данных различаются даже внутри одного продуктового семейства Anthropic: запрос claude code cli api и вопрос про десктоп-приложение ведут к разным правилам, хотя оба формально про Claude Code.

Теперь сведём это в одну таблицу. Она не скопирована из документации целиком: это синтез из атомарных фактов Anthropic, и его задача проста, убрать путаницу до выбора способа входа. Каждая строка привязана к первичному источнику.

Две строки таблицы стоит прочитать внимательнее. OAuth-токен, полученный командой claude setup-token, аутентифицируется подпиской пользователя и по документации требует план Pro, Max, Team или Enterprise. Он не эквивалентен API-ключу и умеет только запросы к моделям: ни сессий Remote Control, ни коннекторов claude.ai. Claude Code on the Web всегда использует учётные данные подписки, и если в этой песочнице выставить ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN, подписку это не перекроет. Это документированный случай, когда API-credential в принципе не может подменить подписочный доступ, и лучший аргумент против веры в один универсальный вход.

Хранение учётных данных тоже разведено. Claude Code перечисляет как отдельные поддерживаемые типы аутентификации: учётные данные Claude.ai, учётные данные Claude API, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth и токены сессии шлюза Claude apps. Каждый тип хранится и обновляется независимо, а не как одно общее состояние «залогинен». Поэтому фраза «я же вошёл» не отвечает на вопрос: важно, в каком именно классе и на какой поверхности.

В команде путаница масштабируется, и здесь работает управляемая настройка forceLoginMethod: администратор организации ограничивает допустимый метод входа. Её валидные значения три: "claudeai" (аккаунты Claude.ai и подписки), "console" (аккаунты Claude Console и API-биллинга) и "gateway" (облачный шлюз). Сам этот перечень значений подтверждает, что перед нами категорически разные, взаимоисключающие классы аутентификации, а не оттенки одного входа.

Ограничение работает жёстче, чем кажется на первый взгляд: forceLoginMethod вместе с forceLoginOrgUUID блокирует сессии, авторизованные через ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper, поскольку членство в организации нельзя проверить для environment-credential. Валидный API-ключ политика может отклонить как не эквивалентный проверенному подписочному логину, и это не баг, а рассчитанное поведение.

Тот же порядок приоритета переходит и в автоматизацию, которую строят поверх claude code agent. Agent SDK оборачивает CLI и подчиняется тем же переменным окружения, что и терминал, поэтому CI-джоба или бот, где собирают claude code agent sdk, наследует тот же порядок и те же риски: забытый ANTHROPIC_API_KEY в раннере молча уводит биллинг и авторизацию не туда. Командам, которые настраивают claude code agent teams в расчёте на один общий ключ для всех участников, стоит сверяться с forceLoginMethod заранее: администратор организации может этот ключ отклонить именно по описанной выше причине.

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

Если задача не сам вход в Claude Code, а доступ к моделям из совместимых клиентов и агентов, это решает другой инструмент под другим именем. Агрегатор provod.ai даёт единый API, совместимый с SDK OpenAI и Anthropic: клиент меняет только api_key и base_url, остальной код не трогает.

Оплата рублёвая: картой, через СБП или по счёту, без VPN и без зарубежной карты, а цены на модели идут по официальным ставкам провайдера, без наценки provod.ai. Важно не путать уровни: это способ платить и подключаться к моделям для совместимых инструментов, а не авторизация для самого Claude Code. Допустимые схемы входа в Claude Code определяет только Anthropic, и никакой сторонний ключ их не заменяет и не расширяет.

Для команды, а не одного разработчика, добавляется другой вопрос: как делить доступ к моделям, не нарушая корпоративную политику вроде forceLoginMethod. Здесь provod.ai предлагает командное пространство с общим балансом организации и разграничением ролей участников, а для бухгалтерии, договор, счёт и закрывающие документы от российского юрлица. Это отвечает на вопрос совместного биллинга за модели, а не на вопрос входа в Claude Code: общий ключ не имеет отношения к цепочке приоритета, разобранной выше, и не участвует в проверке forceLoginMethod.

Карта не обещает поддержку способов, которых нет в официальной документации. Если чужой гайд советует перенести сессию или вставить токен, добытый в обход, здесь такого решения нет: переносить способ авторизации с одной поверхности на другую без подтверждения документацией не стоит.

Она не покрывает будущие изменения. Документация Claude Code версионируется и активно меняется: страница аутентификации отмечает поведение, привязанное к минимальным версиям (например, v2.1.212, v2.1.208, v2.1.206, v2.1.203, v2.1.146). Всё описанное здесь верно на дату доступа 2026-07-18 и требует повторной сверки, если это окно актуальности сдвинулось.

Цены и условия планов стоит уточнять отдельно на момент решения: соответствие «план → Claude Code» получено через AI-суммирование страницы, а не из сырого HTML, поэтому оно направленно верное, но не до копейки.

Подходит ли моя подписка Claude Pro для входа в Claude Code? Да, подписка Pro/Max/Team/Enterprise входит через /login и по документации «включает Claude Code». Но если в окружении лежит API-ключ, он в приоритете и перекроет подписку после подтверждения.

Почему после установки ключа сменился биллинг? Потому что ANTHROPIC_API_KEY стоит в порядке приоритета выше OAuth подписки, и это уводит оплату на pay-as-you-go по токенам. Снять ключ: unset ANTHROPIC_API_KEY. Проверить результат: claude /status.

Можно ли OAuth-токеном из claude setup-token заменить API-ключ? Нет. Такой токен требует плана Pro/Max/Team/Enterprise и умеет только запросы к моделям, без Remote Control и коннекторов claude.ai. Это не эквивалент API-ключа.

Почему в команде мой валидный ключ не принимается? Настройка forceLoginMethod ("claudeai", "console" или "gateway") вместе с forceLoginOrgUUID может блокировать env-credential, потому что членство в организации для него не проверяется.

Даст ли provod.ai авторизацию для Claude Code? Нет. provod.ai — совместимый API для моделей с рублёвой оплатой; допустимые способы входа в Claude Code определяет только Anthropic.

Разделяй эти два контура на практике. Для входа в Claude Code бери документированный способ Anthropic. Для рублёвого доступа к моделям из совместимых клиентов и агентов, с общим балансом команды и документами для бизнеса, подключи provod.ai.

Для внутренних документов важны доступы, роли и контроль расходов: provod.ai даёт рабочие пространства, отдельные аккаунты сотрудников и централизованное управление AI. Платформа проектируется с учётом требований РФ к обработке и защите персональных данных; применимость зависит от конкретного сценария и настроек клиента.

В одном каталоге — актуальные модели для текста и медиа: GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

Корпоративный контроль не превращается в ценовой коэффициент: стоимость моделей сохраняется 1:1 с официальными тарифами, без собственной наценки provod.ai.

Изучите корпоративный контур provod.ai: форма регистрации · цены на модели · защита данных по 152-ФЗ · политика обработки данных