Claude в Microsoft Foundry

Это руководство проведёт вас через процесс настройки и выполнения вызовов API к Claude в Foundry с использованием одного из клиентских SDK Anthropic или прямых HTTP-запросов. Когда вы получаете доступ к Claude в Foundry, плата за использование Claude начисляется через Microsoft Marketplace, что позволяет вам использовать новейшие возможности Claude, управляя расходами через вашу подписку Azure.

Региональная доступность: на момент запуска Claude доступен как тип развёртывания Global Standard в ресурсах Foundry. Цены на Claude в Microsoft Marketplace соответствуют стандартным ценам API Anthropic. Подробности см. на странице Цены.



Предварительная версия

В этой предварительной версии интеграции платформы модели Claude работают на инфраструктуре Anthropic. Это коммерческая интеграция для выставления счетов и доступа через Azure. Поскольку Anthropic является независимым обработчиком данных для Microsoft, на клиентов, использующих Claude через Microsoft Foundry, распространяются условия использования данных Anthropic. Anthropic продолжает обеспечивать свои лучшие в отрасли обязательства по безопасности и работе с данными, включая возможность нулевого хранения данных.



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

Прежде чем начать, убедитесь, что у вас есть:

• Активная подписка Azure
• Доступ к Foundry
• Установленный Azure CLI (необязательно, для управления ресурсами)



Установка SDK

Клиентские SDK Anthropic поддерживают Foundry через специфичный для платформы пакет или класс клиента.



Подготовка ресурсов

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



Подготовка ресурсов Foundry

Создайте ресурс Foundry, который необходим для использования сервисов в Azure и управления ими. Вы можете следовать этим инструкциям для создания ресурса Foundry. В качестве альтернативы вы можете начать с создания проекта Foundry, что включает создание ресурса Foundry.

Чтобы подготовить ваш ресурс:

