Claude Platform on AWS の使い方（2026）：Claude Code と Anthropic API を接続する

Q: Claude Code を Claude Platform on AWS で使える？

使える。Claude Code 専用の provider variables、つまり CLAUDE_CODE_USE_ANTHROPIC_AWS=1、ANTHROPIC_AWS_WORKSPACE_ID、AWS_REGION を使う。SigV4 なら AWS credentials、workspace API key なら ANTHROPIC_AWS_API_KEY を合わせて設定する。/status で resolved provider を確認する。

まず結論

2026-05-12 時点で、Claude Platform on AWS は AWS account 経由で使う Anthropic-operated な Claude API、Claude Console、Claude Code 接続経路、そして native platform feature set だ。native Anthropic features を使いつつ、AWS Marketplace billing、IAM access control、CloudTrail visibility、AWS commitment retirement が必要なら Claude Platform on AWS を使う。security review で AWS が inference stack を運用し、data processor であることが必須なら Amazon Bedrock を使う。

最短の安全な setup path は次の通り。

AWS Console で Claude Platform on AWS を subscribe する。
AWS-linked Anthropic organization setup を完了する。
workspace を作成し、wrkspc_... ID を保存する。
AWS account で outbound web identity federation を有効化する。
AWS gateway SDK helper または workspace API key で Anthropic Messages API をテストする。
CLAUDE_CODE_USE_ANTHROPIC_AWS=1、ANTHROPIC_AWS_WORKSPACE_ID、AWS_REGION で Claude Code を同じ workspace に向ける。
inference-level audit logs が必要なら CloudTrail data events を有効化する。

これは URL が違うだけの Bedrock ではない。Claude Platform on AWS は Anthropic-managed infrastructure を使う。AWS は authentication、IAM、Marketplace billing、CloudTrail integration を担当し、Anthropic が inference inputs と outputs を処理する。

2026-05-11 に何が変わったのか

AWS と Anthropic は 2026-05-11 に Claude Platform on AWS の general availability を発表した。Claude を使う team にとって、これは 3 つ目の実用的な path になる。

Path	inference の運用者	主な API surface	billing path	向いている用途
Claude first-party API	Anthropic	Anthropic Messages API	Anthropic	Anthropic と直接契約し、native API setup を最速にしたい場合
Claude Platform on AWS	Anthropic	`aws-external-anthropic.{region}.api.aws` 経由の Anthropic Messages API	AWS Marketplace	native Anthropic platform を AWS IAM、CloudTrail、Marketplace billing と一緒に使いたい場合
Claude in Amazon Bedrock	AWS	Bedrock APIs または Bedrock の Anthropic Messages endpoint	AWS native service	AWS-operated inference、AWS data processor boundary、Bedrock-native controls が必要な場合

重要なのは、team が Anthropic first-party API と Bedrock の二択だけではなくなった点だ。Claude Platform on AWS は Messages API、Agent Skills、code execution、web search、web fetch、MCP connector、Files API、batch processing、prompt caching、Claude Managed Agents などの native Anthropic feature surface を保つ。その代わり、inference boundary は AWS ではなく Anthropic 側にある。

この setup を使う価値があるケース

次の条件が多く当てはまるなら Claude Platform on AWS が向いている。

native Claude API models と beta headers を同じ cadence で使いたい
Claude Code、Claude Cowork、Agent Skills、code execution、Files API、Managed Agents が計画に入っている
procurement が AWS Marketplace billing または AWS commitment retirement を求めている
IAM policies と workspace ARNs が team の access-control system として既に使われている
CloudTrail events と AWS Cost Explorer に adoption path を出したい
security review が Anthropic を inference data processor として受け入れられる

次の要件があるなら Claude in Amazon Bedrock を使う。

AWS が inference を運用し、data processor である必要がある
strict regional data residency が native Anthropic feature timing より重要
architecture が Bedrock-native controls、model routing、Guardrails、Knowledge Bases、既存の Bedrock governance に依存している
commercial terms、limits、operational dashboards が Bedrock 前提で標準化されている

Decision Table

Question	Better answer	Why
AWS billing 経由で native Claude API features が必要？	Claude Platform on AWS	Anthropic Messages API と native platform features を AWS Marketplace 経由で使える。
Claude Code を AWS-governed workspace に紐づけたい？	Claude Platform on AWS	Claude Code には `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` の専用 provider path がある。
AWS-operated inference または AWS を唯一の processor にしたい？	Claude in Amazon Bedrock	Bedrock では AWS が operating party と data processor になる。
Anthropic API で per-request US inference geography が必要？	Claude Platform on AWS、`inference_geo="us"` を指定	workspace region だけでは inference geography は固定されない。request parameter が必要。
Bedrock-native APIs と controls が必要？	Claude in Amazon Bedrock	Bedrock は service endpoints、model IDs、IAM actions、operational controls が異なる。
developer 向けに長期的な enterprise access が必要？	SigV4 / temporary AWS credentials を優先	Workspace API keys は使えるが long-lived secret で、設定されていると SigV4 より優先される。

