Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.221 ·

Headless MCP startup wait reworked

Headless runs decide more carefully whether to wait for MCP servers before starting.

Under the hood No documentation found Internal Changes
JSON All of v2.1.221
Under the hoodTier: how much it should matter to you
2Useful: my rating, 1 to 5
0Signal: worth watching, 1 to 5
MCPArea: what it touches
Internal ChangesKind: in v2.1.221,
Internal ChangesSection of the release
What

The decision about whether headless startup waits for MCP servers moved into two dedicated helpers.

Details
  • one helper reports whether an explicit MCP config asks the run to wait, returning true if any configured server is not of type sdk
  • the other computes a deadlineMs and a localOnly flag
  • localOnly is set for SDK-URL sessions that are not CLAUDE_CODE_ENVIRONMENT_KIND === "bridge" and not in coordinator mode
Evidence

explicitMcpConfigRequestsWait

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Read from
Names in the bundleCLAUDE_CODE_ENVIRONMENT_KIND

See this entry in the whole of v2.1.221 →

Feedback