SpyBara
Go Premium

authentication.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 57 additions and 57 deletions.

2026
Thu 1 23:59 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Sun 11 23:57 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57 Thu 29 23:57 Fri 30 23:01

Аутентификация

Войдите в Claude Code и настройте аутентификацию для отдельных пользователей, команд и организаций.

Claude Code поддерживает несколько методов аутентификации в зависимости от вашей конфигурации. Отдельные пользователи могут войти с помощью учетной записи claude.ai, а команды могут использовать Claude for Teams или Enterprise, Claude Console или облачного провайдера, такого как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

Вход в Claude Code

После установки Claude Code выполните claude в терминале. При первом запуске Claude Code открывает окно браузера для входа, за исключением, например, следующих случаев, когда запрос на вход можно пропустить:

  • API-ключ: вы задали переменную окружения ANTHROPIC_API_KEY и одобрили этот ключ, когда Claude Code спросил, использовать ли его
  • Предыдущий вход: вы выполнили claude auth login в оболочке до первой сессии или пересобрали dev-контейнер, который хранит ваши учётные данные в томе. Если запрос на вход всё равно появляется, проверьте, что может быть причиной.

Если браузер не открывается автоматически, нажмите c, чтобы скопировать URL для входа в буфер обмена, а затем вставьте его в браузер.

Если после входа браузер показывает код входа вместо перенаправления обратно, вставьте его в терминал в ответ на запрос Paste code here if prompted. Это происходит, когда браузер не может связаться с локальным callback-сервером Claude Code, что часто бывает в WSL2, SSH-сессиях и контейнерах.

Когда вход завершится, терминал покажет Login successful и предложит нажать Enter, чтобы продолжить.

Вы можете пройти аутентификацию с любым из следующих типов учётных записей:

  • Подписка Claude Pro или Max: войдите с помощью своей учётной записи claude.ai. Оформить подписку можно на claude.com/pricing.
  • Claude for Teams или Enterprise: войдите с помощью учётной записи claude.ai, на которую вас пригласил администратор вашей команды.
  • Claude Console: войдите с помощью своих учётных данных Console. Сначала администратор должен пригласить вас. Вы можете войти как с созданием API-ключа, так и без него.
  • Облачные провайдеры: если ваша организация использует Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, задайте необходимые переменные окружения перед запуском claude или выберите 3rd-party platform в запросе на вход — это запустит интерактивный мастер настройки для Bedrock и Vertex AI. Вход через браузер не требуется.
  • Облачный шлюз: если ваша организация использует собственный шлюз приложений Claude, войдите через корпоративный SSO с помощью /login. Токен, выданный шлюзом, является единственными учётными данными сессии.

Администраторы могут определять, какой способ входа используют разработчики, и требовать, чтобы входы через claude.ai принадлежали определённой организации; см. Ограничение входа вашей организацией.

Чтобы выйти и пройти аутентификацию заново, введите /logout в промпте Claude Code. Выход также сбрасывает состояние первоначальной настройки, поэтому при следующем запуске claude вы снова пройдёте через вход и настройку.

Если у вас возникли проблемы со входом, см. устранение неполадок аутентификации.

Запрос на вход появляется, несмотря на предыдущий вход

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

  • Истёкший вход: срок действия вашего предыдущего входа истёк, и Claude Code не может его обновить. Войдите снова в ответ на запрос.
  • Вход ограничен организацией: администратор задал forceLoginOrgUUID в управляемых настройках, чтобы требовать вход из определённых организаций. Запрос появляется независимо от того, принадлежит ли ваша учётная запись одной из них. Войдите с учётной записью из требуемой организации. Если у вас её нет, попросите администратора добавить вас.
  • Обязательный способ входа: ваш вход не того типа, который требует forceLoginMethod в файле настроек. При значении "claudeai" API-ключ от предыдущего входа в Claude Console не считается существующим входом. При значении "console" не считается учётная запись claude.ai. Войдите с учётной записью того типа, который указан в этой настройке.
  • Старая версия: до v2.1.290 запрос появлялся во время настройки независимо от того, выполнен ли вход. Обновите Claude Code, чтобы пропустить его.

Вход с несколькими учётными записями

