Magazine

Saving Claude tokens: where your weekly limit really goes

In the middle of work, “limit reached” suddenly appears in the terminal, and the reflex is a bigger plan. We measured on one of our own production repos what the budget is actually spent on for a single codebase question. By far the biggest item is the search for the right files.

English edition of an article from our German magazine. Read the German original

Collage with an exhausted businessman, an almost empty hourglass, burning coins and a map on the Claude token budget

Empty by noon: if you burn your token budget on searching instead of thinking, a bigger plan will not help either. Image: Collective Brain (AI-generated)

Update from 2 November 2026: New is a section on the effort levels of the current models. In Claude Code, Opus 5.5, Sonnet 5.5 and Haiku 5.5 start on medium; in the API, Sonnet 5.5 runs on high if nothing is specified. The plans reflect the state after Max 20x was renamed Ultra: Max delivers five times Pro, Ultra ten times per week and, for verified accounts, no five-hour limit; more on this in Claude Ultra instead of Max 20x (in German). The /usage command also shows its breakdown in the Ultra plan.
Update from 17 August 2026: Anthropic has expanded the cost documentation for Claude Code considerably since this article appeared. Two points change the recommendation. First, with /usage there is now an official measuring tool that attributes usage to individual skills, subagents, plugins and MCP servers. Second, Anthropic now recommends an upper limit of around 200 lines for the CLAUDE.md and advises moving everything specialized into skills. The new section further down covers both. The bigger picture is on our Claude overview.

Be honest: if you use Claude Code seriously in your daily work, in the repo, in the documentation store, in the project folder, you know the moment. In the middle of work: limit reached. And the knee-jerk reaction is always the same: bigger plan, second account, wait for the reset.

The uncomfortable diagnosis: Your limit is probably big enough. It is just being burned for the wrong purpose.

Contents · 8 sections

What really happens with a single question

Ask a typical question about a codebase: “How does our change system work, and where is a change processed?”

What the model then does is rarely visible, because it happens in the background. But it can be measured. On one of our production repos (186 files, around 1.4 million words), a single question like this looked as follows:

  • Several grep rounds across the whole repo to find candidates
  • Five to eight complete files ended up in the context, including a 6,600-word server file of which three functions turned out to be relevant
  • Re-reading of passages already read, because earlier excerpts had dropped out of the context window

The five right files alone, the ideal case that never happens in practice because you have to search first, come to almost 13,000 words, over 17,000 tokens. The basis actually usable for the answer: under 2,000 tokens. Everything else is search effort, on every single question.

Extrapolate that to a working day with 30 or 40 codebase questions, and you know where your weekly limit went. For a sense of scale: Anthropic puts the cost across enterprise deployments at around 13 US dollars per developer per active day and 150 to 250 US dollars per developer per month. For 90 percent of users it stays below 30 US dollars per active day. How this plays out in the subscription model, we broke down in the overview of usage credits and billing (in German).

Why “buy more budget” is the wrong answer

In 2026 this is the same thinking trap as “buy more servers” was in 2010: if the process is wasteful, more capacity mainly scales the waste. A limit twice as large that is 90 percent taken up by searching doubles your search costs, not your results.

Anthropic states how much more a bigger plan delivers as a multiple of Pro (as of 2 November 2026): Max for 100 US dollars a month delivers five times as much per five hours and per week, Ultra for 200 US dollars ten times as much per week, without a five-hour limit for verified accounts. Fable is included in Max and Ultra, up to half of the weekly limit. That is a ceiling within the weekly limit, not additional volume. In the Team plan, a premium seat brings five times a standard seat. The share eaten up by searching stays the same with every one of these factors.

The real lever is a different question: What really needs to go into the context per request?

On Team and Enterprise plans, there is a detail that surprises many managers when the bill arrives: the seat allowance resets in a rolling five-hour window and a weekly window, and Claude Code, the Claude chat and Cowork share the same pot. A developer seat draws considerably more from it than a chat seat, because every round carries file contents, tool calls and multi-step reasoning.

The way of thinking: give the model a map instead of a flashlight

The breakthrough in our setup came from upfront work rather than better prompting or a bigger model: condensing the knowledge about the codebase once in advance, meaning structure, symbols, relationships, communities, and giving the model only the relevant section of this map per question, instead of sending it through the whole building with a flashlight.

Measured concretely, same question, same repo:

Raw approachMap approach
Context per question≥ 17,000 tokens (ideal case!)~2,000 tokens
Search roundsseveral grep cascades and re-readingone targeted query
Factor1× (reference)conservatively 9×, in reality much more

The conservative factor of 9 assumes that the raw approach hits the right files immediately. It never does. In real sessions, with misses, broad searches and re-reading, we measured up to 72× more answered questions per token budget. A limit that was empty by noon becomes one that lasts the week.

What Anthropic itself recommends

When this article appeared in July, the condensing was still our own detour. Since then the same way of thinking has made it into Anthropic’s own cost documentation, and in surprisingly literal terms. On the code intelligence plugins for typed languages, it says that a single jump to a definition replaces what would otherwise be a grep plus reading several candidate files. And as an example of a useful skill, the documentation names, of all things, a “codebase-overview” that describes the architecture, important directories and naming conventions, so that Claude does not have to work them out by reading several files.

