Anthropic

Anthropic 开发 Claude 系列模型，并提供用于访问这些模型的原生 Messages API。AISIX 允许应用使用原生 Messages 格式或网关的 OpenAI 兼容 API，同时管理 Anthropic 凭证、调用方访问权限、限流和用量核算。

本指南介绍如何将 AISIX 直接连接到 Anthropic。如需改为通过 AWS 访问 Claude，请使用 AWS Bedrock。

准备工作

开始前，请准备以下内容：

一套 AISIX 环境：
- 对于 AISIX Cloud，需要一个已关联网关的环境和具有写入作用域的 Admin Token。对于 On-Premises，请按照 AISIX Cloud 快速入门操作。如需申请 Hybrid Cloud 访问权限，请联系 API7。
- 对于开源 AISIX 网关，请准备本地 AISIX 安装，或使用开源 AISIX 网关快速入门中的 Docker 环境。配置网关以加载声明式资源文件。
从 Anthropic 控制台获取的 Anthropic API Key。
curl 和 jq。

使用 AISIX Cloud 配置

导出 AISIX Cloud 连接信息：

# AISIX_CP 是 Admin API 基础 URL；应包含 /api，且末尾不带斜杠
# 本地 On-Premises 快速入门使用 http://localhost:8080/api
export AISIX_CP="YOUR_AISIX_CLOUD_ADMIN_API_URL"
export AISIX_TOKEN="YOUR_ADMIN_TOKEN"
export ENV_ID="YOUR_ENVIRONMENT_ID"

为由 Anthropic 支持的路由创建服务提供方密钥、模型别名和调用方 API Key。

AISIX 通过原生 anthropic 适配器连接到 Anthropic，并使用 Anthropic 的 x-api-key 请求头对上游请求进行身份验证。

创建服务提供方密钥

创建用于存储 Anthropic 凭证的服务提供方密钥，并允许其在该环境中使用：

# 请替换为实际值
export ANTHROPIC_API_KEY="YOUR_PROVIDER_API_KEY"

PROVIDER_KEY_ID=$(curl -sS -X POST "$AISIX_CP/provider_keys" \
  -H "Authorization: Bearer $AISIX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "anthropic-prod",
    "provider": "anthropic",
    "api_key": "'"${ANTHROPIC_API_KEY}"'",
    "allowed_environments": ["'"${ENV_ID}"'"]
  }' | jq -r '.provider_key.id')

❶ provider 为 anthropic。AISIX Cloud Admin API 会从目录服务提供方派生适配器；适配器字段仅在 BYO 服务提供方密钥上被接受。AISIX 会将凭证作为 x-api-key 请求头发送，并在出站调用中添加 anthropic-version: 2023-06-01。

❷ api_key 存储 Anthropic API Key。其行为遵循服务提供方密钥中的凭证处理方式。

Anthropic 的 api_base 可以省略；此时会回退到 Anthropic 默认端点。响应会返回服务提供方密钥 ID，上文已将其保存为 PROVIDER_KEY_ID。

创建模型

Claude 4.6 及后续代际的模型 ID 是固定快照，而不是持续更新的指针。当前 ID 请参阅 Anthropic 模型参考。

创建调用方将在请求中发送的模型别名：

MODEL_ID=$(curl -sS -X POST "$AISIX_CP/environments/$ENV_ID/models" \
  -H "Authorization: Bearer $AISIX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "claude-sonnet-prod",
    "model_name": "claude-sonnet-5",
    "provider_key_id": "'"${PROVIDER_KEY_ID}"'"
  }' | jq -r '.model.id')

❶ display_name 是调用方在 model 中发送的别名。

❷ model_name 是 Claude 模型 ID，例如 claude-sonnet-5、claude-opus-4-8 或 claude-haiku-4-5。

❸ provider_key_id 将别名关联到 Anthropic 服务提供方密钥。

创建调用方 API Key

创建可访问该模型别名的调用方 API Key。明文密钥由服务器生成，并且只在创建响应中返回一次：

