--- title: Claude Code description: Route Claude Code through AI Gateway using your Cloudflare gateway token. image: https://developers.cloudflare.com/dev-products-preview.png --- > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/ai-gateway/llms.txt > Use this file to discover all available pages before exploring further. [Skip to content](#%5Ftop) # Claude Code [Claude Code ↗](https://docs.anthropic.com/en/docs/claude-code/overview) reads its endpoint and credentials from environment variables. This configuration sends requests to AI Gateway's [Anthropic endpoint](https://developers.cloudflare.com/ai-gateway/usage/providers/anthropic/), authenticated with your Cloudflare gateway token. The Anthropic endpoint exposes the same `/v1/messages` API that Claude Code expects. When AI Gateway supplies the Anthropic credentials for you — using either an Anthropic API key you [store as a provider key (BYOK)](https://developers.cloudflare.com/ai-gateway/configuration/bring-your-own-keys/) or [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) credits — the `ANTHROPIC_API_KEY` that Claude Code requires can be any placeholder value. ## Prerequisites Before you start, you need: * An [authenticated gateway](https://developers.cloudflare.com/ai-gateway/configuration/authentication/) and its [gateway token](https://developers.cloudflare.com/ai-gateway/configuration/authentication/#setting-up-authenticated-gateway-using-the-dashboard). The gateway token must have `Run` permissions. * Your Cloudflare account ID. To find it, refer to [Find your account and zone IDs](https://developers.cloudflare.com/fundamentals/account/find-account-and-zone-ids/). * Credentials for the provider you route to: * **Anthropic**: Either [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) credits loaded on your Cloudflare account (Cloudflare bills you), or your own Anthropic API key (Anthropic bills you). You can provide your own key either by storing it in AI Gateway as a [provider key (BYOK)](https://developers.cloudflare.com/ai-gateway/configuration/bring-your-own-keys/) or by passing it directly in `ANTHROPIC_API_KEY`. * **Amazon Bedrock** or **Google Vertex AI**: your provider credentials stored in AI Gateway as a [provider key (BYOK)](https://developers.cloudflare.com/ai-gateway/configuration/bring-your-own-keys/). * [Claude Code ↗](https://docs.anthropic.com/en/docs/claude-code/setup) installed and updated to the latest version. Note The `cf-aig-authorization` header is what authenticates your request to AI Gateway. When AI Gateway already holds the Anthropic credentials — through [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/) or a [stored provider key (BYOK)](https://developers.cloudflare.com/ai-gateway/configuration/bring-your-own-keys/) — the `ANTHROPIC_API_KEY` value is ignored. Claude Code still requires the variable to be set, so you can set it to any value (this example reuses the gateway token). Otherwise, set `ANTHROPIC_API_KEY` to your own Anthropic API key and AI Gateway forwards it to Anthropic. AI Gateway provides observability, caching, and rate limiting for the traffic either way. For details on where Claude Code reads credentials from, refer to [Anthropic's authentication documentation ↗](https://docs.anthropic.com/en/docs/claude-code/iam#credential-management). 1. Set the base URL to your gateway's Anthropic endpoint and send your gateway token in the `cf-aig-authorization` header. Set `ANTHROPIC_API_KEY` to the same token, since Claude Code requires the variable to be set. The following commands set these as shell environment variables for the current session. To persist them, add them to your shell profile (for example, `~/.zshrc` or `~/.bashrc`) or to Claude Code's [settings.json ↗](https://docs.anthropic.com/en/docs/claude-code/settings#settings-files) under the `env` key. Replace ``, ``, and `` with your values. * [ macOS / Linux ](#tab-panel-6846) * [ Windows (PowerShell) ](#tab-panel-6847) Terminal window ``` export ANTHROPIC_BASE_URL="https://gateway.ai.cloudflare.com/v1///anthropic"export ANTHROPIC_API_KEY=""export ANTHROPIC_CUSTOM_HEADERS="cf-aig-authorization: Bearer " ``` PowerShell ``` $env:ANTHROPIC_BASE_URL = "https://gateway.ai.cloudflare.com/v1///anthropic"$env:ANTHROPIC_API_KEY = ""$env:ANTHROPIC_CUSTOM_HEADERS = "cf-aig-authorization: Bearer " ``` 2. Start Claude Code and send a prompt. Requests now route through AI Gateway. Terminal window ``` claude ``` ## Use Amazon Bedrock To run Claude models through [Amazon Bedrock](https://developers.cloudflare.com/ai-gateway/usage/providers/bedrock/) instead, point Claude Code at your gateway's Amazon Bedrock endpoint. AI Gateway authenticates to Bedrock with the AWS credentials you [store as a provider key](https://developers.cloudflare.com/ai-gateway/configuration/bring-your-own-keys/), so you can skip Claude Code's own AWS authentication. 1. Replace ``, ``, `` (for example, `us-east-1`), and `` with your values. * [ macOS / Linux ](#tab-panel-6848) * [ Windows (PowerShell) ](#tab-panel-6849) Terminal window ``` export CLAUDE_CODE_USE_BEDROCK="1"export ANTHROPIC_BEDROCK_BASE_URL="https://gateway.ai.cloudflare.com/v1///aws-bedrock/bedrock-runtime//"export CLAUDE_CODE_SKIP_BEDROCK_AUTH="1"export ANTHROPIC_CUSTOM_HEADERS="cf-aig-authorization: Bearer " ``` PowerShell ``` $env:CLAUDE_CODE_USE_BEDROCK = "1"$env:ANTHROPIC_BEDROCK_BASE_URL = "https://gateway.ai.cloudflare.com/v1///aws-bedrock/bedrock-runtime//"$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"$env:ANTHROPIC_CUSTOM_HEADERS = "cf-aig-authorization: Bearer " ``` 2. Start Claude Code and send a prompt. Requests now route through AI Gateway to Amazon Bedrock. Terminal window ``` claude ``` ## Use Google Vertex AI To run Claude models through [Google Vertex AI](https://developers.cloudflare.com/ai-gateway/usage/providers/vertex/) instead, point Claude Code at your gateway's Google Vertex AI endpoint. AI Gateway authenticates to Vertex AI with the Google Cloud credentials you [store as a provider key](https://developers.cloudflare.com/ai-gateway/configuration/bring-your-own-keys/), so you can skip Claude Code's own Vertex authentication. 1. Replace ``, ``, ``, `` (for example, `us-east5`), and `` with your values. * [ macOS / Linux ](#tab-panel-6850) * [ Windows (PowerShell) ](#tab-panel-6851) Terminal window ``` export CLAUDE_CODE_USE_VERTEX="1"export ANTHROPIC_VERTEX_BASE_URL="https://gateway.ai.cloudflare.com/v1///google-vertex-ai/v1"export ANTHROPIC_VERTEX_PROJECT_ID=""export CLOUD_ML_REGION=""export CLAUDE_CODE_SKIP_VERTEX_AUTH="1"export ANTHROPIC_CUSTOM_HEADERS="cf-aig-authorization: Bearer " ``` PowerShell ``` $env:CLAUDE_CODE_USE_VERTEX = "1"$env:ANTHROPIC_VERTEX_BASE_URL = "https://gateway.ai.cloudflare.com/v1///google-vertex-ai/v1"$env:ANTHROPIC_VERTEX_PROJECT_ID = ""$env:CLOUD_ML_REGION = ""$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"$env:ANTHROPIC_CUSTOM_HEADERS = "cf-aig-authorization: Bearer " ``` 2. Start Claude Code and send a prompt. Requests now route through AI Gateway to Google Vertex AI. Terminal window ``` claude ``` To confirm traffic reaches AI Gateway, refer to [Verify it works](https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/#verify-it-works). ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/claude-code/#page","headline":"Claude Code · Cloudflare AI Gateway docs","description":"Route Claude Code through AI Gateway using your Cloudflare gateway token.","url":"https://developers.cloudflare.com/ai-gateway/integrations/coding-agents/claude-code/","inLanguage":"en","image":"https://developers.cloudflare.com/dev-products-preview.png","dateModified":"2026-06-29","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/ai-gateway/","name":"AI Gateway"}},{"@type":"ListItem","position":3,"item":{"@id":"/ai-gateway/integrations/","name":"Integrations"}},{"@type":"ListItem","position":4,"item":{"@id":"/ai-gateway/integrations/coding-agents/","name":"Coding agents"}},{"@type":"ListItem","position":5,"item":{"@id":"/ai-gateway/integrations/coding-agents/claude-code/","name":"Claude Code"}}]} ```