[DOCS] Troubleshooting page recommends deprecated NPM installation method

Resolved 💬 3 comments Opened Jan 26, 2026 by coygeek Closed Feb 1, 2026

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)

View original on GitHub ↗

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