[FEATURE] Add settings to hide token counter and version display in status line

Status Fixed / completed
Reported on v2.1.25
Maintainer reply None cached
Activity 11 comments · opened Jan 30, 2026 · closed Aug 17, 2026

Preflight Checklist

  • [x] I have searched existing feature requests and found no duplicates
  • [x] This is a single feature request (not multiple bundled together)
  • [x] I have provided concrete use cases

Problem Statement

When using a custom statusLine configuration, Claude Code still displays built-in UI elements on the right side of the interface:

  • Token counter ("0 tokens" or "X tokens")
  • Version comparison ("current: 2.1.25 · latest: 2.1.25")

There's no documented way to hide these elements for users who want a minimal or fully custom UI.

Proposed Solution

Add environment variables following the existing CLAUDE_CODE_HIDE_* pattern:

{
  "env": {
    "CLAUDE_CODE_HIDE_TOKENS": "1",
    "CLAUDE_CODE_HIDE_VERSION": "1"
  }
}

Alternative Solutions

A single setting for minimal UI could also work:

{
  "env": {
    "CLAUDE_CODE_MINIMAL_STATUS_UI": "1"
  }
}

Priority

Medium - Would be very helpful for users with custom status lines

Feature Category

Configuration and settings

Use Case Example

  1. Streamers/demos - Want clean UI without distracting numbers
  2. Custom statusLine users - Already displaying context info their own way via the statusLine setting
  3. Minimal UI preference - Users who find these elements unnecessary noise

Additional Context

Existing Precedent

CLAUDE_CODE_HIDE_ACCOUNT_INFO already exists for hiding email/organization, so the pattern is established.

Environment

  • Claude Code version: 2.1.25
  • Platform: macOS

View original on GitHub ↗

9 Comments

yulonglin · 6 months ago

+1 (commenting because I see it has just been tagged as stale)

jetm · 6 months ago

+1 — Running a custom statusLine command (ccusage-statusline-rs) that already displays richer context info with percentage:

🤖Opus 4.6 │ 🧠60,380(30%) │ 🔥107%[⏱4h] 5h │ 🕓3h49m │ 📊5h:25% 7d:46% │ 📅1d21h                    61200 tokens

The built-in 61200 tokens on the right is purely redundant — it shows less useful data (raw count, no percentage, no max context reference) than what the custom statusline already provides. There's no way to hide it or change its format.

A CLAUDE_CODE_HIDE_TOKENS env var (or similar) would let custom statusline users avoid this visual noise.

yxssxn · 6 months ago

Would love this. Running a custom statusline via claude-hud that already shows detailed token breakdowns (in/out/cache read/cache write). The built-in token counter overlaps and can't be independently hidden without disabling verbose mode entirely. A statusLine.hideTokens setting or CLAUDE_CODE_HIDE_TOKENS env var would be perfect.

yxssxn · 6 months ago

Related: system notifications breaking custom statusline layouts

This isn't just about hiding the token counter — it's about where system notifications render. Currently, Claude Code injects notifications (token count, rate limit warnings like "You've used 93% of your session limit...", "Now using extra usage", installation banners) directly into the custom statusline area. This breaks multi-line statusline layouts by wrapping/splitting content mid-line.

The fix shouldn't be suppression — the information is useful. The ask is: render system notifications in a separate area (above or below) rather than overlaying them onto the custom statusline output.

A custom statusLine.command should own its display area cleanly. System messages should have their own dedicated space.

Related: #23683 (installation notification destroying statusline — same root cause, different notification type)

coygeek · 5 months ago

Not implemented yet.

CohesionBrew · 5 months ago

+1 — I run a comprehensive custom statusline that already displays model, context bar, token count, cache efficiency, rate limits, git branch, effort level, and commit hash. The built-in version/token indicators on the right side are fully redundant in my case and just add visual noise.

CLAUDE_CODE_HIDE_VERSION and CLAUDE_CODE_HIDE_TOKENS env vars (following the existing CLAUDE_CODE_HIDE_ACCOUNT_INFO pattern) would be the cleanest solution. Would love to see this shipped.

maxnabokow · 2 months ago

+1

JacobMuchow · 2 months ago

+1. Also would like to hide "/rc active" and "⏵⏵ auto mode on (shift+tab to cycle)" so I can just show them in my status line. For example I would like to show simply ""⏵⏵ auto". Maybe there should be a catch-all to hide any hard-coded UI in status line / bottom chrome.

Reason why I want this: there are sometimes up to 3 extra lines added by CC.:

<img width="239" height="103" alt="Image" src="https://github.com/user-attachments/assets/da63fceb-1474-41f9-bbde-823d45947651" />

When I'm working with multiple agents that is taking valuable vertical screen real estate for little/negative value.

rodboev · 2 months ago

This is a clear disparity between "tui": "default" and "tui": "fullscreen" which should be reconciled. If fullscreen TUI does not show these by default, neither should appear in the default display mode.

Showing cached comments. Read the full discussion on GitHub ↗