[DOCS] Amazon Bedrock guide shows `global.*` model ID despite region-prefix guidance

Resolved 💬 1 comment Opened May 5, 2026 by coygeek Closed May 7, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

4. Pin model versions → “To customize models further” Bedrock inference profile example for ANTHROPIC_MODEL

Current Documentation

The page currently says:

These variables use cross-region inference profile IDs (with the us. prefix). If you use a different region prefix or application inference profiles, adjust accordingly. ``bash # Using inference profile ID export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-6' export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0' ``

What's Wrong or Missing?

This example contradicts the page’s own guidance and the rest of the Bedrock documentation, which describe Bedrock model IDs as region-prefixed values such as us.anthropic....

That now looks outdated relative to the Claude Code v2.1.128 changelog entry: “Fixed Bedrock default model resolving to global.* instead of the region-appropriate prefix”. Leaving global.anthropic.claude-sonnet-4-6 in the setup example can cause users to copy a model ID that does not match the documented Bedrock region-prefix format.

Suggested Improvement

Replace the global.anthropic.claude-sonnet-4-6 example with a region-prefixed example that matches the rest of the Bedrock docs.

Before:

export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-6'

After:

export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'

If global.* is still valid for a specific Bedrock path, add a short note that explains exactly when global. is appropriate versus when users should supply us., eu., or apac. IDs.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/amazon-bedrock | 351, 363-365 | The page says Bedrock examples use region prefixes, then shows ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-6' |

Total scope: 1 page affected

Cross-references:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/model-config | 312-316 | Bedrock pinning example uses us.anthropic... and tells readers to apply the same pattern for Sonnet and Haiku |
| https://code.claude.com/docs/en/github-actions | 521-525 | Bedrock workflow example says model IDs include a region prefix such as us.anthropic.claude-sonnet-4-6 |
| https://code.claude.com/docs/en/gitlab-ci-cd | 321-322 | Bedrock job example says model IDs include region-specific prefixes |

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