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.287 ·

Clearer message when a settings file sets a protected environment variable

The refusal for a settings file that sets a protected environment variable now says whether to remove it or move it elsewhere

You'll notice Improvements
JSON All of v2.1.287
You'll noticeTier: how much it should matter to you
1Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
Cloud SessionsArea: what it touches
ImprovementsKind: in v2.1.287,
ImprovementsSection of the release
What

An environment variable is a named value set outside Claude Code, for example in your shell. Claude Code refuses to go ahead when a settings file it uploads for a cloud session sets one of a few protected variables. The message it shows has been reworded.

It used to tell you to remove the variable from that file, set it in your shell if you need it, and restart Claude Code. It now separates two cases:

  • If you did not put the variable there yourself, remove it.
  • If you did, move it to your shell, your user settings or your managed settings.
Why

The message now tells you what to do in each case, and offers user or managed settings as places to keep the variable, not only your shell.

See this entry in the whole of v2.1.287 →

Feedback