始める前に準備するもの

production tooling に触る前に、次を揃えておく。

Item	確認すること	なぜ重要か
AWS account	AWS Marketplace services を subscribe できる account か	Claude Platform on AWS は AWS Marketplace で activate する。
Private offer status	最初の real request 前に既存の Bedrock または Anthropic private offers を確認する	正しい private offer を accept する前の usage に discount は retroactive に適用されない。
Workspace plan	team、environment、app boundary を workspace に対応させる	Workspace IDs は client routing、IAM resource scoping、usage、cost、files、batches、Skills に使われる。
AWS region	workspace region を意図して選ぶ	region は gateway endpoint と AWS-side scope を選ぶ。model inference geography はこれだけでは固定されない。
Auth path	pilot は API key、shared production path は SigV4	implementation と risk profile が違う。
IAM policy	`aws-external-anthropic:*` permissions を可能な限り workspace ARN に scope する	Workspaces が primary IAM resource になる。
Claude Code plan	CLI、Agent SDK、model pins、SSO refresh、usage reporting を rollout 前に決める	Claude Code は独自の `ANTHROPIC_AWS_*` configuration path を使い、usage reporting も first-party Claude Code と違う。
Network path	production traffic 前に public endpoint か AWS PrivateLink かを決める	VPC から Claude Platform on AWS endpoint へ private connectivity が必要な場合、AWS PrivateLink が使える。
Logging plan	inference audit が必要なら CloudTrail management events と data event logging を設計する	Inference events は data events で、default management-event logging では取得されない。
Cost tags	`team`、`environment`、`application`、`cost-center` を事前に決める	AWS Cost Explorer は aggregate CCU cost を表示する。tags は後の cost allocation に効く。

AWS Console の Claude Platform on AWS service page から始める。

Sign up を選び、setup flow で表示される AWS と Anthropic の terms を accept する。
redirect された Anthropic organization setup を完了する。
AWS Console の prompt に従って workspace を作る。
wrkspc_... 形式の workspace ID を記録する。
その workspace の AWS region を記録する。

AWS Marketplace subscription は、AWS account に紐づく新しい Anthropic organization を作る。既存の first-party Claude Console organization とは別物だ。既存の first-party API keys、workspaces、console settings は自動では引き継がれない。

最初の real request の前に private-offer timing を確認する価値がある。Anthropic docs では、既存の Bedrock private offers は Claude Platform on AWS に自動移行されず、private offer accept 前に発生した usage へ discounts を retroactive に適用できないと説明されている。

production traffic の前に、この procurement checklist を確認する。

account が public Marketplace subscription なのか、Claude Platform on AWS private offer なのかを確認する
Bedrock private offer を Claude Platform on AWS discount として扱っていないことを確認する
既存の Anthropic direct private offer が適用されるかを確認し、effective date を書面で残す
この Marketplace product が AWS commitment retirement の対象になる想定か確認する
最初の billing cycle で誰が AWS Cost Explorer の CCU usage を review するか記録する

Step 2: AWS Account の前提条件を有効化する

Anthropic docs は API traffic 前に必要な account-level prerequisite を 1 つ挙げている。AWS account ごとに outbound web identity federation を有効化する。

aws iam enable-outbound-web-identity-federation

確認する。

aws iam get-outbound-web-identity-federation-info

これを飛ばすと、request は Outbound web identity federation is disabled for your account で失敗する可能性がある。SDK code、model IDs、Claude Code settings を疑う前にここを直す。

Step 3: 最初の API test で API Key か SigV4 を選ぶ

Claude Platform on AWS は 2 つの auth path をサポートする。

Auth path	使いどころ	主なリスク
Workspace API key	local validation、demo、one-off scripts、SigV4 署名できない tool	long-lived secret であり、存在すると SigV4 より優先される。
IAM / SigV4	CI、shared services、internal gateways、production developer tooling	IAM role に正しい `aws-external-anthropic` actions と region が必要。
Short-term API key	AWS credentials を保持できない process に temporary `x-api-key` token を渡す場合	SDK は token を自動 refresh しない。

AWS gateway helper を提供する SDK では、shared tools にはその helper を優先する。base URL、workspace header、SigV4 behavior をまとめて扱えるからだ。Anthropic の current docs は Python platform-specific client を次のように示している。

