{"name":"usage","slug":"usage","family":"setting","title":"Settings keys","noun":"settings key","description":"SDK result fields now explain that usage covers only the main loop and costs are estimates.","description_source":"entry","described_by":{"version":"2.1.223","anchor":"sdk-result-schema-documents-what-usage-total-cost-usd-and-mo"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.280","anchor":"compaction-record-now-carries-explicit-usage-stats","heading":"Compaction record now carries explicit usage stats","line":"Compaction records now include detailed token usage stats, not just before\/after totals","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"token-usage-now-attached-to-conversation-messages-and-compac","heading":"Token usage now attached to conversation messages and compaction records","line":"Token usage data is now attached to conversation messages and compaction records","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"task-delegation-now-carries-usage-stats-forward","heading":"Task delegation now carries usage stats forward","line":"Sub-task handoff now carries forward token, tool-use, and duration stats","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.273","anchor":"session-usage-totals-now-take-the-max-of-two-token-counts","heading":"Session usage totals now take the max of two token counts","line":"Session usage totals now use whichever of two token counts is higher","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"compaction-request-now-stamps-usage-onto-turncomplete-when","heading":"Compaction request now stamps usage onto turn.complete when available","line":"The turn-complete event now includes a computed usage figure whenever one is available","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"},{"version":"2.1.267","anchor":"plugin-event-schema-gains-a-usage-field-on-turnstep-and-t","heading":"Plugin event schema gains a usage field on turn.step and turn.complete","line":"Plugin turn.step and turn.complete events now include token usage details","released_at":"2026-09-09 18:25:42","reason":"named in this entry, found in this entry's text"},{"version":"2.1.267","anchor":"turnstep-and-turncomplete-telemetry-events-now-include-usa","heading":"turn.step and turn.complete telemetry events now include usage data","line":"Two internal telemetry events now include usage data like token counts when available","released_at":"2026-09-09 18:25:42","reason":"found in this entry's text"},{"version":"2.1.260","anchor":"fixed-agent-empty-result-counting-for-workflow-agents","heading":"Fixed agent_empty_result counting for workflow agents","line":"Fixed a wrong empty-result count shown in the subagent usage summary.","released_at":"2026-09-03 22:32:02","reason":"found in this entry's text"},{"version":"2.1.259","anchor":"database-write-tool-results-now-report-usage","heading":"Database write tool results now report usage","line":"Artifact database write results now include a usage field, echoed into the confirmation text shown to the model.","released_at":"2026-09-02 21:21:42","reason":"found in this entry's text"},{"version":"2.1.223","anchor":"sdk-result-schema-documents-what-usage-total-cost-usd-and-mo","heading":"SDK result schema documents what usage, total_cost_usd and modelUsage actually cover","line":"SDK result fields now explain that usage covers only the main loop and costs are estimates.","released_at":"2026-08-05 22:51:13","reason":"found in this entry's text"}],"entries_total":10,"docs":[{"source":"api","path":"about-claude\/api-credits-for-subscribers","title":"api-credits-for-subscribers","documented":false},{"source":"api","path":"about-claude\/model-deprecations","title":"model-deprecations","documented":false},{"source":"api","path":"about-claude\/models\/choosing-a-model","title":"choosing-a-model","documented":false},{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false},{"source":"api","path":"about-claude\/pricing","title":"pricing","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/content-moderation","title":"content-moderation","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/ticket-routing","title":"ticket-routing","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/best-practices","title":"PDF Processing","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/claude-api-skill","title":"claude-api-skill","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/usage","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}