# /restart Command

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** /restart, /update, Apply an update

## Think of it like

It is like you turn a toy off and on, so the new part works.

## Definition

/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.

## Example code

```console
/restart
```

Apply the new version and keep this session.

## Why it matters

You get the fixes and the new parts, and you keep the same chat.

## Common mistake

Expecting it to fetch the update. It only turns on one that is already in place.

## Three principles

- **Applies an update.** Already installed.
- **Same session.** The chat stays.
- **Native installs.** macOS or Linux.

## Related terms

- [/upgrade Command](https://learn.benibix.com/term/ai/upgrade-command)
- [/resume Command](https://learn.benibix.com/term/ai/resume-command)
- [/status Command](https://learn.benibix.com/term/ai/status-command)

## Told apart from

- [/upgrade vs /restart](https://learn.benibix.com/compare/upgrade-command-vs-restart-command): 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.

## Taught in

- [Install, Update and Doctor](https://learn.benibix.com/learn/ai-claude-code-commands/install-update-and-doctor): Claude Code Commands, 2/17

---

Source: https://learn.benibix.com/term/ai/restart-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
