文档索引

在以下地址获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

Claude Code 在 AWS 上的 Claude 平台

配置 Claude Code 使用由 Anthropic 运营的 Claude API，支持 AWS 认证、IAM 访问控制和 AWS Marketplace 计费。

AWS 上的 Claude 平台是由 Anthropic 运营的 Claude API，支持 AWS 认证、IAM 访问控制和 AWS Marketplace 计费。请求直接到达 Anthropic 的 API，因此您获得与 Claude API 相同的模型和功能，发布计划也相同。您使用 AWS 凭证或工作区 API 密钥进行认证，通过 AWS Marketplace 付费。

使用本指南将 Claude Code 指向您已通过 AWS 上的 Claude 平台预配置的工作区。有关此之前的 AWS 订阅和工作区设置，请参阅 AWS 上的 Claude 平台文档。

前提条件

在配置 Claude Code 之前，您需要：

• 通过 AWS Marketplace 的有效 AWS 上的 Claude 平台订阅
• 在您的 AWS 关联 Anthropic 组织中的工作区及其工作区 ID
• 有权调用 Anthropic 服务的 IAM 主体，或限定到工作区的 API 密钥
• 环境中的 AWS 凭证、~/.aws/credentials 中的凭证，或附加的 IAM 角色（如果您需要 SigV4 认证）。AWS CLI 仅在 SSO 登录流程中需要。

设置

1. 配置 AWS 凭证

Claude Code 支持两种 AWS 上的 Claude 平台认证方法。选择适合您团队管理访问权限的方式。

选项 A：带 SigV4 的 AWS 凭证

Claude Code 使用标准 AWS 凭证链通过 SigV4 签名请求：环境变量、~/.aws/credentials 中的共享凭证、IAM 角色、AWS SSO 会话以及 AWS SDK 支持的任何其他来源。

对于本地使用，在启动 Claude Code 之前使用 AWS CLI 登录。以下示例使用 SSO 配置文件，但任何在标准位置产生凭证的方法都可以。

aws sso login --profile my-profile
export AWS_PROFILE=my-profile

对于 CI 和自动化，为运行者提供有权调用 Anthropic 服务的 IAM 角色并设置 AWS_REGION。凭证链会自动获取角色。

如果您的 SSO 凭证在会话期间过期，配置 awsAuthRefresh 以便 Claude Code 重新运行登录命令并重试而不是失败。将命令添加到您的 settings.json 中：

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

选项 B：工作区 API 密钥

工作区 API 密钥是一个长期有效的密钥，适用于您不想管理联合 AWS 凭证的场景。在 AWS 控制台的 Claude Platform on AWS -> API keys 下生成一个，并将其设置为 ANTHROPIC_AWS_API_KEY：

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

该密钥作为 x-api-key 发送，优先于 SigV4，因此环境中的任何 AWS 凭证都会被忽略。来自单独 Claude Console 组织的 API 密钥在此处不起作用。

将工作区 API 密钥视为任何其他生产凭证。用户设置文件的 env 块是一种方便的方式，可以将密钥限定到您的机器而不全局导出。

2. 配置 Claude Code

设置环境变量，将 Claude Code 通过 AWS 上的 Claude 平台路由，而不是默认的 Anthropic API。

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1

ANTHROPIC_AWS_WORKSPACE_ID 是必需的，作为 anthropic-workspace-id 头发送到每个请求。基础 URL 从 AWS_REGION 计算为 https://aws-external-anthropic.{region}.api.aws。要直接覆盖 URL，请设置 ANTHROPIC_AWS_BASE_URL。

即使环境中存在 AWS 凭证，AWS 上的 Claude 平台也是选择加入的。Bedrock 和 Foundry 在提供商路由中优先级更高，因此如果设置了 CLAUDE_CODE_USE_BEDROCK 和 CLAUDE_CODE_USE_FOUNDRY，请取消设置它们。

3. 固定模型版本

AWS 上的 Claude 平台使用与直接 Claude API 相同的模型 ID。默认别名 opus、sonnet 和 haiku 解析为工作区中可用的最新版本。

如果您将 Claude Code 部署到团队，请明确固定模型 ID，以便新版本不会同时影响所有人：

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

有关模型 ID 和别名的完整列表，请参阅模型概述。有关其他模型相关变量，请参阅模型配置。

提示缓存会自动启用。要请求 1 小时缓存 TTL 代替 5 分钟默认值，请设置 ENABLE_PROMPT_CACHING_1H=1。API 对 1 小时缓存写入的计费费率更高。有关费率，请参阅提示缓存定价。

使用 Agent SDK

Agent SDK 读取与 CLI 相同的环境变量，因此任何生成 Claude Code 子进程的程序都可以通过在调用前导出 CLAUDE_CODE_USE_ANTHROPIC_AWS、ANTHROPIC_AWS_WORKSPACE_ID 和 ANTHROPIC_AWS_API_KEY 或 AWS 凭证来指向 AWS 上的 Claude 平台。

import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}

此示例依赖环境中的 AWS 凭证链进行 SigV4。要改用工作区 API 密钥认证，请以相同方式设置 ANTHROPIC_AWS_API_KEY。有关更广泛的 Agent SDK 接口，请参阅 Agent SDK 概述。

通过企业代理路由

要通过代理或 LLM 网关路由流量，请将 ANTHROPIC_AWS_BASE_URL 设置为代理的地址。Claude Code 使用相同的工作区和认证头向该 URL 发送请求，因此任何原样转发它们的网关都可以工作。

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

如果您的网关自行签名请求，请设置 CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1，以便 Claude Code 发送未签名的请求并让网关在转发到 AWS 之前添加 SigV4 头。如果网关需要自己的令牌，请在 ANTHROPIC_AUTH_TOKEN 中设置。

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

故障排除

运行 /status 查看解析的提供商以及任何明确配置的工作区 ID、区域、URL 覆盖和认证跳过设置。这是确认 Claude Code 是否指向 AWS 上的 Claude 平台的最快方式。

每个请求都出现 403 Forbidden 或 AccessDenied

Claude Code 解析的 IAM 主体可能缺少在您的工作区中调用 Anthropic 服务的权限。检查附加到您的 AWS 配置文件或启动 Claude Code 的运行者的角色，并验证它具有 IAM 操作参考中记录的 aws-external-anthropic 操作。

如果您设置了 ANTHROPIC_AWS_API_KEY，该密钥优先于 SigV4，过期的密钥会产生相同的错误。在 AWS 控制台的 Claude Platform on AWS -> API keys 下重新生成密钥，或取消设置该变量以回退到您的 AWS 凭证。

请求因缺少工作区错误而失败

ANTHROPIC_AWS_WORKSPACE_ID 可能未设置或为空。每个 AWS 上的 Claude 平台请求都必须包含工作区 ID。它不会由您的 AWS 凭证隐含。在 AWS 控制台服务页面的 Workspaces 下找到 ID，并在启动 Claude Code 之前导出它。

请求仍然发送到 api.anthropic.com

CLAUDE_CODE_USE_ANTHROPIC_AWS 可能未设置或设置为无法解析为真值的值。将其设置为 1 并运行 /status 确认解析的提供商。如果还设置了 CLAUDE_CODE_USE_BEDROCK 或 CLAUDE_CODE_USE_FOUNDRY，它们的优先级高于 AWS 上的 Claude 平台。

其他资源

配置 Claude Code 之前的 AWS 上的 Claude 平台订阅、工作区和 IAM 设置在平台文档中有说明：

• AWS 上的 Claude 平台概述：订阅、工作区设置和产品参考
• IAM 操作参考：权限和托管策略