How to Backup & Uninstall Claude Code (Mac & Windows)
Before you wipe your computer or move to a new machine, make sure your Claude Code settings are safe. In this tutorial, I'll walk you through how to take inventory of your current Claude Code setup, create a full backup of your settings and custom skills, and do a clean uninstall on both Mac and Windows.
If you're switching machines, starting fresh, or just want a clean slate before reinstalling, this is the process to follow before you touch anything.
-------------------------------------------------
What You'll Learn:
-------------------------------------------------
How to check your Claude Code version
How to confirm which installer you used (npm or native)
How to view your global config settings and custom skills
What gets removed during uninstall and what stays untouched
How to create a backup folder and copy your entire .claude directory
How to reveal hidden files on Mac to confirm your backup actually worked
How to uninstall Claude Code forthe native installer and the npm installer
How to verify Claude Code has been fully removed from your system
-------------------------------------------------
Key Commands:
-------------------------------------------------
Check version:
claude --version
Check install location (Mac):
which claude
Check install location (Windows):
where claude
View Claude Code settings:
ls -la ~/.claude/
Create backup folder:
mkdir -p ~/claude-backup
Backup all Claude Code data:
cp -R ~/.claude ~/claude-backup/
-------------------------------------------------
🔗 Links Mentioned
-------------------------------------------------
How to Backup & Uninstall Claude Code (Part 1)
• How to Backup & Uninstall Claude Code (Mac...
How to Install Claude Code (Native Installer) (Part 2(:
• How To Install Claude Code On Mac (Native...
How to Restore Claude Code Settings From a Backup (Part 3):
• How to Restore Claude Code Settings From a...
-------------------------------------------------
⏱️ Timestamps
-------------------------------------------------
00:00 Intro: About This Tutorial
00:14 Who Is This For?
00:42 Prepare For Backup
00:56 Check Current Version of Claude Code
01:17 Which (Where) Claude
02:32 Global Config Settings
02:52 What is Removed & What is Not?
03:24 Backup Location
04:29 Backup Al Claude Code Data
05:52 Confirm Backup Worked
07:06 Uninstall (Clean Removal)
08:38 Remove Claude Code
09:27 Verify Removal
-------------------------------------------------
🪜 Step-by-Step
-------------------------------------------------
1. Run claude --version to note your current version
2. Run which claude (Mac) or where claude (Windows) to confirm which installer you used
3. Run ls -la ~/.claude/ to view your global config, history, and custom skills
4. Create a backup folder: mkdir -p ~/claude-backup
5. Copy all Claude Code data: cp -R ~/.claude ~/claude-backup/
6. Open the backup folder in Finder or File Explorer and press Shift +
7. Command + . (Mac) to show hidden files and confirm the .claude folder
8. Run which claude again to confirm your install type, then run the matching uninstall command (native installer or npm)
9. Remove global settings, auth tokens, and cache using the three removal commands (covered at 08:38)
10. Run which claude and claude --version to verify Claude Code has been fully removed
-------------------------------------------------
📦 Resources (may contain affiliate links)
-------------------------------------------------
➜ Gear I Use: https://mikemurphy.co/resources
➜ Hostinger VPS: https://www.hostg.xyz/SHIDN
➜ 1Password: https://1password.partnerlinks.io/mik...
➜ BeeHiiv Newsletters: https://www.beehiiv.com?via=MikeMurphy1
➜ Amazon Influencer Store: https://www.amazon.com/shop/mikemurphyco
-------------------------------------------------
📍 Find Me
-------------------------------------------------
➜ Website: https://mikemurphy.co
➜ AI Unplugged Newsletter: https://aiunplug.io
➜ Podcast: https://mikemurphy.co/mmu
➜ Instagram: / mikeunplugged
➜ X: http://x.com/mikeunplugged
➜ YouTube: https://mikemurphy.co/youtube
------------------------------------------------
Amazon Associates Disclosure: Mike Murphy is a participant in the Amazon Services LLC Associates Program, an affiliate advertising program designed to provide a means for sites to earn advertising fees by advertising and linking to Amazon.com.
------------------------------------------------
#claudecode #claudeai #anthropic #uninstallclaudecode #backupclaudecode #terminal #mac #windows #cli #aitools #developertools #aicoding #techtutor #macos #commandline