Claude Code now shows a live heartbeat message while it waits out a rate-limit retry
What
- Claude Code recognizes a new kind of system message with subtype
api_retry. - While a request is waiting to retry after hitting a rate limit, new logic polls the pending retry on a timer and emits this synthetic
system/api_retrymessage, including the attempt number, max retries, retry delay in milliseconds, and the error type (rate_limit). - This is gated behind the
tengu_rustling_sunsetflag.
Why
This gives a visible heartbeat in the UI so that when Claude Code is silently waiting to retry a rate-limited request, you can see that it's actually working through the wait rather than appearing stuck.
tengu_rustling_sunset Not enough to sayNothing here resolved what this flag was doing on this version, so nothing here should be read as on or off.
This account: no value returned · anonymous baseline: no value returned · compiled default in v2.1.280: on
These values were read against a different version of Claude Code, so treat them as the nearest reading available instead of one taken on this release.
Read once, for one account on one subscription tier, against v2.1.280. It isn't a statement about your account. What a flag value here can and cannot tell you
Whether this heartbeat message is actually shown depends on the `tengu_rustling_sunset` gate, which has not been read for this account.
New in this build: tengu_rustling_sunset