Claude Cruise

Never hit a rate limit again.
Smart proxy for Claude Code with auto-routing & real-time monitoring.

⭐ Star on GitHub 📖 Documentation ☕ Support on Ko-fi
$ npx claude-cruise
Claude Cruise Dashboard

✨ Features

🔮

Predictive Limits

Learns your actual rate limits from 429 errors and predicts when you'll hit them with 87%+ confidence.

Auto-Routing

Automatically switches to cheaper models (Haiku) or backup providers (OpenRouter, Ollama) as you approach limits.

📊

Real-Time Dashboard

Beautiful web dashboard showing usage, costs, model status, and routing activity at localhost:4141.

💰

Cost Savings

Save 20-40% on typical usage by automatically routing to cheaper models for simple tasks.

🔒

100% Local

Your API keys never leave your machine. All data stays on your computer in a local SQLite database.

🚀

Zero Config

Just run npx claude-cruise and point Claude Code to localhost:4141. That's it!

🔄 Auto-Routing Cascade

0% - 70%
🟢 Claude Sonnet
$3/M tokens
70% - 85%
🟡 Claude Haiku
$0.8/M (73% cheaper!)
85% - 95%
🟠 OpenRouter
$3.5/M tokens
95%+
🔴 Ollama
FREE (local)

🚀 Quick Start

1

Set Your API Key

Get your key from console.anthropic.com

export ANTHROPIC_API_KEY="sk-ant-api03-..."
2

Run Claude Cruise

Start the proxy with one command

npx claude-cruise
3

Point Claude Code to the Proxy

In a new terminal, set the base URL

export ANTHROPIC_BASE_URL="http://localhost:4141"
4

Open the Dashboard

Visit the web dashboard to monitor usage

open http://localhost:4141

💖 Support This Project

If Claude Cruise saves you time and frustration, consider supporting its development!

Support me on Ko-fi

Your support helps maintain the codebase, add new features, and fuel late-night coding sessions! ☕