Чтобы оставаться в системе одновременно в нескольких учётных записях, например рабочей и личной, выделите каждой учётной записи собственный каталог конфигурации. При запуске claude задайте переменную окружения CLAUDE_CONFIG_DIR, указав каталог нужной учётной записи. У каждого каталога свои настройки, история сессий и вход claude.ai или API-ключ. Например, в Bash или Zsh добавьте этот псевдоним в ~/.bashrc или ~/.zshrc, чтобы claude-work использовал вашу рабочую учётную запись, а claude — личную:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Когда вы откроете новый терминал и впервые выполните claude-work, Claude Code проведёт вас через вход и настройку для нового каталога. Отдельные каталоги не разграничивают два входа в Claude Console без API-ключа: такие входы не остаются независимыми друг от друга, поскольку Claude Code хранит этот тип входа вне каталога конфигурации.

Настройка аутентификации команды

Для команд и организаций вы можете настроить доступ к Claude Code одним из следующих способов:

Claude for Teams или Enterprise

Claude for Teams и Claude for Enterprise обеспечивают лучший опыт для организаций, использующих Claude Code. Члены команды получают доступ как к Claude Code, так и к Claude в веб-версии с централизованным выставлением счетов и управлением командой.

  • Claude for Teams: самостоятельный план с функциями сотрудничества, инструментами администратора, SSO, управлением выставлением счетов и параметрами, управляемыми сервером для конфигурации Claude Code на уровне организации. Лучше всего подходит для небольших команд.
  • Claude for Enterprise: добавляет захват домена, разрешения на основе ролей и API соответствия. Лучше всего подходит для крупных организаций с требованиями безопасности и соответствия.

1. Подписка

Подпишитесь на Claude for Teams или свяжитесь с отделом продаж для Claude for Enterprise.

2. Пригласить членов команды

Пригласите членов команды из панели администратора.

3. Установка и вход

Члены команды устанавливают Claude Code и входят со своими учетными записями claude.ai.

Claude Console аутентификация

Для организаций, которые предпочитают выставление счетов на основе API, вы можете настроить доступ через Claude Console.

1. Создать или использовать учётную запись Console

Используйте существующую учётную запись Claude Console или создайте новую.

2. Добавить пользователей

Вы можете добавить пользователей одним из двух способов:

3. Назначить роли

При приглашении пользователей назначьте одну из следующих ролей:

  • Роль Claude Code: пользователи могут создавать только API-ключи Claude Code
  • Роль Developer: пользователи могут создавать API-ключи любого вида

4. Пользователи завершают настройку

Каждый приглашённый пользователь должен:

Вход без ключа API

Вы можете войти в свою учетную запись Console без создания ключа API, даже если ваша организация не позволяет разработчикам их создавать. Выберите учетную запись Anthropic Console в приглашении /login и Claude Code спросит, как вы хотите войти. Требуется Claude Code v2.1.242 или позже. Оба маршрута подписывают вас в Console в браузере и отличаются тем, что Claude Code сохраняет впоследствии:

  • Вход с вашей учетной записью Console, помечено как (recommended): Claude Code сохраняет токен OAuth из этого входа и сохраняет его как профиль Anthropic. Он не создает ключ API
  • Создать ключ API, помечено как (legacy): Claude Code создает ключ API Console для вас и сохраняет его с вашими другими учетными данными

На практике профиль хранит вход OAuth, а API-ключ — это статические учётные данные. Claude Code автоматически обновляет вход профиля, а если обновление не удаётся, запросы завершаются ошибкой истёкшего входа профиля, пока вы снова не войдёте.

Вы не получаете выбор на каждой машине. Claude Code создает ключ API без запроса в этих случаях:

  • Вы работаете с облачным провайдером, таким как Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry или Claude Platform on AWS
  • Любой файл параметров устанавливает forceLoginOrgUUID, или устанавливает forceLoginMethod на "claudeai" или "console"
  • На вашей машине существует источник управляемых параметров, такой как файл управляемых параметров, профиль MDM или кэшированные параметры, управляемые сервером, но Claude Code не может его прочитать и никакой другой управляемый источник не предоставляет политику

Отмените установку ANTHROPIC_API_KEY перед входом без ключа.

После входа без ключа у вас есть профиль вместо сохраненного ключа API:

  • Какой профиль он записывает: Claude Code записывает профиль, названный ANTHROPIC_PROFILE, или ваш активный профиль, или default. Если этот профиль является профилем федерации, Claude Code отказывает в входе вместо его перезаписи
  • Из чего он вас выходит: Claude Code выходит из любого входа claude.ai, сохраненного на машине
  • Как это отменить: запустите /logout, который удаляет и отзывает учетные данные, которые этот вход записал

