CLAUDE_CODE_REMOTE_SESSION_ID
A Claude Code environment variable, read out of the shipped bundle. It has been in the build since v2.1.138, including the newest one read.
Commands blocked in cloud sessions now tell you the exact local command to run instead.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.223.
In the changelogs
32Releases whose published page names CLAUDE_CODE_REMOTE_SESSION_ID.
-
v2.1.302
The exploring subagent can now use Haiku in remote sessions
A built-in exploring agent can now run on the smaller Haiku model in remote sessions, not just in the situations it could before
found in this entry's text
-
v2.1.301
New
CLAUDE_CODE_ATTACHMENTS_IN_USER_DATAsetting for remote session attachmentsRemote sessions can keep attachments in a user-data folder when
CLAUDE_CODE_ATTACHMENTS_IN_USER_DATAis set, unless data retention rules applyfound in this entry's text, named in this entry
-
v2.1.301
Cloud sessions check whether attachments could be stored with user data
Remote sessions with CLAUDE_CODE_ATTACHMENTS_IN_USER_DATA set now check at startup whether attachments could be kept with user data
found in this entry's text, named in this entry
-
v2.1.296
Claude Code can tell which kind of remote environment it runs in
Claude Code gains a check for which kind of remote environment it is in, plus addresses for an artifacts service
found in this entry's text
-
v2.1.293
Stricter checks on what remote sessions can save
Remote sessions now save data only when CLAUDE_CODE_REMOTE_SESSION_ID is set and the session came from an allowed remote entry point
found in this entry's text
-
v2.1.293
Remote session setup stops retrying two failures that cannot recover
Two remote session setup failures are now marked permanent so they are not retried, and a broken credential check is fixed
found in this entry's text
-
v2.1.292
New
CLAUDE_CODE_HOST_SKILL_CATALOGvariable limits which skills loadIn remote sessions,
CLAUDE_CODE_HOST_SKILL_CATALOGcan list the skills allowed to load, and invalid values are ignored with a warningfound in this entry's text, named in this entry
-
v2.1.292
Usage data now notes whether a session runs remotely or in a container
Claude Code now records yes or no for whether a remote session ID or container ID is set
found in this entry's text
-
v2.1.286
CLAUDE_CHROME_TAB_GROUP_KEYis used only in remote sessions and then clearedClaude Code now keeps
CLAUDE_CHROME_TAB_GROUP_KEYonly in remote sessions and removes it so programs it starts do not inherit itfound in this entry's text, named in this entry
-
v2.1.284
Session links on commits and pull requests are added in more cases
The Claude session link on commits and pull requests is now added whenever a session id is found, not only in remote mode
found in this entry's text, named in this entry
-
v2.1.283
Metrics from cloud sessions can be sent through the session's own connection
In remote sessions, usage metrics can now go to the session's own metrics address, signed with
CLAUDE_CODE_SESSION_ACCESS_TOKENfound in this entry's text
-
v2.1.283
Remote Control no longer lets hooks and plugins through its inbound guard
Remote Control's inbound guard now always excludes hooks and plugins, and remote tools depend on two environment variables
found in this entry's text
-
v2.1.280
code-sign now supports lifecycle-hook processes, not just spawned child sessions
Code-signing now also recognizes lifecycle-hook processes, not just spawned sessions
found in this entry's text
-
v2.1.277
New terminal-title-suppression gate for SDK-CLI entrypoint
Terminal title can now be suppressed for the SDK-CLI entrypoint, behind a new flag
found in this entry's text
-
v2.1.274
Stage-file (remote session upload/output) can be invoked without CLAUDE_CODE_REMOTE_SESSION_ID via a 'vouched' path
Remote-session file staging can now skip the session-ID requirement via a new 'vouched' path
named in this entry, found in this entry's text
-
v2.1.271
New 'turn handoff' mechanism for managed cloud worker sessions, with an env var kill switch
New 'turn handoff' lets a managed cloud worker session resume an in-flight turn across restarts, with an env-var kill switch
found in this entry's text, named in this entry
-
v2.1.260
Decoy "enable claude-in-chrome" tool, live only in a specific remote session profile
A decoy tool tells the model browser tools already exist, only active in a specific remote session profile.
found in this entry's text
-
v2.1.247
Remote tool forwarding now has its own admission check
Whether a session may forward tools to a remote worker is now decided by its own check up front.
found in this entry's text
-
v2.1.242
Cloud workflow launches survive a worker restart
A cloud workflow turn cut off by a worker restart now resumes instead of vanishing.
found in this entry's text
-
v2.1.239
Chrome tabs opened by a session are closed when it ends
Chrome tabs a session opened are closed when you leave it, unless they hold real content.
found in this entry's text
-
v2.1.239
Device hook forwarding worker added, off behind two flags and a kill switch
Cloud sessions could register hooks that run on your device, blocked by two off flags.
found in this entry's text
-
v2.1.238
CLAUDE_CODE_HOVER_RESTgives a local override for the new credential and settings storageYou can pin the new credential and settings storage backend yourself with one environment variable.
found in this entry's text
-
v2.1.238
Files changed during a turn are uploaded to the cloud session worker
Cloud sessions now upload files you changed during a turn back to the session worker.
found in this entry's text
-
v2.1.238
Turns in cloud sessions now wait for a pre-turn check, which cannot yet refuse
Headless and SDK turns now wait on a pre-turn check that currently always says go ahead.
found in this entry's text
-
v2.1.232
Worker processes no longer inherit resume state
Child worker processes no longer inherit your session id, resume prompt or auth handles.
found in this entry's text
-
v2.1.227
Remote worker sessions now sync the working directory both ways around every turn
Remote worker sessions now sync your working directory both ways around every turn.
named in this entry, found in this entry's text
-
v2.1.225
Child processes no longer inherit an IDE entrypoint identity
Commands you spawn no longer inherit an IDE entrypoint or remote session id from your editor session.
named in this entry, found in this entry's text
-
v2.1.223
Slash commands unavailable in a cloud session explain how to continue locally
Commands blocked in cloud sessions now tell you the exact local command to run instead.
found in this entry's text
-
v2.1.223
Teleport and remote-control commands explain themselves inside cloud sessions
Running teleport inside a cloud session now tells you the exact local command to run instead of just failing.
named in this entry, found in this entry's text
-
v2.1.223
Remote-settings env allowlist widened
Remote settings can now supply many more environment variables, including auth tokens and home directory paths.
found in this entry's text
-
v2.1.178
Agent Tool:
isolation: "remote"— Cloud-Hosted Subagentsfound in this entry's text
-
v2.0.52
Remote Session ID Tracking
found in this entry's text
First cited
1The earliest release whose published evidence quoted CLAUDE_CODE_REMOTE_SESSION_ID was v2.1.178, 15 Jun 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
1Build by build
149One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the environment variable does. All environment variables.