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 at the lower right of the window. 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, which can take several minutes. If it says “Restart timed out”, or nothing changes for an hour, start Claude Science the way you usually do. On Windows, don’t quit Claude Science first.

​
A Mac app in its own window

If Update now shows an error in red:
  1. Choose Claude Science > Check for App Updates… in the menu bar at the top of the screen. If you don’t see that menu, click the Claude Science window first.
  2. Wait while the window that opens checks and downloads, then select Restart to update. If sessions are running, select Stop session and restart or Stop sessions and restart instead. If macOS asks for an administrator’s password and you don’t have one, ask your IT team.
  3. Send a message. If the Update required box comes back, do steps 1 and 2 once more.
If you can’t find the menu, leave Claude Science open for ten minutes. Then quit with Command-Q, which stops running sessions (closing the window isn’t enough), wait ten seconds, and open Claude Science from your Applications folder.
Download Claude Science again only if the window from step 2 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. On Windows, if an update said “restart aborted” or “The update is installed”, follow the Windows steps first. 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

  • On Windows, an update said “restart aborted” or “The update is installed”: don’t quit Claude Science or run claude-science stop, and don’t shut down or restart your PC, or sign out of Windows. Letting your PC sleep doesn’t close Claude Science. If security software is blocking the new version, Claude Science might not open again. Select Update now or Restart to update again after a few minutes. If it still fails, ask your IT team whether security software is blocking Claude Science, and send them Where the app stores data. If you don’t have an IT team, contact Claude support.
  • Claude Science still asks you to update: on Windows, if an update said “restart aborted” or “The update is installed”, follow the entry above instead. 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” or “The update is installed”: on a Mac or Linux, if you started Claude Science from a terminal, follow the terminal steps. Otherwise, follow restart aborted.
  • The message says “the new version couldn’t start”: you’re still on the version you had. Updating again, even from a terminal, gets the same version until a newer one is released, so contact Claude support with the exact words you see.
  • 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.