Command reference ยท Claude Code
/upgrade
Opens the upgrade page in your browser to switch to a higher plan tier.
/upgrade opens the upgrade page in your browser so you can switch to a higher plan tier โ so it's about your subscription, not the installed software. If the browser fails to open automatically, the command shows a sign-in prompt instead, according to the doc, without printing the URL itself.
The command's visibility depends on plan and platform: the official reference explicitly states that /upgrade isn't shown on Enterprise plans. According to the changelog, it was introduced to simplify switching to Claude Max plans.
/upgrade isn't responsible for updating the installed Claude Code version. /doctor instead points to a newer version in the release channel during the setup check; the update itself runs via the regular installation path or your package manager.
โ WHEN TO USE IT?
Switch to a higher plan tier
Call /upgrade to open the upgrade page in the browser and, for example, switch from Pro to Max.
Get more capacity after hitting a limit
After a limit notification, type /upgrade to switch directly to a higher plan tier instead of waiting for the reset.
โ WHEN NOT TO?
Expecting a CLI update
According to the doc, the command switches the plan tier and opens the browser upgrade page for that โ it doesn't update the installed Claude Code version.
Better: Update the version via the regular installation path or package manager; /doctor points to a newer version.
Use on an Enterprise plan
The official reference explicitly states that /upgrade isn't shown on Enterprise plans.
Better: Clarify plan changes with the responsible admin or team/enterprise management.
SOURCES
- Claude Code docs (official) โ code.claude.com
MORE COMMANDS ยท Claude Code