2026年9月4日 金曜日
AI時短ラボ
検証· 約19

Claude Managed Agentsのinference_geo──推論を「globalかusか」の2択で固定するAPIパラメータ

Anthropicは2026年8月7日、Claude Managed Agentsのエージェント単位・セッション単位で推論実行地域(inference_geo)を指定できるようにしました。データレジデンシー要件への対応で、値は現時点で「global」(デフォルト)と「us」の2つ。公式ドキュメントによると「us」を指定するとClaude 4.6以降のモデルで標準料金の1.1倍が課金されます。

Claude Managed Agentsのinference_geo──推論を「globalかusか」の2択で固定するAPIパラメータ
執筆・編集:
目次

2026年8月27日、Claude Developer Platform公式ドキュメント(platform.claude.com)を実際に開いて確認した内容です。 2026年8月7日のリリースノートに、次の記載があります(原文と訳)。

"You can now control where model inference runs for a Claude Managed Agents agent. Set inference_geo inside the model object when you create the agent, or override it for a single session. See Data residency for the available geos and pricing."

(訳:Claude Managed Agentsのエージェントで、モデル推論の実行場所をコントロールできるようになった。エージェント作成時にmodelオブジェクト内でinference_geoを設定するか、セッション単位で上書きできる。利用可能なgeoと料金についてはData residencyページを参照)

リンク先のData residencyページを読むと、inference_geoパラメータ自体は通常のClaude API(POST /v1/messages)でも使えること、値は2種類しかないこと、そして「us」指定時には料金が1.1倍になることが明記されていました。

3行まとめ

  • inference_geoパラメータはPOST /v1/messagesに付与でき、値は"global"(デフォルト、最適な性能・可用性のためどこでも推論可)と"us"(米国内インフラのみで推論)の2つのみ
  • Claude Managed Agentsでは、エージェントのmodel設定にinference_geoを固定でき、セッション作成時に個別上書きもできる。指定しないエージェントはワークスペースのデフォルト推論geoに従う
  • Claude 4.6以降のモデルでinference_geo: "us"を指定すると、入力・出力トークン・キャッシュ書き込み・キャッシュ読み取りの全カテゴリで標準料金の1.1倍が課金される

差分1行の重さ

公式サンプルのPythonコードを読むと、inference_geo="us"を指定した状態と、その行自体を削除した状態(つまりデフォルトの"global"のまま)の違いは、コード上ではパラメータ1行の有無でしかありません。一方で、この1行の有無がAnthropic側のドキュメントによれば料金に1.1倍の差を生みます。筆者にはこの実装コストの小ささと料金インパクトの大きさが釣り合っていないように見えました。設定の変更自体は簡単でも、その1行を組織のどこかが気づかず有効にしたままにしていないか、という点はコスト管理上見落としやすいと感じます。

データレジデンシーの2つの独立した設定

公式ドキュメントは、データレジデンシーを制御する仕組みとして2つを区別しています。

  • Inference geo(推論地域):モデル推論がどこで実行されるかを、リクエスト単位で制御する。inference_geo APIパラメータ、またはワークスペースのデフォルト設定で指定
  • Workspace geo(ワークスペース地域):データが保管される場所と、エンドポイント処理(画像のトランスコーディングやコード実行など)が行われる場所を制御する。Claude Consoleでワークスペース単位に設定

この2つは独立した設定で、片方を変えてももう片方には影響しません。

APIでの使い方

公式ドキュメントに載っているサンプルは次の通りです(Python)。

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)
# Check where inference actually ran
print(f"Inference geo: {response.usage.inference_geo}")

注目すべきは、レスポンスのresponse.usage.inference_geoから、実際に推論がどこで実行されたかを確認できる点です。リクエストで指定した値と、実際の実行地域が一致しているかをコード側で検証できる、という設計になっています。

プラットフォームによって「そもそも対象外」がある

inference_geoというパラメータ自体は、すべての利用経路で使えるわけではありません。公式ドキュメントの「Model availability」節を確認すると、対応状況は経路ごとに次のように分かれていました。