Four more points from the same source can be used in everyday work right away:

  • Measuring is now official. On Pro, Max, Ultra, Team and Enterprise plans, the /usage command shows what share of usage falls on individual skills, subagents, plugins and MCP servers, and flags patterns such as long context or cache misses from a share of 10 percent. /context shows what is currently in the window.
  • MCP servers cost less context than before, because the tool schemas are loaded only when needed by default. Classic CLI tools such as gh or aws still remain more economical, because they bring no listing at all.
  • A hook can pre-filter output before the model sees it. Instead of reading a log file with 10,000 lines in full, the hook greps for ERROR and returns only the hits, which according to the documentation pushes the context down from tens of thousands of tokens to hundreds.
  • Agent teams use about seven times as much as a normal session in plan mode, because each teammate keeps its own context window. If you use them, keep the teams small and shut them down actively.

The subagent read 6,100 tokens of files. You got a 420-token result. That’s the context savings.

Anthropic, Claude Code documentation on the context window, accessed on 1 November 2026

Which effort level Claude uses by default

Besides the search, thinking drives usage. The effort level determines how thoroughly the model thinks an answer through, and Anthropic bills thinking tokens as output. According to the Help Center, you reach your limit faster with a higher level. Which level applies if you set nothing depends on the model and the surface (as of 2 November 2026):

ModelClaude CodeClaude API
Opus 5.5mediummedium
Sonnet 5.5mediumhigh
Haiku 5.5mediummedium
Fable 5.1highhigh

Older models with an effort control run on high in Claude Code, Opus 4.7 on xhigh. In the Claude apps, Sonnet 5.5 is also set to medium according to Anthropic. Which level a model uses there by default is marked “Default” in the effort menu next to the send button.

Thinking cannot be switched off for Opus 5.5, Sonnet 5.5, Haiku 5.5 and the Fable models in Claude Code, so your control is /effort. For small changes such as a rename, the documentation names low; for debugging existing code, high. Two details belong with this. If you change the level in the middle of a session, the cache is kept for Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1 with a subscription or an API key; with older models it starts over. And a level you saved earlier with /effort, before Claude Code stored the level per model, does not apply to Opus 5.5, Sonnet 5.5 and Haiku 5.5: they start on medium until you choose a level there yourself.

Three levers you can apply today

Even without our complete setup, three habits get you noticeably more out of your budget:

1. Keep a CLAUDE.md, but keep it short. Architecture, conventions, hard rules, a map of the directories: written once, it saves the model the most expensive first rounds of exploration in every session. Since the summer, Anthropic has recommended an upper limit of around 200 lines, because the file lands in the context in full at every session start, even for completely different work. Everything that applies only to individual workflows therefore belongs in a skill that loads only when called. What that looks like in practice is shown in our overview of Claude skills (in German). Our article on Claude Memory shows what belongs in the CLAUDE.md and where it lives (in German).

2. Targeted reads instead of exploring. Say where something is if you know it (“the function is in server/changes.mjs”) instead of letting the model search. Every search round you avoid saves a four-digit number of tokens. For recurring company knowledge, a well-kept project knowledge base (in German) pays off instead.

3. Subagents for broad searches. When the whole repo really has to be searched, delegate the search to a subagent that returns only the result, instead of tipping the dumps of search hits into your main context. The order of magnitude from Anthropic’s own example is in the quote above.

Then there is the cheapest habit of all: /clear between two unrelated tasks. Claude Code sends the complete conversation history with every request, so a session that has been open for hours drags the whole previous conversation along even for a one-line question. And if you pay through the API rather than a subscription, you will find the price side of this calculation in our calculation of Claude API costs (in German).

These are the basics. They might get you to a factor of 2.

The key points in two sentences: The most expensive item in your Claude budget is the search for the right files, not answering the question, and this is exactly the item you can push down with condensing, a short CLAUDE.md, skills and subagents. Check with /usage first where your usage actually goes before you buy a bigger plan.

The rest of the way is not on the blog

The complete setup, meaning which map we build, what we use to keep it current, how it plugs into Claude Code, and the full benchmark with methodology and raw numbers, does not go to everyone. We send it by email to subscribers of CB Brainwave, our newsletter on AI, marketing and web for mid-sized companies, which is written in German.

Sign up, confirm the link in your inbox (double opt-in, GDPR-compliant, unsubscribe at any time), and the article with the complete setup lands with you:

The complete token setup comes by email

Sign up, click the confirmation link, and you get the insider article with setup, benchmark and methodology.

Frequently asked questions

Why is my Claude limit used up so quickly?

Because with codebase and document questions, most of the tokens flow into the search rather than the answer: grep cascades, complete files in the context, repeated reading of the same content. The answer itself often costs only a fraction of that. In its own documentation, Anthropic names further drivers of long sessions: the conversation history sent along, cache misses after longer breaks and scheduled tasks that fire even when idle.

Does it help to simply buy a bigger Claude plan?

