Claude Code Statusline with 1M Context Support

Dynamic context window detection for Claude Code statusline that automatically adjusts to your model's context window size.

Features

• 🎯 Dynamic Context Detection: Automatically detects [1m], [200k], etc. suffixes
• 📊 Accurate Percentages: Shows correct context usage for 1M and 200K models
• 💰 Session Metrics: Cost tracking and duration monitoring
• 💸 Premium Pricing Alert: Shows "💸2x" indicator when exceeding 200K tokens (2x pricing tier)
• 🎨 Color-coded Alerts: Visual warnings at 50%, 75%, 90%, 95% usage

Installation

🚀 Automatic Installation (Recommended)

Run the installer - it will set everything up for you:

npx claude-statusline-1m --install

The installer will:

1. Ask where you want to install (global, project, or local)
2. Copy the Python script to the right location
3. Update your settings.json automatically
4. Show you what was installed

Quick install with defaults (installs locally without prompts):

npx claude-statusline-1m --install --yes

Then restart Claude Code and you're done! 🎉

🛠️ Manual Installation (Advanced)

If you prefer to configure manually, add this to your .claude/settings.json or .claude/settings.local.json:

For npm version:

{
  "statusLine": {
    "type": "command",
    "command": "npx -y claude-statusline-1m"
  }
}

For GitHub version:

{
  "statusLine": {
    "type": "command",
    "command": "npx -y github:vedmichv/claude-statusline-1m"
  }
}

Then restart Claude Code.

How It Works

• 🚀 NPX downloads and caches the package automatically
• ⚡ Claude Code runs it on every session
• 📦 No installation script needed - runs directly from cache
• 🌍 Works at project OR global level
• 🔄 Always uses the cached version for fast startup

Quick Test

Test the statusline before configuring:

# Test with npm package
echo '{"model":{"id":"test[1m]","display_name":"Claude"},"workspace":{"current_dir":"/tmp"},"transcript_path":""}' | npx -y claude-statusline-1m

# Test with GitHub version
echo '{"model":{"id":"test[1m]","display_name":"Claude"},"workspace":{"current_dir":"/tmp"},"transcript_path":""}' | npx -y github:vedmichv/claude-statusline-1m

Expected output: [Claude] 📁 tmp 🧠 🔵 ???

Context Window Detection

The script automatically detects your model's context window from the model ID:

• model[1m] → 1,000,000 tokens
• model[200k] → 200,000 tokens
• No suffix → 200,000 tokens (default)

Supported Models

• ✅ Claude Sonnet 4.5 with 1M context ([1m])
• ✅ Claude Sonnet 4 with 1M context ([1m])
• ✅ Any future models with [XM] or [Xk] suffixes

Pricing Information

Both Anthropic API & AWS Bedrock

Claude Sonnet 4/4.5 with 1M context has tiered pricing:

⚠️ Critical: When you exceed 200K tokens, ALL tokens in that request are charged at the premium rate, not just the excess.

The statusline displays a 💸2x indicator when you cross into premium pricing territory (>200K tokens).

Requirements

• Python 3.x
• Claude Code CLI

License

MIT