Remote and Cloud Sessions
These variables matter when Claude Code runs away from your terminal. They cover cloud sessions, the remote bridge, the desktop app, the Chrome extension, Cowork, and Slack. The host sets most of them, and Claude Code reads them. Set one yourself only when you run your own host.
This page lists 186 variables. The host program that starts Claude Code sets many of them. You can change them only if you control that process. They live in the environment of the Claude Code process.
Example
CLAUDE_CODE_REMOTE=true claude -p "Summarize the repo"
CLAUDE_CODE_REMOTE=true marks the run as a cloud session. Claude Code then raises its Node heap limit to 8192 MB.
Variables
The table is sorted by name. See Environment Variables for what each column and badge means.
| Variable | Status | What it does | Values and default | Notes |
|---|---|---|---|---|
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Gives the agent proxy CA certificate as base64 PEM. Claude Code uses it instead of fetching the CA. | Text. Claude Code reads it once at startup and then removes it from the env. A bad value logs a warning, and Claude Code fetches the CA | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Turns on the CA file watch of the agent proxy relay. | On or off. Read at agent proxy startup with CCR_. Purpose of the watch is not shown beyond the flag name | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Turns on the hosted agent proxy relay that routes git and GitHub traffic of a remote session. | On or off. Needs CLAUDE_ true and a session id and token. Off by default | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Lists hosts for the frame tunnel. A malformed value logs a warning and keeps the gateway routes. | Text. Unset means no frame tunnel host | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Lists the hosts that the agent proxy relays in selective mode. Other hosts use normal networking. | Text. Comma separated string. An empty list in selective mode fails closed and tunnels everything | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Stops the agent proxy from adding its CA straight to the Java trust store. It runs the Java CA hook instead. Added in 2.. | On or off, off by default. The direct install check then reports disabled | Cloud remote sessions, agent proxy tool trust |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Limits the proxy bypass list of the agent proxy relay to local hosts only. | On or off. Used with standalone mode and in the no-proxy list choice | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Stops the agent proxy from keeping a record of its NSS database check. It then checks the database again on each start. Added in 2.. | On or off, off by default. An nss option from the caller wins over it | Cloud remote sessions, agent proxy browser trust |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Turns off the receive gate of the agent proxy relay. | On or off. Claude Code removes it from the env after reading | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Selects the relay mode of the agent proxy. agent_ starts a standalone relay and selective relays only listed hosts. | Text. Standalone mode needs CLAUDE_ to be byoc. Claude Code removes it from the env after reading | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate Caution: It deletes data, skips a safety check, or sends data off your machine. In 2.1.312 the program only clears this variable from the environment of child processes. It no longer reads it. The program reads SELF_HOSTED_RUNNER_AGENT_PROXY_URL, or the --agent-proxy-url flag, instead. | Gave the URL of the standalone agent proxy relay in a bring-your-own-cloud session. | Text. Used in 2.1.306 when the relay mode is agent_. An invalid URL stopped startup | Cloud byoc sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Gives the file descriptor number that holds the relay token for a tool container daemon. | A number. Digits only, number 3 or more. Claude Code reads it once and then removes it from the env | Cloud tool containers |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Turns off the upload gate of the agent proxy relay. | On or off. Claude Code removes it from the env after reading | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Carries auto mode allow rules from the host to a self-hosted runner. The runner removes it from the session env. | Read from session environment_ only when CCR_ is 1. Entries with line breaks or blanks are refused | Self-hosted runner (cloud byoc) |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Switches on the host-sent auto mode rules for a self-hosted runner. The runner removes it from the session env. | Active only when the session environment_ value is exactly 1. Set to undefined for the child | Self-hosted runner (cloud byoc) |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Carries auto mode environment entries from the host to a self-hosted runner. The runner removes it from the session env. | Read from session environment_ only when CCR_ is 1. Set to undefined for the child | Self-hosted runner (cloud byoc) |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Carries auto mode soft_ rules from the host to a self-hosted runner. The runner removes it from the session env. | Read from session environment_ only when CCR_ is 1. Set to undefined for the child | Self-hosted runner (cloud byoc) |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. | Lets the disk and memory watchdog send its telemetry events in a byoc session. It also lets the watchdog run when CLAUDE_ is not set. Added in 2.. | On or off, off by default. A byoc session (CLAUDE_) sends the events only with it. The watchdog does not run when CLAUDECODE is set | Cloud byoc sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Turns on a delta reset path in the CCR git fetch step and adds a delta_ field to startup timing data. | On or off. Truthy check on the env value. The fetch step then checks HEAD is a valid commit before it fetches | Cloud remote and self-hosted runner sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Lets claude -- seed a cloud session from an uploaded local git bundle instead of a remote clone. | On or off. Not used for byoc environments | Local CLI, cloud session start |
CCR_ | Documented: An official docs page names this item. | Forces claude -- to bundle and upload the local repository instead of cloning from its remote. | On or off. Docs name only 1. Skipped for byoc environments and agent sessions | Local CLI, cloud session start |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets how the guard acts when an -- cloud start targets the default branch. The guard has three modes. | One of a fixed set of values. Enum enforce, observe, off. Unset gives enforce, or observe when a feature flag is on | Local CLI, cloud session start |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Carries the network prefetch result of a CCR runner. Claude Code only reports it as prefetch_ in startup timing data. | Text | Cloud remote and self-hosted runner sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Carries the prewarm stat result of a CCR runner. Claude Code only reports it as prewarm_ in startup timing data. | Text | Cloud remote and self-hosted runner sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Carries the prewarm VDA result of a CCR runner. Claude Code only reports it as prewarm_ in startup timing data. | Text | Cloud remote and self-hosted runner sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. | Gives a git hook the email of the session account. The commit message hook that -- installs adds a Co- line to the commit message. The name is the part before the @. | Text. A value with <, >, a line break, or a character outside printable ASCII is dropped, and no line is added | Self-hosted runner. The runner sets it for the session |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Marks a CCR session profile. It turns off default inline tools and prompt cache keepalive, and enables the session ingress check. | On or off. The ingress check also needs SESSION_ and a session id that starts with cse_ | Cloud remote sessions |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Makes the self-hosted runner open a server-sent events stream for work hints, so it wakes sooner. | On or off. Logs CCR_ when on | Self-hosted runner |
CCR_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names a start marks key that the self-hosted runner blanks in the session env. It is also tied to prewarm marker files in /. | Set to undefined in the child env | Self-hosted runner |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Holds the host app grant for local MCP servers. Artifact publish uses it to check the MCP manifest of a page. | raw, parsed by a grant reader. The app that starts the session sets it | Artifact publish in a host-launched session. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Tells a reattached bridge session to skip the history backfill. | On or off. Claude Code sets it to 1 on a reattach spawn. The new process reads it once and deletes it | Remote Control bridge reattach. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Makes a reattached bridge session send only outbound (mirror mode). Without it the reattach is a full bridge. | On or off. Claude Code sets 1 unless the caller passes false. It feeds the bridge enable logic | Remote Control bridge reattach. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Passes the owner account UUID to a reattached bridge session. | Text. Claude Code sets it on a reattach spawn. The new process reads it once and deletes it | Remote Control bridge reattach. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Passes the owner organization UUID to a reattached bridge session. | Text. Claude Code sets it on a reattach spawn. The new process reads it once and deletes it | Remote Control bridge reattach. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Passes the last sequence number to a reattached bridge session. | A number. Whole number. Claude Code sets it only when the number is above 0 | Remote Control bridge reattach. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the bridge session id that a relaunched process must reattach to. | Text. Claude Code sets it on a reattach spawn. The new process reads it once and deletes it | Remote Control bridge reattach. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Names the paired browser extension device for the Chrome bridge. | Text. Must match a device id pattern. Else Claude Code logs a warning and ignores it | Claude in Chrome bridge. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets the browser tab group key for Claude Code browser calls. | Text. Honored only with CLAUDE_. Claude Code then unsets it | Claude in Chrome in remote sessions. Not set from project env before trust |
CLAUDE_ | Documented: An official docs page names this item. | Names a marker file that tells Claude Code you are at the computer. While it exists, Claude Code skips Remote Control mobile pushes. | Text. The code checks with a file stat on each presence check | Remote Control. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Turns on an attachments-in-user-data step in cloud sessions. The step stops when data retention rules apply. | On or off. Needs CLAUDE_ and a cloud session | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks a Remote Control child session as allowed to use artifacts. Claude Code sets it for the child. | On or off. Claude Code sets 1 in the child env. It first clears the inherited value | Remote Control child sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Makes auto mode the default mode of a Remote Control child session. Claude Code sets it for the child. | On or off. Claude Code sets it to 1 in the child env. It also ignores default auto if disable is set | Remote Control child sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks a Remote Control child session that uses machine settings. Claude Code sets it for the child. | On or off. Claude Code sets it to 1 in the child env | Remote Control child sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks a Remote Control child that carries the bridge MCP config. Claude Code sets it. | One of a fixed set of values. Enum 1 or spent. 1 means a child | Remote Control sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Carries the owner account UUID into a Remote Control child session. Claude Code sets it. | Text. The child reads it as the bridge owner identity | Remote Control child sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Carries the owner organization UUID into a Remote Control child session. Claude Code sets it. | Text. Used with CLAUDE_ | Remote Control child sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Holds the SHA-256 of the appended system prompt that the bridge passes to a carrier child. The child checks the prompt file against it. | Text. Claude Code sets it. The child removes it after the first read | Remote Control carrier children |
CLAUDE_ | Documented: An official docs page names this item. | Holds the session_ ID of the active Remote Control connection. Claude Code sets it. | Text. Set while connected and deleted when the connection ends. Claude Code removes it from some child envs | Remote Control, Bash and hook subprocesses |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Carries the source directory into a Remote Control child session. Claude Code sets it from the spawn option source. The program has no code that reads it back. The program only passes it to the child and names it in two env lists. | Text. Set from the spawn option source | Remote Control child sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Picks the env_ attachment mode for the file delivery tool. | On or off. It ranks after CLAUDE_ and the REPL bridge, and before the cloud and BYOC modes | Brief mode attachments |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Starts the hydrate prefetch early for a resumed remote session. | On or off. Needs an SDK URL and a resume option | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Starts the remote connection early for a resumed remote session. | On or off. Needs an SDK URL and a resume option | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. A feature flag can also turn it on | Gives the event reader of the cloud session worker its own connection pool. | On or off, off by default. Since 2. | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Opens the cloud session event stream over a worker socket. | On or off. Needs a cloud session where Claude Code owns the process | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Loads another module for the Claude in Chrome MCP server and socket client. In an Anthropic-hosted cloud session it also skips the install of the Chrome native host. Added in 2.. | On or off, off by default. The skip applies when CLAUDE_ is true and CLAUDE_ is unset | Claude in Chrome |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | When set, the Chrome MCP check reports a denial by the parent organization policy. | On or off. Claude Code deletes it when it builds some child envs | Chrome integration |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Holds the cloud session ID for shell commands that Claude Code runs. Claude Code sets it. | Text. Claude Code adds it to the extra env of spawned shell commands | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Reports the container id in session metadata as claude. Its presence also marks a remote or container session. | Text. No default. Set by the container host | Remote and container sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the desktop app version to Claude Code. Claude Code reads it only for the desktop entrypoints. | Text. Used when CLAUDE_ is claude- or local-. Else ignored | Desktop app |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Names the folder where the runner keeps the checked copy of the repository git settings, which the workspace diff uses. Claude Code creates the folder. | An absolute path. A value that is not absolute gives an error that says the variable must reach Claude Code unchanged from the runner | Set by the runner |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks turn handoff as disabled in the admission check for SDK and remote sessions. | On or off, off by default | SDK and remote sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Lets claude ultrareview start in a folder you have not trusted when it cannot ask, such as in a script or CI job. | On or off, off by default. Since 2.. -- trusts the folder for one run instead | claude ultrareview. See Subcommands |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Stops the synced working-file syncer in remote sessions and blocks the self-hosted admitted state. | On or off, off by default | Remote sessions with CLAUDE_ and an SDK URL |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Stops the working-file syncer from using the file system watch (fs.) on Linux. Added in 2.. | On or off, off by default. Read only on Linux | Remote sessions with the working-file syncer |
CLAUDE_ | Documented: An official docs page names this item. | Starts the session with Chrome integration on or off, ahead of claude. | On, off, or unset. -- and -- win. Remote and Cowork sessions also need this var or the flag | All sessions. Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. A feature flag or server gate decides by default. This variable overrides it | Forces the remote session recap on or off. | On, off, or unset, off by default. Unset uses a feature flag, default off | Remote sessions that report metadata |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Names the remote runner kind. bridge and byoc change session and bridge behavior. | Text | Remote and bridge sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sends the runner version in the x- header on worker requests. | Text. Skipped when empty | Remote runner sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Forces the remote control nudge after a long turn. Uses a 5 s threshold, probability 1, and no impression limit. | On or off. Second env accessor, truthy check. Else a feature flag | Interactive |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Allows cloud peer access for cross-session messaging. | On or off, off by default. Else a feature flag. Needs first-party auth and allow_ | First-party sessions with an org |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets report for the remote session worker. It takes effect only when CLAUDE_ is also on. | On or off. Both values must be true | Remote session worker |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Makes Claude Code ignore saved workspace trust records. | 1 turns it on. Off by default. Since 2. | Self-hosted runner. The runner sets it when it starts with --. Settings env cannot set it |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks the session as Cowork. It allows synced skills and treats the session like a remote one for state and cache checks. | On or off. Checked next to CLAUDE_ and the remote_ entrypoint | Cowork |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Makes a cloud session upload the working tree the previous way, as a git bundle. | On or off. Claude Code ignores it when a settings file sets it or when settings move HOME or CLAUDE_ | Cloud sessions (git bundle upload) |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Feeds the answer value of the parked-permission resume options. No visible effect in a print-mode probe (Probes). | A number of milliseconds, 2000 by default. Whole number of 0 or more. Read next to CLAUDE_ | All sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Feeds the runs field of the parked-permission resume options. No visible effect in a print-mode probe (Probes). | On or off | All sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Feeds the parked field of the parked-permission resume options. No visible effect in a print-mode probe (Probes). | On or off | All sessions |
CLAUDE_ | Documented: An official docs page names this item. | Marks a cloud session. When it is true Claude Code raises the Node heap limit to 8192 MB. | On or off. Set automatically in cloud sessions. Many code paths test it | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Names the kind of remote environment. The value self_ with CLAUDE_ marks a self-hosted runner. | Text. Also copied into telemetry as remote | Cloud and runner sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Reports a hermetic mode flag. It is true only when CLAUDE_ is also set. No visible effect in a print-mode probe (Probes). | On or off | Cloud sessions |
CLAUDE_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names a file with the MCP servers that a runner delivered. Claude Code loads it as a dynamic scope config. | Text. Read only when CLAUDE_ is true and CLAUDE_ is byoc | Self-hosted runner sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the SDK URL of a remote session. Claude Code uses it when no other URL is set and the URL is valid. | Text. Claude Code also sets it from a stored URL in bridge or byoc mode | Bridge and byoc sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sends session keepalive callbacks during heartbeat and long hook runs. Hook keepalive also needs a feature flag. | On or off | Cloud sessions |
CLAUDE_ | Documented: An official docs page names this item. | Holds the ID of the current cloud session. | Text. Claude Code sets it in cloud sessions, and a self-hosted runner sets it too. Telemetry and the session ID parser read it | Cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | The value review marks a review-origin session. Such sessions skip some token disk writes. | Text. Compared to review | Cloud sessions |
CLAUDE_ | Documented: An official docs page names this item. | Holds the UUID form of the remote session ID. A self-hosted runner puts it in the env of the session it starts. | Set by a runner, from the session ID | Self-hosted runner sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Names a file that replaces the remote settings fetch. The log says skipping API fetch. | Text. Read directly | All sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Turns on the remote tools forward mode. When it is on, tool schemas get an optional machine field that names an attached machine to run the call on. When it is off, a call that names a machine fails with "Running tool calls on an attached machine is not enabled in this session". Project settings env cannot set it. | On or off. True only for true. Telemetry also notes whether it is present | Sessions that serve tools to cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | A host passes a grant for unattended runs. Claude Code stores it with set and then removes the var. | Text. Read once at startup and removed from the env | Host apps |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Lets a session that serves tools to a cloud session end itself after it runs nothing here for this many minutes. Work in progress, live tool calls, and background work keep it open. Added in 2.. | A number of minutes. Whole number from 1 to 10080, digits only. Read only in a control-only tools session. A host that starts a child session does not pass the value on. The child gets a value from a feature flag, default 60 | Host apps, sessions that serve tools to cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. A feature flag or server gate decides by default. This variable overrides it | Overrides a feature flag. No visible effect in a print-mode probe (Probes). | Off by default. Read from the env object | Sessions that serve tools to cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Pins remote tool serving to the stored claude.ai login. It stops with an error if the endpoint is not Anthropic's own service. | On or off. True only for true. A token from the env does not satisfy it | Sessions that serve tools to cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Picks the policy of the tools that the session serves to cloud sessions. parity builds the served tools with background shells when they are available. interim builds a separate tool set. The mode is reported in the served tools facts. | Unset or parity gives parity. Any other value gives interim | Sessions that serve tools to cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Turns off serving local tools to cloud sessions when false. A bundle message says it turns the feature off. | Unset gives on. A true value gives on | Interactive sessions with a cloud link |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | A false value turns off the session channel of the remote tools module. Tools are then served over the device bridge only (transport bridge and not auto), and the served tools facts report bridge_. | On or off. Compared to the boolean false only | Sessions that serve tools to cloud sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Maps repo names to local checkout paths for multi-repo sessions. File attribution uses the paths. | Text. A bad value logs Failed to parse env map. Pairs with CLAUDE_ | Sessions with several repos |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. A server kill switch can turn it off | On resume, shows Claude the tool calls that an interruption cut off, so Claude knows their outcome is unknown. | true turns it on. Since 2.. A self-hosted runner sets it for a session that moved to a new runner, unless the value is false | Resumed sessions, self-hosted runner |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks a session that started from a claude.ai chat. Only the value claude_ is valid. | One of a fixed set of values. Enum with one value claude_. Used in an origin check, in account context, and in the permission classifier input | Claude.ai chat sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names a GrowthBook feature whose string value replaces the system prompt on each turn. An empty value keeps the normal prompt. | Text. Read only when CLAUDE_ is set. The feature name goes to a flag lookup | Remote sessions |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets the tee option of the remote I/O transport. The effect of that option is not shown here. | On or off. Claude Code sets it to 1 for self-hosted runner children | Remote I/O and self-hosted runner |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Marks a child as a CCR v2 session. | On or off. Claude Code sets it to 1 in the environment of self-hosted runner children | Self-hosted runner |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets a low free disk level in GiB. The program reads it as disk and forwards it to the remote env. | A number, 0 by default | Any session that is not a child session. A watchdog checks every 60 seconds and shows Claude the notice "Low disk space: ... is free on the filesystem holding the working directory." Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets a low free memory level in GiB. The program reads it as memory and forwards it to the remote env. | A number, 0 by default | Any session that is not a child session. A watchdog checks every 60 seconds and shows Claude the notice "Low memory: ... is available to this session." Not set from project env before trust |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sends Web through the CCR proxy when a CCR session is available. | On or off. Works only with the first-party provider | Cloud sessions, first-party |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sends Web through the CCR proxy when a CCR session is available. | On or off. Works only with the first-party provider | Cloud sessions, first-party |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Counts worker restarts. A value above 1 marks a restored worker, so tools are not announced again. | A number, 1 by default. Integer, default 1. Also passed in the init data when the remote check is true | Remote workers |
CLAUDE_ | Documented: An official docs page names this item. | Sets the prefix of auto-generated Remote Control session names. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Overrides the URL of the device bridge for remote tools. | A URL | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Passes JSON arguments to the workflow script of a remote session. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Holds the workflow script that a remote session runs through a fixed command. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the account email of the work order. | Text. Taken from the account_ claim of the work order | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the account ID of the work order. | Text. Taken from the account_ claim of the work order | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Names an extra file descriptor that the remote IO layer writes to. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets how often a runner child that started a turn before it finished starting up writes an alive_ line to the activity channel. | A number of milliseconds. Since 2.. Set by the self-hosted runner for its child | Self-hosted runner |
CLAUDE_ | Documented: An official docs page names this item. | Gives runner hooks the API base URL. The code-sign helper uses it as a last fallback. | A URL | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the attempt number of the work order. | A number as text. Taken from the attempt claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives a checkout hook the path where the repository is to be checked out. | A path | Self-hosted runner checkout hook |
CLAUDE_ | Documented: An official docs page names this item. | Tells hooks and the child session which client platform started the runner session. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the correlation ID of the work order. | Text. Taken from the correlation_ claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the post-session hook the path of the debug log of the session. The help text of the runner says to copy the log from the hook if you need it locally. | A path | Self-hosted runner post-session hook |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Stops the runner from reporting awaiting- when the child waits at a prompt after a turn ends. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Stops the runner from treating a turn that starts before the child finishes starting up as activity. -- then keeps counting from the start. | On or off, off by default. Since 2. | Self-hosted runner |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the post-session hook the reason that the session ended. | Text | Self-hosted runner post-session hook |
CLAUDE_ | Documented: An official docs page names this item. | Sets the -- of the runner git fetch. | - | - |
CLAUDE_ | Documented: An official docs page names this item. | Sets a cap in ms for the server-progress wait of the runner git fetch. | A number of milliseconds | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives a checkout hook the address of the Anthropic-managed git mount of the session. It is not set for a session without one. | A URL | Self-hosted runner checkout hook |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the ID of the work order. | Text. Taken from the jti claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the server time of the work order. | Text. Taken from the server_ claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the pool ID of the work order. | Text. Taken from the pool_ claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the revision of the primary repository of the work order. | Text. Taken from the primary_ claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the URL of the primary repository of the work order. | Text. Taken from the primary_ claim | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives a checkout hook the ref to check out. | Text. An empty string when there is no ref | Self-hosted runner checkout hook |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the repository sources of the work order. | Text. An empty string when the work order has no sources | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives a checkout hook the URL of the repository to check out. | Text | Self-hosted runner checkout hook |
CLAUDE_ | Documented: An official docs page names this item. | Gives lifecycle hooks the session ID. The code-sign helper reads it when CLAUDE_ is unset. | Text | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives hooks the session ID in a second form, next to CLAUDE_. | Text | Self-hosted runner hooks |
CLAUDE_ | Documented: An official docs page names this item. | Skips the check for a . directory after the checkout hook ends. For non-git source control. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Tells the runner to trust the prewarmed canonical checkout and skip its validation. | - | - |
CLAUDE_ | Documented: An official docs page names this item. | Turns on the Anthropic git proxy for the self-hosted runner. | - | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the spawn-runner hook the path of the file that holds the work order. | A path | Self-hosted runner, orchestrator mode |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Gives the post-session hook the workspace paths of the session. | Text. Paths joined with : | Self-hosted runner post-session hook |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | A text variable that the program declares. With CLAUDE_ it can skip an optional prompt section. A Probes run saw no effect. | Text | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | A presence check in system prompt assembly. With CLAUDE_ it can skip an optional prompt section. A Probes run saw no effect. | A path | - |
CLAUDE_ | Undocumented: Only the program shows this item. It can change without notice. | Sets the root directory for staged upload files in remote sessions. | - | - |
LOCAL_ | Undocumented: Only the program shows this item. It can change without notice. | Points the bridge URL to ws://, like USE_. | - | - |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the agent proxy for the runners that the spawn-runner hook starts. The hook must pass it on to each runner. | Text. An https:// URL. The -- flag wins over the variable when both are set | claude self- only |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the base directory for repository checkouts and per-session state. | Text. Flag --. Default is a POSIX container path | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Limits how long a background task that just finished still counts as in flight, until the follow-up turn that reads its result starts. | A number of milliseconds. 0 or an unusable value gives the built-in default, so the hold cannot be turned off | claude self- only |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets how long a checkout hook may run. At the limit the runner stops the hook, and the setup of the session fails. | Milliseconds. Flag -- (minutes). Default 30 minutes. 0 turns the limit off. Maximum 10080 minutes. Since 2. | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the label sent at registration and shown beside the runner in the console. | Text, the by default. Trimmed string, default the hostname. Flag -- | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Writes a global git identity (Claude <noreply@anthropic.) and commit signing at runner start. | On or off. Flag -- | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the guard mode for settings committed in the repo. | Text. An invalid value fails at startup. Flag -- | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Writes each work-order JWT, decoded JSON and hook stderr to files in this directory. | Text. Dev only, files are pruned after 5 min. Flag -- | Self-hosted runner orchestrator |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Writes live tokens to disk for debugging. | Text. Debug only, not for production. Flag -- | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | On the first SIGTERM, stops new work and waits up to this long before draining. | A number of milliseconds, 0 by default. The flag -- sets it | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Lets the web Changes pane show a repository cloned in a subfolder when the session started with no repository. | On or off. Flag --. One repository only, and only while the tool sandbox is off. Since 2. | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Keeps the runner warm and polling this long after sessions end. | A number of milliseconds, 0 by default. Max 604800 s. The flag -- sets it | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names a file whose presence at drain time reports the exit as a host drain. | Text, unset by default. Telemetry only. The first line may hold a Unix time | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Old name of SELF_. The runner reads it only when the new variable is unset or empty. | A number of milliseconds. Zero, a negative number, or text gives 0. The maximum is 2147483647 | claude self- only. The flag -- is a deprecated alias of -- |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | On SIGTERM, waits up to this long for running turns and background tasks before stopping the session. | A number of milliseconds, 0 by default. Max 86400 s. The flag -- sets it | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Gives the environment secret that the runner uses to authenticate. | Text. Trimmed string. The flag -- wins | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the binary that the runner spawns for child sessions. | Text. Default is the runner's own binary. Flag -- | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the port of the / HTTP listener. | A number, 8080 by default. Integer from 0 to 65535, default 8080. 0 disables it | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names a file that keeps an idle session from being released while the file is a regular file changed in the last 180 seconds. Your host keeps it fresh while a process that the session left running (for example nohup or tmux) lives. The -- flag sets it. Added in 2.. | A path, off when unset or blank. The runner looks again every 30 seconds. A path that leads to a network location is refused. The hold does not apply at startup, at --, at the -- ceiling, or at -- | claude self- only |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names the directory of lifecycle hook scripts (checkout, command, post-session). | Text. Missing hooks use built-in behavior. Flag -- | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names the host config directory that seeds each session's config dir. | Text. Falls back to CLAUDE_, then ~/.. An empty dir turns it off | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Chooses where the startup snapshot of the host config is kept. | Text. Another value throws | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Exits the runner if it gets no work for this long. | A number of milliseconds, never by default. Max 10080 min. The flag -- sets it | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Locks the runner to one account id at registration. | Text. Flag --. Only that account's sessions are assigned | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Copies runner logs to a file in append mode. | Text. Flag --. Stdout is unchanged | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | With SELF_, releases the session anyway after it has been idle this long. The -- flag sets it in minutes. Added in 2.. | A number of ms, 86400000 (24 hours) by default. 0 turns the hold off, and so does a value that is not a usable ms duration. The flag takes 0 to 10080 minutes | claude self- only |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Overrides the hard cap after the max-lifetime deadline. A turn that still runs at the cap gets SIGTERM. | A number of milliseconds. The help text names a cap of 15 minutes past the deadline. 0 or an unusable value gives the built-in default | claude self- only. Works with SELF_ |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Caps the wall-clock life of each session child. | A number of milliseconds, never by default. Max 10080 min. The flag -- sets it | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate Deprecated: The program or the official docs call this deprecated. Alias of SELF_HOSTED_RUNNER_ENVIRONMENT_SECRET | Deprecated alias of SELF_. | Text. Used only if the new name is unset. Prints a deprecation warning | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the SIGTERM budget of the post-session hook. | A number of milliseconds. Positive number in ms. Flag -- sets it | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Limits how long a turn that just finished still counts as in flight, until the session process reports its end to the server. | A number of milliseconds. The help text says the default is normally about two seconds. 0 or an unusable value gives the built-in default | claude self- only |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | For an egress proxy that needs a Proxy- header. The command prints the full header value, and the runner runs it for each new connection to the proxy. | A shell command. Flag --. Setting it together with the file variable is an error. Needs HTTPS_ or HTTP_, and ALL_ alone does not count | claude self- only. The help text says the value is never logged |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Names a file that holds the Proxy- header value for an egress proxy. It is the file form of SELF_. | A path. Flag --. Setting it together with the command variable is an error. Needs HTTPS_ or HTTP_ | claude self- only |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Pushes outcome branches to origin when the runner ends a session itself. | On or off. Flag --. Adds 30 s to the shutdown budget | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Deletes per-session state under the base dir when a session ends. | On or off, off by default. Another value throws. Flag -- | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Retires the runner at a Unix time, in seconds. | A number, never by default. Integer in seconds, valid from 1e9 to 1e11. Else ignored (0) | Self-hosted runner |
SELF_ | Documented: An official docs page names this item. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Chooses which server auto-mode classifier lists a session may receive. | Text. Another value stops the runner. Flag -- | Self-hosted runner |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the SIGKILL grace of a runner session. The runner never uses less than the time of the post-session hook plus a margin. | A number of milliseconds. Default 30000. The maximum is 2147483647 | claude self- only |
SELF_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate Caution: It deletes data, skips a safety check, or sends data off your machine. Renamed. In 2.1.312 the runner stops at startup with a fatal error when this variable is set. | Old name of SELF_. The runner stops with an error that tells you to use the new name. | Do not set it | claude self- only |
SESSION_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the base URL of the session ingress for remote (CCR) sessions. It wins over ANTHROPIC_. | Text. Non-empty string. Reads as SESSION_ first, else ANTHROPIC_ | Remote sessions |
VITALS_ | Undocumented: Only the program shows this item. It can change without notice. Gated: Works only behind a flag or a server gate. Works only behind a feature flag or server gate | Sets the path of the guest vitals emitter binary for remote sessions. | Must be an absolute path. Else the log says vitals are disabled | Remote sessions |
How It Works
A host program starts Claude Code as a child process and passes variables to it. The child reads them to learn where it runs and how to reach the host. Check the Notes column. Claude Code itself sets some variables. Do not set them yourself.
Related Pages
- Environment Variables: how Claude Code reads variables and which value wins.
- SDK and Automation
- Undocumented Items: every item that only the program shows.
Source: the program (variable names found in the 2.1.312 binary) and the Environment Variables page of the official docs.