Все остальное о профилях применяется к этому входу, включая его ранжирование по сравнению с вашими другими учетными данными, строку Profile, которую вы получаете в /status, и функции, которые требуют входа claude.ai. См. Профили Anthropic и учетные данные федерации.

Аутентификация облачного провайдера

Для команд, использующих Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry:

1. Следуйте настройке провайдера

Следуйте документации Amazon Bedrock, документации Google Cloud's Agent Platform или документации Microsoft Foundry.

2. Распределить конфигурацию

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

3. Установить Claude Code

Пользователи могут установить Claude Code.

Ограничить вход в вашу организацию

Чтобы требовать, чтобы входы claude.ai разработчиков принадлежали определенной организации Anthropic, установите forceLoginMethod и forceLoginOrgUUID в управляемых параметрах. Установите forceLoginOrgUUID на ваш ID организации, показанный в параметрах администратора claude.ai для организаций Claude for Teams или Enterprise. Claude Code сообщает об ошибке для входа claude.ai в любую другую организацию и выходит при запуске, если используемые учетные данные claude.ai принадлежат организации, которая не указана в списке.

Для входов Claude Console, Claude Code использует forceLoginOrgUUID для предварительного выбора организации на странице входа Console, когда вы устанавливаете его на один ID организации Console, показанный на platform.claude.com/settings/organization. Он не проверяет, какой организации принадлежат полученные учетные данные Console, при входе или при запуске. Разработчик, который вошел с учетной записью Console до развертывания ключей, остается в системе, и этот сохраненный ключ блокируется на машине, которая также требует входа шлюза или в сеансе, который выбирает облачного провайдера.

Если вы установите forceLoginOrgUUID в любом файле параметров, Claude Code прекратит предлагать вход в Console без ключа в сеансах, к которым применяется этот файл, и вместо этого создаст ключ API. Чтобы направить разработчиков на вход claude.ai, установите forceLoginMethod на "claudeai".

На Claude Code v2.1.212 или позже каждый путь входа, указанный здесь, применяет forceLoginMethod. На интерактивном экране входа терминала, доступном через /login или первоначальную настройку, Claude Code предварительно выбирает метод claudeai или console без его принудительного применения, поэтому даже с установленным forceLoginMethod на "claudeai", разработчик все еще может завершить вход Console там.

Пути отличаются на forceLoginOrgUUID:

  • Входы терминала, расширения VS Code и Agent SDK: проверяют forceLoginOrgUUID для входов учетной записи claude.ai
  • claude setup-token и /install-github-app: применяют только forceLoginMethod, поэтому они могут создать токен в другой организации
  • Вход шлюза: выбирается forceLoginMethod: "gateway" вместо ограничения им, и не аутентифицируется против организации Anthropic, поэтому forceLoginOrgUUID не применяется; используйте поставщика удостоверений вашего шлюза для ограничения доступа

Развертывайте ключи через инструменты управления устройствами. Параметры, управляемые сервером, достигают только учетных записей, которые уже аутентифицированы в вашей организации, поэтому они не могут перенаправить первый вход разработчика. Если ваша организация также распределяет параметры, управляемые сервером, установите ключи в обоих местах: управляемые источники не объединяются, и кэшированные параметры, управляемые сервером, заменяют файл, управляемый устройством, за исключением нескольких исключений для каждого ключа. forceLoginOrgUUID и значения "claudeai" и "console" forceLoginMethod не входят в эти исключения, поэтому держите их в обоих местах.

При развертывании шлюза также держите forceLoginMethod и forceLoginOrgUUID вне параметров, которые служит шлюз.

Ключи также определяют, может ли сеанс, который не использует учетные данные входа, начаться. См. forceLoginOrgUUID в справочнике параметров для полного поведения.

  • ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper: заблокировано при запуске. При forceLoginOrgUUID членство в организации не может быть проверено для учетных данных окружения, и при forceLoginMethod учетные данные будут служить вместо требуемого входа. Когда управляемые параметры также требуют входа шлюза, Claude Code блокирует ключ API, сохраненный более ранним входом Claude Console, таким же образом. См. Политика администратора требует входа облачного шлюза
  • Сеансы облачного провайдера, такие как Amazon Bedrock: блокируются только при наличии учетных данных ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper, или ключа API, сохраненного более ранним входом Claude Console, на машине. Удалите его и сеанс начнется. Эти сеансы аутентифицируются против вашего облачного провайдера, политики доступа которого их регулируют
  • Профиль Anthropic или учетные данные федерации: не блокируются, если только учетные данные ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper, или ключ API, сохраненный более ранним входом Claude Console, также не присутствуют на машине. Ключи не проверяют, какой организации принадлежит профиль

