How To Migrate Claude Code From npm to Native Installer
January 30, 2026 · Mike Murphy
In this tutorial, I will show you how to migrate your current version of Claude Code installed using the old npm package manger to the new Native Installer Version.
Description
In this tutorial, I will show you how to migrate your current version of Claude Code installed using the old npm package manger to the new Native Installer Version.
Problem:
When you launch Claude Code, you see an Alert Message about switching from npm to native installer.
Fix:
Migrate Claude Code to Native Installer (claude install)
📌 Links:
🔗 Official Claude Code Docs:
https://docs.anthropic.com/en/docs/claude-code/getting-started
What You Will Learn:
- Show Current State of Claude Code
- Run Migration Command (claude install)
- Run Diagnostics (claude doctor)
- Confirm Settings Preserved
- Uninstall Old npm Version
⚡ Migration Command:
claude install
#️⃣ Check Version:
claude –version
🛠️ Check Binary Location:
which claude (Mac)
where claude (Win)
🏥 Verify Installation:
claude doctor
🔎 Verify Settings:
cat ~/.claude/settings.json
🧹 Cleanup:
npm uninstall -g @anthropic-ai/claude-code
🕒 Timestamps:
00:00 Intro: About The Tutorial
00:39 Reason For Alert Message
00:49 Old vs. New Method
01:24 Benefits of Native Installer
01:51 Why Are You Seeing Message?
02:18 What Does Migration Do?
02:49 Purpose of Claude Install
03:24 Preview of Migration Steps
03:49 Check Version & Binary Location
04:31 Migrate (Claude Install)
05:19 Claude Doctor
05:45 Check Version & Location
06:07 Confirm Settings
06:21 Remove Old npm Package
07:37 Launch Claude Code
🪜What You Will Learn:
-
- 1. Open MacOS Terminal
-
- 2. Check Claude Code Version (claude –version)
-
- 3. Check Binary Location (what/where claude)
-
- 4. Migrate Claude Code (claude install)
-
- 5. Verify Migration Success (claude doctory)
-
- 6. Confirm Settings Preserved
-
-
cat ~/.claude/settings.json
-
-
- 7. Remove npm Version
-
-
npm uninstall -g @anthropic-ai/claude-code
-