[UX] Hitting the usage/plan limit force-opens the default browser to the upgrade page — please add a toggle to disable

Open 💬 1 comment Opened Jun 21, 2026 by ohchanwu

What happens

When I hit my plan usage limit, Claude Code automatically opens my system default browser and navigates to the Max plan upgrade/registration page. I didn't trigger this and there's no prompt — it just launches a browser tab.

Why this is a problem

  • I'm actively using my default browser for other work. Having Claude Code grab focus and open a new tab (sometimes pulling the window forward) is disruptive.
  • There is currently no way to disable it. I checked the settings reference and environment variables — the only related flag is CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0, which only covers artifact publishing, not the plan-limit flow.
  • The usual BROWSER env var workaround isn't a real fix here: setting BROWSER to a no-op is too broad — it would also suppress legitimate browser-opens like the OAuth login flow, forcing me to open those URLs manually. I want to disable only the upgrade-page launch, not all browser launching.
  • Auto-opening the browser to a purchase page specifically (rather than, say, printing the URL in the terminal) feels heavier-handed than other browser-opening behaviors in the tool.

What I'd like

Any one of these would solve it:

  1. A settings.json key, e.g. "autoOpenUpgradePage": false, or
  2. An environment variable, e.g. CLAUDE_CODE_UPGRADE_AUTO_OPEN=0 (mirroring the existing CLAUDE_CODE_ARTIFACT_AUTO_OPEN), or
  3. Simply print the upgrade URL in the terminal instead of launching a browser when the limit is reached.

A targeted toggle is preferable to relying on the global BROWSER variable, for the reason noted above.

Environment

  • Claude Code 2.1.185
  • macOS (Darwin 25.5.0)
  • Default browser: Chrome

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