[DOCS] Claude Platform on AWS docs contradict new `/login` refresh credentials option

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/claude-platform-on-aws

Section/Topic

"Option A: AWS credentials with SigV4" and the note under "Option B: Workspace API key"

Current Documentation

The page documents awsAuthRefresh for expired SSO credentials:

"If your SSO credentials expire mid-session, configure awsAuthRefresh so Claude Code re-runs your login command and retries instead of failing."

But a later note says:

"The /login and /logout commands don't change Claude Platform on AWS authentication. Authentication runs through your AWS credentials or workspace API key, not through a Claude.ai subscription."

What's Wrong or Missing?

Claude Code v2.1.186 added a "Claude Platform on AWS - refresh credentials" option to /login when awsAuthRefresh is configured.

The docs now contradict the product behavior by saying /login does not affect Claude Platform on AWS authentication. They also do not explain when the refresh option appears or what command it runs.

Suggested Improvement

Update the note to distinguish subscription login from AWS credential refresh. For example:

/login does not switch Claude Platform on AWS to Claude.ai subscription authentication. When awsAuthRefresh is configured, /login also shows a "Claude Platform on AWS - refresh credentials" option that runs the configured refresh command.

Add a short example after the awsAuthRefresh snippet:

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

Then explain that /login can be used to run this refresh command manually before continuing.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/claude-platform-on-aws | Primary Claude Platform on AWS authentication guide |
| https://code.claude.com/docs/en/amazon-bedrock | Existing awsAuthRefresh behavior reference |
| https://code.claude.com/docs/en/settings | awsAuthRefresh setting reference |

Total scope: 3 pages affected