{/* TRANSLATED — 已翻译为中文 */}

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

# Claude Code 在 AWS 上的 Claude 平台

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

export const ContactSalesCard = ({surface}) => {
  const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;
  const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
      <line x1="5" y1="12" x2="19" y2="12" />
      <polyline points="12 5 19 12 12 19" />
    </svg>;
  const STYLES = `
.cc-cs {
  --cs-slate: #141413;
  --cs-clay: #d97757;
  --cs-clay-deep: #c6613f;
  --cs-gray-000: #ffffff;
  --cs-gray-700: #3d3d3a;
  --cs-border-default: rgba(31, 30, 29, 0.15);
  font-family: inherit;
}
.dark .cc-cs {
  --cs-slate: #f0eee6;
  --cs-gray-000: #262624;
  --cs-gray-700: #bfbdb4;
  --cs-border-default: rgba(240, 238, 230, 0.14);
}
.cc-cs-card {
  display: flex; align-items: center; justify-content: space-between;
  gap: 16px; padding: 14px 16px; margin: 0;
  background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);
  border-radius: 8px; flex-wrap: wrap;
}
.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }
.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }
.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
.cc-cs-btn-clay {
  display: inline-flex; align-items: center; gap: 8px;
  background: var(--cs-clay-deep); color: #fff; border: none;
  border-radius: 8px; padding: 8px 14px;
  font-size: 13px; font-weight: 500;
  transition: background-color 0.15s; white-space: nowrap;
}
.cc-cs-btn-clay:hover { background: var(--cs-clay); }
.cc-cs-btn-ghost {
  display: inline-flex; align-items: center; gap: 8px;
  background: transparent; color: var(--cs-gray-700);
  border: 0.5px solid var(--cs-border-default);
  border-radius: 8px; padding: 8px 14px;
  font-size: 13px; font-weight: 500;
}
.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }
.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }
@media (max-width: 720px) {
  .cc-cs-actions { width: 100%; }
}
`;
  return <div className="cc-cs not-prose">
      <style>{STYLES}</style>
      <div className="cc-cs-card">
        <div className="cc-cs-text">
          <strong>在组织中部署 Claude Code？</strong>联系销售了解企业计划、SSO 和集中计费。
        </div>
        <div className="cc-cs-actions">
          <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">
            查看计划
          </a>
          <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">
            联系销售 {iconArrowRight()}
          </a>
        </div>
      </div>
    </div>;
};

