claude-code icon indicating copy to clipboard operation
claude-code copied to clipboard

[DOCS] Unclear default model behavior for Claude Code on Amazon Bedrock when ANTHROPIC_MODEL is not set

Open markspivey opened this issue 4 months ago • 2 comments

Documentation Type

Unclear/confusing documentation

Documentation Location

https://docs.claude.com/en/docs/claude-code/amazon-bedrock#4-model-configuration

Section/Topic

Bedrock -> Model Configuration

Current Documentation

The current documentation doesn't clearly explain what happens when using Claude Code with Amazon Bedrock without explicitly setting the ANTHROPIC_MODEL environment variable.

What's Wrong or Missing?

What happens if the hardcoded default model isn't enabled in the user's Bedrock account?

Does the system gracefully fallback to the newest available enabled model, or does it fail with an access error requiring manual configuration?

Suggested Improvement

Add clear documentation explaining the fallback behavior and what users should expect when the latest default models aren't available in their Bedrock configuration.

Impact

Medium - Makes feature difficult to understand

Additional Context

No response

markspivey avatar Sep 29 '25 19:09 markspivey

Yes if the anthropic model is set, along with the default for sonnet, haiku, and opus. It will use the one specified by the anthropic_model var, and if that isn't there, it seems like it will use the default_sonnet_model var. But it is not clear in the docs

deepnz avatar Oct 01 '25 00:10 deepnz

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

github-actions[bot] avatar Dec 06 '25 10:12 github-actions[bot]