Ограничить, какие поставщики API может использовать машина

allowedProviders в управляемых параметрах перечисляет, какие сервисы управляемая машина может использовать для доступа к Claude, такие как Anthropic API, Amazon Bedrock или шлюз LLM. Он дополняет forceLoginMethod и forceLoginOrgUUID, которые управляют тем, какую учетную запись использует сеанс при разговоре с Anthropic. Требуется Claude Code v2.1.285 или позже.

{
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],
  "allowedProviders": ["anthropic", "bedrock"]
}

С этим файлом разработчик, вошедший в вашу организацию claude.ai или настроенный для Amazon Bedrock, запускается нормально. Сеанс, настроенный для любого другого провайдера, отказывается при запуске, и работающий сеанс, который переключается на один, отказывается при следующем запросе. Управляемые параметры не позволяют этому поставщику API показывает каждое сообщение.

  • Разрешить шлюз LLM или прокси: перечислите "customEndpoint" и установите URL шлюза в управляемом блоке env того же источника. Справочник параметров перечисляет каждое значение и говорит, какие переменные конечной точки требуют управляемого закрепления env.
  • Развертывание на управляемых машинах: поместите список в управляемый источник, который несет остальную часть вашей политики. Примечание Scope записи говорит, как управляемый список сервера объединяется с ним.
  • Только параметры, управляемые сервером: список, который вы устанавливаете только в параметрах, управляемых сервером, достигает только сеансов, которые получают параметры вашей организации, поэтому рассматривайте его как удобство для машин, которые вы не можете достичь с помощью управления устройствами, а не как принудительное применение. Доступность платформы перечисляет, какие сеансы их получают.

Управление учетными данными

Claude Code безопасно управляет вашими учетными данными аутентификации:

  • Место хранения:
    • На macOS учетные данные хранятся в зашифрованной цепочке ключей macOS Keychain. Когда Keychain отклоняет запись, например когда она заблокирована в сеансе SSH, Claude Code вместо этого сохраняет ваш вход в ~/.claude/.credentials.json с режимом файла 0600, то же хранилище, которое он использует на Linux. Вход через Console, который создает ключ API, завершается ошибкой до тех пор, пока Keychain не станет доступным для записи. Чтобы переместить ваш вход обратно в Keychain, следуйте шагам восстановления.
    • На Linux учетные данные хранятся в ~/.claude/.credentials.json с режимом файла 0600.
    • На Windows учетные данные хранятся в %USERPROFILE%\.claude\.credentials.json и наследуют элементы управления доступом из каталога профиля пользователя, что по умолчанию ограничивает доступ к файлу вашей учетной записью.
    • Если вы установили переменную окружения CLAUDE_CONFIG_DIR, Claude Code хранит файл .credentials.json в этом каталоге вместо этого, включая файл, который записывает резервный вариант macOS, и также привязывает запись macOS Keychain к этому каталогу, поэтому сеанс с другим CLAUDE_CONFIG_DIR читает другую запись.
    • Claude Code управляет .credentials.json через /login и /logout. Чтобы маршрутизировать запросы через пользовательскую конечную точку API, установите переменную окружения ANTHROPIC_BASE_URL.
  • Поддерживаемые типы аутентификации: учетные данные claude.ai, учетные данные Claude API, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, учетные данные профиля Anthropic и Workload Identity Federation, а также токены сеанса Claude apps gateway.
  • Пользовательские скрипты учетных данных: настройте параметр apiKeyHelper для запуска скрипта оболочки, который возвращает ключ API.
  • Интервалы обновления: смотрите apiKeyHelper для случаев, в которых Claude Code повторно запускает помощник.
  • Уведомление о медленном помощнике: если apiKeyHelper требует более 10 секунд для возврата ключа, Claude Code отображает предупреждающее уведомление в строке приглашения, показывающее прошедшее время. Если вы видите это уведомление регулярно, проверьте, можно ли оптимизировать ваш скрипт учетных данных.
  • Сбои помощника: когда скрипт завершается с ошибкой, истекает время ожидания или не выводит ничего, запросы завершаются с ошибкой Your apiKeyHelper script is failing в течение трех попыток.

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

