Claude Code アンインストール方法｜完全削除の手順とトラブル解決

Claude Codeをアンインストールする必要がある場合、正しい手順で削除しないと設定ファイルが残ってしまうことがあります。この記事では、Claude Codeを完全に削除する方法を解説します。

アンインストールが必要なケース

• 別のバージョンをクリーンインストールしたい
• ストレージ容量を確保したい
• 設定をリセットして最初からやり直したい
• トラブルシューティングのため

アンインストール方法（OS別）

macOS

npmでインストールした場合

# Claude Codeをアンインストール
npm uninstall -g @anthropic-ai/claude-code

# 正常に削除されたか確認
claude --version
# "command not found" と表示されればOK

Homebrewでインストールした場合

# Claude Codeをアンインストール
brew uninstall claude-code

# 確認
claude --version

Windows

PowerShell（管理者として実行）

# Claude Codeをアンインストール
npm uninstall -g @anthropic-ai/claude-code

# 確認
claude --version

WSL（Windows Subsystem for Linux）

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

Linux（Ubuntu/Debian）

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

設定ファイルの削除（完全削除）

npmコマンドでアンインストールしただけでは、設定ファイルは残ります。完全に削除するには以下も実行してください。

設定ファイルの場所

macOS / Linux

# 設定フォルダを削除
rm -rf ~/.claude

# Claude関連のキャッシュも削除（任意）
rm -rf ~/.cache/claude-code

Windows（PowerShell）

# 設定フォルダを削除
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"

# キャッシュも削除（任意）
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\claude-code"

削除されるもの一覧

npmアンインストールで削除されるもの

• Claude Code 実行ファイル
• 依存パッケージ

手動削除が必要なもの

バックアップを取ってから削除

設定を保存しておきたい場合は、削除前にバックアップを取りましょう。

設定のバックアップ

# バックアップフォルダを作成
mkdir -p ~/claude-backup

# 設定をコピー
cp -r ~/.claude ~/claude-backup/

# 日付を付けてバックアップ
tar -czvf ~/claude-backup-$(date +%Y%m%d).tar.gz ~/.claude

バックアップから復元

# 解凍して復元
tar -xzvf ~/claude-backup-20250201.tar.gz -C ~/

完全削除の確認

以下のコマンドで完全に削除されたか確認できます。

実行ファイルの確認

# コマンドが見つからなければOK
which claude
# または
command -v claude

設定ファイルの確認

# フォルダが存在しなければOK
ls -la ~/.claude

npmパッケージの確認

# パッケージが一覧に表示されなければOK
npm list -g | grep claude

VSCode拡張機能の削除

VSCodeでClaude Code拡張機能を使用している場合：

GUIから削除

1. VSCodeを開く
2. 拡張機能パネル（Ctrl+Shift+X / Cmd+Shift+X）
3. 「Claude」で検索
4. 「アンインストール」をクリック

コマンドから削除

code --uninstall-extension anthropic.claude-code

再インストール方法

クリーンな状態で再インストールする場合：

ステップ1: 完全削除

# アンインストール
npm uninstall -g @anthropic-ai/claude-code

# 設定削除
rm -rf ~/.claude

ステップ2: npmキャッシュをクリア

npm cache clean --force

ステップ3: 再インストール

npm install -g @anthropic-ai/claude-code

ステップ4: 初期設定

claude
# 画面の指示に従ってログイン

トラブルシューティング

「permission denied」エラー

# 権限を修正
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# 再度アンインストール
npm uninstall -g @anthropic-ai/claude-code

アンインストール後もコマンドが使える

シェルのキャッシュが残っている可能性があります。

# bashの場合
hash -r

# zshの場合
rehash

# ターミナルを再起動

複数のインストールがある場合

# インストール場所を確認
which -a claude

# 全ての場所を削除
# 例：
sudo rm /usr/local/bin/claude
rm ~/bin/claude

設定ファイルが削除できない

# 権限を確認
ls -la ~/.claude

# 必要に応じて権限を変更
chmod -R u+rw ~/.claude

# 削除
rm -rf ~/.claude

プロジェクト内のClaude関連ファイル

プロジェクトディレクトリ内にもClaude Code関連のファイルが作成されている場合があります。

確認方法

# プロジェクトディレクトリで
ls -la .claude
cat CLAUDE.md

削除（必要な場合）

# プロジェクトディレクトリで
rm -rf .claude
rm CLAUDE.md
rm .claudeignore

よくある質問

Q: アンインストールしたらデータは消えますか？

A: npmアンインストールでは設定ファイルは残ります。~/.claude/ を手動で削除しない限り、会話履歴やメモリは保持されます。

Q: 課金は止まりますか？

A: Claude Codeをアンインストールしても、Claudeのサブスクリプションは自動的には解約されません。解約はClaudeのアカウント設定から行ってください。

Q: 一部の設定だけ残せますか？

A: はい。~/.claude/ 内の特定のファイルだけを削除することで、必要な設定を残せます。例えば、CLAUDE.md だけを残してほかを削除することも可能です。

Q: アンインストール後、別のPCで使えますか？

A: Claude Codeはローカルにインストールするツールなので、PCごとにインストールが必要です。ただし、同じアカウントでログインすれば、プランは引き継がれます。

まとめ

Claude Codeのアンインストール手順：

注意点：

• バックアップ: 重要な設定がある場合は先にバックアップ
• VSCode: 拡張機能も別途アンインストール
• サブスク: 課金の解約は別途必要

再インストールする場合は、キャッシュをクリアしてから実行するとトラブルが少なくなります。

参考リンク

• Claude Code 公式ドキュメント
• npm uninstall コマンド
• Claude アカウント設定