§01 · The Model

Model provider request

Also called API call · Model call · Request

A single API call: the harness ships the full context to the provider and gets one reply back. Most turns need several of them.

A model provider request is a single round trip to the model provider: the harness ships the entire context window (system prompt, conversation, tool definitions, every tool result so far) and gets back one response, which is either a message for you or a tool call. Because the model is stateless, nothing is kept on the provider side between requests; the full context is re-sent every time.

A single turn usually contains many of these. You ask for a fix; the harness makes one request; the model asks to read a file; the harness reads it and makes a second request with the file contents appended; the model asks to run tests; a third request. A turn with fifteen tool calls is sixteen requests, and each one re-reads everything that came before. That's why cost per turn climbs as a session grows, and why the prefix cache matters so much.

You'll rarely see requests directly, but you feel them: each is a pause while the model reads and thinks, and each is a line on the bill. Fewer, more useful tool calls beat many small ones. A well-targeted search that returns the right file in one go is cheaper than five reads that hunt for it.

In the tools
  • Claude Code/cost totals the requests made this session; the spinner with a changing verb is one request in flight.
  • Anthropic APIOne messages call is one request; tool use means you loop, sending results back in a new call.
In conversation

It only did three edits but the cost jumped by a dollar.

Count the requests, not the edits. Every tool call is another full round trip with the whole session attached.

Related terms
Learn it in the school
Words are the easy part

Course 01 puts every one of these terms to work: you install Claude Code, run the loop, and ship a real project — permission modes, compaction, hooks and all.

Start Course 01 →