Command line settings changedclaude-science/command-line-settings
Nearest release: v2.1.286, published an hour before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 30 Sep 2026 19:06 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 30 Sep 2026 19:37 UTC.
Upstream edited
Recorded here
Lines+47added
Lines−15removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits5to this page, all time
### Roll back to an earlier build
The whole hunk
from line 1, old and new numbered
/
from line 1
11# Command line settings
22
3> Reference for the claude-science command: every subcommand, the serve flags, the single-use login link, and the environment variables Claude Science reads.
3> Reference for the claude-science command: its subcommands, the serve flags, the single-use login link, and the environment variables you can set.
44
5Reference for the claude-science command: every subcommand, the serve flags, the single-use login link, and the environment variables Claude Science reads.\
6claude-science serve starts Claude Science and opens the web app in your browser at a single-use login link. Everyday use is that one command. The others manage the running program: they mint login links, report status, follow logs, install updates, and merge data directories. On Windows, the installer adds the command to your PATH for new terminals. There the app window you open from the Start menu is the everyday way in, and the commands below manage the same running program.
5Reference for the claude-science command: its subcommands, the serve flags, the single-use login link, and the environment variables you can set.\
6claude-science serve starts Claude Science and opens the web app in your browser at a single-use login link. On Linux, everyday use is that one command. The others manage the running program: they mint login links, report status, follow logs, install updates, and merge data directories. On Windows, the installer adds the command to your PATH for new terminals. There the app window you open from the Start menu is the everyday way in, and the commands below manage the same running program.
77
88## Commands
99
from line 11
1111| - | - |
1212| `claude-science serve` | Start the background program and open the web app in your browser at a single-use login link. One runs per data directory; Ctrl-C stops it. |
1313| `claude-science open` | Mint a fresh login link from the running program and open it in your browser. |
14| `claude-science url` | Print a fresh login link alone on standard output and nothing else. |
14| `claude-science url` | Print a fresh login link. At a terminal, the link comes inside a short banner. When you pipe or capture the output, standard output carries only the link. |
1515| `claude-science status` | Print whether the program is running, the version, and the port, as JSON. |
1616| `claude-science logs` | Print the newest log file from the data directory. `--tail` follows it live. |
1717| `claude-science stop` | Stop the program cleanly. |
18| `claude-science update` | Check for and install an update. `--check` only reports; --to `<version>` installs a specific version, which is also how you roll back. Updates are signature-verified and replace the binary atomically. |
18| `claude-science update` | Check for and install an update. `--check` only reports; `--to <build>` installs a specific build, which is also how you roll back (see [Roll back to an earlier build](#roll-back-to-an-earlier-build)). Updates are signature-verified and replace the binary atomically. |
1919| `claude-science import` `<path>` | Merge another data directory, or its database file, into this one. |
20| `claude-science install` | Windows only. Install the app for your user account, with a PATH entry, a Start menu shortcut, and an uninstall entry under Windows **Settings > Apps > Installed apps**. Run it again to repair them. |
2021| `claude-science uninstall` | Windows only. Remove the app, its shortcuts, and its PATH entry while keeping your data; `--purge` also deletes the data directory. Quit Claude Science first. |
2122| `claude-science --version` | Print the version. |
22| `claude-science` `<command>` --help | Print help for any command. |
23| `claude-science <command> --help` | Print help for any command. |
2324
2425<Note>
2526 `import` has no preview and no undo. Back up the data directory before you run it; running the same import a second time is safe.
2627</Note>
2728
29### Roll back to an earlier build
30
31`claude-science update --to <build>` installs one specific build. `<build>` is an 8-character build ID such as `3f9a01bc`, not a version number. `claude-science update --check` prints the ID of the installed build as `Current`.
32
33Claude Science checks for updates in the background and shows **Update available** when one is ready. Note the `Current` ID before you choose **Restart to update**, so you know which build to go back to.
34
35If a newer build has already changed how your data directory stores sessions, the command refuses an older build and installs nothing, because an older build can permanently lose part of every session it writes to. The refusal names a flag that overrides it, `--accept-layout-downgrade`, and says when that is safe. If you cannot tell from the message whether it is safe for you, do not add the flag.
36
37<Note>
38 An older build that does install can still refuse to start if a newer build has already updated the database in your data directory. When it does, it stops at startup and changes nothing in your data. At a terminal, it says the data was `written by a NEWER version`. To start the app again, run `claude-science update`, which installs the latest build.
39</Note>
40
2841## Global flags
2942
3043These two work on every command. On Windows, `~` in the defaults below is your user profile folder, `%USERPROFILE%`.
from line 44
3144
3245| Flag | Default | What it does |
3346| - | - | - |
34| `--data-dir` `<dir>` | `~/.claude-science` | The data directory to use. |
47| `--data-dir` `<dir>` | `~/.claude-science` | The data directory to use. Sign-in tokens and the shared package environment stay under `~/.claude-science` whichever directory you choose, so all your data directories share one sign-in. |
3548| `--config` `<file>` | `~/.claude-science/config.toml` | The configuration file to read. |
3649
3750## The login link
3851
39When serve starts, it prints a line of the form `Web UI -> http://localhost:<port>/?nonce=...`. The nonce is a one-time password: it signs one browser tab in and then expires, about three minutes after it is printed. The signed-in tab stays signed in until you restart the program.\
40You never need to keep a link. claude-science open mints a fresh one and opens it in your browser whenever you want to sign in again. For a machine you reach over SSH, claude-science url prints a fresh link alone on standard output: run it there, then open the printed link through your tunnel. The app listens on 127.0.0.1 unless you change --host, so it is reachable only from your own machine.
52When serve starts, it prints a line of the form `Web UI → http://localhost:<port>/?nonce=...`. The nonce is a one-time password: it signs one browser tab in and then expires, about three minutes after it is printed. The signed-in tab stays signed in until you restart the program.\
53You never need to keep a link. claude-science open mints a fresh one and opens it in your browser whenever you want to sign in again.
4154
55The app listens on 127.0.0.1 unless you change `--host`, so it is reachable only from the machine it runs on. For a machine you reach over SSH, first forward two ports from your computer, the web app port and the preview port (by default the web app port plus one), as [Run on a remote Linux server](/docs/claude-science/run-on-remote-linux-server#forward-the-ports-from-your-computer) shows. Then run claude-science url on that machine and open the link it prints in your own browser.
56
4257## Flags for serve
4358
4459| Flag | Default | What it does |
4560| - | - | - |
46| `--port` `<n>` | `8000` | The port the web app is served on. 0 picks a free port. |
61| `--port` `<n>` | `8000` | The port the web app is served on. 0 picks a free port. If you did not pass `--port` and 8000 is busy, the app takes the next free port and says so. If you passed `--port` and that port is busy, serve exits and tells you to pick a different one. `claude-science status` prints the port in use. |
4762| `--no-browser` | off | Do not open a browser. url prints a login link any time you want one. |
48| `--detached` | off | Run in the background. Implies --no-browser. |
63| `--detached` | off | Run in the background. Implies `--no-browser`. |
4964| `--no-auto-update` | off | Do not check for or install updates. For a pinned or centrally managed install. |
50| `--host` `<address>` | 127.0.0.1 | The address the app listens on. Anything else exposes the app to your network; prefer an SSH tunnel. |
65| `--host` `<address>` | 127.0.0.1 | The address the app listens on. Any other address exposes the app to your network. To work from another machine, use an SSH tunnel. |
5166| `--base-path` `</prefix>` | unset | Serve the app under a URL prefix behind a reverse proxy. |
52| `--allow-origin` `<url>` | unset | An extra browser Origin allowed to connect; repeat the flag for more than one. It does not change which sites Claude can reach. |
67| `--allow-origin` `<url>` | unset | An extra browser Origin allowed to connect, written as `https://<host>` with an optional port and no path. A value that starts with `http://`, has a path, or has no `https://` in front is ignored without a message. Repeat the flag for more than one. It does not change which sites Claude can reach. |
5368| `--sandbox-port` `<n>` | port + 1 | The separate origin that previews of generated HTML are served from, so a previewed page cannot read your session. |
5469| `--verbose` | off | Show startup and info log lines on the console; by default they go only to the log file. |
5570
5671## Dangerous flags
5772
73`claude-science serve` accepts two flags that each turn off a protection.
74
5875<Warning>
59 `--dangerously-no-sandbox` runs code with full read and write access to your home directory and an unrestricted network. `--dangerously-skip-approvals` approves every permission card automatically, for everything, until you restart without the flag; questions addressed to you still appear. Neither belongs in everyday use.
76 * `--dangerously-no-sandbox` turns the [sandbox](/docs/claude-science/core-concepts#sandbox) off. On macOS and Linux, the code Claude runs then has full read and write access to your home directory and unrestricted network access. On Windows, code cells do not run at all while the flag is set.
77 * `--dangerously-skip-approvals` approves [permission cards](/docs/claude-science/core-concepts#permission-cards) for you without showing them, until you restart without the flag. That includes Claude's requests to run code, reach network hosts, open folders, and use connector tools. Cards still show for a connector tool you set to [**Ask each time**](/docs/claude-science/custom-connectors) and for requests only you can answer, such as entering an SSH password, permanently deleting artifacts, or spending usage credits. Questions Claude asks you still appear.
78
79 These flags are acceptable only on a machine that is already isolated, such as a container or a disposable virtual machine. Never use them with data or prompts that came from someone else, because Claude may follow instructions hidden in them. Neither belongs in everyday use.
6080</Warning>
6181
82If your organization [manages the network allowlist](/docs/claude-science/admin-controls#network-allowlist), the app ignores `--dangerously-no-sandbox` and keeps the sandbox on. If the app learns of that setting only after it has started without the sandbox, it pauses new sessions and messages until you restart it.
83
6284## Environment variables
6385
64`DO_NOT_TRACK`, set to any value other than `0` or `false`, turns usage analytics and error reports off. It is the same switch as `disable_telemetry = true` in the configuration file. `GITHUB_TOKEN` is optional and is used only against `api.github.com`, to lift the rate limit when you install a skill from a GitHub repository. Claude Science also reads the standard proxy variables (`HTTPS_PROXY`, `HTTP_PROXY`, `NO_PROXY`, and `ALL_PROXY`); see [Use Claude Science on a corporate network](/docs/claude-science/corporate-networks#connect-through-an-outbound-proxy). The proxy address variables are the one case where the environment overrides the configuration file, and `NO_PROXY` is merged with the `no_proxy` key rather than replacing it. Every other setting belongs in the configuration file.
86`DO_NOT_TRACK`, set to any value other than `0` or `false`, turns usage analytics and error reports off. It is the same switch as `disable_telemetry = true` in the configuration file. `GITHUB_TOKEN` (or `GH_TOKEN`) is optional and is used only against `api.github.com`, to lift the rate limit when you install a skill from a GitHub repository. Claude Science also reads the standard proxy variables (`HTTPS_PROXY`, `HTTP_PROXY`, `NO_PROXY`, and `ALL_PROXY`); see [Use Claude Science on a corporate network](/docs/claude-science/corporate-networks#connect-through-an-outbound-proxy). The proxy address variables are the one case where the environment overrides the configuration file, and `NO_PROXY` is merged with the `no_proxy` key rather than replacing it. Every other setting belongs in the configuration file.
6587
88An app started from the macOS Dock or Finder, or from the Windows Start menu, does not see variables exported in a terminal. The macOS app reads the `env` file in the data directory (by default `~/.claude-science/env`) when it starts, so put the variable there as a `KEY=VALUE` line, then quit and reopen the app. On Windows, set it as a user environment variable, then quit and reopen the app. See [How the environment variables reach the app](/docs/claude-science/corporate-networks#how-the-environment-variables-reach-the-app).
89
6690## See also
6791
6892<CardGroup cols={1}>
93 <Card title="Run on a remote Linux server" href="/docs/claude-science/run-on-remote-linux-server">
94 Install Claude Science on a server and use it from your own browser through an SSH tunnel.
95 </Card>
96
97 <Card title="Configuration file reference" href="/docs/claude-science/configuration-file-reference">
98 Find the `config.toml` file and set its network-related keys.
99 </Card>
100
69101 <Card title="Remote compute clusters" href="/docs/claude-science/remote-compute-clusters">
70102 Connect an SSH host and run jobs on it.
71103 </Card>
No line in this hunk matches that.