Claude Code · /checkup
Claude Code Checkup
One command that tunes up your Claude Code setup. It finds wasted context, proposes trimming your CLAUDE.md files, and flags skills and MCP servers you never use, so every session starts cheaper and smarter. A couple of minutes per project.
Run it
Three steps. Nothing changes without your approval.
- Update Claude Code first.
The command shipped in version 2.1.205 on July 10, 2026, so grab the latest before anything else. Open Terminal and run:
claude update
If you don't have Claude Code yet, start with the Claude Code installer instead.
- Open a project and run the checkup.
In Terminal, go to a project you work in, start Claude, and type:
/checkup
It's the same thing as
/doctor, just a friendlier name. Either one works. - Review what it proposes, then say yes to what you want.
It walks through its findings one at a time. Everything is a suggestion until you approve it, and it explains each fix before applying it.
What it does
A full physical for your setup, in four parts.
- Trims your CLAUDE.md. Proposes cutting anything Claude can figure out from the code itself, keeping only the gotchas, the reasoning, and the conventions it couldn't guess. A leaner CLAUDE.md means fewer tokens spent before you've even asked a question.
- Audits your extensions. Finds skills, MCP servers, and plugins you have installed but never use, shows what each one costs in context, and offers to disable the dead weight.
- Checks the install itself. Duplicate or leftover installs, PATH problems, broken settings files, and slow hooks that drag every session down.
- Suggests permission tune-ups. Spots read-only commands you approve over and over and offers to pre-approve them, so you get fewer permission prompts.
Why you'd bother
Everything in your CLAUDE.md and every enabled extension gets loaded into Claude's context at the start of every session, whether you use it or not. That's the token bill and it also crowds out room for your actual work. Trimming it makes each session cheaper and gives Claude more headroom to be useful. That's the whole trick behind "more token efficient and smarter."
Links
- The 60-second video that made the rounds (James Goldbach on YouTube).
- Official what's-new notes for the release that introduced it.
- Claude Code changelog (see version 2.1.205).
Not to be confused with the Desktop Doctor
This page is about Claude Code, the Terminal tool. If your Claude desktop app is freezing or white-screening, that's a different fix: use the Claude Desktop Doctor.