Follow Discord
Sweep 25 Sep 2026 · 19:33Z Build v2.1.283 504 read Stable v2.1.274 Latest v2.1.283 Next v2.1.283 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.281 ·

env and permissions settings schemas are now built lazily

The env and permissions parts of the settings format are now only prepared the first time they are needed

Entry
JSON All of v2.1.281
EntryKind: in v2.1.281,
ChangesSection of the release
What

Claude Code checks your settings files against a description of what each setting may contain. That description is called a schema. The schemas for the env and permissions settings are now built only the first time something uses them, not up front. This is done by a new internal wrapper called ZodDeferredOptional.

The wrapper refuses any inner schema that already accepts a missing value on its own, such as one marked optional or given a default.

Why

For someone using Claude Code, this changes when work happens inside the program rather than what your settings mean. The env and permissions settings are written and read the same way as before.

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 doubtThe finding does not say whether this makes any difference a user could notice, such as faster start-up.

See this entry in the whole of v2.1.281 →

Feedback