[DOCS] Agent view docs do not mention that `/login` opens the sign-in dialog from the `claude agents` view (v2.1.198)

Open 💬 0 comments Opened Jul 1, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

  • The agent view page section that describes what happens when a background dispatch or session fails because of missing credentials; specifically the block that begins with "If a background dispatch fails with Could not resolve authentication method..."

Current Documentation

The troubleshooting block on the agent view page reads:

If a background dispatch fails with Could not resolve authentication method while interactive sessions authenticate normally, the worker that received the dispatch did not pick up credentials. The supervisor supplies a fresh credential snapshot when it assigns a [pre-warmed worker](#the-supervisor-process), so this error means no stored credential was available to the supervisor process itself. Confirm you have run /login or configured an API key, then stop the supervisor:

This implies the user has to leave agent view to run /login from elsewhere and then restart the supervisor.

What's Wrong or Missing?

The release notes for v2.1.198 add direct sign-in support from inside agent view:

/login now opens the sign-in dialog from the claude agents view instead of saying it isn't available

The current troubleshooting flow tells users to leave the view, run /login, then restart the supervisor. After v2.1.198, users can run /login directly from agent view to open the sign-in dialog. The page does not mention that pathway.

Suggested Improvement

Before:

If a background dispatch fails with Could not resolve authentication method while interactive sessions authenticate normally, the worker that received the dispatch did not pick up credentials. The supervisor supplies a fresh credential snapshot when it assigns a [pre-warmed worker](#the-supervisor-process), so this error means no stored credential was available to the supervisor process itself. Confirm you have run /login or configured an API key, then stop the supervisor:

After:

If a background dispatch fails with Could not resolve authentication method while interactive sessions authenticate normally, the worker that received the dispatch did not pick up credentials. The supervisor supplies a fresh credential snapshot when it assigns a [pre-warmed worker](#the-supervisor-process), so this error means no stored credential was available to the supervisor process itself. As of v2.1.198, run /login directly from the agent view to open the sign-in dialog instead of leaving the view. If you authenticate with an environment variable rather than /login, run the next command from a shell where the variable is set, then stop and restart the supervisor:

Impact

Medium - Makes feature difficult to understand

Additional Context

Related v2.1.198 change:

/login now opens the sign-in dialog from the claude agents view instead of saying it isn't available

The /login row in the commands reference does not mention the new in-view entry point either, so the recovery flow is the only place that reads naturally for this guidance.

Affected Pages:

| Page | Context |
|---|---|
| https://code.claude.com/docs/en/agent-view | Authentication troubleshooting block that points users away from agent view |

View original on GitHub ↗