Source Intelligence

DisclaimerUnofficial, and not affiliated with Anthropic. Nearly all of this is read straight out of what ships: npm bundles, captured prompts, published docs. Anthropic's own notes go in verbatim, marked as theirs. The rest is my reading, and every entry carries the strings behind it. If one looks wrong, vote it down and say why.

All of v2.1.248 Home All releases olderv2.1.247 v2.1.250newer
Claude Code v2.1.248

Remote startup waits for its credentials file instead of failing fast

You'll notice
Useful2 Signal3
Sessions

Remote sessions now wait and retry for their credentials file instead of failing immediately.

What

A remote session that has to read its access token from a file now retries on a fixed backoff (250, 500, 500, 750, 1000 ms) and then waits a grace period for OAuth or API credentials to appear, rather than giving up immediately. It logs "[spare-claim] session ingress token file not readable yet" while waiting and reports attempts, whether it recovered, and total wait time.

Details
  • Only runs for remote invocations started with --sdk-url that have no inline session token: CLAUDE_CODE_REMOTE set, CLAUDE_CODE_SESSION_ACCESS_TOKEN and CLAUDE_CODE_WEBSOCKET_AUTH_FILE_DESCRIPTOR unset.
  • The file location can be overridden with CLAUDE_SESSION_INGRESS_TOKEN_FILE.
  • A separate re-read path logs "Session ingress token re-read from well-known file".
Evidence

cli_worker_lifecycle_claim_token_wait

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

See this entry in the whole of v2.1.248 →