Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] Amazon Bedrock guide shows `global.*` model ID despite region-prefix guidance [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56159•Fetched 2026-05-05 05:56:38
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×4

Code Example

> # 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'
>
RAW_BUFFERClick to expand / collapse

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.

# 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:

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

Total scope: 1 page affected

Cross-references:

PageLine(s)Context
https://code.claude.com/docs/en/model-config312-316Bedrock pinning example uses us.anthropic... and tells readers to apply the same pattern for Sonnet and Haiku
https://code.claude.com/docs/en/github-actions521-525Bedrock 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-cd321-322Bedrock job example says model IDs include region-specific prefixes

extent analysis

TL;DR

Update the ANTHROPIC_MODEL example in the Bedrock documentation to use a region-prefixed model ID, such as us.anthropic.claude-sonnet-4-6, to match the rest of the documentation.

Guidance

  • Replace the outdated global.anthropic.claude-sonnet-4-6 example with a region-prefixed example, such as us.anthropic.claude-sonnet-4-6, in the Bedrock documentation.
  • Consider adding a note to explain when global.* is appropriate versus when users should supply us., eu., or apac. IDs.
  • Review the affected pages, including the Amazon Bedrock documentation, to ensure consistency in model ID formatting.
  • Verify that the updated example aligns with the Claude Code v2.1.128 changelog entry, which fixed Bedrock default model resolving to global.* instead of the region-appropriate prefix.

Example

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

Notes

The update should be applied to the specific lines mentioned in the affected pages, including lines 351, 363-365 of the Amazon Bedrock documentation.

Recommendation

Apply the workaround by updating the ANTHROPIC_MODEL example to use a region-prefixed model ID, as this will ensure consistency with the rest of the Bedrock documentation and align with the Claude Code v2.1.128 changelog entry.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#integration issue#index setup#retrieval issue#search optimization#API routing

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Amazon Bedrock guide shows `global.*` model ID despite region-prefix guidance [1 participants]