CLAUDE_CODE_POLL_EVENTS
A Claude Code environment variable, read out of the shipped bundle. It has been in the build since v2.1.237, including the newest one read.
You can set CLAUDE_CODE_POLL_EVENTS in your shell, but settings files can no longer supply it.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.237.
In the changelogs
5Releases whose published page names CLAUDE_CODE_POLL_EVENTS.
-
v2.1.292
Poll events from a host are refused unless CLAUDE_CODE_POLL_EVENTS is set
Claude Code now rejects every poll event from its host unless the host set CLAUDE_CODE_POLL_EVENTS for that session
found in this entry's text, named in this entry
-
v2.1.275
CLAUDE_CODE_POLL_EVENTS gate simplified — extra guard conditions removed
CLAUDE_CODE_POLL_EVENTS alone can once again switch on poll-event delivery
found in this entry's text, named in this entry
-
v2.1.239
Poll-event mode now also needs the entry path to have wired ingress
Setting the poll-events variable alone no longer switches on poll delivery; the SDK entry path must wire it.
named in this entry, found in this entry's text
-
v2.1.237
Poll-events switch cannot be set from settings
You can set CLAUDE_CODE_POLL_EVENTS in your shell, but settings files can no longer supply it.
named in this entry, found in this entry's text
-
v2.1.237
Poll tool drains queued harness events and reports who sent them
Claude can pull in queued messages from other sessions, stamped with who sent them, but only behind an env var.
named in this entry, found in this entry's text
First cited
4The earliest release whose published evidence quoted CLAUDE_CODE_POLL_EVENTS was v2.1.237, 19 Aug 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
1Build by build
61One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the environment variable does. All environment variables.