All Guides
GuideAI DevelopmentNovember 17, 2026

Stop Claude Burning Tokens Searching Your Files

Take this guide with you.

Drop your email and we'll send the Stop Claude Burning Tokens Searching Your Files straight to your inbox.

No spam. Just the guide. Unsubscribe anytime.

Stop Claude Burning Tokens Searching Your Files

A field guide to tokenmiser, which builds a compact codebase index for Claude Code, re-indexes only changed files, installs the hooks and links the map from CLAUDE.md so sessions stop wasting tokens on blind file searches.

What's inside
  • One compact map of your whole codebase
  • Claude jumps to exact files and line ranges
  • Only changed files get re-indexed
  • One command installs hooks and links CLAUDE.md
  • Example: ~48k tokens down to ~8k

Stop Paying Claude to Search Your Folders

On big projects, a lot of Claude's tokens go to digging through folders looking for the right files. tokenmiser maps your whole project once, so Claude can jump straight to the exact code a task needs, and it only re-maps the files you change.


One Map Instead of Blind Searching

tokenmiser builds a compact index of your codebase. Claude reads that index once instead of opening files one by one, then goes straight to the exact file and line ranges it needs.

Only changed files are re-indexed, using a modification-time cache, so updates stay fast even on very large codebases.

In the guide's example, reading ten files blindly costs about 48k tokens; reading the map plus the exact lines costs about 8k.


One Command Sets It Up

Run this in your project:

npx tokenmiser --hooks

It scans and indexes the project, installs the Claude Code hooks, and adds a reference to your CLAUDE.md, so every session starts with the map instead of a blind search.


Set Expectations

Savings depend on your project and how you work. The project cites around 40%; some users report more.


What's in the Guide

Why blind file searching wastes tokens, how the map and change-only re-indexing work, the one-command setup, a before-and-after token comparison, and similar open-source alternatives.

The full field guide is in the PDF.


Get the Guide

Drop your email below and we'll send it straight to your inbox.

Don't leave without it.

Drop your email and get the Stop Claude Burning Tokens Searching Your Files in your inbox.

No spam. Just the guide. Unsubscribe anytime.

Build Something Real

If you can describe it, you can build it.