Claude Code

Claude Code ↗ 从环境变量读取端点和凭据。此配置会将请求发送到 AI Gateway 的 Anthropic 端点，并使用 Cloudflare gateway 令牌进行身份验证。该 Anthropic 端点暴露与 Claude Code 期望的相同 /v1/messages API。当 AI Gateway 为你提供 Anthropic 凭据时 — 使用你作为提供商密钥（BYOK）存储的 Anthropic API 密钥，或 Unified Billing 积分 — Claude Code 所需的 ANTHROPIC_API_KEY 可以是任意占位值。

前提条件

开始之前，你需要：

一个已认证的 gateway 及其 gateway 令牌。该 gateway 令牌必须具有 Run 权限。
你的 Cloudflare 账户 ID。查找方法请参阅查找账户和 zone ID。
你所路由到的提供商的凭据：
- Anthropic：在 Cloudflare 账户上加载 Unified Billing 积分（由 Cloudflare 向你计费），或使用你自己的 Anthropic API 密钥（由 Anthropic 向你计费）。你可以将自己的密钥存储在 AI Gateway 中作为提供商密钥（BYOK），或直接在 ANTHROPIC_API_KEY 中传递。
- Amazon Bedrock 或 Google Vertex AI：将提供商凭据作为提供商密钥（BYOK）存储在 AI Gateway 中。
已安装并更新到最新版本的 Claude Code ↗。

将 base URL 设为你的 gateway 的 Anthropic 端点，并在 cf-aig-authorization 标头中发送 gateway 令牌。将 ANTHROPIC_API_KEY 设为同一令牌，因为 Claude Code 要求该变量已设置。以下命令将这些值设为当前会话的 shell 环境变量。若要持久化，请将其添加到 shell 配置文件（例如 ~/.zshrc 或 ~/.bashrc），或添加到 Claude Code 的 settings.json ↗ 中的 env 键下。

将 <ACCOUNT_ID>、<GATEWAY_ID> 和 <CF_AIG_TOKEN> 替换为你的值。
export ANTHROPIC_BASE_URL="https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/anthropic" export ANTHROPIC_API_KEY="<CF_AIG_TOKEN>" export ANTHROPIC_CUSTOM_HEADERS="cf-aig-authorization: Bearer <CF_AIG_TOKEN>"
$env:ANTHROPIC_BASE_URL = "https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/anthropic" $env:ANTHROPIC_API_KEY = "<CF_AIG_TOKEN>" $env:ANTHROPIC_CUSTOM_HEADERS = "cf-aig-authorization: Bearer <CF_AIG_TOKEN>"
启动 Claude Code 并发送提示。请求现在会通过 AI Gateway 路由。
```
claude
```

使用 Amazon Bedrock

若要通过 Amazon Bedrock 运行 Claude 模型，请将 Claude Code 指向 gateway 的 Amazon Bedrock 端点。AI Gateway 使用你作为提供商密钥存储的 AWS 凭据向 Bedrock 进行身份验证，因此你可以跳过 Claude Code 自身的 AWS 身份验证。

将 <ACCOUNT_ID>、<GATEWAY_ID>、<AWS_REGION>（例如 us-east-1）和 <CF_AIG_TOKEN> 替换为你的值。

export CLAUDE_CODE_USE_BEDROCK="1"
export ANTHROPIC_BEDROCK_BASE_URL="https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/aws-bedrock/bedrock-runtime/<AWS_REGION>/"
export CLAUDE_CODE_SKIP_BEDROCK_AUTH="1"
export ANTHROPIC_CUSTOM_HEADERS="cf-aig-authorization: Bearer <CF_AIG_TOKEN>"

$env:CLAUDE_CODE_USE_BEDROCK = "1"
$env:ANTHROPIC_BEDROCK_BASE_URL = "https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/aws-bedrock/bedrock-runtime/<AWS_REGION>/"
$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"
$env:ANTHROPIC_CUSTOM_HEADERS = "cf-aig-authorization: Bearer <CF_AIG_TOKEN>"

启动 Claude Code 并发送提示。请求现在会通过 AI Gateway 路由到 Amazon Bedrock。
```
claude
```

使用 Google Vertex AI

若要通过 Google Vertex AI 运行 Claude 模型，请将 Claude Code 指向 gateway 的 Google Vertex AI 端点。AI Gateway 使用你作为提供商密钥存储的 Google Cloud 凭据向 Vertex AI 进行身份验证，因此你可以跳过 Claude Code 自身的 Vertex 身份验证。

将 <ACCOUNT_ID>、<GATEWAY_ID>、<GCP_PROJECT_ID>、<GCP_REGION>（例如 us-east5）和 <CF_AIG_TOKEN> 替换为你的值。

export CLAUDE_CODE_USE_VERTEX="1"
export ANTHROPIC_VERTEX_BASE_URL="https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/google-vertex-ai/v1"
export ANTHROPIC_VERTEX_PROJECT_ID="<GCP_PROJECT_ID>"
export CLOUD_ML_REGION="<GCP_REGION>"
export CLAUDE_CODE_SKIP_VERTEX_AUTH="1"
export ANTHROPIC_CUSTOM_HEADERS="cf-aig-authorization: Bearer <CF_AIG_TOKEN>"

$env:CLAUDE_CODE_USE_VERTEX = "1"
$env:ANTHROPIC_VERTEX_BASE_URL = "https://gateway.ai.cloudflare.com/v1/<ACCOUNT_ID>/<GATEWAY_ID>/google-vertex-ai/v1"
$env:ANTHROPIC_VERTEX_PROJECT_ID = "<GCP_PROJECT_ID>"
$env:CLOUD_ML_REGION = "<GCP_REGION>"
$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"
$env:ANTHROPIC_CUSTOM_HEADERS = "cf-aig-authorization: Bearer <CF_AIG_TOKEN>"

启动 Claude Code 并发送提示。请求现在会通过 AI Gateway 路由到 Google Vertex AI。
```
claude
```

要确认流量已到达 AI Gateway，请参阅验证是否生效。