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

Claude Code

Nasměrováním Claude Code ↗ v AI Gateway namísto přímo u poskytovatele, získáte pozorovatelnost, cachování, omezení frekvence požadavků a centralizovanou správu přihlašovacích údajů pro Anthropic, Amazon Bedrock nebo Google Vertex AI, aniž byste museli měnit způsob volání claude. Claude Code načítá svůj koncový bod a přihlašovací údaje z proměnných prostředí. Pokud je vaše brána chráněná pomocí Cloudflare Access, přečtěte si Použít s Cloudflare Access. Tato konfigurace odesílá požadavky na Koncový bod Anthropic, ověřený pomocí tokenu vaší brány Cloudflare. Koncový bod Anthropic zpřístupňuje stejné /v1/messages API, které Claude Code očekává. Pokud AI Gateway přihlašovací údaje Anthropic poskytuje za vás, ať už pomocí API klíče Anthropic, který jste uložit jako klíč poskytovatele (BYOK) nebo Unified Billing kredity: ANTHROPIC_API_KEY kterou Claude Code vyžaduje, může být libovolná zástupná hodnota.

Předpoklady

Než začnete, budete potřebovat:

autentizovaný gateway a jeho token gateway. Token brány musí mít Run oprávnění.
ID vašeho účtu Cloudflare. Jak ho najít, zjistíte v Najděte ID svého účtu a zóny.
Přihlašovací údaje pro poskytovatele, na kterého směrujete:
- Anthropic: Buď Unified Billing kredity nabité na váš účet Cloudflare (fakturuje vám Cloudflare), nebo vlastní API klíč Anthropic (fakturuje vám Anthropic). Vlastní klíč můžete poskytnout buď jeho uložením v AI Gateway jako klíč poskytovatele (BYOK) nebo jeho přímým předáním v ANTHROPIC_API_KEY.
- Amazon Bedrock nebo Google Vertex AI: přihlašovací údaje poskytovatele uložené v AI Gateway jako klíč poskytovatele (BYOK).
Claude Code ↗ nainstalovaný a aktualizovaný na nejnovější verzi.

Poznámka

cf-aig-authorization hlavička je to, co ověřuje váš požadavek vůči AI Gateway. Pokud AI Gateway již obsahuje přihlašovací údaje Anthropic, a to prostřednictvím Unified Billing nebo uložený klíč poskytovatele (BYOK) , ANTHROPIC_API_KEY hodnota se ignoruje. Claude Code i tak vyžaduje, aby byla proměnná nastavena, takže ji můžete nastavit na libovolnou hodnotu (tento příklad znovu použije gateway token). Jinak nastavte ANTHROPIC_API_KEY na váš vlastní Anthropic API klíč a AI Gateway ho předá dál do Anthropic. AI Gateway v obou případech poskytuje observabilitu, ukládání do mezipaměti a omezování rychlosti provozu. Podrobnosti o tom, odkud Claude Code čte přihlašovací údaje, najdete v dokumentace Anthropic k ověřování ↗.

Nastavte základní URL na koncový bod Anthropic vašeho gateway a odešlete token gateway v cf-aig-authorization hlavička. Nastavte ANTHROPIC_API_KEY na stejný token, protože Claude Code vyžaduje, aby byla proměnná nastavena. Následující příkazy nastaví tyto proměnné jako proměnné prostředí shellu pro aktuální relaci. Chcete-li je zachovat trvale, přidejte je do profilu shellu (například ~/.zshrc nebo ~/.bashrc) nebo do Claude Code settings.json ↗ v části env klíč.

Nahraďte <ACCOUNT_ID>, <GATEWAY_ID>, a <CF_AIG_TOKEN> svými hodnotami.
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>"
Spusťte Claude Code a odešlete prompt. Požadavky nyní směřují přes AI Gateway.
```
claude
```

Použít Amazon Bedrock

Chcete-li spouštět modely Claude prostřednictvím Amazon Bedrock místo toho nasměrujte Claude Code na koncový bod Amazon Bedrock své brány. AI Gateway se k Bedrocku ověřuje pomocí přihlašovacích údajů AWS, které uložit jako klíč poskytovatele, takže můžete přeskočit vlastní ověřování AWS v Claude Code.

Nahraďte <ACCOUNT_ID>, <GATEWAY_ID>, <AWS_REGION> (například us-east-1), a <CF_AIG_TOKEN> svými hodnotami.

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>"

Spusťte Claude Code a odešlete prompt. Požadavky nyní směřují přes AI Gateway do Amazon Bedrock.
```
claude
```

Použít Google Vertex AI

Chcete-li spouštět modely Claude prostřednictvím Google Vertex AI místo toho nasměrujte Claude Code na koncový bod Google Vertex AI své brány. AI Gateway se k Vertex AI ověřuje pomocí přihlašovacích údajů Google Cloud, které uložit jako klíč poskytovatele, takže můžete přeskočit vlastní ověřování Vertex v Claude Code.

Nahraďte <ACCOUNT_ID>, <GATEWAY_ID>, <GCP_PROJECT_ID>, <GCP_REGION> (například us-east5), a <CF_AIG_TOKEN> svými hodnotami.

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>"

Spusťte Claude Code a odešlete prompt. Požadavky nyní směřují přes AI Gateway do Google Vertex AI.
```
claude
```

Použít s Cloudflare Access

Pokud je váš gateway chráněn Cloudflare Access, Claude Code se může ověřit pomocí krátkodobého Access tokenu namísto gateway tokenu. Nasměrujte ANTHROPIC_BASE_URL u vašeho vlastní doména a použijte Claude Code apiKeyHelper k načtení tokenu pomocí cloudflared. Claude Code odesílá token jako API klíč a Access ho ověřuje na okraji sítě.

Přidejte následující do souboru Claude Code settings.json ↗, přičemž nahraďte ai-gateway.example.com svou vlastní doménou:

~/.claude/settings.json

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

První požadavek otevře přihlašovací postup vašeho poskytovatele identity. Po ověření identity se požadavky směrují přes AI Gateway s vaší identitou Access připojenou jako cf.user_id.

Chcete-li potvrdit, že provoz dorazí do AI Gateway, projděte si Ověřte, že to funguje.