Аутентификация Claude API: Anthropic, AWS, Google и Azure
Настройте безопасный доступ к Claude API через Anthropic key, AWS IAM, Google ADC или Microsoft Entra. В статье разобраны методы авторизации для работы SDK на Linux.
Маршруты аутентификации Claude API
Аутентификация в Claude API сводится к одному решению: какие учетные данные ваш клиент передает по сети. Anthropic предлагает прямой доступ к Claude API и пять облачных платформ: Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (под управлением Google), Claude Models on Google Cloud (под управлением Anthropic) и Microsoft Foundry. Прямой API Anthropic принимает API-ключ или кратковременный токен в заголовке Authorization: Bearer, а также по-прежнему поддерживает API-ключи в устаревшем заголовке x-api-key. Amazon Bedrock поддерживает подпись запросов AWS и API-ключи Bedrock; ключи Anthropic в этой схеме не используются. Google Cloud передает кратковременный токен доступа Google. Microsoft Foundry принимает ключ, выданный Azure, или токен Microsoft Entra. В четырех разделах ниже рассматриваются эти способы настройки учетных данных, а предложения AWS и Google Cloud под управлением Anthropic описаны параллельно с их облачными аналогами.
Это руководство предназначено для интеграции SDK (комплекта средств разработки) в сервис, работающий на Linux-сервере. Если вы настраиваете инструмент командной строки Claude Code, переменные и процесс будут другими: см. настройка Claude Code для работы с Bedrock или Vertex. Если сервис еще не создан, сначала разверните его с помощью первого приложения Claude API на VPS и вернитесь сюда для настройки учетных данных.
Все приведенные ниже сведения были сверены с документацией платформы Anthropic в августе 2026 года и повторно проверены по документации каждого провайдера 16 октября 2026 года; детали доступа к моделям Bedrock были повторно проверены по документации AWS 19 октября 2026 года. Страницы Anthropic для всех четырех маршрутов, API-ключей и версий API были повторно проверены 27 октября 2026 года. Страницы Anthropic для Microsoft Foundry, обоих эндпоинтов Bedrock, маршрута под управлением Google, Claude Platform on AWS, аутентификации, Workload Identity Federation и версий API были повторно проверены 10 ноября 2026 года вместе с журналом изменений Ruby SDK. Идентификаторы моделей, цены, версии SDK и форматы эндпоинтов постоянно меняются, поэтому в данном руководстве приведены ссылки на страницы провайдеров, чтобы избежать использования устаревших значений.
Путь 1: API-ключ Anthropic
Это прямой путь, и единственный, при котором Anthropic выдает секретный ключ. Запросы отправляются к эндпоинту Messages на API-хосте Anthropic, и каждый запрос должен содержать три заголовка.
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Замените MODEL_ID на актуальный идентификатор из обзора моделей Anthropic. Корректный ответ представляет собой JSON, содержащий массив content и объект usage. Неверный или просроченный ключ возвращает HTTP 401 с кодом authentication_error. Отсутствие заголовка anthropic-version приводит к отдельной ошибке, так как этот заголовок обязателен для каждого запроса; SDK устанавливают его автоматически. По состоянию на октябрь 2026 года документация Anthropic указывает Authorization: Bearer как основной способ передачи ключа и называет x-api-key устаревшим, однако оба варианта принимаются, поэтому приведенная выше команда продолжает работать. Текущие мажорные версии SDK также передают ключ как Authorization: Bearer, поэтому прокси или шлюз, считывающий X-Api-Key, потребует изменений при обновлении. Версия 2023-06-01 в команде по-прежнему принимается; новейшая версия API Anthropic — 2026-10-21, которую эти версии SDK используют по умолчанию и которая отклоняет некоторые устаревшие параметры запроса, такие как temperature.
Создание клиента — самый короткий этап настройки, так как конструировать практически нечего. Каждый официальный SDK самостоятельно считывает ANTHROPIC_API_KEY из переменных окружения.
import os
from anthropic import Anthropic
client = Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model=os.environ["CLAUDE_MODEL"],
max_tokens=64,
messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)Рекомендуется хранить идентификатор модели в переменных окружения рядом с ключом. Имена моделей меняются по графику, который вы не контролируете, и переразвертывание кода только ради изменения одной строки — лишняя работа.
Ключи создаются в консоли, где при создании вы выбираете срок действия: предустановленные варианты 3 часа, 1 день, 7 дней или 30 дней, произвольный срок или «Никогда» (в зависимости от политики максимального срока действия в вашей организации). Срок действия фиксируется при создании и не может быть изменен позже. Anthropic отправляет уведомление создателю ключа перед истечением срока действия долгоживущего ключа, но ключ с коротким сроком действия истекает без предупреждения по электронной почте. Просроченный ключ возвращает 401 и не может быть реактивирован, поэтому решение всегда заключается в создании нового ключа.
При использовании прямого API не нужно выбирать регион, а счета выставляются напрямую вашей организации в Anthropic. Рабочие области (workspaces) позволяют ограничить ключ одним проектом — это самый прозрачный способ отслеживать расходы отдельного сервиса. Ограничивайте ключ сервера его рабочей областью при создании: ключ личного или сервисного аккаунта, не привязанный к рабочей области, должен передавать заголовок anthropic-workspace-id в каждом запросе, иначе API ответит 400 с кодом invalid_request_error. Для сервиса выбирайте ключ сервисного аккаунта, так как личный ключ перестает работать, когда создавший его сотрудник покидает организацию. О расчетах стоимости см. сравнение цен API за токен с подпиской.
Здесь стоит упомянуть еще один вариант, так как он полностью исключает использование статических секретов. Workload Identity Federation позволяет рабочей нагрузке обменять токен OpenID Connect (OIDC) от доверенного провайдера идентификации на короткоживущий токен Anthropic по адресу POST /v1/oauth/token, при этом SDK обновляет этот токен до истечения срока его действия. Никакая строка sk-ant-api... не создается и не копируется. Это решение подходит для Kubernetes, GitHub Actions и облачных ВМ, которые уже обладают идентификацией платформы. Обычный VPS, как правило, не имеет такого эмитента, поэтому для такого сервера хранение API-ключа в файле является наиболее подходящим решением, и остальная часть этого руководства рассматривает именно этот сценарий.
Путь 2: учетные данные AWS в Amazon Bedrock
В Bedrock вам не нужен ключ Anthropic. При использовании учетных данных AWS SDK подписывает каждый HTTP-запрос с помощью AWS Signature Version 4 (SigV4), а AWS определяет, разрешено ли данному субъекту вызывать модель.
pip install -U "anthropic[bedrock]"
aws sts get-caller-identityaws sts get-caller-identity выводит номер аккаунта и ARN (Amazon Resource Name) идентификатора, к которому привязаны ваши учетные данные. Запускайте эту команду перед любыми другими действиями при использовании SigV4. Для SigV4 SDK разрешает учетные данные конструктора, переменные окружения и стандартную цепочку учетных данных AWS; выбор региона происходит отдельно. В клиенте AnthropicBedrock для Python API-ключ Bedrock, переданный как api_key или через AWS_BEARER_TOKEN_BEDROCK, вызывает ValueError, если вы также передаете aws_access_key, aws_secret_key, aws_session_token или aws_profile. Без этих явных аргументов ключ выбирает аутентификацию по токену (bearer authentication) вместо цепочки учетных данных AWS. Клиент для TypeScript отдает приоритет API-ключу Bedrock перед явными учетными данными AWS. Команда STS не проверяет аутентификацию по токену.
При создании клиента меняется только класс и один аргумент.
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-east-1")AnthropicBedrock управляет интеграцией InvokeModel в Bedrock. По состоянию на октябрь 2026 года Anthropic также документирует Claude в Amazon Bedrock, конечную точку Messages API по адресу https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages для Claude Opus 4.7 и более новых моделей, доступную через клиент AnthropicBedrockMantle из того же пакета. Она поддерживает учетные данные AWS и токены Bedrock; требования к доступу к моделям различаются для этих двух конечных точек, как описано ниже.
Обратите внимание на обновление в строке pip install -U. На 27 октября 2026 года последняя версия SDK по умолчанию отправляет API версии 2026-10-21, в том числе через Bedrock. Anthropic указывает, что версии моделей с ARN, перечисленные для Claude Opus 4.6 и более ранних, не поддерживают эту версию в Bedrock и могут возвращать ошибку 400. Если сервис вызывает одну из таких моделей, оставьте SDK на текущей версии и зафиксируйте её, либо сначала переведите сервис на модель Claude 4.7 или новее.
Регион здесь — не формальность. Конечные точки Bedrock привязаны к регионам, доступные модели Claude различаются в зависимости от региона, а сам регион является частью подписи SigV4, поэтому подпись, вычисленная для одного региона, будет отклонена другим. Явно задавайте AWS_REGION в окружении сервиса, так как SDK по-разному обрабатывают отсутствие этого параметра. Согласно документации за октябрь 2026 года, клиент AnthropicBedrock для Python считывает AWS_REGION или AWS_DEFAULT_REGION, затем регион сессии boto3 или профиля AWS (включая ~/.aws/config), и вызывает ValueError, если ни один из них не определен. Клиент для TypeScript считывает AWS_REGION, при отсутствии значения переходит к us-east-1 и не считывает ~/.aws/config для определения региона. Именно поэтому AWS CLI может успешно перечислить модели Claude на той же машине, где процесс Node вызывает неверный регион: CLI прочитал ваш конфигурационный файл, а клиент — нет.
На инстансе EC2 вы привязываете роль IAM (identity and access management), и секрет никогда не попадает на диск, так как служба метаданных инстанса передает SDK временные учетные данные. VPS вне AWS не имеет ни роли инстанса, ни службы метаданных. В этом случае вы выбираете между долгосрочной парой ключей доступа пользователя IAM, хранящейся на сервере (что является секретом того же класса, что и ключ Anthropic), и федерацией: аутентификация через вашего поставщика идентификации, вызов AWS STS (security token service) и использование возвращаемых временных учетных данных. Bedrock также принимает API-ключи Bedrock — это токены, передаваемые через AWS_BEARER_TOKEN_BEDROCK. AWS документирует два типа таких ключей. Краткосрочный ключ действует до 12 часов (или меньше, если сессия, создавшая его, короче), наследует права создавшей его сущности IAM и рекомендуется AWS для продакшена. Долгосрочный ключ действует до выбранного вами срока истечения (например, 30 или 90 дней с --credential-age-days) или не истекает вовсе, если этот параметр API опущен; консоль создает под ним пользователя IAM, и AWS рекомендует его только для тестирования. Долгосрочный ключ работает только в том регионе, где был создан; использование в другом регионе возвращает Credential should be scoped to a valid region.
Счет выставляется на ваш аккаунт AWS, а не Anthropic, что обычно и является основной причиной использования этого решения. Региональные конечные точки имеют наценку 10% по сравнению с глобальной конечной точкой, согласно документации за октябрь 2026 года. Claude Platform on AWS — это отдельный продукт: им управляет Anthropic, AWS выставляет за него счет через AWS Marketplace, а аутентификация происходит через SigV4 или API-ключ, созданный в консоли AWS (ключи из консоли Claude там не работают), через клиент AnthropicAWS, который Anthropic помечает как бета-версию. Одну ошибку Bedrock стоит запомнить, так как она выглядит как проблема с правами доступа, но таковой не является: Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model.. Это маршрутизация модели, и никакое изменение учетных данных её не исправит.
Маршрут 3: учетные данные Google в Vertex AI
В документации Anthropic этот маршрут теперь называется Claude Models on Google Cloud (Google managed). Google запускает его как часть Agent Platform — это новое название для того, что выросло из Vertex AI. Хост aiplatform.googleapis.com, параметр anthropic[vertex] и класс AnthropicVertex, показанные ниже, остались без изменений.
Google Cloud использует Application Default Credentials (ADC) — фиксированный порядок поиска, которому следуют библиотеки аутентификации Google, чтобы найти учетные данные без их явного указания. ADC сначала проверяет GOOGLE_APPLICATION_CREDENTIALS, затем файл, созданный gcloud auth application-default login, а после — сервисную учетную запись, привязанную через сервер метаданных.
pip install -U "anthropic[vertex]"
gcloud auth application-default loginНа рабочей станции этот вход записывает $HOME/.config/gcloud/application_default_credentials.json, и настройка завершена. На сервере избегайте хранения учетных данных пользователя-человека; команда также поддерживает олицетворение сервисной учетной записи (impersonation). Вне Google Cloud нет сервера метаданных Google, поэтому используйте GOOGLE_APPLICATION_CREDENTIALS, чтобы указать ADC на файл конфигурации Workload Identity Federation или файл ключа сервисной учетной записи. JSON-файл ключа сервисной учетной записи — это долгоживущий секрет, который требует обращения в точности так, как описано далее в этом руководстве. Внутри Google Cloud привяжите сервисную учетную запись к VM, и тогда не потребуется защищать никакой файл. Какая бы идентификация ни была найдена ADC, ей требуется роль IAM, включающая разрешение aiplatform.endpoints.predict, например Agent Platform User (roles/aiplatform.user).
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="my-project", region="global")Две вещи меняются, если вы опускаетесь ниже уровня SDK до прямого HTTP. Идентификатор модели перемещается из тела запроса в путь URL, а anthropic_version перемещается из заголовка в тело. По состоянию на 27 октября 2026 года документация Anthropic принимает там либо vertex-2023-10-16, либо более новую версию API 2026-10-21. Учетными данными является обычный токен доступа Google. В приведенной ниже команде gcloud auth print-access-token использует собственный логин gcloud CLI, а не ADC, поэтому сначала выполните gcloud auth login или gcloud init на машине, где вы проводите тестирование.
curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Регион является аргументом первого класса. global выполняет динамическую маршрутизацию для обеспечения доступности, us и eu — это мультирегиональные идентификаторы, а имя, такое как us-east5, закрепляет за одним регионом. По состоянию на октябрь 2026 года Anthropic документирует однорегиональные эндпоинты только для Claude Sonnet 4.6 и более ранних версий; новые модели используют глобальные или мультирегиональные эндпоинты. Мультирегиональные и региональные эндпоинты стоят на 10% дороже глобальных, как задокументировано в октябре 2026 года. Биллинг осуществляется через проект Google Cloud, поэтому квоты и счета выставляет Google.
По состоянию на 27 октября 2026 года Anthropic также документирует второе предложение Google Cloud, и его структура запроса отличается. В Claude Models on Google Cloud (Anthropic managed) Anthropic сама управляет API Claude по адресу claude.googleapis.com, доступ к которому осуществляется через клиент AnthropicGoogleCloud. Аутентификация по-прежнему происходит с помощью учетных данных Google Cloud, включая ADC, но запрос выглядит как прямой API: model остается в теле, а версия передается в заголовке anthropic-version. Доступ предоставляется через собственные роли IAM (roles/claude.user и связанные с ними), настройка создает новую организацию Anthropic для проекта, а использование оплачивается через Google Cloud Marketplace. Если ваши URL-адреса запросов содержат aiplatform и заканчиваются на :rawPredict, вы используете маршрут под управлением Google, описанный в этом разделе.
Маршрут 4: Microsoft Foundry — это маршрут через Azure
Если вы искали Claude в Azure, это нужный вам раздел, и такой маршрут действительно поддерживается. Claude работает в Microsoft Foundry (ранее Azure AI Foundry), оплата производится через Azure Marketplace в единицах потребления Claude (Claude Consumption Units). Вы создаете ресурс Foundry, развертываете в нем модель Claude и обращаетесь к эндпоинту, размещенному в Azure, по адресу https://{resource}.services.ai.azure.com/anthropic/v1/*.
Работают два типа учетных данных. Первый — ключ, выданный Azure, который можно найти на вкладке Details развертывания в портале Foundry; он передается в заголовке api-key или x-api-key. Второй — токен Microsoft Entra, что является лучшим выбором для сервера, так как управление доступом на основе ролей (RBAC) в Azure позволяет контролировать, кто может вызывать эндпоинт.
ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)
curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
-H "content-type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Поле model содержит имя вашего развертывания, а не идентификатор модели. По умолчанию они совпадают, но перестают совпадать, как только вы задаете имя развертывания самостоятельно, что является частой причиной ошибки Deployment not found при корректном в остальном запросе. SDK для Python и TypeScript считывают ANTHROPIC_FOUNDRY_API_KEY и ANTHROPIC_FOUNDRY_RESOURCE из переменных окружения. Согласно документации от 10 ноября 2026 года, поддержка Foundry охватывает все семь официальных SDK: C#, Go, Java, PHP, Python, Ruby и TypeScript. Для Go используется специальный пакет foundry (go get github.com/anthropics/anthropic-sdk-go/v2/foundry), а в Ruby специальный класс Anthropic::FoundryClient появился в версии гема 2.5.0, выпущенной 4 ноября 2026 года. До этого релиза код на Ruby должен был указывать универсальному клиенту базовый URL Foundry.
Использование универсального клиента с базовым URL Foundry по-прежнему сопряжено с риском, будь то код на Ruby, написанный до версии 2.5.0, или CLI ant, который в примерах Anthropic для Foundry вызывается именно так. Если вы не передаете учетные данные универсальному клиенту явно, а в окружении установлены ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN, клиент подхватит их и отправит ваши учетные данные Anthropic на эндпоинт Microsoft. Удалите переменную или передайте ключ/токен Foundry клиенту явно. В Ruby переход на Anthropic::FoundryClient, который принимает ключ Foundry или провайдер токенов Entra, является более чистым решением. Токен доступа Entra получает случайное время жизни от 60 до 90 минут, поэтому долго работающий процесс должен обновлять его, а не получать один раз при запуске.
Как долго действуют учетные данные на вашем сервере?
Данные, на которых построен график
[
{
"label": "Anthropic key, 30-day preset",
"max_lifetime_hours": 720
},
{
"label": "Anthropic key, 7-day preset",
"max_lifetime_hours": 168
},
{
"label": "AWS STS assumed role",
"max_lifetime_hours": 12
},
{
"label": "Bedrock short-term API key",
"max_lifetime_hours": 12
},
{
"label": "Entra ID access token, default upper bound",
"max_lifetime_hours": 1.5
},
{
"label": "Federated Anthropic token, default",
"max_lifetime_hours": 1
}
]Это предельные значения и настройки по умолчанию, опубликованные каждым провайдером и актуальные на октябрь 2026 года; это не измеренные показатели. Они важны по одной причине: они показывают, как долго скомпрометированные учетные данные будут оставаться рабочими, пока вы выясняете факт утечки. Федеративный токен Anthropic в нижней части таблицы по умолчанию действует до 1 часа, при этом его время жизни ограничено удвоенным оставшимся временем жизни токена провайдера идентификации. У токена доступа Microsoft Entra нет единого значения по умолчанию: Microsoft назначает каждому случайное время жизни от 60 до 90 минут (в среднем 75), что отражено в таблице верхним пределом в 1.5 часа. Это значение по умолчанию также зависит от клиента, ресурса и того, включен ли Conditional Access в клиенте (tenant). Если и клиент, и ресурс поддерживают Continuous Access Evaluation, Entra может увеличить время жизни до 24–28 часов и отзывать токен почти в реальном времени при возникновении событий, таких как отключение учетной записи. Политика времени жизни токена в клиенте может устанавливать любое значение от 10 минут до 23:59:59. SDK автоматически обновляют федеративные токены Anthropic; в Foundry настройте провайдер токенов Entra для обновления токенов, вместо передачи фиксированной строки токена. Правило федерации может устанавливать собственное время жизни токена от одной минуты до 24 часов, а мастер подключения рабочих нагрузок в консоли по умолчанию предлагает 10 минут, поэтому проверяйте правило, а не полагайтесь на значение по умолчанию. Принятая роль (assumed role) и краткосрочный API-ключ Bedrock действуют 12 часа. Долгосрочному API-ключу Bedrock нет места в этой таблице, так как у него нет фиксированного верхнего предела: он действует до истечения срока, выбранного при создании, или не истекает вовсе, если параметр CredentialAgeDays был пропущен при вызове API, поэтому AWS рекомендует использовать его только для ознакомительных целей. Ключ, созданный с предустановкой на 30 дней, остается действительным в течение 720 часов, и именно эти учетные данные могут храниться в файле на вашем сервере в течение месяца.
Где хранить учетные данные на VPS
Поместите секрет в файл, доступный для чтения только пользователю root, и позвольте systemd передать его процессу. Этот подход не зависит от версии SDK, поэтому его стоит реализовать один раз и правильно.
sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/envФайл содержит простые строки KEY=value. Никаких export, кавычек или синтаксиса оболочки, так как systemd парсит его самостоятельно, не запуская через shell.
ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME[Unit]
Description=Claude API service
After=network-online.target
[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure
[Install]
WantedBy=multi-user.targetsystemd считывает EnvironmentFile= от имени root до того, как сменит пользователя на User=claudeapp, поэтому учетной записи сервиса не требуется доступ на чтение к этому файлу. Достаточно прав 600, принадлежащих root, именно поэтому команда install выше устанавливает такие параметры. Запустите сервис с помощью sudo systemctl enable --now claude-app, затем убедитесь командой systemctl status claude-app, что юнит перешел в состояние active (running), а не перезапускается в цикле.
Четыре вещи, которых следует избегать, и причины для каждой из них:
- Не записывайте ключ с помощью
Environment=внутри файла юнита. Юнит в директории/etc/systemd/systemдоступен для чтения всем, поэтомуsystemctl cat claude-appвыведет секрет любому локальному пользователю. - Не добавляйте файл в коммит.
.gitignoreпредотвращает добавление нового файла в коммит, но не помогает с уже закоммиченными файлами, так как история git сохраняет всё, что было передано ранее. - Не встраивайте секрет в образ контейнера. Значения
ENVсохраняются в конфигурации образа, а аргументы сборки видны в истории образа или метаданных происхождения. Удаление файла на последующем слое не удаляет его из предыдущего. Передавайте секреты во время выполнения с помощью--env-fileили смонтированного файла. - Не считайте переменные окружения процесса скрытыми от root.
sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n'выведет ключ. Сама команда чтения файла требуетsudo; перенаправление ввода оболочки выполняется доsudoи использует права вашей текущей учетной записи. Цель состоит в том, чтобы скрыть секрет от всех остальных учетных записей на сервере, а не от root, который может прочитать его в любом случае.
Последний пункт определяет границы того, что дает этот метод. Файл, доступный только root, защищает сохраненный ключ, но любой код, работающий от имени учетной записи сервиса, может прочитать переменные окружения процесса, и дочерние процессы унаследуют их. Это неподходящий контейнер, если процесс выполняет код, который вы не писали, так как всё, что может выполнить процесс, может прочитать его собственное окружение. В Как ограничить доступ AI-агента к секретам рассматривается этот случай — это другая проблема, требующая иного решения.
Как сменить ключ без простоя?
Выполните ротацию вперед, а затем отзовите старый ключ. Перезапуск сервиса, описанный ниже, вызывает кратковременный перерыв в работе; для обеспечения непрерывной доступности требуется наличие другого экземпляра, который будет обрабатывать запросы во время перезапуска.
- Создайте новый ключ в консоли, в той же рабочей области, что и старый.
- Запишите его в
/etc/claude-app/envс помощьюsudoedit. - Выполните
sudo systemctl restart claude-app. - Убедитесь, что сервис отвечает на запросы, после чего отзовите старый ключ в консоли.
EnvironmentFile считывается при запуске юнита, поэтому запущенный процесс сохраняет значение, полученное при старте. systemctl daemon-reload перезагружает файлы юнитов, но не затрагивает переменные окружения запущенного процесса, поэтому новый ключ подхватывается только после перезапуска. Отзыв ключа на этапе 1 вместо этапа 4 приведет к простою, который продлится до завершения этапа 3.
Облачные маршруты проходят ротацию на стороне провайдера. Пользователь IAM поддерживает два активных ключа доступа одновременно: создайте второй, разверните его, а затем удалите первый. Ключ сервисного аккаунта Google проходит ротацию аналогичным образом. Ресурс Foundry поддерживает два ключа, при этом повторная генерация одного из них немедленно делает старое значение нерабочим, поэтому переведите сервис на другой ключ перед тем, как перегенерировать тот, который он использовал. Токены Entra и федеративные токены Anthropic не требуют ручной ротации, и это является самым весомым аргументом в пользу их использования везде, где это возможно.
Пока вы находитесь в консоли, установите лимит расходов для рабочей области. Утечка ключа в первую очередь приводит к финансовым потерям, а в ограничении расходов агента на VPS подробно описаны соответствующие элементы управления.
Почему клиент возвращает 401 или 403?
401 с authentication_error при прямом обращении к API. Ключ неверен, отозван или истёк срок его действия. Срок действия — это то, что часто упускают из виду, так как код не менялся, а вчера запрос работал. Проверьте столбец срока действия ключа в консоли или прочитайте expires_at через Admin API, где для ключей без ограничения срока действия указано null. Персональный ключ также перестаёт работать, когда его владелец покидает организацию.
SDK игнорирует настройки федерации и использует ключ. ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN в порядке приоритета учётных данных стоят выше федерации, поэтому любой из них перекрывает её. Важный нюанс: переменная, экспортированная как пустая строка, всё равно занимает своё место, поэтому ANTHROPIC_API_KEY="" заставляет SDK аутентифицироваться с пустым ключом, вместо того чтобы перейти к следующему методу. Используйте unset ANTHROPIC_API_KEY.
401 с общим сообщением Authentication failed при федерации. Это сообщение намеренно сделано одинаковым для любой возможной причины, чтобы вызывающая сторона не могла изучить конфигурацию ваших правил через чтение текста ошибки. Истинная причина записывается на странице истории аутентификации в консоли. Начните с неё, вместо того чтобы гадать, что не так с JWT.
403 в Foundry. Токен прошёл аутентификацию, но у вашей учётной записи Azure отсутствует роль, разрешающая этот вызов. Назначьте Azure RBAC роль, например Foundry User (ранее Azure AI User) или Cognitive Services User, для идентификатора, выполняющего запрос.
Любые ошибки в Bedrock. Для аутентификации SigV4 сначала выполните aws sts get-caller-identity от имени пользователя сервиса. Это позволит понять, есть ли на сервере рабочие AWS credentials, что отделит проблему с учётными данными от проблемы с доступом к модели или несовпадением региона. По состоянию на 29 октября 2026 года AWS открывает доступ ко многим моделям при первом использовании в коммерческих регионах при наличии необходимых разрешений AWS Marketplace, но для некоторых моделей требуется отдельный доступ на уровне учётной записи. Модели Anthropic, вызываемые через маршрут InvokeModel, требуют предварительного заполнения формы использования для каждой учётной записи (или один раз для всей AWS Organization, хотя в регионах с opt-in это нужно повторить), и до её одобрения вызов возвращает AccessDeniedException. AWS указывает, что форма не применяется к эндпоинту bedrock-mantle. Первый вызов модели в учётной записи также запускает фоновую подписку Bedrock на AWS Marketplace, и для этой подписки требуется идентификатор с правами aws-marketplace:Subscribe, aws-marketplace:Unsubscribe и aws-marketplace:ViewSubscriptions. Отсутствие прав не обязательно приводит к сбою первого вызова: AWS отмечает, что вызовы могут успешно проходить до 15 минут, пока настраивается подписка, а после сбоя подписки последующие вызовы возвращают всё то же AccessDeniedException. Если сервис работал первые несколько минут, а затем начал выдавать ошибки, причина скорее всего здесь, а не в учётных данных. После предоставления прав AWS требуется до 2 минут на завершение подписки. Модель, которая не предлагается в регионе, к которому вы обращаетесь, вызовет ошибку, независимо от корректности учётных данных.
FAQ
Нужен ли мне API-ключ Anthropic для использования Claude в Bedrock или Vertex?
Нет. В Amazon Bedrock SDK подписывает запросы с помощью учетных данных AWS по протоколу SigV4 или отправляет API-ключ Bedrock, а в Google Cloud отправляет токен доступа Google, полученный через Application Default Credentials. В обеих конфигурациях секретные ключи, выданные Anthropic, не используются, а оплата за использование списывается с облачного аккаунта, а не через Anthropic. Именно поэтому наличие ключа Anthropic в ANTHROPIC_API_KEY на таких хостах представляет угрозу: стандартный клиент, направленный на облачную конечную точку, может отправить его туда.
Доступен ли Claude в Azure?
Да, через Microsoft Foundry (ранее Azure AI Foundry). Вы создаете ресурс Foundry, разворачиваете в нем модель Claude и вызываете https://{resource}.services.ai.azure.com/anthropic/v1/messages, используя либо ключ, выданный Azure в заголовке api-key, либо токен носителя Microsoft Entra. Оплата за использование производится через Azure Marketplace в единицах потребления Claude (Claude Consumption Units). Поле model в теле запроса должно содержать имя вашего развертывания. Оно совпадает с идентификатором модели только в том случае, если вы оставили имя по умолчанию при создании развертывания; изменить его впоследствии нельзя.
Где следует хранить API-ключ Claude на сервере Linux?
В файле, владельцем которого является root, с правами доступа 600, загружаемом через EnvironmentFile= в юните systemd. systemd считывает этот файл от имени root до того, как переключится на пользователя User=, указанного в юните, поэтому сервисной учетной записи доступ к файлу не требуется. Не храните ключ в репозитории, в самом файле юнита (который доступен для чтения всем и выводится командой systemctl cat), а также в конфигурации образа контейнера, его слоях и метаданных сборки.
Почему мои запросы к API Claude начали возвращать 401, хотя конфигурация не менялась?
Ключ, срок действия которого истек, возвращает ошибку 401. Срок действия устанавливается при создании, его нельзя изменить впоследствии, а ключи с коротким сроком жизни истекают без предварительного уведомления по электронной почте. Истекший ключ нельзя реактивировать, поэтому создайте новый, запишите его в файл окружения, перезапустите сервис, а затем аннулируйте старый ключ. Если вы уверены, что ключ действителен, проверьте, не перекрывается ли он устаревшими учетными данными: переменная ANTHROPIC_API_KEY, установленная в пустую строку, имеет приоритет над федеративными источниками и профилями.