1. Перейдите на портал Foundry
2. Создайте новый ресурс Foundry или выберите существующий
3. Настройте управление доступом с использованием ключей API, выданных Azure, или Entra ID (ранее Azure Active Directory) для управления доступом на основе ролей
4. При необходимости настройте ресурс как часть частной сети (Azure Virtual Network) для повышенной безопасности
5. Запишите имя вашего ресурса. Вы будете использовать его как {resource} в конечных точках API (например, https://{resource}.services.ai.azure.com/anthropic/v1/*)



Создание развёртываний Foundry

После создания ресурса разверните модель Claude, чтобы сделать её доступной для вызовов API:

1. На портале Foundry перейдите к вашему ресурсу
2. Перейдите в раздел Models + endpoints и выберите + Deploy model > Deploy base model
3. Найдите и выберите модель Claude (например, claude-sonnet-4-6)
4. Настройте параметры развёртывания:
   • Deployment name: по умолчанию соответствует идентификатору модели, но вы можете его изменить (например, my-claude-deployment). Имя развёртывания нельзя изменить после его создания.
   • Deployment type: выберите Global Standard (рекомендуется для Claude)
5. Выберите Deploy и дождитесь завершения подготовки
6. После развёртывания вы можете найти URL вашей конечной точки и ключи в разделе Keys and Endpoint



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

Claude в Foundry поддерживает два метода аутентификации: ключи API и токены Entra ID. Оба метода используют размещённые в Azure конечные точки в формате https://{resource}.services.ai.azure.com/anthropic/v1/*.



Аутентификация с помощью ключа API

После подготовки вашего ресурса Claude в Foundry вы можете получить ключ API на портале Foundry:

1. Перейдите к вашему ресурсу на портале Foundry
2. Перейдите в раздел Keys and Endpoint
3. Скопируйте один из предоставленных ключей API
4. Используйте заголовок api-key или x-api-key в ваших запросах либо передайте ключ в SDK

SDK для Foundry требуют ключ API и либо имя ресурса, либо базовый URL. SDK для C#, Java, PHP, Python и TypeScript автоматически считывают их из следующих переменных окружения, если они определены:

• ANTHROPIC_FOUNDRY_API_KEY — ваш ключ API
• ANTHROPIC_FOUNDRY_RESOURCE — имя вашего ресурса (например, example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL — альтернатива имени ресурса; полный базовый URL (например, https://example-resource.services.ai.azure.com/anthropic/)

Пример с использованием ключа API:



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

Для повышенной безопасности и централизованного управления доступом вы можете использовать токены Entra ID:

1. Включите аутентификацию Entra для вашего ресурса Foundry
2. Получите токен доступа от Entra ID
3. Используйте токен в заголовке Authorization: Bearer {TOKEN}

Пример с использованием Entra ID:



Идентификаторы корреляции запросов

Foundry включает идентификаторы запросов в заголовки HTTP-ответов для отладки и трассировки. При обращении в службу поддержки укажите значения как request-id, так и apim-request-id, чтобы помочь командам быстро найти и исследовать ваш запрос в системах Anthropic и Azure.



Поддержка функций

Claude в Foundry поддерживает большинство мощных функций Claude. Все поддерживаемые в настоящее время функции вы можете найти в разделе Обзор функций.



Контекстное окно

Claude Fable 5, Claude Opus 4.7, Claude Opus 4.6 и Claude Sonnet 4.6 имеют контекстное окно в 1 млн токенов в Microsoft Foundry. Другие модели Claude, включая Claude Opus 4.8 и Sonnet 4.5, имеют контекстное окно в 200 тыс. токенов.



Неподдерживаемые функции

• Admin API
• Compliance API
• Models API
• Message Batches API
• Резервный вариант на стороне сервера (параметр fallbacks; вместо него используйте шаблон резервного варианта на стороне клиента)



Ответы API

Ответы API от Claude в Foundry следуют стандартному формату ответов Claude API. Это включает объект usage в телах ответов, который предоставляет подробную информацию о потреблении токенов для ваших запросов. Объект usage одинаков на всех платформах (Claude API, Foundry, Claude Platform на AWS, Amazon Bedrock и Vertex AI).

Подробности о заголовках ответов, специфичных для Foundry, см. в разделе Идентификаторы корреляции запросов.



Идентификаторы моделей API и развёртывания

Термины жизненного цикла (Deprecated — устаревшая, Retired — выведена из эксплуатации) определены в разделе Устаревание моделей. Microsoft Foundry следует расписанию жизненного цикла Claude API.

Следующие модели Claude доступны через Foundry. Модели последнего поколения (Claude Fable 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6 и Haiku 4.5) предлагают наиболее продвинутые возможности:

По умолчанию имена развёртываний совпадают с идентификаторами моделей, показанными в предыдущей таблице. Однако вы можете создавать пользовательские развёртывания с другими именами на портале Foundry для управления различными конфигурациями, версиями или ограничениями скорости. Используйте имя развёртывания (не обязательно идентификатор модели) в ваших запросах к API.



Мониторинг и логирование

Azure предоставляет комплексные возможности мониторинга и логирования для вашего использования Claude через стандартные шаблоны Azure:

• Azure Monitor: отслеживание использования API, задержки и частоты ошибок
• Azure Log Analytics: запросы и анализ логов запросов/ответов
• Cost Management: мониторинг и прогнозирование расходов, связанных с использованием Claude

Anthropic рекомендует вести логирование вашей активности как минимум за скользящий 30-дневный период, чтобы понимать закономерности использования и расследовать любые потенциальные проблемы.



Устранение неполадок



Ошибки аутентификации

Ошибка: 401 Unauthorized или Invalid API key

• Решение: проверьте правильность вашего ключа API. Вы можете получить новый ключ API на портале Foundry в разделе Keys and Endpoint для вашего ресурса Foundry.
• Решение: если вы используете Microsoft Entra ID, убедитесь, что ваш токен доступа действителен и не истёк. Токены обычно истекают через 1 час.

Ошибка: 403 Forbidden

• Решение: у вашей учётной записи Azure могут отсутствовать необходимые разрешения. Убедитесь, что вам назначена соответствующая роль Azure RBAC (например, «Cognitive Services OpenAI User»).



Ограничение скорости

Ошибка: 429 Too Many Requests

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



Заголовки ограничения скорости

Foundry не включает стандартные заголовки ограничения скорости Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining и anthropic-ratelimit-output-tokens-reset) в ответы. Вместо этого управляйте ограничением скорости через инструменты мониторинга Azure.



Ошибки моделей и развёртываний

Ошибка: Model not found или Deployment not found

• Решение: убедитесь, что вы используете правильное имя развёртывания. Если вы не создавали пользовательское развёртывание, используйте идентификатор модели по умолчанию (например, claude-sonnet-4-6).
• Решение: убедитесь, что модель/развёртывание доступны в вашем регионе Azure.

Ошибка: Invalid model parameter

• Решение: параметр модели должен содержать имя вашего развёртывания, которое можно настроить на портале Foundry. Убедитесь, что развёртывание существует и правильно настроено.



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

• Документация Foundry: ai.azure.com/catalog
• Цены Azure: azure.microsoft.com/en-us/pricing/details/ai-foundry
• Подробности о ценах Anthropic: Цены на модели
• Руководство по аутентификации: см. Аутентификация
• Портал Azure: portal.azure.com