[DOCS] Quickstart `/login` instruction is misleading/invalid for Cloud Provider users (Bedrock/Vertex/Foundry)
Documentation Type
Unclear/confusing documentation
Documentation Location
https://code.claude.com/docs/en/quickstart
Section/Topic
Step 2: Log in to your account
Current Documentation
"When you start an interactive session with theclaudecommand, you'll need to log in: ``bash /login # Follow the prompts to log in with your account``"
What's Wrong or Missing?
The Quickstart provides a generic instruction to run /login as the primary method of authentication. however, for users utilizing Cloud Providers (Amazon Bedrock, Google Vertex AI, or Microsoft Foundry), the /login and /logout commands are explicitly disabled.
As noted in docs/en/amazon-bedrock.md: "When using Bedrock, the /login and /logout commands are disabled since authentication is handled through AWS credentials."
New users following the Quickstart with a cloud-provider configuration will attempt to run /login and receive an error or a message stating the command is disabled, leading to a confusing first-time user experience.
Suggested Improvement
Add a "Note" or "Info" callout to Step 2 of the Quickstart to clarify authentication for cloud users.
Suggested Text:
Note for Cloud Provider Users: If you are using Amazon Bedrock, Google Vertex AI, or Microsoft Foundry, authentication is handled via your provider's environment variables and CLI credentials (e.g.,aws configureorgcloud auth). For these configurations, the/loginand/logoutcommands are disabled. Please see the [Enterprise Deployment](/en/third-party-integrations) guide for setup details.
Impact
High - Prevents users from using a feature
Additional Context
- Internal Reference:
docs/en/amazon-bedrock.md(Section: Setup - Item 3) explicitly mentions: "When using Bedrock, the /login and /logout commands are disabled since authentication is handled through AWS credentials." - Internal Reference:
docs/en/google-vertex-ai.md(Section: Setup - Item 4) notes: "When using Vertex AI, the /login and /logout commands are disabled since authentication is handled through Google Cloud credentials." - Severity: Major. The Quickstart is the primary entry point for all developers; providing an invalid instruction to enterprise/cloud users causes immediate friction.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