SuperClaude アンインストール｜設定ファイルも残さず削除
「SuperClaude を試したけれど元の素の Claude Code に戻したい」「pip uninstall しただけで本当に全部消えたのか不安」——そんなときに必要なのが、正しいアンインストール手順です。SuperClaude は単独のアプリではなく、Python パッケージ本体と ~/.claude/ 配下の設定ファイル群という 2 層構造になっているため、片方だけ消すと中途半端な状態が残ります。本記事では、公式インストールガイドに沿って安全に消し切る方法を解説します。
出典: SuperClaude_Framework(GitHub 公式リポジトリ) / Installation Guide
目次 (9)
アンインストールの前に: SuperClaude は「2 層」でできている
SuperClaude を確実に消すには、まず構造を理解しておく必要があります。SuperClaude は次の 2 つの層から成り立っています。
- Python パッケージ本体:
pipやpipx、npmでインストールされたSuperClaude本体。インストーラーや CLI コマンドの実体です。 - 設定ファイル群:
~/.claude/ディレクトリに配置される振る舞い指示やコマンド定義。SuperClaude installを実行したときに展開されます。
つまり、pip uninstall でパッケージだけ消しても、~/.claude/ 配下の設定は残ったままになります。逆に設定ファイルだけ手で消しても、パッケージ本体は環境に残ります。両方を正しい順番で外すことが、消し残しを防ぐポイントです。
なお、現時点の安定版は v4.3.0(2026 年 3 月 22 日リリース)です。バージョンによって CLI の細かい挙動が変わることがあるため、迷ったら必ず公式リポジトリの記載を正としてください。
基本のアンインストール: 2 ステップで消す
公式インストールガイドが案内する完全削除は、次の 2 ステップです。順番が重要で、先に SuperClaude 側のクリーンアップを走らせてから、最後にパッケージ本体を消します。
- SuperClaude のアンインストーラーを実行し、
~/.claude/に展開された設定ファイルを取り除く:SuperClaude uninstall - Python パッケージ本体を削除する:
pip uninstall SuperClaude
この順序が大切な理由は、SuperClaude uninstall コマンドが「自分がインストール時に配置した設定ファイル」を把握して外してくれるからです。先にパッケージ本体を消してしまうと、このクリーンアップを実行する CLI 自体が無くなり、設定ファイルだけが取り残されてしまいます。
出典: Installation Guide(Uninstall セクション)
pipx / npm で入れた場合の削除コマンド
SuperClaude は複数の方法でインストールできるため、アンインストールも 入れたときと同じパッケージマネージャで行うのが基本です。SuperClaude uninstall を先に実行する点は共通で、最後のパッケージ削除コマンドだけが入れ方によって変わります。
- pip で入れた場合:
SuperClaude uninstallを実行後、pip uninstall SuperClaude - pipx で入れた場合:
SuperClaude uninstallを実行後、pipx uninstall SuperClaude - npm で入れた場合:
SuperClaude uninstallを実行後、npm uninstall -g @bifrost_inc/superclaude(グローバル導入を消す-gを付ける)
npm のパッケージ名は配布の都合で変わることがあります。npm uninstall でエラーになる場合は、npm list -g で実際に入っている SuperClaude 系パッケージ名を確認してから、その名前を指定してください。pipx の場合も同様に、pipx list で導入名を確認できます。
消したあとに ~/.claude/ へ残るものを確認する
SuperClaude uninstall は基本的に自分が配置したファイルを片付けますが、「本当に消えたか」を自分の目で確かめておくと安心です。公式ガイドによれば、SuperClaude は ~/.claude/ に以下のようなファイルを置きます。
- フレームワーク本体のファイル群(合計でおよそ 50MB)
~/.claude/CLAUDE.md(メインの入り口となる指示ファイル、約 2KB)- 振る舞い指示ファイル群(約 200KB)
~/.claude/claude-code-settings.json(MCP サーバー連携の設定、約 5KB)
アンインストール後にこれらが残っていないか、~/.claude/ の中身を ls -la ~/.claude/ などで確認してください。もし SuperClaude 由来のファイルが明らかに残っている場合は、後述のトラブル対処を参照します。
次の注意点が最重要: ~/.claude/ を丸ごと消さない
ここが一番ハマりやすく、かつ取り返しがつかない落とし穴です。~/.claude/ は SuperClaude 専用のフォルダではなく、Claude Code 本体も使う共有ディレクトリです。あなた自身が書いた CLAUDE.md のメモや、Claude Code の各種設定もこの中に入っています。
そのため、「設定ファイルを残さず消したいから」と rm -rf ~/.claude/ のようにディレクトリごと削除してしまうと、SuperClaude だけでなく Claude Code 本体の個人設定まで消えてしまいます。これが、わざわざ SuperClaude uninstall コマンドが用意されている理由です。アンインストーラーは「SuperClaude が追加した分」だけを選んで外してくれるので、共有ディレクトリを巻き込まずに済みます。
どうしても手作業で消したい場合でも、ディレクトリ全消しは避け、SuperClaude が生成したファイルだけを個別に削除してください。判断に迷うファイルは消さずに残しておくのが安全です。
念のため: 消す前にバックアップを取る
「設定を作り込んだので、消す前に保険をかけておきたい」という場合は、アンインストール前にバックアップを取得できます。SuperClaude には backup 用のコマンドが用意されています。
- 現在の状態をバックアップする:
SuperClaude backup --create - 必要になったら復元する:
SuperClaude backup --restore [ファイル]
--create で作成したバックアップファイルを保管しておけば、アンインストール後に「やっぱり戻したい」となっても、--restore で設定を呼び戻せます。本格的に環境を入れ替える前のひと手間として覚えておくと安心です。
出典: Installation Guide(Backup セクション)
アンインストールがうまくいかないときの対処
手順どおりに進めても、状況によってはエラーや消し残しが起きることがあります。代表的なつまずきと対処を整理します。
SuperClaude: command not foundと出る:先にパッケージ本体を消してしまったケースが多いです。この場合は一度pip install SuperClaude(または pipx)で本体を入れ直し、SuperClaude uninstallを実行してから、改めてパッケージを削除します。~/.claude/に SuperClaude 由来のファイルが残る:SuperClaude uninstallを再実行します。それでも残る場合は、上記「残るものを確認する」のリストを参照し、SuperClaude が置いたファイルだけを個別に削除します。共有ディレクトリ全消しは禁物です。- 権限エラーで消せない:
pipxやnpm -gでグローバル導入した場合、環境によっては実行権限が必要です。利用環境のパッケージマネージャの作法に従って権限を確認してください。 - どの方法で入れたか分からない:
pip show SuperClaude/pipx list/npm list -gをそれぞれ実行し、ヒットしたパッケージマネージャでアンインストールします。
切り分けの基本は、「まず SuperClaude uninstall で設定を片付け、次に本体を消す」という順序を崩さないことです。
アンインストール後に再インストールしたくなったら
一度消したあと、やはりもう一度使いたくなった場合は、通常のインストール手順に戻るだけで再導入できます。pipx を使う場合は pipx install SuperClaude で本体を入れ、SuperClaude install でコンポーネントを配置し直します。バックアップを取っていれば、SuperClaude backup --restore で以前の設定を復元することも可能です。
「全部消すのではなく一部だけ整理したい」という場合は、インストール時に SuperClaude install --components core mcp modes のようにコンポーネントを指定できる仕組みがあります。アンインストール時の細かいオプションが必要なときは、SuperClaude uninstall --help を実行して、その時点で利用できる選択肢を確認してください。
まとめ
SuperClaude のアンインストールは、「SuperClaude uninstall で設定を片付けてから、pip(または pipx / npm)でパッケージ本体を消す」という 2 ステップが基本です。最大の注意点は、~/.claude/ が Claude Code 本体と共有のディレクトリであるため、rm -rf で丸ごと消してはいけないこと。専用の SuperClaude uninstall コマンドを使えば、追加した分だけを安全に取り除けます。消す前に SuperClaude backup --create でバックアップを取っておけば、いつでも元に戻せるので安心です。CLI の細かい挙動はバージョンで変わることがあるため、最終的な手順は公式リポジトリで確認してください。
