[BUG] Context usage panel: “Usage” column label is misleading next to “Free space”

Open Beginner friendly
#110,675 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
64/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
cli

Research direction

Start by locating the /context panel and the code that labels its last column and renders the “Free space” row. Check how the displayed percentages are calculated and compare them with the header’s usage figure. Done means the column label or free space presentation no longer makes available context look like used context.

Written by the indexing model from the issue text.

Description

area:ui bug platform:vscode platform:windows
Preflight Checklist
  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code
What's Wrong?

Title: Context usage panel: "Usage" column label is misleading next to "Free space"

Description:
In the /context panel, the last column is labeled "Usage". Every row shows a percentage of the total context window, including "Free space", which reads "85.1%". At a glance this looks like 85% of the context has been used, when it's actually 85% still available. The real usage (12%) only appears in the header.

image

Environment: Claude Code, model claude-opus-5-5, 1M context window. Screenshot attached.

What Should Happen?

Suggestion:
Rename the column to something neutral, like "% of total" or "Share". Alternatively, show "Free space" separately from the used categories, for example as a summary line ("851k tokens available").

Error Messages/Logs

Steps to Reproduce
  1. Open Claude Code (VS Code extension) and start a session with claude-opus-5-5 (1M context window)
  2. Have a short conversation so some context is used (~115k tokens in my case)
  3. Open the "Context usage" panel (click the context indicator, or run /context)
  4. Look at the "USAGE" column: the "Free space" row shows "85.1%"
  5. Compare with the header, which shows the real usage: "115.8k / 1.0M tokens (12%)"

Result: because the column is labeled "USAGE", the 85.1% next to "Free space" reads at first glance as "85% used", while it actually means 85% still available.

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

2.1.322.

Platform

Other

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

No response

Dominant language
TypeScript
Stars
156k
Forks
25k
Avg merge
12h 27m
Merged PRs (30d)
4

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from anthropics/claude-code

All issues in anthropics/claude-code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.