In the short term yes, structurally no. Max brings five times Pro, Ultra ten times per week, as of 2 November 2026. But if 90 percent of the budget flows into searching, more budget mainly scales the waste along with it. The lever lies in what goes into the context per question. Anthropic puts the cost across enterprise deployments at around 13 US dollars per developer per active day, and for 90 percent of users it stays below 30 US dollars. The plan and credit logic behind this is in our overview of usage credits (in German).

How do I measure what my tokens are spent on?

Since summer 2026 there has been an official built-in tool for this. On Pro, Max, Ultra, Team and Enterprise plans, the /usage command shows a breakdown that attributes usage to individual skills, subagents, plugins and MCP servers, each as a percentage, and flags behavior patterns such as long context or cache misses from a share of 10 percent. With /context you also see what is taking up space in the current window.

What does a CLAUDE.md file in the project do?

A well-kept CLAUDE.md gives the model orientation at the start of a session: architecture, conventions, hard rules. That saves the most expensive first rounds of exploration. Anthropic now explicitly recommends keeping it under around 200 lines and moving specialized work instructions into skills (in German), because the content of the CLAUDE.md sits in the context at every session start, even when you are working on something completely different.

How much does a subagent really save?

Anthropic works this out with an example in its own context window documentation: the subagent read 6,100 tokens of files and returned a result of 420 tokens. The remaining roughly 5,700 tokens stayed in its own context window and never touched the main window. Be careful with agent teams, though: according to Anthropic’s cost documentation, they use about seven times as much as a normal session in plan mode.

Does Claude Code count against the same limit as Claude in the browser?

Yes. According to Anthropic, Claude on the web, on the desktop, on mobile and Claude Code draw from the same allowance. On Team and Enterprise plans, each member draws from a seat allowance that resets in a rolling five-hour window and a weekly window, and Claude Code, the Claude chat and Cowork share this allowance. A week on a coding seat uses more than a week of chat, because every round carries file contents, tool calls and multi-step reasoning.

Which effort level does Claude use by default?

That depends on the model and the surface. In Claude Code, Opus 5.5, Sonnet 5.5 and Haiku 5.5 start on medium, Fable 5.1 and older models with an effort control on high, Opus 4.7 on xhigh. In the Claude API, Opus 5.5 and Haiku 5.5 are set to medium, Sonnet 5.5 and Fable 5.1 to high. In the Claude apps, Sonnet 5.5 uses medium according to Anthropic. Higher levels use more tokens; for routine work you lower the level in Claude Code with /effort. As of 2 November 2026.

Sources & references

  • Anthropic: Claude Code documentation “Manage costs effectively”, primary source for the daily cost per developer, the /usage breakdown, the 200-line recommendation for CLAUDE.md, the hook pre-filter, thinking tokens as output and the sevenfold usage of agent teams. Accessed on 1 November 2026. code.claude.com
  • Anthropic: Claude Code documentation on the context window, primary source for the subagent example with 6,100 tokens read and 420 tokens returned. Accessed on 1 November 2026. code.claude.com
  • Anthropic: Claude Code documentation on subagents, primary source for the separate context window of each subagent and the loading of the CLAUDE.md hierarchy. Accessed on 1 November 2026. code.claude.com
  • Anthropic: Claude Code documentation on model configuration, primary source for the default effort per model in Claude Code, the recommendations per level and Opus 5.5 starting on medium. Accessed on 1 November 2026. code.claude.com
  • Anthropic: Claude Code documentation on prompt caching, primary source for the fact that an effort change keeps the cache for Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1. Accessed on 1 November 2026. code.claude.com
  • Anthropic: platform documentation on effort, primary source for the default levels in the Claude API. Accessed on 1 November 2026. platform.claude.com
  • Anthropic: announcement of Claude Sonnet 5.5 on 28 September 2026, primary source for the default effort medium in Claude Code and the Claude apps and high on the Claude Platform. Accessed on 1 November 2026. anthropic.com
  • Claude Help Center: changing the model, effort and thinking settings, primary source for the “Default” marker in the effort menu and the faster use of the limit at a higher level. Accessed on 1 November 2026. support.claude.com
  • Anthropic: pricing page with the usage multiples of Max, Ultra and the Team seats and the shared allowance for web, desktop, mobile and Claude Code. Accessed on 1 November 2026. claude.com
  • Claude Help Center: the Ultra plan, formerly Max 20x, with ten times Pro usage per week and no five-hour limit for verified accounts. Accessed on 1 November 2026. support.claude.com
  • Claude Help Center: usage credits for Pro, Max and Ultra, primary source for the separate Fable ceiling within the weekly limit in Max and Ultra. Accessed on 1 November 2026. support.claude.com
  • Collective Brain: our own benchmark on a production repo with 186 files and around 1.4 million words, collected in July 2026. Methodology and raw numbers go to newsletter subscribers. collectivebrain.de
Arno Hoffrichter, CTO, Collective Brain GmbH · Hamburg

Arno Hoffrichter

CTO, Collective Brain GmbH · Hamburg

CTO at Collective Brain. Responsible for the technical delivery of web projects and the SEO architecture.