Skip to content

[DOCS] (Claude Desktop UI) Misleading authentication token message in Claude Desktop settings #13435

Description

@MatthewGrantAU

Documentation Type

Unclear/confusing documentation

Documentation Location

Claude Desktop app on MacOS > Settings > Claude Code

Section/Topic

Manage your authorization tokens

Current Documentation

No connected Claude Code instances
When you sign in to Claude Code, your authorization tokens will appear here.

What's Wrong or Missing?

Problem:
This wording suggests that when users authenticate Claude Code CLI (via claude auth login), their tokens will appear in this Desktop settings page. However, this is incorrect - Claude Code CLI uses a separate authentication system (stored in system keychain on macOS) and those tokens never appear in Desktop settings.

Impact:
Users who successfully authenticate with Claude Code CLI become concerned that something is wrong when they see "No connected Claude Code instances" and expect to see their tokens listed.

Suggested Improvement

The message should clarify that this section is specifically for applications/tools that connect to Claude Desktop's local API, not for Claude Code CLI authentication. For example:

Manage your authorization tokens
No connected instances
Authorization tokens for applications connecting to Claude Desktop's API will appear here.
Note: Claude Code CLI uses separate authentication (claude auth login).

Impact

Low - Minor confusion or inconvenience

Additional Context

Environment:

  • Claude Desktop version: [latest]
  • Claude Code version: 2.0.62
  • OS: macOS (Darwin 24.6.0)

This issue its suggested fix were provided by Claude while I was troubleshooting my authentication.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:authdocumentationImprovements or additions to documentationplatform:macosIssue specifically occurs on macOSstaleIssue is inactive

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions