Why ClaudeTrack?

Claude's API has no built-in dashboard. You're flying blind on cost, token burn, rate limits, and per-session usage. ClaudeTrack fixes that — it's a transparent proxy + analytics layer that sits between your code and Anthropic, giving you full visibility with zero changes to your application code.

No SaaS subscription. No data leaving your infrastructure. No vendor lock-in.

Quick Start

# 1. Clone
git clone https://github.com/your-org/claudetrack.git
cd claudetrack

# 2. Configure (one env var)
echo "SESSION_SECRET=$(openssl rand -hex 32)" > .env

# 3. Run
docker compose up -d

# → Dashboard at http://localhost:5000

That's it. Three commands.

Zero Code Changes Integration

The Anthropic SDK reads ANTHROPIC_BASE_URL from your environment automatically. Add two lines to your .env and your existing code is tracked without modification:

# In your application's .env (not ClaudeTrack's)
ANTHROPIC_API_KEY="cti_your_proxy_key_from_dashboard"
ANTHROPIC_BASE_URL="http://localhost:5000/proxy/v1"

# Run your app exactly as before — every Claude call is now tracked.

Works with every platform that uses the Anthropic SDK:

If you'd rather keep your Anthropic key on your own server, use SDK-only mode — your app calls Anthropic directly, then posts only token counts to ClaudeTrack. Your key never touches our proxy.

Features

Architecture

Your App
   │
   │  ANTHROPIC_BASE_URL="http://your-claudetrack/proxy/v1"
   │  ANTHROPIC_API_KEY="cti_your_proxy_key"
   ▼
┌─────────────────────────────────────────────────────┐
│                    ClaudeTrack                      │
│                                                     │
│  Express proxy  ──►  Token counter  ──►  Postgres   │
│       │                                     │       │
│       ▼                                     ▼       │
│  api.anthropic.com              React dashboard     │
└─────────────────────────────────────────────────────┘

Tech stack: Node.js · Express · React · Vite · PostgreSQL · Drizzle ORM · Recharts · shadcn/ui · Tailwind CSS

Self-Hosting Options

Docker Compose (recommended)

git clone https://github.com/your-org/claudetrack.git
cd claudetrack
cp .env.example .env
# Edit .env — set SESSION_SECRET at minimum
docker compose up -d

Replit (one click, zero config)

Database is auto-provisioned. Share the URL with your team and you're done.

Manual (Node.js 20+)

git clone https://github.com/your-org/claudetrack.git
cd claudetrack
npm install
cp .env.example .env
# Edit .env with your DATABASE_URL and SESSION_SECRET
npm run dev          # development
npm run build && npm start  # production

Claude Code + OTEL Support

Track Claude Code sessions by pointing its OpenTelemetry exporter at ClaudeTrack:

export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:5000"
claude  # sessions now appear in your ClaudeTrack dashboard

Companion Tools (coming soon)

Inspired by the Resend / React Email playbook — standalone tools released separately to build community before the ecosystem matures:

• claude-cost — CLI cost estimator. npx claude-cost --model sonnet --tokens 50000. No account, no proxy, just math.
• claude-ratelimit — CLI rate limit calculator. Paste your usage tier, get a live window gauge.

If either of these sounds useful, upvote the issue or open a PR — they're designed to be beginner-friendly.

Contributing

ClaudeTrack is community-driven. Every contributor becomes a maintainer-in-spirit.

Good first issues

Look for issues tagged good first issue — these are explicitly scoped, documented, and mentor-supported:

• Add Slack / Discord webhook for budget alerts
• CSV export for request log
• Per-model cost configuration (custom pricing)
• Claude Code OTEL receiver implementation
• claude-cost standalone CLI (new repo)
• claude-ratelimit standalone CLI (new repo)

How to contribute

git clone https://github.com/your-org/claudetrack.git
cd claudetrack
cp .env.example .env      # fill in DATABASE_URL + SESSION_SECRET
npm install
npm run dev               # http://localhost:5000

Then open a PR. We review within 48 hours.

Areas we need help

GitHub Topics

If you're adding this repo to GitHub, use these topics for discoverability:

claude · anthropic · llm-observability · api-proxy · cost-tracking · token-tracking · rate-limiting · opentelemetry · self-hosted · developer-tools

Roadmap

• Proxy endpoint with token tracking
• Real-time dashboard with Recharts
• Budget alerts + rate limit prediction
• Per-session analytics
• AES-256-GCM key encryption
• Docker Compose self-hosting
• Slack / Discord alert webhooks
• Claude Code OTEL receiver
• claude-cost CLI (standalone)
• claude-ratelimit CLI (standalone)
• Prometheus metrics endpoint
• Team access / multi-user

License

MIT — use it, fork it, sell it, build on it. Just keep the copyright notice.