claude-code - 💡(How to fix) Fix [DOCS] Errors page omits `/compact` and `--debug` guidance for auto mode classifier outages [1 participants]

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. Update the Auto mode cannot determine the safety of an action section so it matches the current error guidance in v2.1.128.

1. Update the example/error explanation to note that Claude Code may surface hints such as retrying, running /compact, or restarting with claude --debug. | https://code.claude.com/docs/en/errors | 115-129 | Auto mode outage error still documents retry-only guidance |

TL;DR

Update the "Auto mode cannot determine the safety of an action" documentation section to include the new error guidance and recovery paths introduced in Claude Code v2.1.128.

Guidance

• Review the v2.1.128 changelog to understand the new error handling behavior and hints provided to users.
• Update the documentation to include the three hinted recovery paths: retrying, running /compact, and rerunning with --debug, along with brief explanations for each.
• Cross-link the new hint actions to the existing command references for /compact and --debug to provide users with more detailed information.
• Verify the changes by comparing the updated documentation with the actual error messages and guidance provided in the product.

Example

No code snippet is necessary for this documentation update, but the revised section could look like:

Auto mode cannot determine the safety of an action

The model that auto mode uses to classify actions may surface hints for resolution. Possible hints include:

• Retry after a few seconds for transient classifier overload
• Run /compact if the session is under context pressure
• Rerun with --debug when a debug log is needed for troubleshooting

What to do:

• Retry after a few seconds; Claude may retry on its own
• Run /compact for context pressure issues (/compact command reference)
• Rerun with --debug for debug logging (--debug CLI flag reference)

Notes

The update should ensure that the documentation accurately reflects the current error handling behavior and provides users with relevant guidance and resources for resolving issues.

Recommendation

Apply the suggested documentation updates to ensure that users have access to accurate and helpful information for resolving "