Back to all guides

Team token usage

A team of roles uses more tokens than a single agent, because each role is a separate teammate with its own context and review loops add back-and-forth. Learn what the Light, Moderate, and Heavy intensity tiers mean, and the levers you can pull to spend less.

Why a team uses more tokens

Most tools point a single AI agent at your whole task. Castforge runs a small team instead, and a team uses more tokens than one agent. That is expected, and it is worth understanding so you can decide when the extra work is worth it.

There are two main reasons:

On Claude specifically, programmatic runs draw from your capped Agent SDK credit first, then from standard API rates once that credit is used. A team that does more work draws from that credit faster than a single agent would. This is the same billing context shown on the Claude card when you connect it.

The intensity indicator

When you set up a team, Castforge shows a relative intensity indicator: Token use: Light, Moderate, or Heavy, with an approximate range like "~2-3x a single agent for the same task".

A few things to keep in mind:

The indicator exists to set expectations honestly, so a bigger token bill is never a surprise. It does not change what your team does; it just tells you, before you start, that more roles means more work.

How to spend less

If you want the same outcome for fewer tokens, these are the levers, roughly in order of impact:

A good rule of thumb: start small, and add roles or turn on the review loop only when the task is big enough to earn them. You can change any of this at any time, both when creating a project and later in the project's Agents and roles settings.