[DOCS] Setup and system requirements docs omit Linux glibc compatibility floor clarified by v2.1.73 fix

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/setup

Section/Topic

Linux native-build compatibility and minimum glibc guidance in system requirements and troubleshooting.

Current Documentation

System requirements currently list Linux distributions (for example Ubuntu/Debian/Alpine) and an Alpine musl note, but do not document a glibc version requirement or compatibility caveat for older enterprise distros.

Troubleshooting covers musl/glibc mismatch detection, but does not provide a clear compatibility statement for older glibc baselines such as Amazon Linux 2 (glibc 2.26).

What's Wrong or Missing?

Changelog v2.1.73 explicitly fixes native module loading on Amazon Linux 2 and other glibc 2.26 systems, which indicates this compatibility boundary matters operationally.

Docs currently do not describe supported glibc baselines or compatibility expectations for older Linux environments, leaving admins without clear guidance when planning deployments on enterprise fleets.

Suggested Improvement

Add a Linux compatibility subsection that includes:

• Explicit glibc compatibility statement (including Amazon Linux 2 / glibc 2.26)
• Clear distinction between musl-specific requirements and glibc compatibility
• Recommended verification command(s) to check libc version before deployment
• Cross-link from Setup system requirements to relevant troubleshooting section

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/setup | System requirements should include explicit Linux/glibc compatibility guidance |
| https://code.claude.com/docs/en/troubleshooting | Linux compatibility troubleshooting should reference supported glibc baselines |

Total scope: 2 pages affected

Source: Changelog v2.1.73

Exact changelog entry:

Fixed Linux native modules not loading on Amazon Linux 2 and other glibc 2.26 systems