[FEATURE] Improve Claude Code error messages for AWS Bedrock marketplace subscription errors

[markspivey]

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

When configuring AWS Bedrock with Claude Code, users can correctly set up IAM permissions and have model access already enabled by default, but still encounter cryptic errors because AWS Marketplace subscriptions are required/missing.

Current error experience: [ERROR] Error streaming: Calling boto3.exceptions.botocore.exceptions.ClientError: An error occurred (AccessDeniedException) when calling the Converse operation: API Model access is denied by Marketplace subscription

This raw AWS error message:

• Doesn't explain what "marketplace subscription" means in this context
• Provides no guidance on how to fix it
• Leaves users confused because they've followed all documented setup steps
• Doesn't link to relevant documentation

Users waste time debugging IAM permissions when the actual issue is a missing marketplace subscription/an AWS admin accepting the offer.

Proposed Solution

Claude Code should detect AWS Bedrock marketplace subscription errors and provide actionable, user-friendly guidance.

Enhanced error message example:

[ERROR] AWS Bedrock access denied: Missing marketplace subscription

AWS Bedrock models require marketplace subscription acceptance in addition to IAM permissions.

To resolve:

1. xxx
2. xxx
3. xxx

For detailed setup instructions, see: https://docs.claude.com/en/docs/claude-code/amazon-bedrock#setup

Raw AWS error: AccessDeniedException - API Model access is denied by Marketplace subscription

Alternative Solutions

Current workarounds:

• Users must manually search for the error message online
• Community forums and GitHub issues provide solutions
• Users trial-and-error through AWS console until finding marketplace subscriptions

Other approaches considered:

• Pre-flight validation that checks marketplace subscriptions before attempting operations
• Interactive setup wizard that guides through marketplace subscription process
• Warning in logs when Bedrock is configured without verified marketplace access

Priority

High - Significant impact on productivity

Feature Category

Configuration and settings

Use Case Example

No response

Additional Context

Related issues:

• #9620 - Original bug report that revealed this UX gap
• #9681 - Documentation issue submitted for adding marketplace subscription info to setup docs

AWS context:

• AWS recently changed Bedrock access model to require marketplace subscriptions
• This is a new requirement that many users encounter unexpectedly
• The AWS error message itself is not user-friendly

Similar patterns in other tools:

• Many developer tools parse cloud provider errors and add context
• Examples: Terraform, AWS CDK, Pulumi all provide enhanced error messages for common cloud permission issues

[github-actions[bot]]

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.