Claude в Microsoft Foundry
Получите доступ к моделям Claude через Microsoft Foundry с нативными для Azure конечными точками и аутентификацией.
В этом руководстве показано, как настроить Claude в Microsoft Foundry и выполнять к нему вызовы API. Вы можете использовать один из клиентских SDK от Anthropic или прямые HTTP-запросы. При доступе к Claude в Microsoft Foundry вы оплачиваете использование Claude через Azure Marketplace. Доступные модели перечислены в разделе Идентификаторы моделей API и развертывания. Также доступны такие функции, как «context window» (контекстное окно) на 1M токенов. Вы управляете расходами через свою подписку Azure.
Claude доступен в ресурсах Foundry с типами развертывания Global Standard и US Data Zone Standard, а оплата выставляется в Claude Consumption Units через Azure Marketplace. Подробности см. в разделе Цены на Claude в Microsoft Foundry.
Варианты размещения
Модели Claude в Microsoft Foundry доступны в двух вариантах «hosting» (размещения). Вариант размещения выбирается при настройке «deployment» (развертывания).
| Размещение в Azure | Размещение в Anthropic | |
|---|---|---|
| Где выполняется инференс | Сервис под управлением Anthropic, работающий на инфраструктуре Azure | Сервис под управлением Anthropic, работающий на инфраструктуре Anthropic |
| Доступность моделей | Некоторые модели Opus, Sonnet и Haiku | Все модели Claude, доступные в Microsoft Foundry |
| Типы развертывания | Global Standard, US Data Zone Standard | Global Standard |
| Рекомендуется для | Большинства рабочих нагрузок | Рабочих нагрузок, которым нужны модели, размещённые только в Anthropic, или функции, доступные только при размещении в Anthropic |
Для развертываний, размещенных в Azure, Anthropic обрабатывает подсказки и ответы на инфраструктуре Azure и хранит там сохраняемый контент. Сохраняемый контент включает контент, помеченный системами безопасности Anthropic для проверки со стороны Anthropic. Операционные данные, не содержащие подсказок или ответов, хранятся в системах Anthropic за пределами Azure. Примеры таких данных — оценки, выдаваемые классификаторами безопасности, идентификаторы, а также данные об использовании и выставлении счетов.
Предварительные требования
Перед началом работы убедитесь, что у вас есть:
- Активная подписка Azure
- Доступ к порталу Foundry
- Роль «Azure role-based access control» (управления доступом на основе ролей Azure), или RBAC, например Foundry User или Cognitive Services User, для ресурса Foundry, который вы создаёте в разделе Подготовка к работе
- Необязательно: Azure CLI для получения токенов Microsoft Entra ID с помощью
az account get-access-token
Установка SDK
Клиентские SDK от Anthropic поддерживают Foundry через платформенно-специфичный пакет или клиентский класс. Примеры на этой странице также показывают запросы с помощью cURL и CLI ant. Чтобы настроить CLI, см. Быстрый старт CLI.
pip install -U "anthropic"
# Для аутентификации через Entra ID также установите библиотеку Azure Identity
pip install azure-identityПодготовка к работе
Foundry использует двухуровневую иерархию: ресурсы содержат ваши настройки безопасности и выставления счетов, а развёртывания — это экземпляры моделей, которые вы вызываете через API. Сначала вы создаёте ресурс Foundry, а затем одно или несколько развёртываний Claude внутри него.
Подготовка ресурсов Foundry
Чтобы подготовить ваш ресурс:
- Перейдите на портал Foundry.
- Создайте или выберите ресурс Foundry в регионе Azure, где доступна ваша модель. Вы можете следовать инструкциям Microsoft по созданию ресурса Foundry или создать проект Foundry, при этом ресурс будет создан автоматически.
- Запишите имя вашего ресурса — это
{resource}в конечных точках API, напримерhttps://{resource}.services.ai.azure.com/anthropic/v1/*.
Чтобы ограничить сетевой доступ, вы можете добавить свой ресурс в частную сеть (Azure Virtual Network).
Создание развертываний Foundry
После создания ресурса разверните модель Claude, чтобы сделать ее доступной для вызовов API. Эти шаги описывают новый портал Foundry (переключатель New Foundry включен):
- Войдите на портал Foundry. На главной странице портала выберите Discover в навигации в правом верхнем углу, затем Models на левой панели, чтобы открыть каталог моделей.
- Найдите и выберите модель Claude (например,
claude-opus-5-5). Каждая модель отображается в каталоге один раз, независимо от того, сколько вариантов размещения она поддерживает. - На карточке модели выберите Deploy, затем Custom settings, чтобы открыть панель настроек развёртывания. Если вместо этого выбрать Default settings, развёртывание автоматически настраивается как размещённое в Azure для моделей, доступных в обоих вариантах размещения.
- При первом развертывании Claude ознакомьтесь с условиями Azure Marketplace, выберите отрасль и нажмите Agree and Proceed, чтобы принять условия и подписаться на предложение Azure Marketplace.
- Настройте развертывание:
- Deployment name: по умолчанию совпадает с ID модели, но его можно изменить (например,
my-claude-deployment). Имя развертывания нельзя изменить после создания. - Model version: этот параметр определяет вариант размещения. Раскройте Model version settings, откройте раскрывающееся меню Model version и выберите версию, помеченную нужным вам вариантом размещения.
- Region scope: выберите Global или, если развертывание размещено в Azure, Data Zone. Data Zone создаёт развертывание US Data Zone Standard, при котором инференс выполняется в пределах США. Сведения о ценах см. в разделе География инференса.
- Deployment name: по умолчанию совпадает с ID модели, но его можно изменить (например,
- Выберите Deploy и дождитесь завершения подготовки.
- После развертывания выберите Build в навигации в правом верхнем углу, затем Models на левой панели и откройте свое развертывание. На вкладке Details отображаются Target URI (URL вашей конечной точки) и Key (ваш ключ API).
Если переключатель New Foundry выключен, вы находитесь в классическом интерфейсе портала. В нем откройте Model catalog на левой панели, чтобы найти и развернуть модель, и откройте Models + endpoints (в разделе My assets), чтобы просмотреть свои развертывания и сведения об их конечных точках.
Аутентификация
Claude в Microsoft Foundry поддерживает два метода аутентификации: ключи API и токены Entra ID. Оба метода используют конечные точки в формате https://{resource}.services.ai.azure.com/anthropic/v1/*. Для моделей Claude Mythos используйте токены Entra ID.
Аутентификация с помощью ключа API
После подготовки вашего ресурса Claude в Foundry вы можете получить ключ API на портале Foundry:
- На портале Foundry выберите Build в навигации в правом верхнем углу, затем Models на левой панели.
- Откройте свое развертывание Claude и выберите вкладку Details.
- Скопируйте значение Key (и запишите Target URI для вашей конечной точки).
- Используйте заголовок
api-keyилиx-api-keyв своих запросах либо передайте ключ в SDK.
Клиент Foundry в SDK требует ключ API и либо имя ресурса, либо базовый URL, и автоматически считывает их из следующих переменных окружения, если они заданы:
ANTHROPIC_FOUNDRY_API_KEY— ваш ключ APIANTHROPIC_FOUNDRY_RESOURCE— имя вашего ресурса (например,example-resource)ANTHROPIC_FOUNDRY_BASE_URL— альтернатива имени ресурса во всех SDK, кроме C#: полный базовый URL (например,https://example-resource.services.ai.azure.com/anthropic/)
Пример с использованием ключа API:
import os
from anthropic import AnthropicFoundry
client = AnthropicFoundry(
api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
resource="example-resource", # your resource name
)
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Аутентификация Microsoft Entra
Аутентификация Entra ID позволяет управлять доступом с помощью Azure RBAC, интегрироваться с системой управления удостоверениями вашей организации и избежать ручной работы с ключами API. Чтобы использовать токены Entra ID:
- Включите аутентификацию Microsoft Entra ID для своего ресурса Foundry.
- Получите токен доступа от Entra ID.
- Используйте токен в заголовке
Authorization: Bearer {TOKEN}.
Пример с использованием Entra ID:
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
# Получение токена Microsoft Entra ID с помощью шаблона поставщика токенов
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://ai.azure.com/.default"
)
# Создание клиента с аутентификацией через Entra ID
client = AnthropicFoundry(
resource="example-resource", # your resource name
azure_ad_token_provider=token_provider, # Use token provider for Entra ID auth
)
# Выполнение запроса
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Корреляционные идентификаторы запросов
Foundry включает идентификаторы запросов в заголовки HTTP-ответов для отладки и трассировки. При обращении в службу поддержки предоставьте значения request-id и apim-request-id (Azure API Management), чтобы помочь командам быстро найти и исследовать ваш запрос в системах как Anthropic, так и Azure.
Поддержка функций
Claude в Microsoft Foundry поддерживает большинство функций Claude. В обзоре функций перечислены функции Claude, а в разделе Доступность на странице каждой функции указано, поддерживает ли её Foundry и с каким вариантом размещения.
Контекстное окно
Все доступные модели имеют контекстное окно на 1M токенов в Microsoft Foundry, за исключением Claude Opus 4.5, Claude Sonnet 4.5 (устаревшая) и Claude Haiku 4.5. У этих трёх моделей контекстное окно составляет 200k токенов.
Функции Claude, не поддерживаемые для Claude в Microsoft Foundry
- Admin API
- Инструмент-советник
- Claude Managed Agents
- Compliance API
- Models API
- Message Batches API
- Серверный резервный вариант (server-side fallback; параметр
fallbacks); вместо него используйте шаблон клиентского резервного варианта - Конечные точки профилей пользователей (
/v1/user_profiles; вместо этого создавайте профили в Claude API)
Дополнительные функции, не поддерживаемые при размещении в Azure
Следующие функции доступны для развертываний, размещённых в Anthropic, но не поддерживаются для развертываний, размещённых в Azure:
- Выполнение кода
- Версии инструментов веб-поиска и веб-загрузки новее
web_search_20250305иweb_fetch_20250910. Развертывания, размещённые в Azure, поддерживают только эти базовые версии, поэтому динамическая фильтрация, включение ответов и обход кэша недоступны. - Agent Skills
- Программный вызов инструментов
- Files API
Запросы, использующие эти функции с развертыванием, размещённым в Azure, намеренно возвращают ошибку 400 Bad Request. Claude Code определяет развертывания, размещённые в Azure, и автоматически адаптирует свой набор функций.
Ответы API
Ответы API от Claude в Microsoft Foundry соответствуют стандартному формату ответов Claude APIДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., включая объект usage.
Подробности о заголовках ответов, специфичных для Foundry, см. в разделе Корреляционные идентификаторы запросов.
Идентификаторы моделей API и развертывания
Термины жизненного цикла (Deprecated, Retired) определены в разделе Устаревание моделей. Microsoft Foundry следует графику жизненного цикла Claude API.
Через Foundry доступны следующие модели Claude:
| Модель | Имя развертывания по умолчанию | Размещение в Azure | Размещение в Anthropic |
|---|---|---|---|
| Claude Fable 5.2 | claude-fable-5-2 | ✓ | |
| Claude Mythos 5.2 (ограниченный доступ(открывается в новой вкладке)) | claude-mythos-5-2 | ✓ | |
| Claude Fable 5.1 | claude-fable-5-1 | ✓ | |
| Claude Mythos 5.1 (ограниченный доступ(открывается в новой вкладке)) | claude-mythos-5-1 | ✓ | |
| Claude Fable 5 | claude-fable-5 | ✓ | |
| Claude Mythos 5 (ограниченный доступ(открывается в новой вкладке)) | claude-mythos-5 | ✓ | |
| Claude Opus 5.5 | claude-opus-5-5 | ✓ | ✓ |
| Claude Opus 5 | claude-opus-5 | ✓ | ✓ |
| Claude Opus 4.8 | claude-opus-4-8 | ✓ | ✓ |
| Claude Opus 4.7 | claude-opus-4-7 | ✓ | |
| Claude Opus 4.6 | claude-opus-4-6 | ✓ | |
| Claude Opus 4.5 | claude-opus-4-5 | ✓ | |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | ✓ | ✓ |
| Claude Sonnet 5 | claude-sonnet-5 | ✓ | ✓ |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | ✓ | |
| Claude Sonnet 4.5 (устарела) | claude-sonnet-4-5 | ✓ | |
| Claude Haiku 5.5 | claude-haiku-5-5 | ✓ | ✓ |
| Claude Haiku 4.5 | claude-haiku-4-5 | ✓ | ✓ |
По умолчанию имена развертываний совпадают с идентификаторами моделей, указанными в таблице выше. Однако вы можете создавать пользовательские развертывания с другими именами на портале Foundry для управления различными конфигурациями, версиями или ограничениями скорости. Используйте в ваших запросах API имя развертывания (не обязательно идентификатор модели).
Claude Code
Позвольте Claude Code перенести ваш код на более новую модель
/claude-api migrate этот проект на последнюю модель Claude OpusБиллинг
Claude в Microsoft Foundry выставляет счета через Azure Marketplace. Использование выражается в Claude Consumption Units (CCU), измеряется ежечасно и выставляется к оплате ежемесячно по факту в вашем счёте Azure. CCU не являются предоплаченными кредитами. Баланса CCU или обязательств по ним не существует.
Цену CCU, механику конвертации и тарифы на токены для каждой модели см. в разделе Цены на Claude в Microsoft Foundry.
Миграция между вариантами размещения
Чтобы перенести существующее развертывание с одного варианта размещения на другой:
- Создайте новое развертывание другой версии размещения модели (размещение в Azure или в Anthropic). Оно может находиться в том же ресурсе Foundry или в новом.
- Обновите ваше приложение, чтобы передавать новое имя развертывания в параметре
model. - Удалите старое развертывание после переноса трафика.
Если новое развертывание находится в том же ресурсе Foundry, URL вашей конечной точки и аутентификация остаются без изменений. Если вы создали новый ресурс, обновите конечную точку и учётные данные вашего приложения, чтобы они указывали на него.
Мониторинг и логирование
Azure предоставляет мониторинг и логирование вашего использования Claude с помощью стандартных механизмов Azure:
- Azure Monitor: отслеживание использования API, задержек и частоты ошибок
- Azure Log Analytics: запросы и анализ логов запросов/ответов
- Cost Management: мониторинг и прогнозирование расходов, связанных с использованием Claude
Anthropic рекомендует вести логи вашей активности как минимум за скользящий 30-дневный период, чтобы понимать закономерности использования и исследовать любые потенциальные проблемы.
Устранение неполадок
Ошибки аутентификации
Ошибка: 401 Unauthorized или Invalid API key
- Решение: Убедитесь, что ваш ключ API верен. Вы можете найти его на портале Foundry на вкладке Details вашего развертывания (в разделе Build > Models).
- Решение: Если вы используете Microsoft Entra ID, убедитесь, что ваш токен доступа действителен и не истёк. Токены обычно истекают через 1 час.
Ошибка: 403 Forbidden
Причина: У вашей учётной записи Azure может не быть необходимых разрешений.
- Решение: Убедитесь, что вам назначена соответствующая роль Azure RBAC (например, Foundry User или Cognitive Services User).
Ограничение скорости
Ошибка: 429 Too Many Requests
- Решение: Вы превысили ваше «rate limit» (ограничение скорости). Реализуйте в вашем приложении экспоненциальную задержку и логику повторных попыток.
- Решение: Рассмотрите возможность запросить увеличение ограничений скорости через портал 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-opus-5-5). - Решение: Убедитесь, что модель/развертывание доступны в вашем регионе Azure.
Ошибка: Invalid model parameter
- Решение: параметр
modelдолжен содержать имя вашего развёртывания, которое можно настроить на портале Foundry. Убедитесь, что развёртывание существует и правильно настроено.
Следующие шаги
Изучите расширенные функции и возможности Claude.
Узнайте о структуре цен Anthropic на модели и функции.
По мере выхода более безопасных и более мощных моделей Anthropic регулярно выводит из эксплуатации старые. Ознакомьтесь со всеми устаревшими версиями API и рекомендуемыми заменами.
Дополнительные ресурсы
Просмотрите модели Anthropic в каталоге Foundry.
Ознакомьтесь с ценами Microsoft на Microsoft Foundry.
Ознакомьтесь с ценами Anthropic для каждой модели.
Управляйте вашими ресурсами Azure.
Эта страница была полезной?