Обновление истекающего входа

Когда вход, созданный с помощью /login, находится в пределах трех дней до истечения срока действия, Claude Code показывает предупреждение при запуске: Your login expires in 3 days · run /login to renew.

Запустите /login для обновления. Предупреждение носит информационный характер и никогда не блокирует запрос: аутентификация продолжает работать до фактического истечения срока действия входа.

После истечения срока действия сохраненного входа и невозможности его обновления каждый запрос модели завершается с ошибкой Login expired · Please run /login до тех пор, пока вы снова не войдете.

Вы можете проверить это состояние перед тем, как запрос завершится ошибкой: /status показывает строку Login, читающую Expired — log in again, плюс организацию и адрес электронной почты, которые он сохранил для истекшего входа. Строка появляется только когда сохраненный вход claude.ai является активным учетным данием. Строка требует Claude Code v2.1.210 или позже.

Предупреждение появляется только когда вход claude.ai является активным учетным данием, а не когда облачный провайдер, ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper предоставляет учетные данные.

Раннее обновление наиболее важно для сеансов, которые работают без присмотра. Фоновый сеанс в представлении агента или сеанс Remote Control, который пережил вход, прекращает прогресс после истечения срока действия учетных данных и не может восстановиться, пока вы снова не войдете.

Приоритет аутентификации

Когда присутствуют несколько учетных данных, Claude Code выбирает одно в этом порядке:

  1. Учетные данные облачного провайдера, когда установлены CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX или CLAUDE_CODE_USE_FOUNDRY. Смотрите интеграции третьих сторон для настройки.
  2. Переменная окружения ANTHROPIC_AUTH_TOKEN. Отправляется как заголовок Authorization: Bearer. Используйте это при маршрутизации через шлюз LLM или прокси, который аутентифицируется с помощью токенов-носителей, а не ключей API Anthropic.
  3. Переменная окружения ANTHROPIC_API_KEY. Отправляется как заголовок X-Api-Key. Используйте это для прямого доступа к API Anthropic с ключом из Claude Console. В интерактивном режиме вам предлагается один раз одобрить или отклонить ключ, и ваш выбор запоминается. Чтобы изменить его позже, используйте переключатель "Use custom API key" в /config. Переключатель появляется только при установке ANTHROPIC_API_KEY в вашей среде. В неинтерактивном режиме (-p) ключ всегда используется при наличии.
  4. Выход скрипта apiKeyHelper. Используйте это для динамических или ротирующихся учетных данных, таких как краткосрочные токены, полученные из хранилища.
  5. Переменная окружения CLAUDE_CODE_OAUTH_TOKEN. Долгоживущий токен OAuth, созданный claude setup-token. Используйте это для конвейеров CI и скриптов, где вход через браузер недоступен. Если вы запустите /login при установленной переменной, Claude Code переключит текущий сеанс на новый вход, но будет читать переменную снова в каждом новом сеансе, пока вы не удалите ее из профиля оболочки или блока env файла параметров.
  6. Учетные данные профиля Anthropic и федерации, учетные данные, которые используют CLI ant и Workload Identity Federation. Профиль, который написал ant auth login, ранжируется здесь только когда вы называете его в ANTHROPIC_PROFILE; в противном случае он ранжируется ниже /login. Смотрите Профили Anthropic и учетные данные федерации.
  7. Учетные данные OAuth подписки из /login. Это значение по умолчанию для пользователей Claude Pro, Max, Team и Enterprise.

Подписанный сеанс Claude apps gateway находится вне этого списка: это выбор провайдера, как Amazon Bedrock или Google Cloud's Agent Platform, и он имеет приоритет над ними. Когда существует сеанс шлюза, CLI аутентифицируется с помощью токена шлюза, даже если установлены CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX или CLAUDE_CODE_USE_FOUNDRY, и источники учетных данных выше, такие как токен-носитель, ключ API, apiKeyHelper и профили, не используются.

