--- title: Резидентность данных url: https://platform.claude.com/docs/ru/manage-claude/data-residency description: Управляйте тем, где выполняется инференс модели и где хранятся данные, с помощью географических элементов управления. --- Элементы управления «data residency» (резидентность данных) позволяют вам управлять тем, где обрабатываются и хранятся ваши данные. За это отвечают две независимые настройки: * **Inference geo (география инференса):** Управляет тем, где выполняется инференс модели, для каждого отдельного запроса. Задаётся через параметр API `inference_geo` или как значение по умолчанию для рабочего пространства. * **Workspace geo (география рабочего пространства):** Управляет тем, где данные хранятся в состоянии покоя и где происходит обработка на конечных точках (например, транскодирование изображений и выполнение кода). Настраивается на уровне рабочего пространства в [Claude Console](https://platform.claude.com). [Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview) поддерживает географическую привязку на уровне агента: `inference_geo` в [конфигурации модели агента](https://platform.claude.com/docs/ru/managed-agents/agent-setup#pin-the-inference-geo) закрепляет географию, обслуживающую запросы к модели для сессий, в которых работает этот агент, с возможностью [переопределения для отдельной сессии](https://platform.claude.com/docs/ru/managed-agents/sessions#pin-the-inference-geo-for-a-session) при её создании. Агенты без привязки используют географию инференса рабочего пространства по умолчанию для каждого запроса. Managed Agents также учитывает Workspace geo, настроенную в Console, а при использовании [самостоятельно размещаемых песочниц](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes) выполнение инструментов и файловая система песочницы остаются на контролируемой вами инфраструктуре; содержимое подключённых [хранилищ памяти](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-memory) по-прежнему хранится у Anthropic и копируется в вашу песочницу на время сессии. ## География инференса Чтобы узнать, как «zero data retention» (нулевое хранение данных), или ZDR, применяется к этой функции, см. раздел [API и хранение данных](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention). Параметр `inference_geo` управляет тем, где выполняется инференс модели для конкретного запроса API. Добавьте его в любой вызов `POST /v1/messages`. | Значение | Описание | | ---------- | ---------------------------------------------------------------------------------------------------------------------- | | `"global"` | По умолчанию. Инференс может выполняться в любой доступной географии для оптимальной производительности и доступности. | | `"us"` | Инференс выполняется только на инфраструктуре, расположенной в США. | ### Использование API ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "inference_geo": "us", "messages": [{ "role": "user", "content": "Summarize the key points of this document." }] }' ``` ```bash CLI ant messages create \ --model claude-opus-5-5 \ --max-tokens 1024 \ --inference-geo us \ --message '{role: user, content: "Summarize the key points of this document."}' \ --transform '{content.#(type=="text").text,usage.inference_geo}' --format yaml ``` ```python Python client = anthropic.Anthropic() response = client.messages.create( model="claude-opus-5-5", max_tokens=1024, inference_geo="us", messages=[ {"role": "user", "content": "Summarize the key points of this document."} ], ) for block in response.content: if block.type == "text": print(block.text) # Проверьте, где фактически выполнялся инференс print(f"Inference geo: {response.usage.inference_geo}") ``` ```typescript TypeScript const client = new Anthropic(); const response = await client.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, inference_geo: "us", messages: [ { role: "user", content: "Summarize the key points of this document." } ] }); const textBlock = response.content.find( (block): block is Anthropic.TextBlock => block.type === "text" ); console.log(textBlock?.text); // Проверяем, где фактически выполнялся инференс console.log(`Inference geo: ${response.usage.inference_geo}`); ``` ```csharp C# var client = new AnthropicClient(); var response = await client.Messages.Create( new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, InferenceGeo = "us", Messages = [ new() { Role = Role.User, Content = "Summarize the key points of this document." }, ], } ); foreach (var block in response.Content) { if (block.TryPickText(out var textBlock)) { Console.WriteLine(textBlock.Text); } } // Проверьте, где фактически выполнялся вывод Console.WriteLine($"Inference geo: {response.Usage.InferenceGeo}"); ``` ```go Go client := anthropic.NewClient() message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, InferenceGeo: anthropic.String("us"), Messages: []anthropic.MessageParam{ anthropic.NewUserMessage(anthropic.NewTextBlock("Summarize the key points of this document.")), }, }) if err != nil { log.Fatal(err) } for _, block := range message.Content { if textBlock, ok := block.AsAny().(anthropic.TextBlock); ok { fmt.Println(textBlock.Text) } } // Проверьте, где фактически выполнялся инференс fmt.Printf("Inference geo: %s\n", message.Usage.InferenceGeo) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); Message response = client.messages().create( MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024L) .inferenceGeo("us") .addUserMessage("Summarize the key points of this document.") .build()); response.content().stream() .flatMap(block -> block.text().stream()) .forEach(textBlock -> IO.println(textBlock.text())); // Проверяем, где фактически выполнялся инференс IO.println("Inference geo: " + response.usage().inferenceGeo().get()); ``` ```php PHP $client = new Client(); $response = $client->messages->create( model: 'claude-opus-5-5', maxTokens: 1024, inferenceGeo: 'us', messages: [ ['role' => 'user', 'content' => 'Summarize the key points of this document.'], ], ); foreach ($response->content as $block) { if ($block->type === 'text') { echo $block->text, PHP_EOL; } } // Проверьте, где фактически выполнялся инференс echo "Inference geo: {$response->usage->inferenceGeo}\n"; ``` ```ruby Ruby client = Anthropic::Client.new response = client.messages.create( model: "claude-opus-5-5", max_tokens: 1024, inference_geo: "us", messages: [ {role: "user", content: "Summarize the key points of this document."} ] ) response.content.each do |block| puts block.text if block.type == :text end # Проверьте, где фактически выполнялся инференс puts "Inference geo: #{response.usage.inference_geo}" ``` ### Ответ Объект `usage` в ответе включает поле `inference_geo`, указывающее, где был выполнен инференс: ```json Output { "usage": { "input_tokens": 25, "output_tokens": 150, "inference_geo": "us" } } ``` ### Доступность моделей Параметр `inference_geo` поддерживается моделями Claude 4.6 и более поздними. Запросы с `inference_geo` к Claude Opus 4.5, Claude Sonnet 4.5 (устаревшая), Claude Haiku 4.5 или более ранним моделям возвращают ошибку 400. Параметр `inference_geo` доступен в Claude API (напрямую от Anthropic) и в [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws). В Amazon Bedrock и Google Cloud регион инференса определяется URL конечной точки или профилем инференса, поэтому `inference_geo` неприменим. В [Claude в Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry) `inference_geo` также неприменим: развёртывания, размещённые в Azure, могут вместо этого использовать тип развёртывания US Data Zone Standard, который удерживает инференс в пределах США. Параметр `inference_geo` также недоступен через [конечную точку совместимости с OpenAI SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/libraries/openai-sdk). ### Ограничения на уровне рабочего пространства Настройки рабочего пространства также позволяют ограничивать доступные географии инференса: * **`allowed_inference_geos`:** Ограничивает, какие географии может использовать рабочее пространство. Если в запросе указан `inference_geo`, отсутствующий в этом списке, API возвращает ошибку. * **`default_inference_geo`:** Задаёт резервную географию, когда `inference_geo` не указан в запросе. Отдельные запросы могут переопределить это значение, явно задав `inference_geo`. Эти настройки можно задать через Console или [Admin API](https://platform.claude.com/docs/ru/manage-claude/admin-api) в поле `data_residency`. ## География рабочего пространства География рабочего пространства задаётся при создании рабочего пространства и не может быть изменена впоследствии. В настоящее время `"us"` — единственная доступная география рабочего пространства. Чтобы задать географию рабочего пространства, создайте новое рабочее пространство в [Console](https://platform.claude.com): 1. В Console перейдите на страницу [Workspaces](https://platform.claude.com/settings/workspaces) (`platform.claude.com/settings/workspaces`). 2. Нажмите **Create workspace**, чтобы открыть страницу [Create workspace](https://platform.claude.com/settings/workspaces/new) (`platform.claude.com/settings/workspaces/new`) в Console. 3. Введите имя, подтвердите значение в поле **Workspace geo** и нажмите **Create workspace**. **Claude Platform on AWS:** География рабочего пространства не настраивается. Сессии Claude Managed Agents на этой платформе работают с фактической Workspace geo, равной `"us"`, которая в настоящее время является единственной доступной географией рабочего пространства. См. [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws) для ознакомления с особенностями резидентности данных, специфичными для этой платформы. ## Цены Цены на резидентность данных зависят от поколения модели: * **Модели Claude 4.6 и более поздние:** Инференс только в США (`inference_geo: "us"`) тарифицируется по ставке 1,1x от стандартной во всех категориях цен на токены (входные токены, выходные токены, запись в кэш и чтение из кэша). Для Claude Haiku 5.5 множитель также применяется к повышенным ценам для подсказок длиной более 100 000 токенов (см. [Цены на длинный контекст](https://platform.claude.com/docs/ru/about-claude/pricing#long-context-pricing)). * **Глобальная маршрутизация** (`inference_geo: "global"`): Применяются стандартные цены. * **Более старые модели:** Не поддерживают `inference_geo` (см. [Доступность моделей](https://platform.claude.com/docs/ru/manage-claude/data-residency#model-availability)); применяются стандартные цены. Запросы, включающие этот параметр, возвращают ошибку 400. Эти цены применяются к Claude API (напрямую от Anthropic) и Claude Platform on AWS. В Claude в Microsoft Foundry тот же коэффициент 1,1x применяется к развёртываниям, размещённым в Azure и использующим тип развёртывания US Data Zone Standard. Платформы, управляемые партнёрами (Bedrock и Google Cloud), имеют собственные региональные цены. Подробности см. в разделе [Цены на резидентность данных](https://platform.claude.com/docs/ru/about-claude/pricing#data-residency-pricing). Тот же коэффициент применяется к [Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview): когда [конфигурация модели](https://platform.claude.com/docs/ru/managed-agents/agent-setup) агента закрепляет `inference_geo` на значении `"us"`, запросы к модели в сессиях, в которых работает этот агент, тарифицируются с коэффициентом 1,1x от стандартной ставки. Если у вас есть обязательство по [Priority Tier](https://platform.claude.com/docs/ru/api/service-tiers), коэффициент 1,1x для инференса только в США также влияет на то, как токены учитываются в счёт вашей ёмкости Priority Tier. Каждый токен, потреблённый с `inference_geo: "us"`, списывает 1,1 токена из вашего зарезервированного TPM, в соответствии с тем, как другие ценовые коэффициенты (например, кэширование подсказок) влияют на скорость расходования. ## Поддержка Batch API Параметр `inference_geo` поддерживается в [Batch API](https://platform.claude.com/docs/ru/build-with-claude/batch-processing). Каждый запрос в пакете может указывать собственное значение `inference_geo`. ## Миграция с устаревших отказов Если ваша организация ранее отказалась от глобальной маршрутизации, чтобы удерживать инференс в США, ваше рабочее пространство было автоматически настроено с `allowed_inference_geos: ["us"]` и `default_inference_geo: "us"`. Изменения в коде не требуются. Ваши существующие требования к резидентности данных продолжают соблюдаться с помощью новых географических элементов управления. ### Что изменилось Устаревший отказ был настройкой на уровне организации, которая ограничивала все запросы инфраструктурой, расположенной в США. Новые элементы управления резидентностью данных заменяют её двумя механизмами: * **Управление на уровне запроса:** Параметр `inference_geo` позволяет указывать `"us"` или `"global"` в каждом вызове API, обеспечивая гибкость на уровне запроса. * **Управление на уровне рабочего пространства:** Настройки `default_inference_geo` и `allowed_inference_geos` в Console позволяют применять географические политики ко всем ключам в рабочем пространстве. ### Что произошло с вашим рабочим пространством Ваше рабочее пространство было перенесено автоматически: | Устаревшая настройка | Новый эквивалент | | ---------------------------------------------- | --------------------------------------------------------------- | | Отказ от глобальной маршрутизации (только США) | `allowed_inference_geos: ["us"]`, `default_inference_geo: "us"` | Все запросы API, использующие ключи из вашего рабочего пространства, продолжают выполняться на инфраструктуре, расположенной в США. Для сохранения текущего поведения никаких действий не требуется. ### Если вы хотите использовать глобальную маршрутизацию Если ваши требования к резидентности данных изменились и вы хотите воспользоваться глобальной маршрутизацией для повышения производительности и доступности, обновите настройки географии инференса вашего рабочего пространства, включив `"global"` в список разрешённых географий и установив `default_inference_geo` в значение `"global"`. Подробности см. в разделе [Ограничения на уровне рабочего пространства](https://platform.claude.com/docs/ru/manage-claude/data-residency#workspace-level-restrictions). ### Влияние на цены Устаревшие модели не затронуты этой миграцией. Актуальные цены на более новые модели см. в разделе [Цены](https://platform.claude.com/docs/ru/manage-claude/data-residency#pricing). ## Текущие ограничения * **Общие ограничения скорости:** Ограничения скорости являются общими для всех географий. * **География инференса:** Доступны только `"us"` и `"global"`. * **География рабочего пространства:** В настоящее время доступна только `"us"`. Географию рабочего пространства нельзя изменить после его создания. ## Следующие шаги Ознакомьтесь с подробностями цен на резидентность данных. Узнайте о настройке рабочих пространств. Отслеживайте использование и затраты по резидентности данных.