# ANTHROPIC_BASE_URL

> It sends the API requests to a new address.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** ANTHROPIC_BASE_URL environment variable, ANTHROPIC_BEDROCK_BASE_URL, ANTHROPIC_VERTEX_BASE_URL

## Think of it like

It is like you send your letters to a new post office.

## Definition

ANTHROPIC_BASE_URL changes the address Claude Code sends its API requests to. Then they go through a proxy or gateway first. Bedrock and Google Cloud each have their own form of it. From version 2.1.196, Remote Control turns off when it points at any host but api.anthropic.com.

## Example

Emma's team logs and caps each AI request at one gateway. Each laptop points this at the gateway. So nothing goes straight to Anthropic.

## Example code

```bash
export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
claude
```

Route every request through your gateway.

## Why it matters

It is how a company puts its own checks, logs and limits in front of Claude.

## Common mistake

Setting it and then asking where Remote Control went. Remote Control only works with Anthropic's own host.

## Three principles

- **New address.** Gateway or proxy.
- **One per provider.** Bedrock and Google.
- **No Remote Control.** Off a non-Anthropic host.

## Related terms

- [LLM Gateway](https://learn.benibix.com/term/development/llm-gateway)
- [ANTHROPIC_AUTH_TOKEN](https://learn.benibix.com/term/ai/anthropic-auth-token-variable)
- [claude remote-control Command](https://learn.benibix.com/term/ai/claude-remote-control-command)
- [claude gateway Command](https://learn.benibix.com/term/ai/claude-gateway-command)

![A request goes out through your proxy and gateway, with the headers and cert you set.](https://learn.benibix.com/diagrams/env-network-path.svg)

---

Source: https://learn.benibix.com/term/ai/anthropic-base-url-variable
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
