gyp: No Xcode or CLT version detected!
node-gyp on macOS can’t find the Xcode Command Line Tools to compile native modules.
Seen on:
npm
Meaning
macOS updates often remove or invalidate the Command Line Tools.
Common causes
- Command Line Tools missing after a macOS update
- xcode-select pointing to a removed path
⚡ Quick fix
- Reinstall CLT: xcode-select --install
- Reset: sudo xcode-select --reset
- If that fails, remove /Library/Developer/CommandLineTools and reinstall
Detailed fix by platform
iOS
sudo rm -rf /Library/Developer/CommandLineTools && xcode-select --install
How to diagnose
- Path — xcode-select -p
- Recent change — Did it start after a deploy, upgrade, or configuration change? Compare with the last working version.
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
Was this page helpful?
Report a correction or suggest an improvement
Last updated 2 Oct 2026