Claude Code Status Line

A custom status line for Claude Code that displays model info, token usage, rate limits, and reset times in a single compact line. It runs as an external shell command, so it does not slow down Claude Code or consume any extra tokens.

Screenshot

What it shows

Segment	Description
Model	Current model name (e.g., Opus 4.6)
CWD@Branch	Current folder name, git branch, and file changes (+/-)
Tokens	Used / total context window tokens (% used)
Effort	Reasoning effort level (low, med, high)
5h	5-hour rate limit usage percentage and reset time
7d	7-day rate limit usage percentage and reset time
Extra	Extra usage credits spent / limit (if enabled)

Usage percentages are color-coded: green (<50%) → yellow (≥50%) → orange (≥70%) → red (≥90%).

Requirements

• jq — for JSON parsing
• curl — for fetching usage data from the Anthropic API
• Claude Code with OAuth authentication (Pro/Max subscription)

Installation

Quick setup (recommended)

Copy the contents of statusline.sh and paste it into Claude Code with the prompt:

Use this script as my status bar

Claude Code will save the script and configure settings.json for you automatically.

Manual setup

1. Copy the script to your Claude config directory:

   cp statusline.sh ~/.claude/statusline.sh
   chmod +x ~/.claude/statusline.sh

2. Add the status line config to ~/.claude/settings.json:

   {
     "statusLine": {
       "type": "command",
       "command": "~/.claude/statusline.sh"
     }
   }

3. Restart Claude Code.

Caching

Usage data from the Anthropic API is cached for 60 seconds at /tmp/claude/statusline-usage-cache.json to avoid excessive API calls.

License

MIT

Author

Daniel Oliveira