[DOCS] Settings reference missing AWS_REGION and CLOUD_ML_REGION environment variables
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_REGIONCLOUD_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_REGIONis a required environment variable. Claude Code does not read from the.awsconfig 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)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