Documentation
Learn how to use ClaudeBoost
Everything you need to install, configure, and get the most out of ClaudeBoost in your Claude Code workflow.
Getting Started
ClaudeBoost is a free MCP (Model Context Protocol) plugin for Claude Code that automatically enhances your prompts before they reach Claude. Install it in 30 seconds.
Step 1: Install & configure (regular terminal)
pip install claudeboost-mcp claudeboost-mcp --setup
Setup asks for your Anthropic API key, installs slash commands, and offers to sign in (for dashboard sync).
Step 2: Register MCP server (inside Claude Code)
Open Claude Code and type:
/boost --setup
This registers the MCP server. You only need to do this once. Restart Claude Code after this step.
Step 3: Start using it
That's it. Auto-boost is on by default — every task prompt you type is automatically enhanced. You don't need to type /boost every time, just type normally.
> build me a REST API for user management # ⚡ CLAUDEBOOST · general_coding · Score: 8/30 → 22/30 (+14) # 🔧 Boost added: tests & success criteria, organized sections # Choose: Use boosted / Add notes / Keep original
How It Works
When you type a prompt in Claude Code, ClaudeBoost intercepts it and runs a 4-step pipeline before Claude sees your instruction:
Score
Your prompt is scored across 6 dimensions (Specificity, Verification, Context, Constraints, Structure, Output). If it scores 20+/30, ClaudeBoost skips the boost — your prompt is already well-structured.
Classify
Claude Haiku classifies your prompt into one of 7 domains (data science, DevOps, general coding, etc.) to apply domain-specific enhancement rules.
Enhance
The weakest scoring dimensions are identified and targeted. Light/medium boosts use Haiku (~3s), full boosts use Sonnet (~12s). Your past feedback and domain constraints are injected.
Present
You see the original vs boosted prompt with scores, what was added, and a breakdown by dimension. Choose to use the boost, add notes to refine it, or keep your original.
Commands
ClaudeBoost adds several slash commands and modifiers to Claude Code:
Terminal Commands
Run these in your regular terminal (outside Claude Code):
| Command | Description |
|---|---|
claudeboost-mcp --setup | Set up API key, install skills, and sign in |
claudeboost-mcp --login | Sign in (email + password in terminal) |
claudeboost-mcp --logout | Sign out |
claudeboost-mcp --status | Show connected account |
claudeboost-mcp --check | Quick version/config consistency check |
claudeboost-mcp --doctor | Full diagnostics (checks all 9 systems) |
claudeboost-mcp --version | Show installed version |
Claude Code Commands
Run these inside Claude Code:
| Command | Description |
|---|---|
Just type normally | Auto-boosts every task prompt (when auto-boost is on) |
/boost <prompt> | Manually boost a specific prompt with the full comparison UI |
/boost --setup | Register the MCP server (run once inside Claude Code) |
/boost --login | Sign in to ClaudeBoost (runs terminal login) |
/boost --logout | Sign out of ClaudeBoost |
/boost --status | Show connected account and sync state |
/boost-settings | View current boost settings (level and auto-boost status) |
/boost-settings --level <light|medium|full> | Change boost intensity. Short flag: -l |
/boost-settings --auto <true|false> | Toggle automatic prompt boosting. Short flag: -a |
/boost-help | Show all available commands and usage guide |
<prompt> --raw | Skip auto-boost for that single prompt |
Examples
# First time only — register the MCP server > /boost --setup ✅ MCP server registered. Restart Claude Code to activate. # After restart, auto-boost is on — just type normally > build me an API endpoint for user auth ⚡ CLAUDEBOOST · general_coding · Score: 8/30 → 22/30 (+14) 🔧 Boost added: tests & success criteria, organized sections # Skip boost for one prompt > fix this typo in readme.md --raw # Sign in (email + password in terminal) > /boost --login # Check which account is connected > /boost --status # Change boost level > /boost-settings -l full # Well-structured prompts skip automatically > /boost fix the 403 error in src/auth/session.ts by adding token refresh ✅ Your prompt scores 22/30 — already well-structured!
Boost Levels
ClaudeBoost offers three intensity levels. Each targets a different quality score threshold:
Light
Level 3 · Haiku · ~2-3s
Fixes only dimensions scoring 1-2. Clarifies and structures your prompt while staying close to the original. Uses Haiku for speed.
Medium
Level 4 · Haiku · ~3-5s
Fixes dimensions below 3. Adds verification criteria, constraints, and structure. Fast and balanced — the default.
Full
Level 5 · Sonnet · ~10-15s
Pushes all 6 dimensions to maximum. Full enterprise playbook with anti-patterns, metrics, and acceptance criteria. Uses Sonnet for quality.
Domains
ClaudeBoost auto-classifies every prompt into one of 7 domains using Claude Haiku. Each domain has tailored enhancement rules:
| Domain | Description | Example Prompt |
|---|---|---|
data_science | ML, statistics, data analysis, visualization | train a churn prediction model |
data_engineering | ETL, pipelines, databases, data infrastructure | build a Spark pipeline for user events |
business_analytics | Reporting, dashboards, KPIs, business logic | create a quarterly revenue dashboard |
general_coding | Web dev, APIs, frontend, backend, debugging | build a REST API with auth |
documentation | Docs, READMEs, API specs, technical writing | write API docs for the payment module |
devops | CI/CD, infrastructure, Docker, deployment | set up GitHub Actions pipeline |
other | Anything that doesn't fit the above | organize my desktop files |
Scoring System
Every prompt is scored 1-5 on six dimensions, for a total of 6-30. Scoring is automated via text analysis — no API calls required.
| Dimension | What It Measures | Score 1 | Score 5 |
|---|---|---|---|
Specificity | Are files, functions, and behaviors named? | "fix the bug" | "fix the 403 error in src/auth/session.ts" |
Verification | Are tests or success criteria defined? | No mention of testing | "Jest tests, >90% coverage, CI green" |
Context | Are relevant files and patterns referenced? | No file references | "See src/auth/, follows existing OAuth pattern" |
Constraints | Are boundaries and non-goals stated? | No limits given | "Don't break SSO flow, no new deps" |
Structure | Is it organized with sections/steps? | Single run-on sentence | Numbered steps with clear sections |
Output | Are deliverables and formats specified? | No output described | "Single PR with migration + tests + docs" |
Quality Levels
| Level | Average Score | Label |
|---|---|---|
L1 | < 1.5 | Unacceptable — too vague to act on |
L2 | 1.5 - 2.4 | Needs Work — missing key dimensions |
L3 | 2.5 - 3.4 | Acceptable — clear enough for most tasks |
L4 | 3.5 - 4.4 | Production — well-structured with constraints |
L5 | 4.5+ | Enterprise — comprehensive, auditable prompt |
Feedback & RLHF
ClaudeBoost learns from your preferences through a feedback loop inspired by Reinforcement Learning from Human Feedback (RLHF).
You write a prompt
ClaudeBoost enhances it
You rate & give feedback
Next boost improves
When you rate a boost (1-5 stars) or leave text feedback, it's stored in~/.claudeboost/history.json. Next time ClaudeBoost enhances a prompt in the same domain, it loads your last 5 feedback entries + your domain constraints and injects them into the enhancement prompt. The more feedback you give, the more personalized your boosts become.
Constraints
Domain constraints are persistent rules that ClaudeBoost always applies when enhancing prompts in a specific domain. Set them in the Dashboard under Constraints, or via the CLI settings.
Quick Presets
The Dashboard includes 12 one-click presets for common stacks: Python Data Science, PyTorch ML, dbt+BigQuery, Spark Pipeline, React+TypeScript, Next.js App Router, FastAPI, AWS+Terraform, Docker+Kubernetes, GitHub Actions CI/CD, API Documentation, and Executive Reports. Click one to fill in the domain constraints instantly.
Custom Constraints
Data Science
"Always use Python 3.11+. Prefer scikit-learn over custom implementations. Output as Jupyter notebooks."
General Coding
"Use TypeScript strict mode. Prefer Zod for validation. Follow existing project patterns."
DevOps
"Use GitHub Actions, not Jenkins. All Docker images must be multi-stage. No hardcoded secrets."
Documentation
"Use OpenAPI 3.1 for API docs. Include curl examples. Write for junior developers."
Dashboard
ClaudeBoost includes a web dashboard with authentication. Sign up at the landing page and your data syncs between CLI and web. The dashboard auto-refreshes every 5 seconds.
Pages
History
/org/newBrowse all boosted prompts. Filter by domain or quality level. Expand cards to see original vs boosted, score breakdown, and leave feedback.
Stats
/dashboard/statsAnalytics dashboard with boost acceptance rate, domain distribution, average ratings, 6-dimension score histograms, ROI metrics, feedback coverage, and daily activity.
Constraints
/dashboard/constraintsConfigure boost level, toggle auto-boost, choose from 12 quick presets for common stacks, and set custom per-domain constraint rules.
Running the Dashboard
cd web-dashboard npm install npm run dev # Dashboard available at https://claudeboost.vercel.app
FAQ
Does ClaudeBoost modify my prompt before Claude sees it?
Yes. When auto-boost is on, ClaudeBoost rewrites your prompt and shows you the comparison. You choose whether to use the boosted version, refine it, or keep your original. You're always in control.
What happens when the MCP server isn't running?
Claude Code works normally without ClaudeBoost. Your prompts go directly to Claude without enhancement. You'll see a message that the MCP server is not connected.
Where is my data stored?
If signed in, data syncs to Supabase (our cloud database) so you can access it from the web dashboard and across devices. If not signed in, everything is stored locally in ~/.claudeboost/ as JSON files. Prompt text goes to the Anthropic API for enhancement.
Can I use ClaudeBoost with other AI tools?
ClaudeBoost is designed specifically for Claude Code via the MCP protocol. It hooks directly into the Claude Code CLI workflow.
What models does ClaudeBoost use?
Claude Haiku 4.5 for classification and light/medium enhancement (~2-5s). Claude Sonnet 4 for full-level enhancement (~10-15s). You provide your own Anthropic API key.
How do I install it?
Three steps: (1) pip install claudeboost-mcp in your terminal, (2) claudeboost-mcp --setup to configure API key and sign in, (3) /boost --setup inside Claude Code to register the MCP server. Restart Claude Code and you're done.
Do I need to type /boost every time?
No. Auto-boost is on by default — just type your prompt normally and it gets enhanced automatically. Use /boost only when you want to manually boost a specific prompt.
What if my prompt is already good?
ClaudeBoost skips prompts that score 20+/30 automatically. You'll see '✅ Your prompt is already well-structured!' and it proceeds without boosting.
Can I disable ClaudeBoost temporarily?
Use /boost-settings --auto false to turn off auto-boost. You can still manually boost with /boost <prompt>. Or append --raw to any prompt to skip just that one.
Something isn't working after upgrading. What do I do?
Run claudeboost-mcp --check in your terminal. It detects version mismatches, stale skills, and missing config. The fix is almost always: claudeboost-mcp --setup (to re-install skills matching your new version). For full diagnostics: claudeboost-mcp --doctor.
MCP server says 'not connected' even after setup
The MCP server must be registered inside Claude Code. Open Claude Code and type: /boost --setup. This runs 'claude mcp add' which always works from inside Claude Code. Then restart Claude Code.