> ## Documentation Index
> Fetch the complete documentation index at: https://fireworks.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For Fireworks Nexus, start at https://docs.fireworks.ai/nexus.
> Use https://docs.fireworks.ai/nexus/quickstart for coding harnesses, custom agents, APIs, SDKs, and LLM gateways.
> Use https://docs.fireworks.ai/ecosystem/firerouter/overview for model router types, composition, and pricing.
> Prefer canonical short model IDs such as firerouter/opus. In LiteLLM, use the fireworks_ai/ provider prefix.
> Family names such as opus track the latest evaluated family version; do not describe them as fixed model versions.

# Usage and Cost

> Track estimated Claude Code session cost and model mix locally. Then view Fireworks model usage by model, user, or API key and Fireworks account cost by model.

Track estimated cost and model choices for one Claude Code session, then review Fireworks model usage and cost across your account.

| View                        | Best for                                                                              | Open it                                                      |
| --------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| **Claude Code status line** | Live estimated session cost, model mix, cache share                                   | Connect with `fireconnect claude`                            |
| **Session meter**           | Requests and estimated cost for one Claude Code session                               | `fireconnect claude usage`                                   |
| **Usage dashboard**         | Fireworks model usage by model, user, or API key                                      | [Account usage](https://app.fireworks.ai/account/usage)      |
| **User Limits**             | Current-period spend on supported Fireworks serverless models against each user's cap | [User Limits](https://app.fireworks.ai/settings/user-limits) |

## Track one Claude Code session

The status line shows which models served turns during the session. Each segment is sized by its share of estimated cost.

<Frame caption="Session cost, model mix, and cache share in Claude Code">
  <img src="https://mintcdn.com/fireworksai-docs/iVVGeuaohW3vcBl4/images/fireworks-nexus/session-cost/status-line.png?fit=max&auto=format&n=iVVGeuaohW3vcBl4&q=85&s=98c3361de6153b4876dbf302df109767" alt="Claude Code status line with a session cost bar split across several models" width="2000" height="192" data-path="images/fireworks-nexus/session-cost/status-line.png" />
</Frame>

Open the session meter for request-level detail:

```bash wrap theme={null}
fireconnect claude usage
```

The meter is local to the machine where Claude Code ran. Other harnesses route through Nexus but do not have this local meter yet. See [Session Cost](/docs/nexus/session-usage) for commands and token buckets.

## Break down Fireworks usage and cost

Use the [usage dashboard](https://app.fireworks.ai/account/usage) to break down Fireworks traffic by model, user, or API key over the selected date range. The **Cost** view groups Fireworks account spend by model:

<Frame caption="Account cost by model. Names and amounts are illustrative.">
  <img src="https://mintcdn.com/fireworksai-docs/iVVGeuaohW3vcBl4/images/fireworks-nexus/session-cost/account-cost.png?fit=max&auto=format&n=iVVGeuaohW3vcBl4&q=85&s=119e099c2121467fd9fe75de5f98ca61" alt="Usage dashboard Cost view split across several models" width="2000" height="1221" data-path="images/fireworks-nexus/session-cost/account-cost.png" />
</Frame>

<Note>
  The account dashboard covers Fireworks model usage and cost. It does not include usage billed by closed-model providers.
</Note>

## Know which number you are reading

* **Session meter:** a local estimate from token counts and published model rates.
* **Usage dashboard:** Fireworks model usage and cost for the selected range.
* **Billing page:** the source of truth for the Fireworks invoice.

To cap each user's spend on supported Fireworks serverless models, set [Spend Limits](/docs/nexus/usage-limits).
