Skip to content

Clarify Claude Code /login in auth UI and docs - #90

Open
shreyashankar wants to merge 2 commits into
mainfrom
cursor/clarify-claude-login-docs-8d6e
Open

Clarify Claude Code /login in auth UI and docs#90
shreyashankar wants to merge 2 commits into
mainfrom
cursor/clarify-claude-login-docs-8d6e

Conversation

@shreyashankar

@shreyashankar shreyashankar commented Aug 28, 2026

Copy link
Copy Markdown
Collaborator

Problem

When Claude auth failed, DocWriter told people to run /login without explaining that this is a Claude Code terminal slash command (not a DocWriter UI action). The docs also listed a vague claude login one-liner, so users often pasted an Anthropic API key instead — which works, but bills API usage rather than the Claude Code subscription.

Changes

  • Auth failure toast for Claude now lists numbered terminal steps (claude → type /login → browser sign-in) and warns that pasting an API key switches to API billing.
  • Settings → API keys: clearer Claude note, refresh-login tip when using login, and a billing note when a key is set.
  • Docs: expand Connect a provider Claude section and Provider errors with an explicit Claude Code login section.

How to verify

  1. Open Settings → API keys and confirm the Claude notes match the login vs API-key cases.
  2. Trigger a Claude auth failure (or inspect authRecoveryHint in +page.svelte) and confirm the steps mention the terminal /login flow.
  3. Skim docs/connect-provider.mdx and docs/help/provider-errors.mdx.

Walkthrough

API keys panel: Claude optional with /login steps
API keys panel: key set warns about API billing
api-keys-claude-login-guidance.mp4

npm run check passed (0 errors).

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

cursoragent and others added 2 commits August 28, 2026 21:37
The auth failure toast previously said "run claude and /login" without
explaining that /login is a Claude Code terminal slash command. Expand
recovery copy, Settings → API keys notes (including API-key vs subscription
billing), and the connect-provider / provider-errors docs.

Co-authored-by: Shreya Shankar <shreyashankar@cmu.edu>
Co-authored-by: Shreya Shankar <shreyashankar@cmu.edu>
@mintlify

mintlify Bot commented Aug 28, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
docwriter 🟢 Ready View Preview Aug 28, 2026, 9:38 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants