How to fix npm ERR! No Xcode or CLT version detected! in npm

npmBEGINNERHIGHUpdated Dec 5, 2025· 137 views

This macOS-specific error occurs when node-gyp can't find Xcode Command Line Tools. These tools are required to compile native npm modules on macOS.

Quick fix

Fixes npm ERR! No Xcode or CLT version detected!

sudo xcode-select --reset
  1. Reset xcode-select (try first)
  2. Install Xcode Command Line Tools
  3. Remove and reinstall CLT
  4. Set correct xcode-select path
npm — error
sudo xcode-select --reset
npm ERR! No Xcode or CLT version detected!

What this error means

The "No Xcode or CLT version detected!" error is macOS-specific. node-gyp needs Xcode Command Line Tools (CLT) to compile native modules because CLT provides: - clang/clang++ (C/C++ compilers) - make - Other build utilities This error commonly occurs: - After macOS system updates (which can invalidate CLT) - On fresh macOS installations - When the xcode-select path is misconfigured - After Xcode was uninstalled or moved You don't need the full Xcode app—just the Command Line Tools.

Typical symptoms

  • npm install fails with 'No Xcode or CLT version detected'
  • Error occurs only on macOS
  • gyp ERR! messages precede this error
  • Happens after macOS upgrade
  • Native module packages fail to install

Common causes

  1. Xcode Command Line Tools not installed
  2. CLT installation corrupted after macOS update
  3. xcode-select pointing to invalid path
  4. CLT needs to be reinstalled after OS upgrade
  5. Multiple Xcode versions causing confusion

How to fix "npm ERR! No Xcode or CLT version detected!"

1Reset xcode-select (try first)

Often a simple reset fixes the issue:

bash
sudo xcode-select --reset

Then retry npm install.

2Install Xcode Command Line Tools

Install or reinstall CLT:

bash
xcode-select --install

A dialog will appear. Click "Install" and wait for completion (may take several minutes).

3Remove and reinstall CLT

If CLT is corrupted, do a clean reinstall:

bash
# Check current path
xcode-select --print-path

# Remove existing installation
sudo rm -rf $(xcode-select --print-path)

# Reinstall
xcode-select --install
4Set correct xcode-select path

If you have full Xcode installed, point to it:

bash
# For full Xcode
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

# For CLT only
sudo xcode-select --switch /Library/Developer/CommandLineTools
5Download CLT manually

If the install command fails, download directly from Apple:

1. Go to https://developer.apple.com/download/all/
2. Sign in with Apple ID
3. Search for "Command Line Tools"
4. Download the version matching your macOS
5. Install the downloaded .dmg file

6Verify and retry

Confirm CLT is working:

bash
# Check CLT version
xcode-select --version

# Verify compilers work
clang --version
make --version

# Retry npm install
npm cache clean --force
npm install

Advanced notes

After macOS updates: Major macOS updates (Catalina, Big Sur, Monterey, Ventura, Sonoma) often invalidate CLT. Run xcode-select --install after upgrading macOS.

Full Xcode vs CLT: For npm/node-gyp, you only need Command Line Tools (~1GB), not full Xcode (~12GB). However, if you have Xcode installed, ensure xcode-select points to it or CLT.

Known macOS version issues: Some macOS versions had specific CLT bugs:
- Catalina: Required reinstall after certain updates
- Big Sur: Path issues with /Library/Developer
- Monterey/Ventura: Sometimes needs manual download

License agreement: After CLT install, you may need to accept the license:

bash
sudo xcodebuild -license accept

Frequently asked questions

What does "npm ERR! No Xcode or CLT version detected!" mean?
" error is macOS-specific. node-gyp needs Xcode Command Line Tools (CLT) to compile native modules because CLT provides: - clang/clang++ (C/C++ compilers) - make - Other build utilities This error commonly occurs: - After macOS system updates (which can invalidate CLT) - On fresh macOS installations - When the xcode-select path is misconfigured - After Xcode was uninstalled or moved You don't need the full Xcode app—just the Command Line Tools.
How do I fix "npm ERR! No Xcode or CLT version detected!"?
This macOS-specific error occurs when node-gyp can't find Xcode Command Line Tools. These tools are required to compile native npm modules on macOS.
What causes "npm ERR! No Xcode or CLT version detected!"?
Xcode Command Line Tools not installed CLT installation corrupted after macOS update xcode-select pointing to invalid path
Is the "npm ERR! No Xcode or CLT version detected!" error serious?
Yes. This is a high-severity error that usually blocks work until it is fixed, but the steps above resolve it.

Official resources & further reading