[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
BROWSERenv var workaround isn't a real fix here: settingBROWSERto 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:
- A settings.json key, e.g.
"autoOpenUpgradePage": false, or - An environment variable, e.g.
CLAUDE_CODE_UPGRADE_AUTO_OPEN=0(mirroring the existingCLAUDE_CODE_ARTIFACT_AUTO_OPEN), or - 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
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