Mike MurphyAI Handyman
Subscribe
Back to tutorials

How To Migrate Claude Code From npm to Native Installer

January 30, 2026 ·

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. 1. Open MacOS Terminal

 

    1. 2. Check Claude Code Version (claude –version)

 

    1. 3. Check Binary Location (what/where claude)

 

    1. 4. Migrate Claude Code (claude install)

 

    1. 5. Verify Migration Success (claude doctory)

 

    1. 6. Confirm Settings Preserved

 

    1.             cat ~/.claude/settings.json

 

    1. 7. Remove npm Version

 

    1.            npm uninstall -g @anthropic-ai/claude-code

AI Unplugged · weekly

Newsletter for AI Builders

One practical email with the news, tools, terms, and tutorials worth remembering. Beehiiv sends it; Astro owns the archive.

No spam. Reply-friendly. Easy to leave.