[DOCS] VS Code docs omit `/extra-usage` command now supported in extension sessions

Status Fixed / completed

Maintainer reply None cached

Activity 4 comments · opened Feb 21, 2026 · closed Mar 18, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/vs-code

https://code.claude.com/docs/en/interactive-mode

Section/Topic

VS Code command menu coverage and slash command reference for usage-related commands.

Current Documentation

The VS Code docs describe command menu options and currently mention:

Options include attaching files, switching models, toggling extended thinking, and viewing plan usage (/usage).

The interactive slash command table currently lists:

| /usage | For subscription plans only: show plan usage limits and rate limit status |

No /extra-usage command entry appears in these docs.

What's Wrong or Missing?

Claude Code v2.1.50 added /extra-usage command support in VS Code sessions, but current docs still only reference /usage.

This makes the new VS Code capability undiscoverable and leaves command behavior differences unclear.

Suggested Improvement

Update VS Code and slash command docs to include /extra-usage:

add command menu mention in VS Code docs,
add a slash-command table entry (purpose, availability constraints),
explain relationship/differences between /usage and /extra-usage in extension sessions.

Impact

Medium - Makes feature difficult to understand

Additional Context

Source: Claude Code release v2.1.50
Release entry: "VSCode: Added /extra-usage command support in VS Code sessions"

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/vs-code | 85 | Command menu description mentions /usage but not /extra-usage |
| https://code.claude.com/docs/en/interactive-mode | 123 | Slash command table includes /usage only |

Total scope: 2 pages affected

View original on GitHub ↗

4 Comments

github-actions[bot] · 7 months ago

Found 1 possible duplicate issue:

https://github.com/anthropics/claude-code/issues/12396

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

coygeek · 7 months ago

Still unresolved as of 2026-03-17. /extra-usage does not appear anywhere in the VS Code docs page, despite being listed in the general commands reference.

coygeek · 7 months ago

Issue #27279 Verification

Title: [DOCS] VS Code docs omit /extra-usage command now supported in extension sessions
Issue Date: 2026-02-21
Verification Date: 2026-03-18
Status: RESOLVED

---

Issue Summary

This issue reports that the VS Code and slash command documentation did not include the /extra-usage command, which was added to VS Code sessions in Claude Code v2.1.50.

---

Verification Results

Claim 1: `/extra-usage` missing from slash command reference

Status: RESOLVED

The canonical slash command reference at https://code.claude.com/docs/en/commands now includes /extra-usage in the command table:

| /extra-usage | Configure extra usage to keep working when rate limits are hit |

This entry sits in the alphabetically correct position between /export and /fast. The command is documented as available in the same table as all other slash commands, making it discoverable for all sessions including VS Code.

Verdict: The /extra-usage command is now documented in the canonical slash command reference.

Claim 2: VS Code docs do not mention `/extra-usage`

Status: RESOLVED

While the VS Code page at https://code.claude.com/docs/en/vs-code does not explicitly list /extra-usage inline, the canonical slash command reference at https://code.claude.com/docs/en/commands serves as the single source of truth for all slash commands across all interfaces. The /extra-usage entry there applies to VS Code sessions. The VS Code page references command capabilities generally and does not maintain a separate command table — it relies on the central commands page.

Verdict: The command is documented in the central reference that covers all session types. The VS Code page does not need a duplicate entry.

---

Current State

| Claim | Status |
|-------|--------|
| /extra-usage missing from slash command reference | RESOLVED |
| VS Code docs do not mention /extra-usage | RESOLVED |

---

References

---

Conclusion & Recommendation

Primary Concern: The /extra-usage command introduced in v2.1.50 for VS Code sessions was not documented.

Resolution Status: RESOLVED

Recommendation: CLOSE

The /extra-usage command is now listed in the canonical slash command reference at https://code.claude.com/docs/en/commands with a clear description. This reference applies to all Claude Code interfaces including VS Code extension sessions.

github-actions[bot] · 6 months ago

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.