export ANTHROPIC_AWS_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"
export AWS_REGION="us-west-2"

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ready."}],
)

print(message)

この platform-specific client は、default で ANTHROPIC_AWS_WORKSPACE_ID と AWS_REGION を environment から読み、https://aws-external-anthropic.<region>.api.aws を計算し、API key がない場合は AWS credential chain から SigV4 signing を行い、required な anthropic-workspace-id header を送る。Anthropic はこれらの Claude Platform on AWS SDK clients を beta としているため、production tools では SDK versions を pin する。

API key pilot の場合は、AWS Console の Claude Platform on AWS -> API keys で key を作り、次を設定する。

export ANTHROPIC_AWS_API_KEY="sk-ant-xxxxx"

同じ AnthropicAWS() example はこの API key でも動く。ANTHROPIC_AWS_API_KEY が default AWS credential chain より優先されるからだ。quick API-key smoke test では、AWS launch post の generic Anthropic client も使える。

export ANTHROPIC_API_KEY="&#x3C;your-workspace-api-key>"
export ANTHROPIC_BASE_URL="https://aws-external-anthropic.&#x3C;your-region>.api.aws"
export ANTHROPIC_WORKSPACE_ID="&#x3C;your-workspace-id>"

from anthropic import Anthropic
import os

client = Anthropic(
    default_headers={
        "anthropic-workspace-id": os.environ["ANTHROPIC_WORKSPACE_ID"]
    }
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ready."}],
)

print(message.content)

これは smoke test として使い、team の final pattern にはしない。production では AWS gateway SDK helper と temporary AWS credentials または IAM roles を優先する。

Step 4: IAM の形を正しくする

SigV4 では、まず process が使う AWS identity を確認する。

aws sts get-caller-identity

SigV4 service name と IAM action namespace はどちらも aws-external-anthropic だ。real-time inference、model lookup、token counting の tight starter policy は次のような actions を必要とする。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CreateInference",
        "aws-external-anthropic:CountTokens",
        "aws-external-anthropic:GetModel",
        "aws-external-anthropic:ListModels",
        "aws-external-anthropic:GetWorkspace"
      ],
      "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
    },
    {
      "Effect": "Allow",
      "Action": "aws-external-anthropic:ListWorkspaces",
      "Resource": "*"
    }
  ]
}

同じ principal に workspace API keys の利用も許可するなら、aws-external-anthropic:CallWithBearerToken を Resource: "*" で追加する。Anthropic docs では、この action は authentication-layer action であり、workspace-ARN-scoped route action ではないと説明されている。

credential precedence は見落としやすい。Platform-specific clients は constructor API key、constructor AWS access key pair、constructor AWS profile、ANTHROPIC_AWS_API_KEY、default AWS credential chain の順で auth を解決する。shell に古い ANTHROPIC_AWS_API_KEY が残っていると、SDK は有効な SigV4 credentials を無視し、その古い API key で送信する。

Step 5: Claude Code を同じ Workspace に向ける

Claude Code では ANTHROPIC_BASE_URL と ANTHROPIC_CUSTOM_HEADERS だけに頼らない。Claude Code には Claude Platform on AWS 専用の provider path がある。

SSO profile を使った SigV4 の例：

aws sso login --profile my-profile
export AWS_PROFILE="my-profile"
export AWS_REGION="us-west-2"
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"

workspace API key の例：

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"
export AWS_REGION="us-west-2"
export ANTHROPIC_AWS_API_KEY="sk-ant-xxxxx"

Claude Code を開いたら、次を実行する。

/status

status output には resolved provider、workspace ID、region、base URL override があればそれ、auth-skip setting が表示されるはずだ。request がまだ api.anthropic.com に行くなら、CLAUDE_CODE_USE_ANTHROPIC_AWS が missing か truthy ではない。CLAUDE_CODE_USE_BEDROCK または CLAUDE_CODE_USE_FOUNDRY も設定されている場合は unset する。Claude Code provider routing では Bedrock と Foundry が Claude Platform on AWS より優先される。

team rollout 前に model aliases を pin しておくと、新 model release で全員が同時に移動することを避けられる。

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

Claude Code usage reporting は first-party Claude Code と同じだと考えない。Anthropic の current Claude Platform on AWS docs では、Claude Code workspace and Analytics API は利用不可、automatic rate limits 付き workspace も利用不可、Claude Code usage は dedicated screen ではなく general usage view に出ると説明されている。

