[DOCS] Errors page omits `/compact` and `--debug` guidance for auto mode classifier outages
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/errors
Section/Topic
Auto mode cannot determine the safety of an action
Current Documentation
The docs currently say:
### Auto mode cannot determine the safety of an action The model that auto mode uses to classify actions is overloaded, so auto mode blocked the action instead of approving it unchecked. <model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again. What to do: Retry after a few seconds; Claude sees the same message and usually retries on its own If retries keep failing, continue with read-only tasks and come back to the blocked action later * This is transient and unrelated to auto mode eligibility; you do not need to change settings
What's Wrong or Missing?
This section is outdated for Claude Code v2.1.128.
The v2.1.128 changelog says the runtime error now includes a hint for cases where the auto mode classifier cannot evaluate an action, with guidance to retry, run /compact, or rerun with --debug.
The current docs only describe retry behavior. They do not mention the newer /compact or --debug hint paths, so the error reference no longer matches what users see in the product and does not explain when those extra hints are relevant.
Suggested Improvement
Update the Auto mode cannot determine the safety of an action section so it matches the current error guidance in v2.1.128.
Suggested changes:
- Update the example/error explanation to note that Claude Code may surface hints such as retrying, running
/compact, or restarting withclaude --debug. - Add one short bullet for each hinted recovery path:
- retry after a few seconds for transient classifier overload
- run
/compactif the session is under context pressure - rerun with
--debugwhen the user needs a debug log for troubleshooting
- Cross-link the hint actions to the existing command references for
/compactand--debug.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/errors | 115-129 | Auto mode outage error still documents retry-only guidance |
Related docs for cross-reference:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/commands | /compact and /debug command reference |
| https://code.claude.com/docs/en/cli-reference | --debug CLI flag reference |
Total scope: 1 primary page affected
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