Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.268 ·

Insufficient-permission errors now classified as 'not_permitted'

Claude Code now recognizes 403 permission errors distinctly and stops retrying catalog fetches that fail this way

TierYou'll noticehow much it should matter to you
Useful1my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaErrorswhat it touches
KindBug Fixesin v2.1.268,
Group of 2 You'll notice

Claude Code now recognizes 403 permission errors distinctly and stops retrying catalog fetches that fail this way

What

  • When a server responds with a 403 error whose body contains the code oauth_scope_insufficient, Claude Code now classifies it specifically as not_permitted (with an errorCode of oauth_scope_insufficient) instead of treating it as a generic HTTP error.
  • When fetching the marketplace/plugin catalog fails for this not_permitted reason, Claude Code now records a servedCatalogNotPermitted flag and short-circuits to using the cached catalog only, instead of retrying the network fetch.
  • Error results throughout this path can now carry an optional errorCode field.

Why

Before this change, a permissions problem could look like a generic network failure and cause Claude Code to keep retrying a fetch that was never going to succeed. Recognizing the specific 'not permitted' case lets it fail fast and fall back to cached data instead.

See this entry in the whole of v2.1.268 →

Feedback