coderplan-tier

Analyze your Claude Code usage and get a recommendation for the optimal pricing tier.

Quick Start

npx coderplan-tier@latest

Problem

Developers need guidance on which Claude Code pricing tier best fits their usage patterns. This tool analyzes actual usage data and recommends the most cost-effective plan.

Tier Overview

| Tier | Monthly Cost | Rate Limits | Best For | |------|--------------|-------------|----------| | API Only | Pay-per-token | Unlimited | Occasional users (<1 session/week) | | Pro | $20/month | ~45 msgs/5hr, 40-80 hrs/week | Regular daily users | | Max 5x | $100/month | 5× Pro limits | Heavy users, multiple projects | | Max 20x | $200/month | 20× Pro limits | Power users, constant usage |

How It Works

1. Reads usage data from both:
   • Claude Code via ccusage
   • OpenAI Codex via @ccusage/codex
2. Combines and analyzes usage patterns (sessions, tokens, costs, model mix)
3. Calculates break-even points for each tier
4. Recommends the tier that minimizes your total cost

This is especially useful for developers transitioning from Codex to Claude - see your combined costs and what Claude tier would cover your usage.

Example Output

╭──────────────────────────────────────────────────────────╮
│              CoderPlan Tier Recommendation               │
╰──────────────────────────────────────────────────────────╯

Your Usage (Last 30 Days)
   Sessions:        47
   Active Days:     22/30
   Total Tokens:    2.4M
   API Cost:        $127.32
   ├─ Claude:     $67.32 (53%)
   └─ Codex:      $60.00 (47%)
   Primary Model:   Claude Opus (45%), Codex gpt-5 (40%), Claude Sonnet (15%)

Recommendation: Max 5x ($100/month)
   Confidence: HIGH (consistent daily usage pattern)

   Reasoning:
   - Heavy usage (22 active days/month)
   - API costs ($127/mo) exceed Pro break-even (~$25)
   - Max 5x limits would cover your typical usage

   Projected Savings: ~$65/month vs API-only

╭──────────────────────────────────────────────────────────╮
│ Tier Comparison                                          │
├──────────────────────────────────────────────────────────┤
│ API Only     $127/month   (current spend)                │
│ Pro          $58/month    ($20 + ~$38 overflow)          │
│ Max 5x       $113/month   ($100 + ~$13 overflow) <--     │
│ Max 20x      $203/month   ($200 + ~$3 overflow)          │
╰──────────────────────────────────────────────────────────╯

CLI Options

coderplan-tier                # Analyze last 30 days (default)
coderplan-tier --period 90    # Analyze last 90 days
coderplan-tier --json         # Output as JSON
coderplan-tier --verbose      # Show detailed metrics

Break-Even Analysis

The recommendation algorithm considers:

| Tier | Break-Even Point | |------|------------------| | Pro ($20) | ~$25-30/month API spend | | Max 5x ($100) | ~$120-150/month API spend | | Max 20x ($200) | ~$250+/month API spend |

Confidence Levels

The tool shows a confidence indicator based on usage variance:

• HIGH: Consistent daily usage, stable patterns
• MEDIUM: Some variation but clear trend
• LOW: Highly variable (heavy some weeks, idle others)

API Token Pricing Reference

| Model | Input (per 1M) | Output (per 1M) | |-------|----------------|-----------------| | Haiku | $1 | $5 | | Sonnet 4.5 | $3 | $15 | | Opus 4.5 | $5 | $25 | | Opus 4.1 | $15 | $75 |

Requirements

• Node.js 18+
• Claude Code usage history (stored locally by Claude Code)

License

MIT