「data residency」(データレジデンシー)コントロールを使用すると、データが処理および保存される場所を管理できます。これは2つの独立した設定によって制御されます。
inference_geo APIパラメータを通じて、またはワークスペースのデフォルトとして設定します。Claude Managed Agentsはinference_geoパラメータをサポートしていませんが、Consoleで設定されたワークスペースジオを尊重します。セルフホストサンドボックスを使用すると、ツール実行とサンドボックスのファイルシステムは、お客様が管理するインフラストラクチャ上に留まります。
「zero data retention」(ゼロデータ保持)、すなわちZDRがこの機能にどのように適用されるかについては、APIとデータ保持を参照してください。
inference_geoパラメータは、特定のAPIリクエストに対してモデル推論が実行される場所を制御します。任意のPOST /v1/messages呼び出しに追加できます。
| 値 | 説明 |
|---|---|
"global" | デフォルト。最適なパフォーマンスと可用性のために、推論は利用可能な任意の地域で実行される場合があります。 |
"us" | 推論は米国ベースのインフラストラクチャでのみ実行されます。 |
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-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}")レスポンスのusageオブジェクトには、推論が実行された場所を示すinference_geoフィールドが含まれます。
{
"usage": {
"input_tokens": 25,
"output_tokens": 150,
"inference_geo": "us"
}
}inference_geoパラメータは、Claude 4.6以降のモデルでサポートされています。Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5、またはそれ以前のモデルでinference_geoを指定したリクエストは、400エラーを返します。
inference_geoパラメータは、Claude API(ファーストパーティ)およびClaude Platform on AWSで利用できます。Amazon BedrockおよびGoogle Cloudでは、推論リージョンはエンドポイントURLまたは推論プロファイルによって決定されるため、inference_geoは適用されません。Claude in Microsoft Foundryでも同様にinference_geoは適用されません。Azureでホストされているデプロイメントでは、代わりにUS Data Zone Standardデプロイメントタイプを使用することで、推論を米国内に保つことができます。inference_geoパラメータは、OpenAI SDK互換エンドポイントでも利用できません。
ワークスペース設定では、利用可能な推論ジオを制限することもできます。
allowed_inference_geos: ワークスペースが使用できるジオを制限します。リクエストがこのリストにないinference_geoを指定した場合、APIはエラーを返します。default_inference_geo: リクエストでinference_geoが省略された場合のフォールバックジオを設定します。個々のリクエストは、inference_geoを明示的に設定することでこれを上書きできます。これらの設定は、ConsoleまたはAdmin APIのdata_residencyフィールドで設定できます。
ワークスペースジオはワークスペースの作成時に設定され、その後変更することはできません。現在、利用可能なワークスペースジオは"us"のみです。
ワークスペースジオを設定するには、Consoleで新しいワークスペースを作成します。
Claude Platform on AWS: ワークスペースジオは設定できません。ワークスペースはAWS Consoleを通じてプロビジョニングされ、Claude ConsoleのWorkspacesページは読み取り専用です。このプラットフォーム上のClaude Managed Agentsセッションは、実質的なワークスペースジオ"us"で実行されます。これは現在利用可能な唯一のワークスペースジオです。このプラットフォーム固有のデータレジデンシーに関する考慮事項については、Claude Platform on AWSを参照してください。
データレジデンシーの料金は、モデルの世代によって異なります。
inference_geo: "us")は、すべてのトークン料金カテゴリ(入力トークン、出力トークン、キャッシュ書き込み、キャッシュ読み取り)において、標準料金の1.1倍で課金されます。inference_geo: "global"): 標準料金が適用されます。inference_geoをサポートしていません(モデルの利用可否を参照)。標準料金が適用されます。このパラメータを含むリクエストは400エラーを返します。この料金は、Claude API(ファーストパーティ)およびClaude Platform on AWSに適用されます。Claude in Microsoft Foundryでは、US Data Zone Standardデプロイメントタイプを使用するAzureでホストされたデプロイメントに、同じ1.1倍の乗数が適用されます。パートナー運営のプラットフォーム(BedrockおよびGoogle Cloud)には、独自のリージョン別料金があります。詳細については、データレジデンシーの料金を参照してください。
Priority Tierのコミットメントがある場合、米国限定推論の1.1倍の乗数は、Priority Tierの容量に対するトークンのカウント方法にも影響します。inference_geo: "us"で消費される各トークンは、コミットされたTPMから1.1トークンを消費します。これは、他の料金乗数(プロンプトキャッシングなど)がバーンダウンレートに影響する方法と一貫しています。
inference_geoパラメータは、Batch APIでサポートされています。バッチ内の各リクエストは、それぞれ独自のinference_geo値を指定できます。
組織が以前に推論を米国内に保つためにグローバルルーティングをオプトアウトしていた場合、ワークスペースは自動的にallowed_inference_geos: ["us"]およびdefault_inference_geo: "us"で設定されています。コードの変更は必要ありません。既存のデータレジデンシー要件は、新しいジオコントロールを通じて引き続き適用されます。
レガシーのオプトアウトは、すべてのリクエストを米国ベースのインフラストラクチャに制限する組織レベルの設定でした。新しいデータレジデンシーコントロールは、これを2つのメカニズムに置き換えます。
inference_geoパラメータを使用すると、各API呼び出しで"us"または"global"を指定でき、リクエストレベルの柔軟性が得られます。default_inference_geoおよびallowed_inference_geos設定を使用すると、ワークスペース内のすべてのキーにジオポリシーを適用できます。ワークスペースは自動的に移行されました。
| レガシー設定 | 新しい同等の設定 |
|---|---|
| グローバルルーティングのオプトアウト(米国のみ) | allowed_inference_geos: ["us"]、default_inference_geo: "us" |
ワークスペースのキーを使用するすべてのAPIリクエストは、引き続き米国ベースのインフラストラクチャで実行されます。現在の動作を維持するためのアクションは必要ありません。
データレジデンシー要件が変更され、より良いパフォーマンスと可用性のためにグローバルルーティングを活用したい場合は、ワークスペースの推論ジオ設定を更新して、許可されたジオに"global"を含め、default_inference_geoを"global"に設定してください。詳細については、ワークスペースレベルの制限を参照してください。
レガシーモデルはこの移行の影響を受けません。新しいモデルの現在の料金については、料金を参照してください。
"us"と"global"のみが利用可能です。"us"のみが利用可能です。ワークスペースジオはワークスペース作成後に変更できません。Was this page helpful?