--session-tunnel
A Claude Code CLI flag, read out of the shipped bundle. It has been in the build since v2.1.295, including the newest one read.
In remote cloud sessions only, claude mcp serve can now listen over HTTP with --transport, --port and --session-tunnel
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.295.
In the changelogs
3Releases whose published page names --session-tunnel.
-
v2.1.295
claude mcp servegains an HTTP mode, limited to remote cloud sessionsIn remote cloud sessions only,
claude mcp servecan now listen over HTTP with--transport,--portand--session-tunnelfound in this entry's text
-
v2.1.295
mcp servegains a session tunnel mode and can return tool outputclaude mcp servehas a new--session-tunnelmode that connects through a relay, and can return tool output and relay permission asksfound in this entry's text, named in this entry
-
v2.1.295
Session tunnel startup reads sign-in and proxy tokens from a file descriptor
Started with
--session-tunnel, Claude Code can read its sign-in token and an agent proxy token from a launcher-supplied channelfound in this entry's text, named in this entry
First cited
3The earliest release whose published evidence quoted --session-tunnel was v2.1.295, 8 Oct 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
1One 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 CLI flag does. All CLI flags.