Skip to content
BENIBIX Learn

/upgrade vs /restart

People think /upgrade updates Claude Code, because /update sounds like the same thing. It is not. /upgrade opens a web page where you move to a bigger Claude plan, with higher limits. /restart, which also answers to /update, closes Claude Code and opens it again with the same chat, so a new version that is already installed starts to run. One changes what you pay for. The other changes the version you run.

AI⌨️ Claude Code

/upgrade Command

It opens the page to move to a bigger plan.

/upgrade opens the page in your browser where you move to a higher Claude plan. When no browser can open, such as over SSH, it prints the page's address so you can open it somewhere else. It changes your plan, not the version of Claude Code you are running.

Example
Lucy keeps reaching her plan's limit by Thursday. She runs /upgrade, moves to a bigger plan, and her limits go up.
Why it matters
When limits block real work, this is the shortest path to more room.
Full entry
AI⌨️ Claude Code

/restart Command

It restarts Claude Code to apply an update, and keeps the chat.

/restart closes Claude Code and opens it again with the same session, which applies an update that has already been installed. Run it when the bar at the bottom says an update is ready. It needs a Pro, Max or Ultra plan and a native install on macOS or Linux. It does not run on WSL.

Example
A note under Emma's prompt says a new version is installed. She types /restart, and a few seconds later she is back in the same chat on the new version.
Why it matters
You get the fixes and the new parts, and you keep the same chat.
Full entry

In one line

/upgrade Command
It opens the page to move to a bigger plan.
/restart Command
It restarts Claude Code to apply an update, and keeps the chat.