Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.308 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

modelUsage

setting never mined JSON

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.

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.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 150on this box, as of v2.1.309
Written about v2.1.223 first named in a changelog, 5 Aug 2026

In the changelogs

4

Releases whose published page names modelUsage.

  1. v2.1.277
    New SDK query() usage/cost fields get detailed docs

    SDK docs now spell out that query() usage and cost totals accumulate across turns and reset on /clear

    found in this entry's text

  2. v2.1.239
    Stream-JSON result schema spells out what a held-back result includes

    The stream-JSON schema now documents that a held-back result still carries cost and usage.

    found in this entry's text

  3. v2.1.223
    SDK 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, found in this entry's text

  4. v2.1.223
    SDK 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, found in this entry's text

First cited

1

The earliest release whose published evidence quoted modelUsage was v2.1.239, 21 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.

ReleaseDateThe span that was quoted
v2.1.23921 Aug 2026as do its total_cost_usd, duration_api_ms and modelUsage

Presence across releases

0

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.

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.

Feedback