modelUsage
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.
What it is
SDK results now document exactly what token usage and dollar cost figures include, and that /clear resets them.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.223.
Presence across releases
The 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.
Changelog entries naming it
-
v2.1.223SDK result docs for modelUsage and totalCostUsd
SDK results now document exactly what token usage and dollar cost figures include, and that /clear resets them.
named in this entry
-
v2.1.223SDK result schema documents what usage, total_cost_usd and modelUsage actually cover
SDK result fields now explain that usage covers only the main loop and costs are estimates.
named in this entry
Documentation pages
- Events mentions it Claude Developer Platform
- List Events mentions it Claude Developer Platform
- Stream Events mentions it Claude Developer Platform
- Threads mentions it Claude Developer Platform
- Events mentions it Claude Developer Platform
- List Session Thread Events mentions it Claude Developer Platform
- Stream Session Thread Events mentions it Claude Developer Platform
- How the agent loop works mentions it Claude Code CLI
- Track cost and usage mentions it Claude Code CLI
- Agent SDK reference - Python mentions it Claude Code CLI
- Agent SDK reference - TypeScript mentions it Claude Code CLI
- Model configuration mentions it Claude Code CLI
A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.
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.