[DOCS] Errors page omits `/compact` and `--debug` guidance for auto mode classifier outages

Resolved 💬 2 comments Opened May 5, 2026 by coygeek Closed May 17, 2026

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:

  1. Update the example/error explanation to note that Claude Code may surface hints such as retrying, running /compact, or restarting with claude --debug.
  2. Add one short bullet for each hinted recovery path:
  • retry after a few seconds for transient classifier overload
  • run /compact if the session is under context pressure
  • rerun with --debug when the user needs a debug log for troubleshooting
  1. Cross-link the hint actions to the existing command references for /compact and --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

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