[DOCS] `@` file-path docs missing guidance on corrected-path suggestions for missing repo-folder prefixes

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

@ file-path mention behavior and troubleshooting for missing-path errors.

Current Documentation

The interactive-mode quick commands section currently states:

@ | File path mention | Trigger file path autocomplete

There is no documented behavior for corrected-path suggestions when a file path is invalid because the repository folder segment was dropped.

What's Wrong or Missing?

Claude Code v2.1.49 added improved file-not-found errors that suggest corrected paths when the model drops the repository folder from a path.

Current docs do not describe this recovery behavior or how users should act on these suggestions.

Suggested Improvement

Add a short troubleshooting note (or section) that explains:

• when corrected-path suggestions appear,
• a before/after example for dropped repo-folder prefixes,
• how to quickly retry with the suggested path.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/interactive-mode | 80-85 | @ path-mention behavior documented without corrected-path guidance |
| https://code.claude.com/docs/en/troubleshooting | N/A (missing section) | No obvious guidance for file-not-found path-correction suggestions |

Total scope: 2 pages affected