Claude в Microsoft Foundry

В этом руководстве показано, как настроить Claude в Microsoft Foundry и выполнять вызовы API с помощью одного из клиентских SDK Anthropic или прямых HTTP-запросов. При доступе к Claude в Microsoft Foundry счета за использование Claude выставляются через Azure Marketplace. Вам доступны модели Claude, включая Claude Fable 5.1, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Sonnet 5.5 и Claude Sonnet 5, а также такие функции, как «context window» (контекстное окно) на 1M токенов. Расходами при этом можно управлять через вашу подписку Azure.

Claude доступен в типах развертывания Global Standard и US Data Zone Standard в ресурсах Foundry, с оплатой в Claude Consumption Units через Azure Marketplace. Подробности см. в разделе Цены на Claude в Microsoft Foundry.

Варианты размещения

Модели Claude в Microsoft Foundry доступны в двух вариантах размещения. Вы выбираете вариант размещения при настройке развертывания.

Claude Sonnet 5.5 поддерживает только развертывания Global Standard.

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

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

• Активная подписка Azure
• Доступ к порталу Foundry
• Установленный Azure CLI (обязателен для примера cURL с Entra ID, в остальных случаях необязателен)
• Роль Azure RBAC, позволяющая использовать ресурс, например Foundry User (ранее Azure AI User) или Cognitive Services User

Установка SDK

Клиентские SDK Anthropic поддерживают Foundry через специфичный для платформы пакет или клиентский класс. Примеры на этой странице также показывают запросы с помощью cURL и ant CLI. Чтобы настроить CLI, см. Быстрый старт с CLI.

pip install -U "anthropic"

# Для аутентификации через Entra ID также установите библиотеку Azure Identity
pip install azure-identity

Подготовка к работе

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

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

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

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

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

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

После создания ресурса разверните модель Claude, чтобы сделать её доступной для вызовов API. Эти шаги описывают новый портал Foundry (переключатель New Foundry включён):

1. Войдите на портал Foundry. На главной странице портала выберите Discover в навигации в правом верхнем углу, а затем Models на левой панели, чтобы открыть каталог моделей.
2. Найдите и выберите модель Claude (например, claude-opus-5). Каждая модель отображается в каталоге один раз, независимо от того, сколько вариантов размещения она поддерживает.
3. На карточке модели выберите Deploy, а затем Custom settings, чтобы открыть панель настроек развертывания. Если вместо этого выбрать Default settings, для моделей, доступных в обоих вариантах размещения, развертывание автоматически настраивается как Hosted on Azure.
4. При первом развертывании Claude ознакомьтесь с условиями Azure Marketplace, выберите отрасль и нажмите Agree and Proceed, чтобы принять условия и оформить подписку на предложение Azure Marketplace.
5. Настройте развертывание:
   • Deployment name: по умолчанию совпадает с идентификатором модели, но его можно изменить (например, my-claude-deployment). Имя развертывания нельзя изменить после создания.
   • Region scope: выберите Global или, для моделей с размещением в Azure, Data Zone. При выборе Data Zone создается развертывание US Data Zone Standard, при котором инференс выполняется в пределах США; это эквивалентно установке inference_geo: "us" в Claude API. Для Claude Sonnet 5.5 выберите Global.
   • Model version: разверните Model version settings и выберите версию в раскрывающемся меню Model version. Каждый вариант размещения указан как отдельная версия модели с пометкой о варианте размещения (например, версия 1 для Hosted on Anthropic, версия 2 для Hosted on Azure).
6. Выберите Deploy и дождитесь завершения подготовки.
7. После развертывания выберите Build в навигации в правом верхнем углу, затем Models на левой панели и откройте свое развертывание. На вкладке Details отображаются Target URI (URL вашей конечной точки) и Key (ваш ключ API).

Если переключатель New Foundry выключен, вы находитесь в классическом интерфейсе портала. Там откройте Model catalog на левой панели, чтобы найти и развернуть модель, и откройте Models + endpoints (в разделе My assets), чтобы просмотреть ваши развертывания и сведения об их конечных точках.

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

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

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

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

1. На портале Foundry выберите Build в навигации в правом верхнем углу, затем Models на левой панели.
2. Откройте ваше развертывание Claude и выберите вкладку Details.
3. Скопируйте значение Key (и запишите Target URI для вашей конечной точки).
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/). SDK для C# не считывает эту переменную: он всегда формирует базовый URL из имени ресурса.

Пример с использованием ключа 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:

1. Включите аутентификацию Microsoft Entra ID для вашего ресурса Foundry.
2. Получите токен доступа от Entra ID.
3. Используйте токен в заголовке 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 Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5.5, Claude Sonnet 5 и Claude Sonnet 4.6 имеют в Microsoft Foundry контекстное окно на 1M токенов. Другие модели Claude, включая Claude Sonnet 4.5, имеют контекстное окно на 200k токенов.

Функции Claude, не поддерживаемые для Claude в Microsoft Foundry

• Admin API
• Инструмент Advisor
• Claude Managed Agents
• Compliance API
• Models API
• Message Batches API
• Резервное переключение на стороне сервера (параметр fallbacks; вместо него используйте паттерн резервного переключения на стороне клиента)
• Наборы инструментов computer use и browser use (computer_toolset_20260801 и browser_toolset_20260801 в настоящее время недоступны в Microsoft Foundry; бета-версии инструмента computer use остаются доступными)

Дополнительные функции, не поддерживаемые при размещении в 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. Это включает объект usage в телах ответов, который предоставляет подробную информацию о потреблении токенов для ваших запросов. Объект usage единообразен на всех платформах (Claude API, Amazon Bedrock, Claude Platform on AWS, Foundry и Google Cloud).

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

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

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

Через Foundry доступны следующие модели Claude:

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

Биллинг

Claude в Microsoft Foundry выставляет счета через Azure Marketplace. Использование выражается в Claude Consumption Units (CCU), измеряется ежечасно и выставляется к оплате ежемесячно по факту в вашем счёте Azure. CCU не являются предоплаченными кредитами. Баланса CCU или обязательств по ним не существует.

Цену CCU, механику конвертации и тарифы на токены для каждой модели см. в разделе Цены на Claude в Microsoft Foundry.

Миграция между вариантами размещения

Чтобы перенести существующее развертывание с одного варианта размещения на другой:

1. Создайте новое развертывание другой версии размещения модели (Hosted on Azure или Hosted on Anthropic). Оно может находиться в том же ресурсе Foundry или в новом.
2. Обновите ваше приложение, чтобы передавать новое имя развертывания в параметре model.
3. Удалите старое развертывание после переноса трафика.

Если новое развертывание находится в том же ресурсе 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 (ранее Azure AI 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).
• Решение: Убедитесь, что модель/развертывание доступны в вашем регионе Azure.

Ошибка: Invalid model parameter

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

Следующие шаги

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