# VERTEX_REGION_CLAUDE_* Variables

> It sets the Google Cloud region for one model.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** VERTEX_REGION_CLAUDE_5_5_OPUS, VERTEX_REGION_CLAUDE_5_5_SONNET, VERTEX_REGION_CLAUDE_HAIKU_5_5, VERTEX_REGION_CLAUDE_FABLE_5_2, VERTEX_REGION_CLAUDE_HAIKU_4_5, VERTEX_REGION_CLAUDE_4_5_SONNET

## Think of it like

It is like one dish that only one cook in town can make.

## Definition

A VERTEX_REGION_CLAUDE_ variable sets the Google Cloud region for one model. Most models have one, such as the one for Opus 5.5. It wins over CLOUD_ML_REGION for that model only. Use it when your main region is global but a model is not.

## Example

Jack runs on global, but one old model is not. He sets that model's own region, and it works while the rest stay on global.

## Example code

```bash
export CLOUD_ML_REGION=global
export VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5
claude
```

Send one model to its own region.

## Why it matters

One model with no global spot would fail without it, while the rest work.

## Common mistake

Setting it for a model you do not use. Only the variable for the model you run matters.

## Three principles

- **One per model.** Most versions.
- **Wins for that model.** Over CLOUD_ML_REGION.
- **For regional-only models.** When main is global.

## Related terms

- [CLOUD_ML_REGION](https://learn.benibix.com/term/ai/cloud-ml-region-variable)
- [ANTHROPIC_VERTEX_PROJECT_ID](https://learn.benibix.com/term/ai/anthropic-vertex-project-id-variable)
- [Gemini Enterprise Agent Platform](https://learn.benibix.com/term/ai/gemini-enterprise-agent-platform)

## Told apart from

- [CLOUD_ML_REGION vs VERTEX_REGION_CLAUDE_*](https://learn.benibix.com/compare/cloud-ml-region-variable-vs-vertex-region-claude-variables): People think CLOUD_ML_REGION and the VERTEX_REGION_CLAUDE_ variables do the same job. One sets the region for every model. The other sets it for one model. Claude Code checks the model's own variable first. If it is not set, it uses CLOUD_ML_REGION, and then us-east5. Set CLOUD_ML_REGION once. Add a model's own only when that model needs a different region.

![On Google Cloud, a model's own region wins, then CLOUD_ML_REGION, then us-east5.](https://learn.benibix.com/diagrams/env-vertex-region.svg)

---

Source: https://learn.benibix.com/term/ai/vertex-region-claude-variables
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-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
