[DOCS] Amazon Bedrock docs missing `ANTHROPIC_BEDROCK_SERVICE_TIER` configuration

Resolved 💬 2 comments Opened Apr 28, 2026 by coygeek Closed May 2, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/amazon-bedrock

Section/Topic

"3. Configure Claude Code" on the Amazon Bedrock page, plus the Bedrock entries in the environment variable reference

Current Documentation

The Amazon Bedrock page currently says:

Set the following environment variables to enable Bedrock: ``bash # Enable Bedrock integration export CLAUDE_CODE_USE_BEDROCK=1 export AWS_REGION=us-east-1 # or your preferred region # Optional: Override the region for the small/fast model (Haiku). # Also applies to Bedrock Mantle. export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2 # Optional: Override the Bedrock endpoint URL for custom endpoints or gateways # export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com ``

The environment variable reference currently lists related Bedrock variables such as:

ANTHROPIC_BEDROCK_BASE_URL | Override the Bedrock endpoint URL. Use for custom Bedrock endpoints or when routing through an LLM gateway. ANTHROPIC_BEDROCK_MANTLE_BASE_URL | Override the Bedrock Mantle endpoint URL.

No documentation currently exists for ANTHROPIC_BEDROCK_SERVICE_TIER or for the X-Amzn-Bedrock-Service-Tier header it controls.

What's Wrong or Missing?

Claude Code v2.1.122 added ANTHROPIC_BEDROCK_SERVICE_TIER to let Bedrock users choose default, flex, or priority, with Claude Code sending the value as the X-Amzn-Bedrock-Service-Tier header.

That configuration is not documented on either the Amazon Bedrock setup page or the environment variable reference, so users have no official guidance that this option exists, what values are accepted, or how it maps to the Bedrock request header.

Suggested Improvement

Add this variable to both the Amazon Bedrock setup page and env-vars reference.

Suggested addition:

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

With accompanying text that explains:

  • Accepted values are default, flex, and priority
  • Claude Code sends the selected value as the X-Amzn-Bedrock-Service-Tier header
  • This option is available starting in v2.1.122

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/amazon-bedrock | 314-327 | Bedrock environment-variable setup lists related variables but omits ANTHROPIC_BEDROCK_SERVICE_TIER |
| https://code.claude.com/docs/en/env-vars | 16-17, 41, 45, 135, 149 | Environment variable reference lists Bedrock-specific variables but has no entry for ANTHROPIC_BEDROCK_SERVICE_TIER |

Total scope: 2 pages affected

Version introduced: v2.1.122

View original on GitHub ↗

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