---
title: Claude в Microsoft Foundry
url: https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry
description: Получите доступ к моделям Claude через Microsoft Foundry с нативными для Azure конечными точками и аутентификацией.
---

В этом руководстве показано, как настроить Claude в Microsoft Foundry и выполнять к нему вызовы API. Вы можете использовать один из клиентских SDK от Anthropic или прямые HTTP-запросы. При доступе к Claude в Microsoft Foundry вы оплачиваете использование Claude через Azure Marketplace. Доступные модели перечислены в разделе [Идентификаторы моделей API и развертывания](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#api-model-ids-and-deployments). Также доступны такие функции, как [«context window» (контекстное окно) на 1M токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows). Вы управляете расходами через свою подписку Azure.

Claude доступен в ресурсах Foundry с типами развертывания Global Standard и US Data Zone Standard, а оплата выставляется в Claude Consumption Units через Azure Marketplace. Подробности см. в разделе [Цены на Claude в Microsoft Foundry](https://platform.claude.com/docs/ru/about-claude/pricing#claude-in-microsoft-foundry-pricing).

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

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

|                          | Размещение в Azure                                                                                                                                       | Размещение в Anthropic                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Где выполняется инференс | Сервис под управлением Anthropic, работающий на инфраструктуре Azure                                                                                     | Сервис под управлением Anthropic, работающий на инфраструктуре Anthropic                                                                                                                                                                                                                                                                                                                        |
| Доступность моделей      | [Некоторые модели Opus, Sonnet и Haiku](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#api-model-ids-and-deployments) | [Все модели Claude, доступные в Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#api-model-ids-and-deployments)                                                                                                                                                                                                                             |
| Типы развертывания       | Global Standard, US Data Zone Standard                                                                                                                   | Global Standard                                                                                                                                                                                                                                                                                                                                                                                 |
| Рекомендуется для        | Большинства рабочих нагрузок                                                                                                                             | Рабочих нагрузок, которым нужны [модели, размещённые только в Anthropic](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#api-model-ids-and-deployments), или [функции, доступные только при размещении в Anthropic](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#additional-features-not-supported-when-hosted-on-azure) |

Для развертываний, размещенных в Azure, Anthropic обрабатывает подсказки и ответы на инфраструктуре Azure и хранит там сохраняемый контент. Сохраняемый контент включает контент, помеченный системами безопасности Anthropic для проверки со стороны Anthropic. Операционные данные, не содержащие подсказок или ответов, хранятся в системах Anthropic за пределами Azure. Примеры таких данных — оценки, выдаваемые классификаторами безопасности, идентификаторы, а также данные об использовании и выставлении счетов.

<Note>
  Anthropic выступает в качестве независимого обработчика данных для Microsoft. На клиентов, использующих Claude через Microsoft Foundry, распространяются [условия использования данных](https://www.anthropic.com/legal) Anthropic. Anthropic соблюдает свои обязательства в области безопасности и обработки данных.
</Note>

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

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

* Активная подписка Azure
* Доступ к [порталу Foundry](https://ai.azure.com/)
* Роль «Azure role-based access control» (управления доступом на основе ролей Azure), или RBAC, например **Foundry User** или **Cognitive Services User**, для ресурса Foundry, который вы создаёте в разделе [Подготовка к работе](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#provisioning)
* Необязательно: [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli) для получения токенов [Microsoft Entra ID](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#microsoft-entra-authentication) с помощью `az account get-access-token`

## Установка SDK

[Клиентские SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) от Anthropic поддерживают Foundry через платформенно-специфичный пакет или клиентский класс. Примеры на этой странице также показывают запросы с помощью cURL и CLI `ant`. Чтобы настроить CLI, см. [Быстрый старт CLI](https://platform.claude.com/docs/ru/cli-sdks-libraries/cli/quickstart).

<Tabs>
  <Tab title="Python">
    ```bash
    pip install -U "anthropic"

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

  <Tab title="TypeScript">
    ```bash
    npm install @anthropic-ai/foundry-sdk

    # Для аутентификации через Entra ID также установите библиотеку Azure Identity
    npm install @azure/identity
    ```
  </Tab>

  <Tab title="C#">
    ```bash
    dotnet add package Anthropic.Foundry
    ```
  </Tab>

  <Tab title="Go">
    ```bash
    go get github.com/anthropics/anthropic-sdk-go/v2/foundry

    # Для аутентификации через Entra ID также установите библиотеку Azure Identity
    go get github.com/Azure/azure-sdk-for-go/sdk/azidentity
    ```
  </Tab>

  <Tab title="Java">
    <Tabs>
      <Tab title="Gradle">
        ```kotlin
        implementation("com.anthropic:anthropic-java:3.11.0")
        implementation("com.anthropic:anthropic-java-foundry:3.11.0")
        ```
      </Tab>

      <Tab title="Maven">
        ```xml
        <dependency>
            <groupId>com.anthropic</groupId>
            <artifactId>anthropic-java</artifactId>
            <version>3.11.0</version>
        </dependency>
        <dependency>
            <groupId>com.anthropic</groupId>
            <artifactId>anthropic-java-foundry</artifactId>
            <version>3.11.0</version>
        </dependency>
        ```
      </Tab>
    </Tabs>

    Для аутентификации через Entra ID также добавьте в вашу сборку библиотеку Azure Identity (`com.azure:azure-identity`) последней версии из [Maven Central](https://central.sonatype.com/artifact/com.azure/azure-identity).
  </Tab>

  <Tab title="PHP">
    ```bash
    composer require "anthropic-ai/sdk" "guzzlehttp/guzzle:^7"
    ```
  </Tab>

  <Tab title="Ruby">
    ```bash
    bundle add anthropic
    ```

    Для аутентификации через Entra ID вы передаёте клиенту поставщик токенов. Поставщик из раздела [Аутентификация Microsoft Entra](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#microsoft-entra-authentication) получает токены из [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli), поэтому установите Azure CLI, чтобы использовать этот поставщик.
  </Tab>
</Tabs>

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

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

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

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

1. Перейдите на [портал Foundry](https://ai.azure.com/).
2. Создайте или выберите ресурс Foundry в [регионе Azure, где доступна ваша модель](https://learn.microsoft.com/en-us/azure/foundry/foundry-models/how-to/use-foundry-models-claude). Вы можете следовать [инструкциям Microsoft по созданию ресурса Foundry](https://learn.microsoft.com/en-us/azure/ai-services/multi-service-resource?pivots=azportal) или [создать проект Foundry](https://learn.microsoft.com/en-us/azure/foundry/how-to/create-projects), при этом ресурс будет создан автоматически.
3. Запишите имя вашего ресурса — это `{resource}` в конечных точках API, например `https://{resource}.services.ai.azure.com/anthropic/v1/*`.

Чтобы ограничить сетевой доступ, вы можете [добавить свой ресурс в частную сеть](https://learn.microsoft.com/en-us/azure/foundry/how-to/configure-private-link) (Azure Virtual Network).

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

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

1. Войдите на портал Foundry. На главной странице портала выберите **Discover** в навигации в правом верхнем углу, затем **Models** на левой панели, чтобы открыть каталог моделей.

2. Найдите и выберите модель Claude (например, claude-opus-5-5). Каждая модель отображается в каталоге один раз, независимо от того, сколько вариантов размещения она поддерживает.

3. На карточке модели выберите **Deploy**, затем **Custom settings**, чтобы открыть панель настроек развёртывания. Если вместо этого выбрать **Default settings**, развёртывание автоматически настраивается как размещённое в Azure для моделей, доступных в обоих вариантах размещения.

4. При первом развертывании Claude ознакомьтесь с условиями Azure Marketplace, выберите отрасль и нажмите **Agree and Proceed**, чтобы принять условия и подписаться на предложение Azure Marketplace.

5. Настройте развертывание:

   * **Deployment name:** по умолчанию совпадает с ID модели, но его можно изменить (например, `my-claude-deployment`). Имя развертывания нельзя изменить после создания.
   * **Model version:** этот параметр определяет [вариант размещения](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#hosting-options). Раскройте **Model version settings**, откройте раскрывающееся меню **Model version** и выберите версию, помеченную нужным вам вариантом размещения.
   * **Region scope:** выберите **Global** или, если развертывание размещено в Azure, **Data Zone**. **Data Zone** создаёт развертывание US Data Zone Standard, при котором инференс выполняется в пределах США. Сведения о ценах см. в разделе [География инференса](https://platform.claude.com/docs/ru/about-claude/pricing#foundry-inference-geography).

6. Выберите **Deploy** и дождитесь завершения подготовки.

7. После развертывания выберите **Build** в навигации в правом верхнем углу, затем **Models** на левой панели и откройте свое развертывание. На вкладке **Details** отображаются **Target URI** (URL вашей конечной точки) и **Key** (ваш ключ API).

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

<Note>
  Выбранное вами имя развертывания становится значением, которое вы передаете в параметре `model` своих запросов API. Вы можете создать несколько развертываний одной и той же модели с разными именами, чтобы управлять отдельными конфигурациями или «rate limits» (ограничениями скорости).
</Note>

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

Claude в Microsoft Foundry поддерживает два метода аутентификации: ключи API и токены Entra ID. Оба метода используют конечные точки в формате `https://{resource}.services.ai.azure.com/anthropic/v1/*`. Для [моделей Claude Mythos](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#api-model-ids-and-deployments) используйте [токены Entra ID](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#microsoft-entra-authentication).

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

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

1. На портале Foundry выберите **Build** в навигации в правом верхнем углу, затем **Models** на левой панели.
2. Откройте свое развертывание Claude и выберите вкладку **Details**.
3. Скопируйте значение **Key** (и запишите **Target URI** для вашей конечной точки).
4. Используйте заголовок `api-key` или `x-api-key` в своих запросах либо передайте ключ в SDK.

Клиент Foundry в SDK требует ключ API и либо имя ресурса, либо базовый URL, и автоматически считывает их из следующих переменных окружения, если они заданы:

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

<Note>
  Параметры `resource` и `base_url` являются взаимоисключающими. Укажите либо имя ресурса (которое SDK использует для формирования URL вида `https://{resource}.services.ai.azure.com/anthropic/`), либо непосредственно полный базовый URL.
</Note>

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

<CodeGroup>
  ```bash cURL
  curl https://{resource}.services.ai.azure.com/anthropic/v1/messages \
    -H "content-type: application/json" \
    -H "api-key: YOUR_AZURE_API_KEY" \
    -H "anthropic-version: 2026-10-21" \
    -d '{
      "model": "claude-opus-5-5",
      "max_tokens": 1024,
      "messages": [
        {"role": "user", "content": "Hello!"}
      ]
    }'
  ```

  ```bash CLI
  # ant считывает ANTHROPIC_API_KEY
  export ANTHROPIC_API_KEY="YOUR_AZURE_API_KEY"

  ant messages create \
    --base-url https://example-resource.services.ai.azure.com/anthropic \
    --model claude-opus-5-5 \
    --max-tokens 1024 \
    --message '{role: user, content: "Hello!"}'
  ```

  ```python Python
  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)
  ```

  ```typescript TypeScript
  import AnthropicFoundry from "@anthropic-ai/foundry-sdk";

  const client = new AnthropicFoundry({
    apiKey: process.env.ANTHROPIC_FOUNDRY_API_KEY,
    resource: "example-resource" // your resource name
  });

  const message = await client.messages.create({
    model: "claude-opus-5-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello!" }]
  });
  console.log(message.content);
  ```

  ```csharp C#
  using Anthropic.Foundry;
  using Anthropic.Models.Messages;

  // Клиент C# всегда формирует базовый URL из имени ресурса.
  // Он не считывает ANTHROPIC_FOUNDRY_BASE_URL.
  var client = new AnthropicFoundryClient(
      new AnthropicFoundryApiKeyCredentials(
          Environment.GetEnvironmentVariable("ANTHROPIC_FOUNDRY_API_KEY")!,
          "example-resource"
      )
  );

  var response = await client.Messages.Create(new MessageCreateParams
  {
      Model = "claude-opus-5-5",
      MaxTokens = 1024,
      Messages = [new UserMessageParam { Content = "Hello!" }],
  });

  Console.WriteLine(
      string.Join("", response.Content
          .Select(block => block.Value)
          .OfType<TextBlock>()
          .Select(textBlock => textBlock.Text)));
  ```

  ```go Go
  package main

  import (
  	"context"
  	"fmt"
  	"os"

  	"github.com/anthropics/anthropic-sdk-go/v2"
  	"github.com/anthropics/anthropic-sdk-go/v2/foundry"
  )

  func main() {
  	client, err := foundry.NewClient(foundry.ClientConfig{
  		APIKey:   os.Getenv("ANTHROPIC_FOUNDRY_API_KEY"),
  		Resource: "example-resource", // your resource name
  	})
  	if err != nil {
  		panic(err)
  	}

  	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
  		Model:     "claude-opus-5-5",
  		MaxTokens: 1024,
  		Messages: []anthropic.MessageParam{
  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
  		},
  	})
  	if err != nil {
  		panic(err)
  	}
  	fmt.Println(message.Content)
  }
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.foundry.backends.FoundryBackend;
  import com.anthropic.models.messages.MessageCreateParams;

  void main() {
      // Требуются переменные окружения: ANTHROPIC_FOUNDRY_API_KEY, ANTHROPIC_FOUNDRY_RESOURCE
      AnthropicClient client = AnthropicOkHttpClient.builder()
          .backend(FoundryBackend.fromEnv())
          .build();

      MessageCreateParams params = MessageCreateParams.builder()
          .model("claude-opus-5-5")
          .maxTokens(1024)
          .addUserMessage("Hello!")
          .build();

      client.messages().create(params).content().stream()
          .flatMap(block -> block.text().stream())
          .forEach(textBlock -> IO.println(textBlock.text()));
  }
  ```

  ```php PHP
  use Anthropic\Foundry;

  $client = Foundry\Client::withCredentials(
      apiKey: getenv('ANTHROPIC_FOUNDRY_API_KEY'),
      baseUrl: 'https://example-resource.services.ai.azure.com/anthropic',
  );

  $message = $client->messages->create(
      maxTokens: 1024,
      messages: [
          ['role' => 'user', 'content' => 'Hello!']
      ],
      model: 'claude-opus-5-5',
  );
  echo array_find($message->content, fn ($block) => $block->type === 'text')->text;
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::FoundryClient.new(
    api_key: ENV.fetch("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!"}]
  )

  message.content.grep(Anthropic::Models::TextBlock).each { |block| puts block.text }
  ```
</CodeGroup>

<Warning>
  Храните свои ключи API в безопасности. Никогда не добавляйте их в систему контроля версий и не публикуйте. Любой, у кого есть доступ к вашему ключу API, может отправлять запросы к Claude через ваш ресурс Foundry.
</Warning>

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

Аутентификация Entra ID позволяет управлять доступом с помощью Azure RBAC, интегрироваться с системой управления удостоверениями вашей организации и избежать ручной работы с ключами API. Чтобы использовать токены Entra ID:

1. Включите [аутентификацию Microsoft Entra ID](https://learn.microsoft.com/en-us/azure/ai-foundry/model-inference/how-to/configure-entra-id) для своего ресурса Foundry.
2. Получите токен доступа от Entra ID.
3. Используйте токен в заголовке `Authorization: Bearer {TOKEN}`.

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

<CodeGroup>
  ```bash cURL
  # Выполнение запроса с токеном Microsoft Entra ID. Замените {resource} на имя вашего ресурса
  curl https://{resource}.services.ai.azure.com/anthropic/v1/messages \
    -H "content-type: application/json" \
    -H "Authorization: Bearer $(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)" \
    -H "anthropic-version: 2026-10-21" \
    -d '{
      "model": "claude-opus-5-5",
      "max_tokens": 1024,
      "messages": [
        {"role": "user", "content": "Hello!"}
      ]
    }'
  ```

  ```bash CLI
  # Выполните запрос с токеном Microsoft Entra ID. Замените {resource} на имя вашего ресурса
  # env -u сбрасывает ANTHROPIC_API_KEY, который CLI иначе отправил бы вместо токена
  env -u ANTHROPIC_API_KEY \
    ANTHROPIC_AUTH_TOKEN="$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)" \
    ant messages create \
      --base-url https://{resource}.services.ai.azure.com/anthropic \
      --model claude-opus-5-5 \
      --max-tokens 1024 \
      --message '{role: user, content: "Hello!"}'
  ```

  ```python Python
  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)
  ```

  ```typescript TypeScript
  import AnthropicFoundry from "@anthropic-ai/foundry-sdk";
  import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";

  // Получение токена Entra ID с помощью шаблона поставщика токенов
  const credential = new DefaultAzureCredential();
  const tokenProvider = getBearerTokenProvider(credential, "https://ai.azure.com/.default");

  // Создание клиента с аутентификацией через Entra ID
  const client = new AnthropicFoundry({
    resource: "example-resource", // your resource name
    azureADTokenProvider: tokenProvider // Use token provider for Entra ID auth
  });

  // Выполнение запроса
  const message = await client.messages.create({
    model: "claude-opus-5-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello!" }]
  });
  console.log(message.content);
  ```

  ```csharp C#
  using Anthropic.Foundry;
  using Anthropic.Models.Messages;
  using Azure.Identity;

  var client = new AnthropicFoundryClient(
      new AnthropicFoundryIdentityTokenCredentials(
          new DefaultAzureCredential(),
          "example-resource"
      )
  );

  var response = await client.Messages.Create(new MessageCreateParams
  {
      Model = "claude-opus-5-5",
      MaxTokens = 1024,
      Messages = [new UserMessageParam { Content = "Hello!" }],
  });

  Console.WriteLine(
      string.Join("", response.Content
          .Select(block => block.Value)
          .OfType<TextBlock>()
          .Select(textBlock => textBlock.Text)));
  ```

  ```go Go
  package main

  import (
  	"context"
  	"fmt"

  	"github.com/Azure/azure-sdk-for-go/sdk/azcore/policy"
  	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
  	"github.com/anthropics/anthropic-sdk-go/v2"
  	"github.com/anthropics/anthropic-sdk-go/v2/foundry"
  )

  func main() {
  	credential, err := azidentity.NewDefaultAzureCredential(nil)
  	if err != nil {
  		panic(err)
  	}

  	tokenProvider := func(ctx context.Context) (string, error) {
  		token, err := credential.GetToken(ctx, policy.TokenRequestOptions{
  			Scopes: []string{foundry.EntraIDScope},
  		})
  		return token.Token, err
  	}

  	client, err := foundry.NewClient(foundry.ClientConfig{
  		Resource:             "example-resource", // your resource name
  		AzureADTokenProvider: tokenProvider,
  	})
  	if err != nil {
  		panic(err)
  	}

  	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
  		Model:     "claude-opus-5-5",
  		MaxTokens: 1024,
  		Messages: []anthropic.MessageParam{
  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
  		},
  	})
  	if err != nil {
  		panic(err)
  	}
  	fmt.Println(message.Content)
  }
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.foundry.backends.FoundryBackend;
  import com.anthropic.models.messages.MessageCreateParams;
  import com.azure.identity.AuthenticationUtil;
  import com.azure.identity.DefaultAzureCredentialBuilder;
  import java.util.function.Supplier;

  void main() {
      Supplier<String> bearerTokenSupplier = AuthenticationUtil.getBearerTokenSupplier(
          new DefaultAzureCredentialBuilder().build(),
          "https://ai.azure.com/.default"
      );

      AnthropicClient client = AnthropicOkHttpClient.builder()
          .backend(FoundryBackend.builder()
              .bearerTokenSupplier(bearerTokenSupplier)
              .resource("example-resource")
              .build())
          .build();

      MessageCreateParams params = MessageCreateParams.builder()
          .model("claude-opus-5-5")
          .maxTokens(1024)
          .addUserMessage("Hello!")
          .build();

      client.messages().create(params).content().stream()
          .flatMap(block -> block.text().stream())
          .forEach(textBlock -> IO.println(textBlock.text()));
  }
  ```

  ```php PHP
  use Anthropic\Foundry;

  // Получите токен доступа Entra ID, например с помощью Azure CLI:
  //   az account get-access-token --resource https://ai.azure.com \
  //     --query accessToken -o tsv
  $token = getenv('AZURE_ACCESS_TOKEN');

  $client = Foundry\Client::withCredentials(
      authToken: $token,
      baseUrl: 'https://example-resource.services.ai.azure.com/anthropic',
  );

  $message = $client->messages->create(
      maxTokens: 1024,
      messages: [
          ['role' => 'user', 'content' => 'Hello!']
      ],
      model: 'claude-opus-5-5',
  );
  echo array_find($message->content, fn ($block) => $block->type === 'text')->text;
  ```

  ```ruby Ruby
  require "anthropic"

  # Получите токен Microsoft Entra ID через Azure CLI. Клиент вызывает эту
  # лямбда-функцию при каждом запросе и повторе, поэтому в продакшене кэшируйте токен,
  # пока не приблизится срок его истечения.
  token_provider = lambda do
    `az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv`
  end

  client = Anthropic::FoundryClient.new(
    resource: "example-resource", # your resource name
    azure_ad_token_provider: token_provider
  )

  message = client.messages.create(
    model: "claude-opus-5-5",
    max_tokens: 1024,
    messages: [{role: "user", content: "Hello!"}]
  )

  message.content.grep(Anthropic::Models::TextBlock).each { |block| puts block.text }
  ```
</CodeGroup>

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

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

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

Claude в Microsoft Foundry поддерживает большинство функций Claude. В [обзоре функций](https://platform.claude.com/docs/ru/build-with-claude/overview) перечислены функции Claude, а в разделе **Доступность** на странице каждой функции указано, поддерживает ли её Foundry и с каким вариантом размещения.

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

Все [доступные модели](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#api-model-ids-and-deployments) имеют [контекстное окно на 1M токенов](https://platform.claude.com/docs/ru/build-with-claude/context-windows) в 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`](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback#server-side-fallback)); вместо него используйте [шаблон клиентского резервного варианта](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback#client-side-fallback)
* Конечные точки профилей пользователей (`/v1/user_profiles`; вместо этого [создавайте профили в Claude API](https://platform.claude.com/docs/ru/manage-claude/user-profiles#before-you-begin))

### Дополнительные функции, не поддерживаемые при размещении в Azure

Следующие функции доступны для развертываний, размещённых в Anthropic, но не поддерживаются для развертываний, размещённых в Azure:

* [Выполнение кода](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/code-execution-tool)
* Версии инструментов [веб-поиска](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/web-search-tool) и [веб-загрузки](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/web-fetch-tool) новее `web_search_20250305` и `web_fetch_20250910`. Развертывания, размещённые в Azure, поддерживают только эти базовые версии, поэтому динамическая фильтрация, включение ответов и обход кэша недоступны.
* [Agent Skills](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/overview)
* [Программный вызов инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/programmatic-tool-calling)
* [Files API](https://platform.claude.com/docs/ru/build-with-claude/files)

Запросы, использующие эти функции с развертыванием, размещённым в Azure, намеренно возвращают ошибку `400 Bad Request`. Claude Code определяет развертывания, размещённые в Azure, и автоматически адаптирует свой набор функций.

## Ответы API

Ответы API от Claude в Microsoft Foundry соответствуют стандартному [формату ответов Claude API](https://platform.claude.com/docs/ru/api/messages/create), включая объект `usage`.

Подробности о заголовках ответов, специфичных для Foundry, см. в разделе [Корреляционные идентификаторы запросов](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry#correlation-request-ids).

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

Термины жизненного цикла (Deprecated, Retired) определены в разделе [Устаревание моделей](https://platform.claude.com/docs/ru/about-claude/model-deprecations). Microsoft Foundry следует графику жизненного цикла Claude API.

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

| Model                                                                                                 | Default deployment name | Hosted on Azure | Hosted on Anthropic |
| :---------------------------------------------------------------------------------------------------- | :---------------------- | :-------------: | :-----------------: |
| Claude Fable 5.2                                                                                      | `claude-fable-5-2`      |                 |          ✓          |
| Claude Mythos 5.2 ([limited availability](https://support.claude.com/en/articles/14604842))           | `claude-mythos-5-2`     |                 |          ✓          |
| Claude Fable 5.1                                                                                      | `claude-fable-5-1`      |                 |          ✓          |
| Claude Mythos 5.1 ([limited availability](https://support.claude.com/en/articles/14604842))           | `claude-mythos-5-1`     |                 |          ✓          |
| Claude Fable 5                                                                                        | `claude-fable-5`        |                 |          ✓          |
| Claude Mythos 5 ([limited availability](https://support.claude.com/en/articles/14604842))             | `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 ([deprecated](https://platform.claude.com/docs/ru/about-claude/model-deprecations)) | `claude-sonnet-4-5`     |                 |          ✓          |
| Claude Haiku 5.5                                                                                      | `claude-haiku-5-5`      |        ✓        |          ✓          |
| Claude Haiku 4.5                                                                                      | `claude-haiku-4-5`      |        ✓        |          ✓          |

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

<Info>
  [Claude Mythos Preview](https://anthropic.com/glasswing) — это исследовательская предварительная версия, доступная приглашённым клиентам в Microsoft Foundry.
</Info>

Позвольте Claude Code перенести ваш код на более новую модель

```text
/claude-api migrate этот проект на последнюю модель Claude Opus
```

## Биллинг

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

Цену CCU, механику конвертации и тарифы на токены для каждой модели см. в разделе [Цены на Claude в Microsoft Foundry](https://platform.claude.com/docs/ru/about-claude/pricing#claude-in-microsoft-foundry-pricing).

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

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

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

Если новое развертывание находится в том же ресурсе Foundry, URL вашей конечной точки и аутентификация остаются без изменений. Если вы создали новый ресурс, обновите конечную точку и учётные данные вашего приложения, чтобы они указывали на него.

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

Azure предоставляет мониторинг и логирование вашего использования Claude с помощью стандартных механизмов Azure:

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

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

<Note>
  Сервисы логирования Azure настраиваются в рамках вашей подписки Azure. Включение логирования не предоставляет Microsoft или Anthropic доступ к вашему контенту сверх того, что необходимо для биллинга и работы сервиса.
</Note>

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

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

**Ошибка:** `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. Убедитесь, что развёртывание существует и правильно настроено.

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

<CardGroup cols={2}>
  <Card title="Обзор функций" icon="stack" href="https://platform.claude.com/docs/ru/build-with-claude/overview">
    Изучите расширенные функции и возможности Claude.
  </Card>

  <Card title="Цены" icon="chart" href="https://platform.claude.com/docs/ru/about-claude/pricing#claude-in-microsoft-foundry-pricing">
    Узнайте о структуре цен Anthropic на модели и функции.
  </Card>

  <Card title="Устаревание моделей" icon="arrow-clockwise" href="https://platform.claude.com/docs/ru/about-claude/model-deprecations">
    По мере выхода более безопасных и более мощных моделей Anthropic регулярно выводит из эксплуатации старые. Ознакомьтесь со всеми устаревшими версиями API и рекомендуемыми заменами.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="Каталог моделей Foundry" icon="grid" href="https://ai.azure.com/catalog/publishers/anthropic">
    Просмотрите модели Anthropic в каталоге Foundry.
  </Card>

  <Card title="Цены на Microsoft Foundry" icon="calculator" href="https://azure.microsoft.com/en-us/pricing/details/ai-foundry/#pricing">
    Ознакомьтесь с ценами Microsoft на Microsoft Foundry.
  </Card>

  <Card title="Цены на модели" icon="table" href="https://platform.claude.com/docs/ru/about-claude/pricing#model-pricing">
    Ознакомьтесь с ценами Anthropic для каждой модели.
  </Card>

  <Card title="Портал Azure" icon="cloud" href="https://portal.azure.com/">
    Управляйте вашими ресурсами Azure.
  </Card>
</CardGroup>
