← Cloudflare AI Gateway / ai-gateway / integrations / coding-agents

Claude Code

Направляя Claude Code ↗ в AI Gateway вместо прямого обращения к провайдеру, вы получаете наблюдаемость, кэширование, ограничение скорости запросов и централизованное хранение учётных данных для Anthropic, Amazon Bedrock или Google Vertex AI, не меняя способ вызова claude. Claude Code считывает свой эндпойнт и учётные данные из переменных окружения. Если ваш шлюз защищён Cloudflare Access, см. Использование с Cloudflare Access. Эта конфигурация отправляет запросы к Конечная точка Anthropic, аутентифицированный с помощью токена шлюза Cloudflare. Эндпойнт Anthropic предоставляет тот же /v1/messages API, который ожидает Claude Code. Когда AI Gateway предоставляет учётные данные Anthropic за вас, используя либо ваш ключ API Anthropic, который вы сохранить как ключ провайдера (BYOK) или Unified Billing кредитов: ANTHROPIC_API_KEY который требуется Claude Code, может быть любым значением-заполнителем.

Предварительные требования

Прежде чем начать, вам потребуется:

Одна authenticated gateway и его токен шлюза. Токен шлюза должен иметь Run разрешения.
Account ID вашего аккаунта Cloudflare. Чтобы найти его, см. Найдите свои account ID и zone ID.
Учётные данные для провайдера, к которому выполняется маршрутизация:
- Anthropic: Либо Unified Billing кредитов, зачисленных на ваш аккаунт Cloudflare (счёт выставляет Cloudflare), либо собственный API-ключ Anthropic (счёт выставляет Anthropic). Собственный ключ можно указать, сохранив его в AI Gateway как ключ провайдера (BYOK) или передав его напрямую в ANTHROPIC_API_KEY.
- Amazon Bedrock или Google Vertex AI: ваши учётные данные провайдера, сохраненные в AI Gateway как ключ провайдера (BYOK).
Claude Code ↗ установлен и обновлён до последней версии.

Примечание

cf-aig-authorization заголовок используется для аутентификации запроса в AI Gateway. Если у AI Gateway уже есть учетные данные Anthropic, полученные через Unified Billing или сохранённый ключ провайдера (BYOK) ANTHROPIC_API_KEY значение игнорируется. Claude Code все равно требует, чтобы переменная была задана, поэтому вы можете указать любое значение (в этом примере повторно используется токен шлюза). В противном случае задайте ANTHROPIC_API_KEY на ваш собственный API-ключ Anthropic, и AI Gateway пересылает его в Anthropic. В любом случае AI Gateway обеспечивает наблюдаемость, кеширование и ограничение частоты запросов для трафика. Подробнее о том, откуда Claude Code считывает учетные данные, см. в Документация Anthropic по аутентификации ↗.

Установите базовый URL на Anthropic-эндпойнт своего шлюза и отправляйте токен шлюза в cf-aig-authorization заголовок. Укажите ANTHROPIC_API_KEY на тот же токен, поскольку Claude Code требует, чтобы переменная была задана. Следующие команды задают их как переменные окружения оболочки для текущей сессии. Чтобы сохранить их постоянно, добавьте их в профиль оболочки (например, ~/.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

Чтобы запускать модели Claude через Amazon Bedrock и вместо этого направьте Claude Code на конечную точку Amazon Bedrock вашего шлюза. AI Gateway аутентифицируется в Bedrock с помощью учётных данных AWS, которые вы сохранить как ключ провайдера, поэтому можно пропустить собственную аутентификацию AWS в Claude Code.

Замените <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

Чтобы запускать модели Claude через Google Vertex AI и вместо этого направьте Claude Code на конечную точку Google Vertex AI вашего шлюза. AI Gateway аутентифицируется в Vertex AI с помощью учётных данных Google Cloud, которые вы сохранить как ключ провайдера, поэтому можно пропустить собственную аутентификацию Vertex в Claude Code.

Замените <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
```

Использование с Cloudflare Access

Если ваш шлюз защищён Cloudflare Access, Claude Code может аутентифицироваться с помощью краткоживущего токена Access вместо токена шлюза. Укажите ANTHROPIC_BASE_URL у вашего пользовательский домен и используйте в Claude Code apiKeyHelper для получения токена с помощью cloudflared. Claude Code отправляет токен в качестве ключа API, а Access проверяет его на границе сети.

Добавьте следующее в файл конфигурации Claude Code settings.json ↗, заменив ai-gateway.example.com с вашим пользовательским доменом:

~/.claude/settings.json

{
	"apiKeyHelper": "cloudflared access login --no-verbose https://ai-gateway.example.com",
	"env": {
		"ANTHROPIC_BASE_URL": "https://ai-gateway.example.com/anthropic"
	}
}

Первый запрос открывает процесс входа через вашего провайдера идентификации. После аутентификации запросы направляются через AI Gateway с идентификацией Access, прикреплённой в качестве cf.user_id.

Чтобы убедиться, что трафик доходит до AI Gateway, см. Проверьте, что всё работает.