Feature Request: Usage history tracking for Pro/Max subscription users

[paulnegz]

Feature Request

Summary: Provide Pro/Max subscription users with access to their detailed token usage history, similar to what API users get via the Admin API.

Problem

Currently, subscription users (Pro/Max) have no official way to view:

• Historical token usage across sessions
• Cumulative usage over time (weekly/monthly/all-time)
• Breakdown by model (Opus, Sonnet, Haiku)
• Usage trends and patterns

Current Limitations:

1. /cost command shows: "With your Claude Max subscription, no need to monitor cost — your subscription includes Claude Code usage."
2. Claude Console only tracks API usage, not subscription usage
3. claude.ai/settings/usage shows limited current-period info, no history
4. Local JSONL files get pruned, losing historical data

Workarounds (inadequate):

• Third-party tools like ccusage parse local files but can't recover pruned data
• No way to get complete historical picture

Proposed Solution

Option A: API Endpoint for Subscription Users

Extend the Admin API or create a new endpoint:

GET /v1/users/me/usage_history

Returns token usage grouped by day/week/month with model breakdown.

Option B: Enhanced /usage Command

Add a Claude Code command that queries Anthropic's backend:

/usage --history        # Show all-time usage
/usage --month 2025-12  # Show specific month
/usage --export csv     # Export data

Option C: Claude.ai Dashboard Enhancement

Provide detailed usage history at claude.ai/settings/usage including:

• Historical graphs
• Token breakdowns
• Export functionality

Use Cases

1. Personal tracking - Users want to understand their usage patterns
2. Optimization - Identify which tasks consume most tokens
3. Planning - Decide whether to upgrade/downgrade subscription tier
4. Transparency - Know what you're getting for your subscription cost

Related Issues

• [FEATURE] Agent Token Usage API - Critical Infrastructure for Agent Development Ecosystem #10388 - Agent Token Usage API (related but focused on programmatic agent access)
• Feature Request: Add command to view all-time cumulative token usage #13891 - All-time cumulative token usage command

References

• Using Claude Code with Pro/Max
• Shipyard: How to track Claude Code usage

---

🤖 Generated with Claude Code

[github-actions]

Found 3 possible duplicate issues:

1. Feature Request: Add command to view all-time cumulative token usage #13891
2. Usage Metrics Visibility for Max Subscribers #1109
3. Feature Request: Pro Plan 5-Hour Window Usage Visibility #9617

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically closed as a duplicate of #13891.

If this is incorrect, please re-open this issue or create a new one.

🤖 Generated with Claude Code

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.