export AISIX_API_KEY=$(curl -sS -X POST "$AISIX_CP/environments/$ENV_ID/api_keys" \
  -H "Authorization: Bearer $AISIX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "claude-caller",
    "allowed_models": ["'"${MODEL_ID}"'"]
  }' | jq -r '.plaintext')

allowed_models 值通过上文保存为 MODEL_ID 的 ID 引用模型。请安全存储明文密钥，此后无法再次获取。

调用方通过 Authorization: Bearer 请求头中的调用方 API Key 向 AISIX 进行身份验证。AISIX 会向上游提供 Anthropic 的 x-api-key 和 anthropic-version 请求头，客户端无需发送这些请求头。

使用开源 AISIX 网关配置

导出上游凭证，并选择应用将发送给网关的调用方 API Key：

export ANTHROPIC_API_KEY="YOUR_PROVIDER_API_KEY"
export CALLER_API_KEY="YOUR_CALLER_API_KEY"

为该服务提供方创建完整的声明式资源文件：

resources.yaml
_format_version: "1"

provider_keys:
  - display_name: "anthropic-prod"
    provider: "anthropic"
    adapter: "anthropic"
    api_key: ${ANTHROPIC_API_KEY}
    api_base: "https://api.anthropic.com"

models:
  - display_name: "claude-sonnet-prod"
    provider: "anthropic"
    model_name: "claude-sonnet-5"
    provider_key: "anthropic-prod"

api_keys:
  - display_name: "claude-caller"
    key_env: CALLER_API_KEY
    allowed_models:
      - "claude-sonnet-prod"

如果 AISIX 安装在本地，请在加载前验证文件：

aisix validate --resources resources.yaml

验证后，在网关进程环境中提供文件引用的环境变量，再启动网关。仅当这些变量已经可供进程使用时，才重新加载现有网关；否则，请使用更新后的环境重启网关。

如果使用 Docker，请调整开源 AISIX 网关快速入门中的验证和启动命令。挂载此 resources.yaml 文件，并在两条命令中使用 -e 传入它引用的每个环境变量。资源加载后，准备下文共用的验证请求：

export AISIX_API_KEY="$CALLER_API_KEY"

验证服务提供方连接

导出 AISIX 网关 Origin：

# 本地快速入门使用 http://127.0.0.1:3000
export AISIX_PROXY="YOUR_AISIX_GATEWAY_ORIGIN"

通过 AISIX 代理发送原生 Messages 请求：

curl -sS -X POST "$AISIX_PROXY/v1/messages" \
  -H "Authorization: Bearer ${AISIX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-prod",
    "max_tokens": 64,
    "messages": [
      {
        "role": "user",
        "content": "Say hello from Claude."
      }
    ]
  }'

网关会返回 Anthropic Messages 响应，其中回显面向调用方的别名 claude-sonnet-prod。如果请求因上游身份验证错误而失败，请检查服务提供方密钥的 api_key。

对于使用 OpenAI 格式的客户端，同一个别名也适用于 /v1/chat/completions。此转换会丢弃非文本内容块，因此图像或文档输入应直接调用 /v1/messages。

清理资源

不再需要示例资源时，请在 Dashboard 中依次删除 claude-caller 调用方 API Key、claude-sonnet-prod 模型和 anthropic-prod 服务提供方密钥。

后续步骤

你已将 AISIX 连接到 Anthropic，并验证了模型别名。接下来可阅读以下指南：

Anthropic SDK：通过 Anthropic SDK 在 /v1/messages 上调用此别名。
AWS Bedrock：改为配置由 Bedrock 托管的 Claude 模型。
模型别名：为此别名配置路由、重试行为或成本元数据。
服务提供方兼容性：查看支持的代理端点和服务提供方特定边界。

准备工作​

使用 AISIX Cloud 配置​

创建服务提供方密钥​

创建模型​

创建调用方 API Key​

使用开源 AISIX 网关配置​

验证服务提供方连接​

清理资源​

后续步骤​