Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Platform on AWS — это API Claude, управляемый Anthropic, с аутентификацией AWS, контролем доступа IAM и выставлением счетов через AWS Marketplace. Запросы поступают непосредственно в API Anthropic, поэтому вы получаете те же модели и функции, что и в Claude API по тому же графику выпусков. Вы аутентифицируетесь с помощью учетных данных AWS или ключа API рабочей области, и вы платите через AWS Marketplace. Используйте это руководство, чтобы направить Claude Code на рабочую область, которую вы уже подготовили через Claude Platform on AWS. Для подписки AWS и настройки рабочей области, которые предшествуют этому, см. документацию Claude Platform on AWS.
Подписка через AWS Marketplace подготавливает новую организацию Anthropic, привязанную к вашей учетной записи AWS. Эта организация отделена от любой организации, которая у вас уже есть в Anthropic, и учетные данные не передаются между ними. Используйте идентификатор рабочей области и ключи API из организации, связанной с AWS, а не из предварительно существующей учетной записи Claude Console.

​
Предварительные требования

Перед настройкой Claude Code вам потребуется:
  • Активная подписка Claude Platform on AWS через AWS Marketplace
  • Рабочая область в вашей организации Anthropic, связанной с AWS, с ее идентификатором рабочей области
  • Субъект IAM с разрешением на вызов сервиса Anthropic или ключ API, ограниченный рабочей областью
  • Учетные данные AWS в вашей среде, в ~/.aws/credentials или от присоединенной роли IAM, если вы хотите аутентификацию SigV4. AWS CLI требуется только для потока входа SSO.

​
Настройка

​
1. Настройте учетные данные AWS

Claude Code поддерживает два метода аутентификации для Claude Platform on AWS. Выберите метод, который соответствует тому, как ваша команда управляет доступом. Вариант A: учетные данные AWS с SigV4 Claude Code подписывает запросы с помощью SigV4, используя стандартную цепочку учетных данных AWS: переменные окружения, общие учетные данные в ~/.aws/credentials, роли IAM, сеансы AWS SSO и любые другие источники, которые поддерживает AWS SDK. Для локального использования войдите с помощью AWS CLI перед запуском Claude Code. Пример ниже использует профиль SSO, но любой метод, который создает учетные данные в стандартных местоположениях, работает. 
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
Для CI и автоматизации дайте средству выполнения роль IAM с разрешением на вызов сервиса Anthropic и установите AWS_REGION. Цепочка учетных данных автоматически подхватывает роль. Если ваши учетные данные SSO истекают во время сеанса, настройте awsAuthRefresh, чтобы Claude Code повторно запустил вашу команду входа и повторил попытку вместо сбоя. Добавьте команду в ваш settings.json: 
{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}
Вариант B: ключ API рабочей области Ключ API рабочей области — это долгоживущий секрет, полезный, когда вы не хотите управлять федеративными учетными данными AWS. Создайте его в консоли AWS в разделе Claude Platform on AWS → API keys и установите его как ANTHROPIC_AWS_API_KEY: 
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx
Ключ отправляется как x-api-key и имеет приоритет над SigV4, поэтому любые учетные данные AWS в вашей среде игнорируются. Ключи API из отдельной организации Claude Console здесь не будут работать. Обращайтесь с ключами API рабочей области как с любыми другими производственными учетными данными. Файл пользовательских настроек блок env — это удобный способ ограничить ключ вашей машиной без глобального экспорта.
Команды /login и /logout не изменяют аутентификацию Claude Platform on AWS. Аутентификация выполняется через ваши учетные данные AWS или ключ API рабочей области, а не через подписку Claude.ai.

​
2. Настройте Claude Code

Установите переменные окружения, которые направляют Claude Code через Claude Platform on AWS вместо API Anthropic по умолчанию. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1
ANTHROPIC_AWS_WORKSPACE_ID является обязательным и отправляется при каждом запросе как заголовок anthropic-workspace-id. Базовый URL вычисляется из AWS_REGION как https://aws-external-anthropic.{region}.api.aws. Чтобы переопределить URL напрямую, установите ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS является добровольным, даже если учетные данные AWS присутствуют в вашей среде. Bedrock и Foundry имеют приоритет в маршрутизации поставщиков, поэтому отмените установку CLAUDE_CODE_USE_BEDROCK и CLAUDE_CODE_USE_FOUNDRY, если они установлены.

