turn.step
A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
Plugin hooks are limited in what they may rewrite, and cannot take over question prompts.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.242.
In the changelogs
11Releases whose published page names turn.step.
-
v2.1.299
Plugin hooks on turn start now count when Claude Code checks for turn hooks
A plugin hook listening for the start of a turn now counts as an active turn hook, alongside the step and complete hooks
found in this entry's text
-
v2.1.271
turn.step plugin hook events now carry an agentId
The turn.step hook event now includes an agentId field
found in this entry's text
-
v2.1.269
turn.step hooks can override or veto the model per request
New
turn.stephook lets plugins redirect which model handles a request, subject to a policy checkfound in this entry's text, named in this entry
-
v2.1.269
Streaming (async-generator) hook dispatch built end-to-end, but only 'turn.step' is enabled to use it
Claude Code builds streaming hook support end-to-end, but only enables it for the 'turn.step' event
found in this entry's text, named in this entry
-
v2.1.267
Plugin event schema gains a
usagefield on turn.step and turn.completePlugin turn.step and turn.complete events now include token usage details
found in this entry's text
-
v2.1.267
turn.step and turn.complete telemetry events now include usage data
Two internal telemetry events now include usage data like token counts when available
found in this entry's text
-
v2.1.265
Hook registry gains command.describe as a core hook event
Claude Code adds a new internal hook event called command.describe
found in this entry's text
-
v2.1.260
Turn-lifecycle event hooks added to session loop
The session loop now emits turn-start and turn-step lifecycle markers.
named in this entry, found in this entry's text
-
v2.1.242
Each hook event enforces what a plugin is allowed to change
Plugin hooks are limited in what they may rewrite, and cannot take over question prompts.
found in this entry's text
-
v2.1.242
Plugin modules with a
$API that can hook events and redraw the terminal UIPlugins can install code that intercepts tool calls and repaints parts of the terminal interface.
found in this entry's text
-
v2.1.242
Turns emit start and complete events, and a plugin can append to the final answer
Each turn now emits start and complete events a plugin module can hook and append text to.
found in this entry's text
First cited
2The earliest release whose published evidence quoted turn.step was v2.1.269, 11 Sep 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
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
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 settings key does. All settings keys.