Rate limit triggered on minimal single-command usage, misleading "usage limit" error

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

Description:

Claude Code hits "You've hit your usage limit" mid-task on a trivial operation (single commit + push). No parallel agents, no heavy context, no overnight loops running. Literally one command: "merge, commit, push, and deploy."

Steps to reproduce:

Open Claude Code in VS Code extension
Issue a simple command like "commit and push"
Claude stops mid-execution with "You've hit your usage limit - View usage"
Type "hello" or "continue" — it resumes immediately
Expected behavior: A simple commit/push should complete without rate limiting.

Actual behavior: Execution halts mid-task with a misleading "usage limit" message. Typing any short message resumes it, proving this is a transient rate limit, not an actual usage cap.

Why this is broken:

The error message says "usage limit" but it's actually a rate limit — these are different things and require different user action
A single lightweight operation should not trigger rate limiting
The "fix" is typing "hi" which makes no sense and wastes time
No visibility into what's actually being throttled or why
Environment: Claude Code VS Code extension, Windows 11, Opus 4.6

What Should Happen?

A simple single command like "commit and push" should complete without being rate-limited. Lightweight operations with no parallel agents, no large context, and no concurrent sessions should never trigger a usage limit mid-execution.

Error Messages/Logs

"You've hit your usage limit - View usage"

This appears mid-task during a simple commit/push operation. No other Claude Code sessions are running. Typing any short message (e.g., "hello", "continue") immediately resumes execution, indicating this is a transient rate limit — not an actual usage cap.

Environment: Claude Code VS Code extension, Windows 11, Opus 4.6 (1M context)

Steps to Reproduce

1. Open Claude Code in the VS Code extension
2. Issue a simple command such as "merge, commit, push, and deploy" — no parallel agents, no heavy file reads, no sub-agents
3. Claude begins executing (e.g., runs git commands, edits a file)
4. Mid-task, execution halts and displays "You've hit your usage limit - View usage"
5. Type "hi" or "continue" — Claude immediately resumes and completes the task

This happens repeatedly across sessions. The error message is misleading — it implies the billing usage cap has been reached, but it's actually a transient rate limit. There's no way to distinguish the two from the UI, and no information is given about what triggered the throttle or how long to wait.

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.1.69 (Claude Code)

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

VS Code integrated terminal

Additional Information

_No response_