developer が AWS SSO を使い、長い Claude Code session 中に credentials が expire する場合は、Claude Code settings に awsAuthRefresh command を追加する。CLI が login flow を再実行でき、task の途中で失敗しにくくなる。

Step 6: Data Residency を約束する前にテストする

workspace は 1 つの AWS region に紐づく。この region は gateway endpoint と、IAM、CloudTrail、billing、usage、quotas、files、batches、Skills の AWS-side scope を制御する。ただし model inference がどこで走るかを自動で固定するものではない。

2026-05-12 時点で、Claude Platform on AWS は 2 つの inference geographies をサポートする。

`inference_geo`	何をするか	cost note
`global`	Anthropic-operated data centers worldwide に inference を route できる	standard pricing。省略時の default。
`us`	inference を US data centers に留める	1.1x pricing multiplier が適用される。

必要な場合は request ごとに inference geography を設定する。

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=256,
    inference_geo="us",
    messages=[{"role": "user", "content": "Reply with the word ready."}],
)

print(message)

model support も contract の一部だ。Anthropic docs では、inference_geo は Claude Opus 4.6、Claude Sonnet 4.6、および later models でサポートされる。Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5 に inference_geo を付けると 400 error になる。US-only inference が必要な workflow では、Claude Code や API clients を claude-haiku-4-5 に pin しない。

これを blanket compliance statement にしてはいけない。Anthropic は Claude Platform on AWS では workspace-level inference geography controls が利用できないと説明している。inference_geo は request ごとに設定する必要がある。Zero Data Retention は first-party Claude API model に従い、Anthropic account representative 経由で request できる。data-retention guarantees に依存する workload を移す前に、ZDR enrollment を確認する。

Step 7: 本当に必要な Logging を有効化する

CloudTrail coverage は便利だが、正しい event class を設定している場合に限る。

AWS と Anthropic は 2 つの logging layer を分けている。

workspace and vault operations は management events で、default で表示される
inference、batch、file、skill、model、user profile、Claude Managed Agents operations は data events で、CloudTrail data event logging を明示的に有効化する必要がある

review ではこの違いが重要だ。API call が成功していて CloudTrail management-event trail が静かな場合、inference logging が壊れているとは限らない。多くの場合 data events が有効化されていないだけだ。

debug 時は両方の request IDs を保存する。

x-amzn-requestid: AWS-side investigation と CloudTrail lookup 用
request-id: Anthropic support 用

実務的な internal acceptance test は次の通り。

AWS gateway helper または SigV4-signed client で SDK request を 1 回実行する。
/status で AWS provider を確認した後、Claude Code prompt を 1 回実行する。
期待される遅延後、両方が Claude Console usage に出ることを確認する。
data event logging を有効化した後、API request が CloudTrail に入ることを確認する。
cost が AWS Cost Explorer に Claude Consumption Unit line item として表示されることを確認する。

Step 8: Spend が広がる前に Workspace に Tag を付ける

Claude Platform on AWS usage は AWS Marketplace を通じて Claude Consumption Units（CCUs）で billed される。Anthropic docs では、CCUs は hourly に metered され、monthly in arrears で invoice される。CCUs は prepaid credits や balance ではない。

初日から小さな mandatory tag set を使う。

team
environment
application
cost-center

rate-limit increases の owner も決めておく。Claude Platform on AWS は Anthropic-managed Tier 1 limits から始まり、AWS Service Quotas ではない。automatic tier advancement も first-party Claude API と同じではない。workspace を pilot から production に進めるなら、最初の launch week 前に higher limits を request する担当者を決める。

Team がよく間違える点

Bedrock の新しい名前だと思い込む

違う。Claude Platform on AWS は Anthropic Messages API、claude-sonnet-4-6 のような Anthropic model IDs、aws-external-anthropic endpoint と IAM namespace を使う。Bedrock は endpoints、model IDs、service names、control planes、release timing が異なる。

Workspace Region を Data Residency の約束として扱う

workspace region は AWS gateway endpoint と AWS-side resources を制御する。inference geography は固定しない。US-only inference が必要なら、request ごとに inference_geo="us" を渡し、1.1x multiplier を budget に入れる。

古い API Key で SigV4 を上書きしてしまう

ANTHROPIC_AWS_API_KEY は default AWS credential chain より優先される。developer が「IAM fix が効かない」と言う場合、古い workspace API key がまだ export されていないか確認する。

Claude Code の Provider Switch を忘れる

AWS credentials があるだけでは、Claude Code は自動で Claude Platform on AWS を使わない。CLAUDE_CODE_USE_ANTHROPIC_AWS=1 を設定し、Bedrock や Foundry provider flags があれば unset し、/status で確認する。

すべての Anthropic API Feature が使えると期待する

