Skip to main content
Install Claude Science on your computer, sign in with your Claude account, and run your first analysis. You need a Claude Pro, Max, Team, or Enterprise plan. The Claude Team plan for scientists has Claude Science on by default. On other Team and Enterprise plans, an Owner must turn Claude Science on first. For what each plan includes and how usage works, see Plans and usage.

​
Install

Download the installer from claude.com/product/claude-science and double-click to install. On first launch, the app sets up its runtime and starter Python and R environments, which takes a few minutes, then opens a new tab in your default browser. If no browser tab appears, click Claude Science in the Dock.Updates. Installing an update from inside Claude Science can switch it from a browser tab to its own window. See Claude Science in its own window on macOS.
  • If it opens in a browser tab: Claude Science checks for updates in the background and shows Update available when one is ready. Choose Restart to update to install it.
  • If it opens in its own window: Claude Science downloads updates by itself and installs them when you quit. To check for an update right away, choose Claude Science > Check for App Updates… in the menu bar.
To update Claude Science later, or when it asks you to update, see Update Claude Science.
Claude Science is a local application, not a website, so there’s no public URL to visit. On Windows it opens in its own window, and on Linux it opens in a browser tab. On a Mac it opens in a browser tab, or in its own window once an update has switched it over (see Claude Science in its own window on macOS). Open it from the application itself: Claude Science in Applications or the Dock on macOS, the Start menu on Windows, or the claude-science command on Linux. On a remote server, the sign-in link reaches your browser through an SSH tunnel; see Run on a remote Linux server.

​
Sign in and complete setup

When the app opens, sign in with your Claude account. If Claude Science opens in its own window, on Windows or on a Mac, click the Sign in on the web button and confirm with Continue. Claude Science then opens claude.ai in your default browser. Once you approve the sign-in there, Claude Science continues in its own window. No API key is required. In a browser tab or in the Windows app, if you approve the sign-in in your browser but Claude Science doesn’t continue (for example, on a remote server when the sign-in can’t return through the SSH tunnel), sign in with a code instead:
  1. Go back to the Claude Science sign-in screen and select Paste code instead, then Open on web.
  2. Approve access in the browser, then copy the whole code the page shows.
  3. Paste the code into Claude Science. If the sign-in doesn’t continue on its own, select Continue.
After sign-in, a setup wizard walks you through enabling connectors and skills, setting which websites Claude can access, and choosing whether memory is on. You can change these at any time in Settings.
Claude Science keeps your data in a single folder in your home directory: ~/.claude-science on macOS and Linux, and %USERPROFILE%\.claude-science on Windows. On Linux, the claude-science command itself installs to ~/.local/bin, and on Windows the app installs to %LOCALAPPDATA%\Programs\ClaudeScience and adds that folder to your user PATH. Beyond that, it doesn’t modify your existing conda installation, R libraries, or shell configuration. To remove Claude Science, see Uninstall Claude Science.

​
Run your first analysis

  • Open the Example project, or create a new one.
  • Start a conversation. Reference a folder on your computer by typing its path or using the @ picker in the composer.
  • Review the folder-access card when it appears and choose whether to allow it.
  • Review the code-execution card when Claude proposes running code and choose whether to allow it.
  • Results appear as artifacts in the Files panel.

​
Uninstall Claude Science

Uninstalling removes the application and keeps your data folder. Your projects, artifacts, and conversation history stay on your computer until you delete that folder.
Deleting the data folder (~/.claude-science, or %USERPROFILE%\.claude-science on Windows) removes all your projects, artifacts, conversation history, environments, and settings, and signs you out. Copy anything you want to keep first, with Download on an artifact or by copying the project’s folder from inside the data folder.Before you uninstall, check where your data is under Settings > Storage > Data location. If it shows a folder other than the default, the default folder still holds your environments and your sign-in, and it can also hold projects from before that location was set. To remove all your data:
  • The folder that Data location shows holds your current projects. Move anything else you stored there yourself out of it, then delete that folder.
  • Delete the default folder (~/.claude-science, or %USERPROFILE%\.claude-science on Windows).
Files in the folders you granted Claude access to aren’t affected unless they’re inside the folder that Data location shows.
1

Quit Claude Science

In the Dock, Control-click the Claude Science icon and choose Quit. If you started Claude Science from Terminal with claude-science serve, also run claude-science stop.
2

Move the application to the Trash

In Finder, open the Applications folder and move Claude Science to the Trash. If Claude Science isn’t there, look in the Applications folder inside your home folder.
3

Remove the Terminal command

The app also adds a claude-science command for Terminal. Remove it with rm ~/.local/bin/claude-science.
To remove your data as well, delete the ~/.claude-science folder. If Claude Science opened in its own window, also delete ~/Library/Application Support/Claude Science, which holds that window’s own settings and stored data.
To reinstall, follow Install again. Installing doesn’t replace an existing data folder.

