[DOCS] Settings reference missing AWS_REGION and CLOUD_ML_REGION environment variables

Resolved 💬 3 comments Opened Jan 26, 2026 by coygeek Closed Feb 28, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

"Environment variables" section

Current Documentation

The Environment variables table lists many variables including CLAUDE_CODE_USE_BEDROCK and CLAUDE_CODE_USE_VERTEX, but does not include:

  • AWS_REGION
  • CLOUD_ML_REGION

What's Wrong or Missing?

The Settings reference claims to document "environment variables to control its behavior" but omits two critical variables required for cloud provider configurations:

A. AWS_REGION is missing

The Amazon Bedrock guide explicitly states:

AWS_REGION is a required environment variable. Claude Code does not read from the .aws config file for this setting.

And shows it in the configuration example:

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # or your preferred region

B. CLOUD_ML_REGION is missing

The Google Vertex AI guide shows it as a required variable:

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

A developer consulting the Settings reference for a complete list of environment variables would not find these required variables, leading them to miss critical configuration steps.

Suggested Improvement

Add these entries to the Environment variables table:

| Variable | Purpose |
|:---------|:--------|
| AWS_REGION | AWS region for Amazon Bedrock. Required when using CLAUDE_CODE_USE_BEDROCK=1. Claude Code does not read from .aws config for this setting. See Amazon Bedrock |
| CLOUD_ML_REGION | Google Cloud region for Vertex AI (e.g., global, us-east5). Required when using CLAUDE_CODE_USE_VERTEX=1. See Google Vertex AI |
| ANTHROPIC_VERTEX_PROJECT_ID | Google Cloud project ID for Vertex AI. Required when using CLAUDE_CODE_USE_VERTEX=1. See Google Vertex AI |

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:

| Page | Section | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/settings | Environment variables table | Missing entries |

Cross-references showing these are required:

| Page | Evidence |
|------|----------|
| https://code.claude.com/docs/en/amazon-bedrock | "AWS_REGION is a required environment variable" (line 119) |
| https://code.claude.com/docs/en/google-vertex-ai | CLOUD_ML_REGION shown in required config (line 71) |

Total scope: 1 page affected (Settings reference)

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