[DOCS] Claude Code attachments docs missing size limits (100 pages, 20MB)

Resolved 💬 2 comments Opened Feb 4, 2026 by coygeek Closed Mar 5, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/vs-code

Section/Topic

Use the prompt box / Reference files and folders (attachments guidance)

Current Documentation

The docs mention attaching files but do not state any limits. For example:

Options include attaching files, switching models, toggling extended thinking

What's Wrong or Missing?

Claude Code now surfaces the actual limits for PDF/request size errors (100 pages, 20MB) in its error messaging, but the documentation never states these limits. Users only learn about limits after a failure and lack guidance on how to avoid it.

Suggested Improvement

Add a short "Attachment limits" note near the attachment guidance on both the VS Code and IDE integrations pages. Suggested content:

  • PDF limit: 100 pages per attachment
  • Request size limit: 20MB total request size
  • If a PDF exceeds these limits, split it or attach fewer pages/files

If there is (or should be) a central attachments/file-input page, put the limits there and link to it from these pages.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
| --- | --- | --- |
| https://code.claude.com/docs/en/vs-code | 85, 101 | Command menu mentions attaching files; drag-and-drop attachments note |
| https://code.claude.com/docs/en/ide-integrations | 108, 122 | Command menu mentions attaching files; drag-and-drop attachments note |

Total scope: 2 pages affected

Source: Changelog v2.1.31

Changelog entry: "Improved PDF and request size error messages to show actual limits (100 pages, 20MB)"

View original on GitHub ↗

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