Skip to main content
Your projects, conversations, and artifacts stay in your data folder. Updating stops running sessions, so afterward select Resume in any session that shows it above the message box.

​
Update from the app

  1. Select Update now in the Update required box, or Restart to update on the “Update available” notice. With neither, select Check for updates under Settings > General > About, then Restart to update.
  2. If sessions are still running, select Stop & restart, which stops them.
  3. Leave Claude Science open while it downloads and restarts.

​
A Mac app in its own window

If Update now shows an error in red:
  1. Quit Claude Science with Command-Q, which stops running sessions. Closing the window isn’t enough.
  2. Wait ten seconds, open Claude Science from your Applications folder, and send a message.
  3. If the Update required box comes back, choose Claude Science > Check for App Updates… in the menu bar. When the window says “Ready to update”, select Restart to update.
Download Claude Science again only if that window says “install the newest Claude Science app over this one”, or if Claude Science won’t open and says “This copy of Claude Science can’t be opened”. Then install Claude Science again. The download is the app that opens in a browser tab, not the app you have.

​
From a terminal or on a server

Run these commands in a terminal on the computer where Claude Science runs. The second one stops running sessions.
If claude-science stop says “Not killing pid”, press Ctrl-C in the terminal where Claude Science is running, or restart the computer. If it tells you to remove a file, don’t. Then start Claude Science the way you usually do, and open the new link that it prints.

​
Install Claude Science again

On a Mac where Claude Science opens in its own window, do this only if the steps for that Mac sent you here, and get help if they didn’t. Installing again doesn’t replace your data folder. If your projects don’t appear afterward, don’t delete any folders, and get help.
  1. Quit Claude Science. On a Mac, Control-click Claude Science in the Dock and choose Quit. On Windows, right-click its icon in the notification area of the taskbar and choose Quit Claude Science.
  2. Download the installer from claude.com/product/claude-science and open it. On a Mac, choose Install.
On Linux, run this installer in a terminal instead, then run claude-science stop and start Claude Science again:

​
If the update still fails

  • Claude Science still asks you to update: on a Mac where Claude Science opens in its own window, quit it with Command-Q, wait ten seconds, then open it from your Applications folder. Anywhere else, run claude-science stop in a terminal (on a Mac or Linux, if the command isn’t found, type ~/.local/bin/claude-science stop), quit Claude Science if you’re on a Mac, then open it again. If claude-science stop says “Not killing pid”, follow the terminal steps.
  • The message says “restart aborted”: follow restart aborted.
  • Anything else: on a Mac where Claude Science opens in its own window, contact Claude support with your version and the exact words you see. Anywhere else, install Claude Science again, and contact support if that doesn’t work.