Если управляемые параметры вашей машины устанавливают forceLoginMethod на "gateway" или устанавливают forceLoginGatewayUrl, и вы не выбираете облачного провайдера через переменную, такую как CLAUDE_CODE_USE_BEDROCK или CLAUDE_CODE_USE_VERTEX, ваш сеанс использует только вход через шлюз. Claude Code пропускает другие источники учетных данных и просит вас войти с помощью /login. Смотрите Administrator policy requires a Cloud gateway sign-in для того, что вы видите с каждым оставшимся учетным данием. Требуется Claude Code v2.1.261 или позже, или v2.1.265 или позже на машине, которая устанавливает только forceLoginGatewayUrl.

Если у вас есть активная подписка Claude, но также установлен ANTHROPIC_API_KEY в вашей среде, Claude Code использует ключ API после одобрения. Это может привести к сбоям аутентификации, если ключ принадлежит отключенной или истекшей организации.

Запустите unset ANTHROPIC_API_KEY, чтобы вернуться к вашей подписке, и проверьте /status, чтобы подтвердить, какой метод активен. Когда вход и ключ API оба настроены, /status отмечает учетное данные, которое не используется.

Облачные сеансы всегда используют учетные данные вашей подписки. Если вы установите ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN в облачной среде, это не переопределит учетные данные вашей подписки.

Профили Anthropic и учетные данные федерации

Профиль — это именованный файл конфигурации учетных данных в вашем каталоге конфигурации Anthropic, по умолчанию ~/.config/anthropic на macOS и Linux или %APPDATA%\Anthropic на Windows. Режим аутентификации профиля — это oidc_federation когда вы настраиваете его для Workload Identity Federation (WIF) или user_oauth когда ant auth login написал его или вы вошли в учетную запись Console без ключа API.

Claude Code не читает профили или переменные федерации в bare mode, в Claude Desktop или в облачных сеансах. В этих сеансах /status не показывает строку Profile.

Claude Code проверяет три источника в этом порядке и останавливается на первом установленном. Таблица показывает, что устанавливает каждый источник и где он ранжируется против вашего учетного данного /login.

Источник Установлено Ранг против /login
Именованный профиль ANTHROPIC_PROFILE Выше, независимо от режима аутентификации профиля
Переменные федерации ANTHROPIC_FEDERATION_RULE_ID и ANTHROPIC_ORGANIZATION_ID, оба установлены Выше
Активный профиль Файл active_config в вашем каталоге конфигурации или профиль с именем default Выше когда его режим аутентификации — oidc_federation; ниже рабочего учетного данного /login когда его режим аутентификации — user_oauth

Для переменных федерации Claude Code также читает другие переменные в справочнике WIF, такие как ANTHROPIC_IDENTITY_TOKEN_FILE, когда он обменивает ваш токен идентификации. Для формата файла профиля смотрите справочник WIF.

Чтобы подтвердить, какой источник выбрал Claude Code, запустите /status. Строка Profile называет источник вместо строки Login method. Когда профиль является используемым учетным данием, строки Organization и Email показывают его учетную запись.

Когда срок действия входа профиля user_oauth истёк и Claude Code не может его обновить, запросы завершаются ошибкой об истёкшем входе профиля.

Функции, которые требуют вашего входа claude.ai, такие как соединители claude.ai и /schedule, недоступны при выборе одного из этих источников. Чтобы остановить Claude Code от выбора источника:

  • Именованный профиль или переменные федерации: отмените установку ANTHROPIC_PROFILE или отмените установку любой переменной федерации
  • Активный профиль: запустите /logout для профиля user_oauth чье текущее учетное данные вы написали войдя в учетную запись Console без ключа API, запустите ant auth logout для одного чье текущее учетное данные написал ant auth login, или удалите файл профиля из configs/ в вашем каталоге конфигурации для любого режима аутентификации

Создание долгоживущего токена

Для конвейеров CI, скриптов или других сред, где интерактивный вход через браузер недоступен, создайте однолетний токен OAuth с помощью claude setup-token:

claude setup-token

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

macOS, Linux, WSL

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Windows PowerShell

$env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

Windows CMD

set CLAUDE_CODE_OAUTH_TOKEN=your-token

Этот токен аутентифицируется с помощью вашей подписки Claude и требует план Pro, Max, Team или Enterprise. Он может только выполнять запросы модели, поэтому он не может устанавливать сеансы Remote Control или получать соединители claude.ai. Серверы MCP, которые вы настраиваете локально, все еще работают.

Bare mode не читает CLAUDE_CODE_OAUTH_TOKEN. Если ваш скрипт передает --bare, аутентифицируйтесь с помощью ANTHROPIC_API_KEY или apiKeyHelper вместо этого.