macos-disk-cleanup について
macOS Disk Cleanupは、macOSのディスク使用量を測定し、不要ファイルを整理する手順型スキルです。再生成できる項目と個別承認が必要なデータを分け、削減量も確認します。
主な機能
- 01ディスクとディレクトリ使用量の測定
- 02削除候補をリスク別に分類
- 03安全なクリーンアップコマンドの実行
- 04重要データの削除前に承認を取得
- 05実行前後の使用量を比較
活用シーン
- 01Macの容量を占めるディレクトリの特定
- 02再生成可能な開発キャッシュの削除
- 03アプリデータ削除前の確認
- 04クリーンアップ結果とスナップショットの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/macos-disk-cleanupを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/paths.md
詳細
macOS のディスククリーンアップ
削除する前に測定し、安全に削除できるものから優先して処理し、ローカルにしか存在しない状態を保持するものはすべて事前確認必須として扱います。再ダウンロードできないため、ユーザーから明示的な許可を得る必要があります。
手順
- 最上位とホームディレクトリの使用量を測定します。
- ユーザーが所有するディレクトリのうち、最も容量の大きいものを詳しく調べます。
- 候補をすべて、すぐに削除できるものと事前確認必須のものに分類し、2つのグループに分けて提示します。
- すぐに削除できるものを実行し、事前確認必須のものは削除するたびに許可を求めます。
- 再測定し、差分を報告します。
完了条件は、約1Gを超える容量を使用している項目がすべて分類され、事前確認必須の削除がそれぞれ個別に承認され、実行前後の df -h / で実際に解放された容量が示されていることです。
測定
# 1. Top-level
du -sh /System /Users /private /Applications /Library 2>/dev/null | sort -rh
# 2. Home breakdown
du -sh ~/Library ~/Code ~/Downloads 2>/dev/null | sort -rh
# 3. Library breakdown
du -sh ~/Library/Application\ Support/* ~/Library/Caches/* ~/Library/Group\ Containers/* 2>/dev/null | sort -rh | head -20
ユーザーのプロフィールに応じて、詳しく調べる項目を絞り込みます。
| プロフィール | 最初に確認する項目 | 一般的な削減量 |
|---|---|---|
| 開発者 | Homebrew、uv/npm/pip、DerivedData、シミュレーター | 10–20G |
| AI/ML ユーザー | Ollama の未使用モデル、HuggingFace、LM Studio | 5–15G |
| Chrome を多用するユーザー | OptGuideOnDeviceModel、GoogleUpdater | 約5G |
すぐに削除できるもの
以下はすべて、必要に応じて再構築または再ダウンロードされます。確認せずに実行してください。
| コマンド | 解放される容量 | 備考 |
|---|---|---|
brew cleanup --prune=all | 2–10G | インストーラーのキャッシュ |
uv cache clean --force | 1–10G | uv のパッケージキャッシュ |
npm cache clean --force | 500M–2G | npm のキャッシュ |
pip3 cache purge | 100–500M | pip のキャッシュ |
pre-commit clean | 200–500M | pre-commit の環境 |
rm -rf ~/Library/Developer/Xcode/DerivedData | 500M–5G | 必要に応じて再構築されます |
xcrun simctl delete unavailable | 1–10G | 未使用の iOS シミュレーター |
パスのカタログ
Chrome、AI モデルのキャッシュ、開発ツールのキャッシュ、および事前確認必須のアプリデータについて、パスごとの判定を確認するには、上記の「すぐに削除できるもの」以外の削除を提案する前に references/paths.md をお読みください。
クリーンアップ後
APFS のローカルスナップショットが解放されたブロックを保持しているため、df -h / の表示には遅れが生じます。tmutil listlocalsnapshots / を確認し、スナップショットは約24時間以内に自動的に縮小されるとユーザーに伝えてください。内部ではすでに数値は正しいため、次に行うべきことは再度クリーンアップするのではなく、待つことです。