Claude Platform on AWS

是什么

Claude Platform on AWS 是通过 AWS Marketplace 订阅的 Anthropic 托管 Claude API，使用 AWS 认证（SigV4 或 workspace API key）和 AWS Marketplace 计费，同时保留 Anthropic 直接 API 的功能特性。与 Amazon Bedrock 不同，这是 Anthropic 运营的 API，只是通过 AWS 认证和计费。

核心机制

与 Amazon Bedrock 的区别

• Claude Platform on AWS：Anthropic 运营的 API，AWS 认证 + AWS Marketplace 计费，使用 Anthropic API 的模型 ID
• Amazon Bedrock：AWS 运营的服务，AWS 认证 + AWS 计费，使用 Bedrock 格式的模型 ID

前置条件

• 通过 AWS Marketplace 的活跃 Claude Platform on AWS 订阅
• AWS 关联的 Anthropic 组织中的 workspace ID
• IAM 权限或 workspace API key

注意：AWS Marketplace 订阅创建的 Anthropic 组织与已有 Claude Console 账号相互独立，凭证不通用。

认证方式

# 方式 A：SigV4（AWS 标准凭证链）
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
 
# 方式 B：Workspace API key
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

配置环境变量

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1
# 可选：覆盖 base URL
# export ANTHROPIC_AWS_BASE_URL=https://aws-external-anthropic.us-east-1.api.aws

SSO 凭证自动刷新

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

凭证过期时自动重新登录并重试，避免 session 中断。

固定模型版本 使用与 Anthropic API 相同的模型 ID（如 claude-sonnet-4-6），团队部署时固定版本。

关键细节

• CLAUDE_CODE_USE_ANTHROPIC_AWS=1 是 opt-in，即使环境中有 AWS 凭证也不会自动启用
• Bedrock 和 Foundry 的路由优先级高于 Claude Platform on AWS，需确保未设置 CLAUDE_CODE_USE_BEDROCK 和 CLAUDE_CODE_USE_FOUNDRY
• /login 和 /logout 命令在此模式下不改变认证状态
• Workspace API key 优先级高于 SigV4，两者同时存在时使用 API key

与其他概念的关联

• amazon-bedrock - 另一种 AWS 路径，AWS 运营的 Bedrock 服务
• authentication - 认证方式总览
• costs - 成本追踪

实践要点

• 使用 AWS Marketplace 订阅时，从 AWS 关联的 Anthropic 组织获取 workspace ID 和 API key
• CI/CD 环境推荐使用 IAM role，本地开发推荐 SSO profile
• 配置 awsAuthRefresh 避免长时间 session 中 SSO 凭证过期问题