export const Experiment = ({flag, treatment, children}) => {
  const VID_KEY = 'exp_vid';
  const CONSENT_COUNTRIES = new Set(['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE', 'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'RE', 'GP', 'MQ', 'GF', 'YT', 'BL', 'MF', 'PM', 'WF', 'PF', 'NC', 'AW', 'CW', 'SX', 'FO', 'GL', 'AX', 'GB', 'UK', 'AI', 'BM', 'IO', 'VG', 'KY', 'FK', 'GI', 'MS', 'PN', 'SH', 'TC', 'GG', 'JE', 'IM', 'CA', 'BR', 'IN']);
  const fnv1a = s => {
    let h = 0x811c9dc5;
    for (let i = 0; i < s.length; i++) {
      h ^= s.charCodeAt(i);
      h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);
    }
    return h >>> 0;
  };
  const bucket = (seed, vid) => fnv1a(fnv1a(seed + vid) + '') % 10000 < 5000 ? 'control' : 'treatment';
  const [decision] = useState(() => {
    const params = new URLSearchParams(location.search);
    const preBucketed = document.documentElement.dataset['gb_' + flag.replace(/-/g, '_')];
    const force = params.get('gb-force');
    if (force) {
      for (const p of force.split(',')) {
        const [k, v] = p.split(':');
        if (k === flag) return {
          variant: v || 'treatment',
          track: false
        };
      }
    }
    if (navigator.globalPrivacyControl) {
      return {
        variant: 'control',
        track: false
      };
    }
    const prefsMatch = document.cookie.match(/(?:^|; )anthropic-consent-preferences=([^;]+)/);
    if (prefsMatch) {
      try {
        if (JSON.parse(decodeURIComponent(prefsMatch[1])).analytics !== true) {
          return {
            variant: 'control',
            track: false
          };
        }
      } catch {
        return {
          variant: 'control',
          track: false
        };
      }
    } else {
      const country = params.get('country')?.toUpperCase() || (document.cookie.match(/(?:^|; )cf_geo=([A-Z]{2})/) || [])[1];
      if (!country || CONSENT_COUNTRIES.has(country)) {
        return {
          variant: 'control',
          track: false
        };
      }
    }
    let vid;
    try {
      const ajsMatch = document.cookie.match(/(?:^|; )ajs_anonymous_id=([^;]+)/);
      if (ajsMatch) {
        vid = decodeURIComponent(ajsMatch[1]).replace(/^"|"$/g, '');
      } else {
        vid = localStorage.getItem(VID_KEY);
        if (!vid) {
          vid = crypto.randomUUID();
        }
        document.cookie = `ajs_anonymous_id=${vid}; domain=.claude.com; path=/; Secure; SameSite=Lax; max-age=31536000`;
      }
      try {
        localStorage.setItem(VID_KEY, vid);
      } catch {}
    } catch {
      return {
        variant: 'control',
        track: false
      };
    }
    const variant = preBucketed === '1' ? 'treatment' : preBucketed === '0' ? 'control' : bucket(flag, vid);
    return {
      variant,
      track: true,
      vid
    };
  });
  useEffect(() => {
    if (!decision.track) return;
    fetch('https://api.anthropic.com/api/event_logging/v2/batch', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'x-service-name': 'claude_code_docs'
      },
      body: JSON.stringify({
        events: [{
          event_type: 'GrowthbookExperimentEvent',
          event_data: {
            device_id: decision.vid,
            anonymous_id: decision.vid,
            timestamp: new Date().toISOString(),
            experiment_id: flag,
            variation_id: decision.variant === 'treatment' ? 1 : 0,
            environment: 'production'
          }
        }]
      }),
      keepalive: true
    }).catch(() => {});
  }, []);
  return decision.variant === 'treatment' ? treatment : children;
};

<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

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

使用本指南将 Claude Code 指向您已通过 AWS 上的 Claude 平台预配置的工作区。有关此之前的 AWS 订阅和工作区设置，请参阅 [AWS 上的 Claude 平台文档](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。

<Note>
  通过 AWS Marketplace 订阅会预配置一个与您的 AWS 账户关联的新 Anthropic 组织。此组织与您已有的任何 Anthropic 组织是分开的，凭证不会在它们之间转移。使用来自 AWS 关联组织的工作区 ID 和 API 密钥，而不是来自预先存在的 Claude Console 账户的。
</Note>

## 前提条件

在配置 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 配置文件，但任何在标准位置产生凭证的方法都可以。

```bash theme={null}
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
```

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

如果您的 SSO 凭证在会话期间过期，配置 [`awsAuthRefresh`](/cn/amazon-bedrock#高级凭证配置) 以便 Claude Code 重新运行登录命令并重试而不是失败。将命令添加到您的 `settings.json` 中：

```json theme={null}
{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}
```

**选项 B：工作区 API 密钥**

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

```bash theme={null}
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx
```

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

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

<Note>
  `/login` 和 `/logout` 命令不会更改 AWS 上的 Claude 平台认证。认证通过您的 AWS 凭证或工作区 API 密钥运行，而不是通过 Claude.ai 订阅。
</Note>

### 2. 配置 Claude Code

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

```bash theme={null}
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，以便新版本不会同时影响所有人：

```bash theme={null}
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 和别名的完整列表，请参阅[模型概述](https://platform.claude.com/docs/en/about-claude/models/overview)。有关其他模型相关变量，请参阅[模型配置](/cn/model-config)。

[提示缓存](/cn/prompt-caching)会自动启用。要请求 1 小时缓存 TTL 代替 5 分钟默认值，请设置 `ENABLE_PROMPT_CACHING_1H=1`。API 对 1 小时缓存写入的计费费率更高。有关费率，请参阅[提示缓存定价](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。

## 使用 Agent SDK

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

```typescript theme={null}
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 概述](/cn/agent-sdk/overview)。

## 通过企业代理路由

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

```bash theme={null}
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` 中设置。

```bash theme={null}
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 操作参考](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions)中记录的 `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 平台概述](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)：订阅、工作区设置和产品参考
* [IAM 操作参考](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions)：权限和托管策略