[DOCS] `/usage-credits` documentation omits amount validation and high-value confirmation
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/commands
Section/Topic
The /usage-credits command entry and the usage-credit cost-management guidance.
Current Documentation
The commands page currently says:
“Configure usage credits to keep working when you hit a limit. Opens the usage-credits billing page in your browser.”
The costs page currently says:
“On Pro and Max plans, you can set a monthly spend limit on usage credits with the /usage-credits command.”
Neither section explains what amount input is accepted or what confirmation is required for a large amount.
What's Wrong or Missing?
Claude Code v2.1.207 changed /usage-credits amount handling: malformed values are rejected with an error instead of being silently stripped down to digits, and amounts over $1,000 require a typed confirmation.
These are user-facing validation and safety behaviors for a billing command, but the command reference only describes the destination and general purpose. Users who paste a malformed value or see a confirmation prompt for a high amount have no documentation explaining that the behavior is intentional and protective.
Suggested Improvement
Expand the /usage-credits command entry or link it to a dedicated usage-credit billing section that documents accepted amount input, rejection of malformed values, and the typed confirmation required for amounts over $1,000. Explain that invalid input is not normalized silently and provide a safe example of a valid amount.
Cross-link the same behavior from the costs page, alongside the existing monthly spend-limit explanation. Keep the documentation clear about whether the amount is a monthly limit, a purchase amount, or another billing setting so the validation threshold is not misunderstood.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/commands | /usage-credits command reference |
| https://code.claude.com/docs/en/costs | Usage-credit spend-limit guidance |
| https://code.claude.com/docs/en/errors | Usage-credit-related recovery guidance, which currently explains when to run /usage-credits but not its input validation |
Total scope: 3 pages affected
Source: Claude Code v2.1.207
Fixed /usage-credits amount inputs silently stripping malformed values (e.g. a pasted timestamp) to digits; malformed amounts are now rejected with an error, and amounts over $1,000 require a typed confirmation