[DOCS] Login troubleshooting page missing "OAuth not allowed for organization" guidance

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Login and authentication" / "Find your error" troubleshooting entries for organization-level OAuth denial

Current Documentation

The troubleshooting page currently has a broad OAuth/403 entry in the error table:

OAuth error or 403 Forbidden | Fix authentication

The linked "Login and authentication" section covers invalid OAuth codes and one specific 403 response:

If you see API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} after logging in: Claude Pro/Max users: verify your subscription is active at claude.ai/settings Anthropic Console users: confirm your account has the "Claude Code" or "Developer" role. Admins assign this in the Anthropic Console under Settings -> Members. * Behind a proxy: corporate proxies can interfere with API requests. See network configuration for proxy setup.

There is no troubleshooting entry for the organization-level OAuth denial surfaced in Claude Code v2.1.126: "OAuth not allowed for organization".

What's Wrong or Missing?

Claude Code v2.1.126 fixed the product UI so that "OAuth not allowed for organization" errors show the login screen with guidance to contact an admin. The docs do not contain the error string, so users and admins searching the troubleshooting page for that exact message will only find the generic OAuth/403 guidance.

This is a different failure mode from an invalid OAuth code, an expired/revoked token, or the documented Request not allowed 403. The expected next action is also different: the user likely needs organization admin action rather than local re-authentication, subscription verification, or proxy troubleshooting.

Suggested Improvement

Add an explicit row to the "Find your error" table, for example:

| What you see | Solution |
| :--- | :--- |
| OAuth not allowed for organization | [Contact your organization admin](#oauth-not-allowed-for-organization) |

Add a matching subsection under "Login and authentication":

OAuth not allowed for organization

If the login screen says OAuth not allowed for organization, Claude Code access is blocked by your organization's authentication or access policy. Contact your Claude organization admin and ask them to enable Claude Code/OAuth access for your account or organization. After the admin updates access, run /logout, then /login and try again.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/troubleshoot-install | 36, 693-727 | Generic OAuth/403 troubleshooting exists, but no exact entry for OAuth not allowed for organization |
| https://code.claude.com/docs/en/authentication | 21-28, 30-60 | Authentication overview explains team/admin setup, but delegates login failures to the troubleshooting page |

Version context: Claude Code v2.1.126 release entry: "Fixed showing the login screen for \"OAuth not allowed for organization\" errors - now shows guidance to contact your admin."