[DOCS] OAuth login troubleshooting missing timeout guidance for slow, proxied, and IPv6-only environments

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/troubleshoot-install

Section/Topic

"Login and authentication" section

Current Documentation

The troubleshooting page currently covers generic re-authentication and some OAuth-specific failures:

These sections address login failures, OAuth errors, and token issues.

If the browser doesn't open automatically during login, press c to copy the OAuth URL to your clipboard, then paste it into a browser manually.

It also documents invalid codes, 403s, and WSL2 browser-login problems, but it does not mention OAuth login timeout symptoms.

What's Wrong or Missing?

Claude Code v2.1.126 fixed OAuth login failing with a timeout on slow or proxied connections, in IPv6-only devcontainers, and when the browser callback cannot reach localhost.

The troubleshooting page does not currently give users a way to recognize that failure mode or distinguish it from other OAuth login issues. Users who hit a login timeout in those environments may only find generic reset, invalid-code, 403, WSL2, or installer-network guidance, none of which says that upgrading to v2.1.126 or later is the relevant fix.

Suggested Improvement

Add a short troubleshooting subsection under "Login and authentication", for example:

OAuth login times out

If browser-based OAuth login times out on a slow or proxied connection, inside an IPv6-only devcontainer, or after the browser sign-in completes but the localhost callback cannot reach Claude Code, update to Claude Code v2.1.126 or later and retry login.

If the browser shows a login code instead of redirecting back to the terminal, paste that code at the Paste code here if prompted prompt.

For devcontainers where editor port forwarding does not route the localhost callback, see the devcontainer sign-in note.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/troubleshoot-install | 691-755 | Login troubleshooting covers reset, invalid OAuth code, 403, and WSL2 cases, but not OAuth login timeout cases fixed in v2.1.126 |
| https://code.claude.com/docs/en/authentication | 13-17 | General login flow mentions pasting a login code when redirect does not complete |
| https://code.claude.com/docs/en/devcontainer | 87-88 | Devcontainer guide documents the localhost callback fallback but does not connect it to OAuth timeout troubleshooting or v2.1.126 |

Total scope: 3 pages affected

Release context: v2.1.126 fixed OAuth login timeout failures on slow or proxied connections, in IPv6-only devcontainers, and when the browser callback cannot reach localhost.