​
3. Закрепите версии моделей

Claude Platform on AWS использует те же идентификаторы моделей, что и прямой API Claude. Псевдонимы по умолчанию opus, sonnet и haiku разрешаются в последние версии, доступные в вашей рабочей области. Если вы развертываете Claude Code для команды, явно закрепите идентификаторы моделей, чтобы новый выпуск не переместил всех сразу: 
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
Полный список идентификаторов моделей и псевдонимов см. в разделе Обзор моделей. Для других переменных, связанных с моделями, см. Конфигурация модели. Prompt caching включен автоматически. Записи кэша на 1 час выставляются по более высокому тарифу, чем записи на 5 минут. Чтобы запросить TTL кэша на 1 час вместо стандартного 5 минут, установите ENABLE_PROMPT_CACHING_1H=1.

​
Используйте Agent SDK

Agent SDK читает те же переменные окружения, что и CLI, поэтому любая программа, которая порождает подпроцесс Claude Code, может нацеливаться на Claude Platform on AWS, экспортируя CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID и либо ANTHROPIC_AWS_API_KEY, либо учетные данные AWS перед вызовом. 
import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}
Этот пример полагается на окружающую цепочку учетных данных AWS для SigV4. Чтобы вместо этого аутентифицироваться с помощью ключа API рабочей области, установите ANTHROPIC_AWS_API_KEY таким же образом. Для более широкой поверхности Agent SDK см. Обзор Agent SDK.

​
Маршрутизация через корпоративный прокси

Чтобы маршрутизировать трафик через прокси или LLM gateway, установите ANTHROPIC_AWS_BASE_URL на адрес прокси. Claude Code отправляет запросы на этот URL с теми же заголовками рабочей области и аутентификации, поэтому любой шлюз, который пересылает их без изменений, работает. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com
Если ваш шлюз подписывает запросы сам, установите CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1, чтобы Claude Code отправлял неподписанные запросы и позволял шлюзу добавлять заголовки SigV4 перед пересылкой в AWS. Если шлюз требует свой собственный токен, установите его в ANTHROPIC_AUTH_TOKEN. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

​
Troubleshooting

Запустите /status, чтобы увидеть разрешенного поставщика и любой явно настроенный идентификатор рабочей области, регион, переопределение базового URL и параметр пропуска аутентификации. Это самый быстрый способ подтвердить, что Claude Code нацелен на Claude Platform on AWS вообще.

​
403 Forbidden или AccessDenied при каждом запросе

Субъект IAM, который разрешил Claude Code, вероятно, не имеет разрешения на вызов сервиса Anthropic в вашей рабочей области. Проверьте роль, присоединенную к вашему профилю AWS или средству выполнения, которое запустило Claude Code, и убедитесь, что оно имеет действия aws-external-anthropic, задокументированные в справочнике действий IAM. Если вы установили ANTHROPIC_AWS_API_KEY, ключ имеет приоритет над SigV4, и устаревший ключ создает ту же ошибку. Создайте ключ заново в консоли AWS в разделе Claude Platform on AWS → API keys или отмените установку переменной, чтобы вернуться к вашим учетным данным AWS.

​
Запросы не выполняются с ошибкой отсутствующей рабочей области

ANTHROPIC_AWS_WORKSPACE_ID вероятно не установлен или пуст. Каждый запрос Claude Platform on AWS должен включать идентификатор рабочей области. Он не подразумевается вашими учетными данными AWS. Найдите идентификатор в разделе Workspaces на странице сервиса консоли AWS и экспортируйте его перед запуском Claude Code.

​
Запросы по-прежнему идут на api.anthropic.com

CLAUDE_CODE_USE_ANTHROPIC_AWS вероятно не установлен или установлен на значение, которое не анализируется как истинное. Установите его на 1 и запустите /status, чтобы подтвердить разрешенного поставщика. Если также установлены CLAUDE_CODE_USE_BEDROCK или CLAUDE_CODE_USE_FOUNDRY, они имеют приоритет над Claude Platform on AWS.

​
Дополнительные ресурсы

Подписка Claude Platform on AWS, настройка рабочей области и IAM, которые предшествуют настройке Claude Code, рассматриваются в документации платформы: