Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.287 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.288 ·

Remote sessions handle proxy certificates and the gh command per session

In remote sessions using the agent proxy, certificate checks accept swapped order and the gh stand-in now lives in each session's own folder

Use it now Notable Improvements
JSON All of v2.1.288
Use it nowTier: how much it should matter to you
3Useful: my rating, 1 to 5
3Signal: worth watching, 1 to 5
SessionsArea: what it touches
ImprovementsKind: in v2.1.288,
What probably matters to youSection of the release
What

Some remote sessions send their network traffic through an agent proxy (a go-between that sits in front of the internet). This only applies when CLAUDE_CODE_REMOTE and CCR_AGENT_PROXY_ENABLED are set. These sessions changed in several ways:

  • CCR_AGENT_PROXY_CA_WATCH_ENABLED is a new environment variable that Claude Code now reads.
  • Two sets of certificates (the files that prove a secure connection is trusted) now count as the same when they contain the same two certificates in the other order. Before, they had to match byte for byte.
  • Installing the proxy's certificate into the system's trusted list now reports whether it worked, and a retry is marked as incomplete.
  • The gh shim (a small stand-in for the GitHub command-line tool) now lives in its own folder for each session, under sessions/<id>/bin, instead of one shared folder. That folder is added to the command search path.
  • Setting up the shim now checks whether one was inherited from elsewhere, checks whether jq is available, and skips some relaying.
  • Claude's instructions now say that when the shim is not a stand-in, gh in Bash is the machine's own GitHub command-line tool.
Why

This affects how remote sessions decide which secure connections to trust and which gh command Claude actually runs. Keeping the shim per session stops one session's setup from affecting another's.

Read from
What the documentation says
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat `CCR_AGENT_PROXY_CA_WATCH_ENABLED` turns on is not shown.

See this entry in the whole of v2.1.288 →

Feedback