Messages API features の多くは first-party Claude API と一致するが、current gaps がある。2026-05-12 時点で Anthropic が利用不可としているものには、HIPAA readiness、workspace endpoints 以外の多くの Admin API endpoints、workspace member management、spend limits、OAuth authentication、Fast mode、OpenAI-compatible endpoints、workspace-level inference geography controls、Claude Code workspace / Analytics APIs が含まれる。

最初に試すならこの Use Case

最もきれいな first use case は、1 つの platform team または security team 向けの internal coding workflow だ。

実用的な pilot は次のように組める。

pilot team と environment 用に 1 つの workspace を作る。
AWS account で outbound web identity federation を有効化する。
小さな IAM role に CreateInference、model read、workspace read、ListWorkspaces access を付与する。
developer machine または CI runner から AnthropicAWS() smoke test を 1 回実行する。
CLAUDE_CODE_USE_ANTHROPIC_AWS=1、ANTHROPIC_AWS_WORKSPACE_ID、AWS_REGION で Claude Code を設定する。
最初の real coding task の前に /status を実行する。
pilot が inference auditability を証明する必要があるなら、CloudTrail data event logging を有効化する。
2 つ目の team を追加する前に、Claude Console usage と AWS Cost Explorer を review する。

この pilot で service boundary、IAM path、Claude Code configuration、logging path、cost allocation pattern を一度に検証できる。pilot が Claude Managed Agents も使うなら、追加の制限を考慮する。Claude Platform on AWS では、autonomous session は user events なしで最大 6 時間まで実行でき、その後 reauthentication が必要になる。

FAQ

Claude Platform on AWS を使うには別の Anthropic account が必要？

billing activation には別契約は不要だが、AWS Marketplace subscription は separate AWS-linked Anthropic organization を作る。既存の first-party Claude Console organization ではなく、その AWS-linked organization の workspace IDs と API keys を使う。

Claude Platform on AWS は Claude in Amazon Bedrock と同じ？

違う。Claude Platform on AWS は Anthropic-operated で、AWS authentication と Marketplace billing 経由で native Anthropic platform を提供する。Claude in Amazon Bedrock は AWS-operated で、AWS が data processor でなければならない場合に向いている。

Claude Code を Claude Platform on AWS で使える？

使える。Claude Code 専用の provider variables、つまり CLAUDE_CODE_USE_ANTHROPIC_AWS=1、ANTHROPIC_AWS_WORKSPACE_ID、AWS_REGION を使う。SigV4 なら AWS credentials、workspace API key なら ANTHROPIC_AWS_API_KEY を合わせて設定する。/status で resolved provider を確認する。

IAM と API key、どちらから始めるべき？

多くの team では、workspace API key は 1 回の quick validation test に限る。shared tools、CI、production developer workflows は temporary AWS credentials または IAM roles と SigV4 に移す。

AWS region は inference location を保証する？

しない。workspace region は gateway endpoint と AWS-side resources を選ぶだけだ。inference geography が重要なら request ごとに inference_geo を設定する。省略時は global。inference_geo="us" は inference を US data centers に留め、1.1x pricing multiplier が適用される。Claude Opus 4.6、Claude Sonnet 4.6、または later models でのみ使う。

Bedrock から移行する前に何を確認すべき？

data processor requirement、private offer と discount path、model ID changes、SigV4 service name、required workspace header、CloudTrail data-event logging、ZDR enrollment、spend limits や Fast mode などの feature gaps を確認する。

検証メモ

この記事は 2026-05-12 に以下の公式情報で検証した。

AWS launch post: GA timing、AWS Marketplace activation、native platform feature examples、first API key smoke test、CloudTrail summary、tags、supported-region announcement を確認：https://aws.amazon.com/blogs/machine-learning/introducing-claude-platform-on-aws-anthropics-native-platform-through-your-aws-account/
Anthropic Claude Platform on AWS docs: architecture、Bedrock comparison、setup flow、outbound web identity federation、AnthropicAWS、auth paths、model IDs、feature gaps、inference_geo support limits、workspace scoping、CCU billing、CloudTrail event classes、PrivateLink、Managed Agents session behavior、migration notes、IAM action examples を確認：https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws
Claude Code docs: Claude Platform on AWS provider variables、SigV4 vs workspace API key behavior、/status、model pinning、proxy options、Bedrock / Foundry provider precedence を確認：https://code.claude.com/docs/en/claude-platform-on-aws
Anthropic launch blog: same-day native API feature positioning、global / US inference geographies、Bedrock boundary guidance、private-offer warning を確認：https://claude.com/blog/claude-platform-on-aws