利用経路 inference_geoの扱い
Claude API(ファーストパーティ) 使える("global" / "us"
Claude Platform on AWS 使える("global" / "us"
Amazon Bedrock 非対応。推論地域はエンドポイントURLやinference profileで決まる
Google Cloud(Vertex AI) 非対応。同上
Claude in Microsoft Foundry 非対応。代わりにAzure上の「US Data Zone Standard」デプロイタイプを使うと米国限定推論になり、同じ1.1倍が適用される
OpenAI SDK互換エンドポイント 非対応

出典: platform.claude.com/docs/en/manage-claude/data-residency「Model availability」節(2026年8月29日確認)

BedrockとGoogle Cloudについては、inference_geoの代わりとなる独自の仕組みも確認できました。Pricingページによると、Claude Sonnet 4.5・Haiku 4.5・Opus 4.5以降のモデルでは、Bedrockに「global endpoints」と「regional endpoints」の2種類、Google Cloudには「global」「multi-region」「regional」の3種類のエンドポイントタイプがあり、リージョン限定・マルチリージョンのエンドポイントには「グローバルエンドポイントに対して10%のプレミアム」が上乗せされます。Anthropic側のinference_geo: "us"が1.1倍(=10%増)であるのと、率としては同じ水準です。

ワークスペース単位でも縛れる

エージェントやセッション単位の指定とは別に、ワークスペース設定でもinference_geoを制御できることが「Workspace-level restrictions」節に書かれていました。

  • allowed_inference_geos:そのワークスペースで使えるinference_geoの値を制限する。リストに無い値を指定したリクエストはエラーになる
  • default_inference_geo:リクエストでinference_geoを省略した場合のフォールバック値を設定する

この2つはConsoleまたはAdmin APIのdata_residencyフィールドから設定できます。さらに、以前から「グローバルルーティングをオプトアウトして米国内推論のみに限定していた」組織については、自動的にallowed_inference_geos: ["us"]default_inference_geo: "us"へ移行済みであることも「Migration from legacy opt-outs」節に明記されていました。

旧設定 新しい相当設定
グローバルルーティングのオプトアウト(米国限定) allowed_inference_geos: ["us"]default_inference_geo: "us"

出典: platform.claude.com/docs/en/manage-claude/data-residency「Migration from legacy opt-outs」節(2026年8月29日確認)

つまり、以前から米国限定で運用していた組織は、コード変更なしに同じ挙動が保証される形で自動移行されており、逆にグローバルルーティングを新たに使いたい場合は、ワークスペース側の設定を明示的に"global"へ変更する必要がある、という設計になっています。

Claude Managed Agentsでの2段階の指定

Claude Managed Agents(エージェントを常設のクラウド実行環境で動かす仕組み)では、inference_geoをさらに2段階で指定できます。

  1. エージェント単位のピン留め:エージェントのmodel設定オブジェクトにinference_geoを設定すると、そのエージェントを使う全セッションのモデルリクエストが、その地域で処理される
  2. セッション単位の上書き:セッション作成時に個別のセッションだけinference_geoを上書きできる

そして「ピン留めしていないエージェントは、リクエストごとにワークスペースのデフォルト推論geoに従う」ともドキュメントに明記されています。つまり、エージェント→セッション→ワークスペースデフォルトという優先順位で解決される、という構造です。「Agent setup」ページによれば、この「ワークスペースのデフォルトに従う」という挙動は固定値ではなく「at the time it's served(実際にリクエストが処理される時点)」でそのつど評価される、という一文もありました。ワークスペース側のデフォルト設定を後から変更すれば、ピン留めしていない既存エージェントの挙動もそれ以降のリクエストから追随することになります。

なお、inference_geoをエージェントにピン留めした場合、その値はエージェント自体のレスポンスのmodel.inference_geoにも反映されます。公式サンプルコードでは、エージェント作成直後にagent.model.inference_geoを読み出して、意図通りの値が設定されたかを確認するという使い方が示されていました。

公式ドキュメントには、Claude Managed Agentsが「Workspace geo」の設定も尊重すること、自己ホスト型サンドボックスを使う場合はツール実行・サンドボックスのファイルシステムがユーザー自身の管理するインフラ上に留まる一方、アタッチしたメモリストアの中身はAnthropic側に保管されセッションごとにサンドボックスへコピーされる、という補足もありました。

「us」指定時の1.1倍料金

公式ドキュメントの料金セクションには、次の記載があります(原文と訳)。

"Claude 4.6 and later models: US-only inference (inference_geo: "us") is priced at 1.1x the standard rate across all token pricing categories (input tokens, output tokens, cache writes, and cache reads)."

(訳:Claude 4.6以降のモデル:米国限定推論(inference_geo: "us")は、全トークン料金カテゴリ(入力トークン・出力トークン・キャッシュ書き込み・キャッシュ読み取り)にわたって標準料金の1.1倍で課金される)

この価格設定は、Claude API(ファーストパーティ)とClaude Platform on AWSに適用され、Claude in Microsoft FoundryではAzure上のUS Data Zone Standardデプロイメントタイプに同じ1.1倍が適用される、と続きます。パートナー運営のプラットフォーム(BedrockとGoogle Cloud)は、それぞれ独自の地域別料金体系を持つため対象外です。

同じ1.1倍はClaude Managed Agentsにも及び、エージェントのmodel設定でinference_geo"us"に固定されている場合、そのエージェントを使うセッションのモデルリクエストは全て1.1倍で課金されます。さらに、Priority Tierのコミットメントを持つ場合、inference_geo: "us"で消費した各トークンは、コミット済みTPM(Tokens Per Minute)に対して1.1トークン分として消費される、とも明記されています。

なお、この1.1倍の料金表示自体は、Claude Codeのコスト見積り機能にも反映されています。詳しくは別記事で扱っています。

geoの選択肢が今後増える予定かは分からなかった

"global""us"以外の地域(例えばEU限定など)が将来追加される予定があるかどうかは、今回確認したドキュメントには記載がありませんでした。ただし、ドキュメント末尾の「Current limitations」節には、現時点の制約として次の3点が明記されていました。

  • "Shared rate limits: Rate limits are shared across all geos."
  • "Inference geo: Only 'us' and 'global' are available."
  • "Workspace geo: Only 'us' is currently available. Workspace geo can't be changed after workspace creation."

(訳:共有レート制限:レート制限は全geoで共有される/Inference geo:現時点で使えるのは"us"と"global"のみ/Workspace geo:現時点で使えるのは"us"のみ。ワークスペースgeoはワークスペース作成後に変更できない)

これは「今後増える予定」を積極的に約束する記載ではなく、あくまで「現時点ではこの2つ(Workspace geoは1つ)に限られる」という制約の明記に留まります。将来の拡張予定については、今回確認した情報源からは判断できません。あわせて、Inference geoとは別のWorkspace geo(データの保管場所)は、現時点で選べる値が"us"しかなく、しかもワークスペース作成後は変更できないという、Inference geoよりもさらに制約の強い設計になっている点も、このLimitations節で確認できました。

なお、Claude 4.6より前のモデルでinference_geoを指定した場合の挙動は、同じドキュメントのModel availability節に明記されていました(原文と訳)。

"The inference_geo parameter is supported on Claude 4.6 and later models. Requests with inference_geo on Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5, or earlier models return a 400 error."

(訳:inference_geoパラメータはClaude 4.6以降のモデルでサポートされる。Claude Opus 4.5・Claude Sonnet 4.5・Claude Haiku 4.5以前のモデルでinference_geoを指定したリクエストは400エラーを返す)

料金についても、Pricing節に「Older models: Don't support inference_geo...standard pricing applies」(古いモデルはinference_geoに対応していない・標準料金が適用される)と明記されており、Claude 4.5世代以前は1.1倍の対象外で、パラメータを指定しても400エラーになります。

関連記事

シェア: ポスト はてブ

出典・参照資料

AIニュースの解説を動画でも

YouTubeでは注目ニュースの背景を解説し、Xでは新着記事をお知らせしています。

コメント

まだコメントはありません。最初のコメントを書いてみませんか?

AIについて聞きたいことはありますか?

質問箱で無料で受け付けています。回答は公開され、他の方の参考にもなります。

質問箱を見る →

新しい記事をメールで受け取る

AIの新しい発表を、出典付きで整理して届けます。

関連記事

非エンジニア15人が1週間でAIエージェントを50体に増やした話──Anthropicが公開した1,100人企業の内側の記事画像
プロダクト08.18読了10

非エンジニア15人が1週間でAIエージェントを50体に増やした話──Anthropicが公開した1,100人企業の内側

出典 ─ Anthropic公式ブログ「How ABC
Claude Managed Agentsがリポジトリの.claude/skillsを自動で読むようになった──公式ドキュメントが明記する信頼境界の警告の記事画像
検証09.01読了18

Claude Managed Agentsがリポジトリの.claude/skillsを自動で読むようになった──公式ドキュメントが明記する信頼境界の警告

出典 ─ Claude Managed Agents 公式ドキュメント
Claude Agent SDKを『エディタの共通言語ACP』に翻訳する──Zed製アダプタが対応する機能を数えてみたの記事画像
検証09.04読了13

Claude Agent SDKを『エディタの共通言語ACP』に翻訳する──Zed製アダプタが対応する機能を数えてみた

出典 ─ zed-industries/claude-
AI-Native SDLCとは──Anthropicが「コードの80%をClaudeが書く」現場から逆算した開発フローの記事画像
活用09.01読了21

AI-Native SDLCとは──Anthropicが「コードの80%をClaudeが書く」現場から逆算した開発フロー

出典 ─ The AI-Native SDLC pla
Claude APIが会話の途中でツールセットを変えられるようになった──プロンプトキャッシュを保ったままの記事画像
プロダクト09.01読了18

Claude APIが会話の途中でツールセットを変えられるようになった──プロンプトキャッシュを保ったまま

出典 ─ Claude Developer Platform公式ドキュメント
「トークンマキシング」を追う──燃やした量を成果と呼んでいた数ヶ月間の記事画像
業界09.01読了16

「トークンマキシング」を追う──燃やした量を成果と呼んでいた数ヶ月間

出典 ─ Tokenmaxxing is dead.
Anthropic社内の『GTM Claudification』チーム──自社の営業をエージェント化する求人票を読むの記事画像
業界09.02読了14

Anthropic社内の『GTM Claudification』チーム──自社の営業をエージェント化する求人票を読む

出典 ─ Anthropic採用ページ「AI Engi
Dynamic Workflowsとは──JavaScriptスクリプトで数百のsubagentをオーケストレーションする仕組みの記事画像
活用09.02読了14

Dynamic Workflowsとは──JavaScriptスクリプトで数百のsubagentをオーケストレーションする仕組み

出典 ─ Orchestrate subagents