​
Troubleshooting first launch

  • macOS says the application isn’t supported, or the app icon appears crossed out: the download page picked the build for the wrong processor. Return to the download page and choose Mac (Intel) or Mac (Apple Silicon) to match your Mac. To check which you have, open the Apple menu, choose About This Mac, and look at the Chip or Processor line.
  • Nothing opened on macOS, or no browser tab appeared on Linux: on macOS, click Claude Science in the Dock, or open it from the Applications folder. On Linux, copy the printed URL into a browser on the same machine, or run claude-science url to print a fresh one.
  • On macOS, some of Claude’s tools can’t start and the error mentions the Xcode license, usually right after an Xcode update: macOS won’t run the Python that comes with Apple’s developer tools until the license is accepted. Open Xcode and agree to the license with an administrator account, or run sudo xcodebuild -license accept in Terminal, then ask Claude to try again.
  • A Claude Science message on Windows says the app was not installed because the file could not be confirmed: the copy you opened still runs but isn’t installed. Download the installer again from claude.com/product/claude-science and open the new file. If the message persists, the PC could not verify the publisher’s signature, so ask your IT team.
  • The Windows app reports that it couldn’t set up the app window engine: the first launch downloads that engine from downloads.claude.ai, and this usually means the app couldn’t reach it. Check the internet connection, and on a corporate network ask IT to allow that domain (see Network requirements).
  • On Linux, the installer stops with The download service may be unreachable, or not yet available in your region: the installer couldn’t get the latest version from storage.googleapis.com. Check the internet connection, and on a corporate network ask IT to allow that domain (see Network requirements). Claude Science is available where Anthropic offers claude.ai. See Supported countries and regions.
  • On Linux, the installer stops with was NOT installed and says the copy you already had was left as it is: Claude Science was already installed, so the installer first tried to check that the new version starts on this computer. The check didn’t succeed, so nothing was replaced. The message and the lines under it say why and, where there is a fix, what to do. If they point to the configuration file, ~/.claude-science/config.toml, fix what they report in that file, then run the installer again from the Linux tab of Install. If they give no fix, keep using the copy you already had.
  • On Linux, the shell reports command not found for claude-science: ~/.local/bin isn’t on your PATH. Add the PATH line that the installer printed to your shell profile, then open a new terminal.
  • On Linux, claude-science serve stops with a Sandbox unavailable: message that says bwrap not found in a list of folders, or bwrap was found on PATH at a path: bubblewrap isn’t installed in a system folder. In version 0.1.71 and later, Claude Science runs bubblewrap and socat only from the system folders that the message lists or from a copy you’ve approved. It doesn’t search your PATH. Install both with the command for your distribution in the Linux tab of Install. Without administrator access, approve a copy of your own with the claude-science sandbox approve command that the message prints. If this happened after you typed claude-science update, you can go back to version 0.1.70.
  • On Linux, claude-science serve stops with a Sandbox unavailable: message such as /usr/bin/bwrap is too old: the bubblewrap it names is older than 0.8.0. Check its version in a terminal with that path, for example /usr/bin/bwrap --version, then upgrade bubblewrap. Ubuntu 24.04’s repositories carry a new enough version and Ubuntu 22.04’s don’t. If you can’t upgrade it, approve a newer copy of your own.
  • On Linux, claude-science serve stops with Sandbox unavailable: bwrap cannot create unprivileged user namespaces: the kernel or an AppArmor profile blocks the sandbox from creating user namespaces. The rest of the message names the settings to check on Ubuntu, Debian, and other distributions, and changing them takes administrator (sudo) access.
  • On Linux, claude-science serve stops with Sandbox unavailable: socat is required for Linux sandbox networking: socat isn’t installed in a system folder, and Claude Science doesn’t search your PATH for it. Install socat with the command for your distribution in the Linux tab of Install. Without administrator access, you can approve a copy of your own so that Claude Science starts. Until socat is in a system folder, environment setup fails with Package downloads are being blocked by network policy, because code that Claude runs has no network access. If this happened after you typed claude-science update, you can go back to version 0.1.70.
  • On Linux, a line starting [sandbox] says sandboxed commands run without network access, in the terminal where claude-science serve runs or in the output of claude-science logs: Claude Science started, but the sandbox has no network access. The sandbox runs socat only from system folders such as /usr/bin, and doesn’t use a copy from conda, pixi, a cluster module, or your home folder, including a copy that you approved. Code that Claude runs can’t reach the internet, and environment setup fails with Package downloads are being blocked by network policy even when your network blocks nothing. Install socat with the command for your distribution in the Linux tab of Install, or if you don’t have administrator access, ask your system administrator to install it for the whole system.
  • Projects from another computer don’t appear: by design, Claude Science keeps your work on the computer where it’s installed, so each computer starts with its own projects. Your earlier projects are still on the other computer. See Use Claude Science on more than one computer.
  • Projects you created under another sign-in on this computer don’t appear automatically, for example, after you move from a personal plan to your organization’s Team plan: your earlier projects are still in that sign-in’s folder. Select the Review button on the banner at the top of the home screen, or select Review next to Access previously saved Claude Science work on this computer under Settings > General > Account, to access them. On Team and Enterprise plans, if there’s no banner and the setting is grayed out, your admin controls it. See Access work from another sign-in on your computer.
  • Sign-in stops at claude.ai: your account is on the Free plan (upgrade required), the redirect couldn’t return (in a browser tab or in the Windows app, use Paste code instead), or your Team or Enterprise organization hasn’t enabled Claude Science yet.
  • After you paste a code, Claude Science says the code wasn’t recognized or was issued for an earlier sign-in attempt: select Open on web again, approve access, and paste the whole new code. If it says PKCE state missing or expired instead, select Back and follow the steps in Sign in and complete setup again.