§02 · Sessions, Context Windows & Turns

Turn

Your message and all the work the agent does before it hands control back to you.

A turn is the unit of back-and-forth in a session: you say something, the agent works until it has nothing more to do without you, and control comes back. From your side that is one exchange. Underneath, a single turn can contain many model provider requests, because after every tool call the harness feeds the result to the model and asks what comes next. A turn that reads eight files and runs the tests twice is a dozen round trips billed as one conversation step.

This is the mismatch behind surprising bills and slow responses. The cost of a turn is not the length of your message; it is how many tool calls the agent needs and how much context gets resent on each of them. Late in a long session every request carries the whole transcript, so the same simple turn costs several times what it cost at the start.

Shorter, more decisive turns tend to work better than sprawling ones. Give the agent a bounded task, let the turn run, review, then take the next turn with what you learned. If a turn is heading somewhere wrong, interrupt it (see steering) rather than letting it complete a plan you already know is off.

In the tools
  • Claude CodeA turn ends when the agent stops and the prompt returns; Escape interrupts a running turn.
  • AntigravityThe manager view shows each agent's turns as steps you can inspect and approve individually.
In conversation

That one turn took four minutes and cost more than my whole morning.

It made about thirty tool calls, and each one resends the context. Late-session turns are expensive; compact or start fresh.

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 →