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.
What it is
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.
Presence across releases
| Releases | Reading | Declared type | Default |
|---|---|---|---|
| 2.1.245 – 2.1.250 5 releases | never mined | — | — |
| 2.1.237 – 2.1.243 7 releases | in the build | bool | — |
A row reading never mined is a release with no archived bundle behind it. Nothing was read out of it, so nothing here says whether the name was in it. A declared type or a default is only ever what that release's own bundle stated.
Changelog entries naming it
-
v2.1.239Poll-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
-
v2.1.237Poll-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
-
v2.1.237Poll 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
Documentation pages
None of Anthropic's documentation pages this site has a copy of carries this name.
Names beside it
Every environment variable in the inventory starting claude_code, up to twelve of them.
CLAUDE_CODE_3P_PROBE_WROTE_OPUS_DEFAULTNo description from anybody. 2.1.207
CLAUDE_CODE_3P_PROBE_WROTE_SONNET_DEFAULTNo description from anybody. 2.1.207
CLAUDE_CODE_ACCESSIBILITYSet to 1 to keep the native terminal cursor visible and disable the inverted-text cursor indicator. Allows screen magnifiers like macOS Zoom to track cursor position 2.1.138
CLAUDE_CODE_ACCOUNT_TAGGED_IDNo description from anybody. 2.1.138
CLAUDE_CODE_ACCOUNT_UUIDThe device bridge is skipped entirely when the host's account UUID doesn't match the stored one. 2.1.138
CLAUDE_CODE_ACT_DONT_REDERIVEThree existing feature gates moved position; their defaults are unchanged. 2.1.162
CLAUDE_CODE_ACTIONNo description from anybody. 2.1.138
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MDSet to 1 to load memory files from directories specified with --add-dir. Loads CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md, and CLAUDE.local.md. By default, additional directories do not load memory files 2.1.138
CLAUDE_CODE_ADDITIONAL_PROTECTIONNo description from anybody. 2.1.138
CLAUDE_CODE_ADOPT_UNDERIVABLE_PARKED_PERMISSIONA resumed headless session could hand you back a permission prompt left unanswered, but three variables must be set. 2.1.238
CLAUDE_CODE_AGENTNo description from anybody. 2.1.138
CLAUDE_CODE_AGENT_COST_STEERNo description from anybody. 2.1.138
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.