[DOCS] Troubleshooting page recommends deprecated NPM installation method
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/troubleshooting
Section/Topic
"Installation Issues" section
Current Documentation
The setup page explicitly states NPM is deprecated:
NPM installation is deprecated. We recommend using one of the methods above instead.
However, the troubleshooting page recommends:
Fresh install: Try installing Claude Code fresh: ``bash npm uninstall -g @anthropic-ai/claude-code npm install -g @anthropic-ai/claude-code ``
What's Wrong or Missing?
The troubleshooting page contradicts the setup page:
A. Setup page deprecates NPM
The official installation guide marks NPM as deprecated and recommends other methods.
B. Troubleshooting recommends deprecated NPM
Users experiencing issues are directed to use the deprecated installation method, potentially compounding their problems.
Suggested Improvement
Update the troubleshooting section to use the recommended installation method:
Before:
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
After:
# Remove any existing installation
npm uninstall -g @anthropic-ai/claude-code
# Fresh install using recommended method
curl -fsSL https://claude.ai/install.sh | sh
Or reference the setup page for the current recommended installation methods.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Section | Issue |
|------|---------|-------|
| https://code.claude.com/docs/en/setup | Installation | Correctly marks NPM as deprecated |
| https://code.claude.com/docs/en/troubleshooting | Installation Issues | Recommends deprecated NPM method |
Total scope: 1 page needs update (troubleshooting)
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