Follow Discord
Sweep 03 Nov 2026 · 22:27Z Build v2.1.318 536 read Stable v2.1.311 Latest v2.1.318 Next v2.1.318 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.317 ·

Clearer errors when --await-initialize does not get the initialize request first

Programs using --await-initialize now get a distinct initialize_not_first refusal and a cause field saying what went wrong

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

What

--await-initialize is a startup option for programs that drive Claude Code through the SDK (the toolkit for building on Claude Code). With it, Claude Code expects an initialize control request as the first line of standard input, which is the text a program feeds into it. The errors for getting this wrong are now more specific:

  • initialize_not_first: a new startup refusal reason. It is used when the first line is not the initialize request. The schema text says to fix the host program or wrapper script rather than retry.
  • cause: "first_line": the error for a wrong first line now includes this field. It is also added when the first line is not valid JSON, next to the existing message.
  • cause: "plugins": the error for a malformed initialize.plugins value now includes this field.

Why

A program driving Claude Code can now tell these failures apart and show an error that points at the real problem. Retrying with the same broken setup will not help.

See this entry in the whole of v2.1.317 →

Feedback