メインコンテンツへスキップ
見出し画像

【AI開発環境の落とし穴】Macの空き容量が激減・・・ 2.5GiB→120.64GiBに回復するまでに調べたこと

    こんにちは!YURIYです。

    最近、Claude Codeを使った個人開発にどハマりしています!

    Webアプリ、iPhoneアプリ、Macアプリ、ゲームなど、思いついたものをいろいろ作っています。しかも、Claude Codeのセッションを複数起動して、あちらでは実装、こちらではテスト、その間に別のアプリのレビュー・・・という具合に、かなりの並行開発をしています。

    そんな生活を続けていたところ、Macのストレージが大変なことになっていました。

    空き容量、2.5GiB。

    ・・・えっ?

    私のMacは約1TBのストレージを搭載しているのですが、いつの間にかほとんど使い切っていました。

    さすがにこのままでは開発できなくなってしまう!なので、Claude Codeと一緒に大掃除を始めることにしました。

    ところが、最初の掃除で約80GiBまで回復したのに、数日後には再び28GiBに。

    何がそんなに容量を使っているのでしょうか?

    最終的には、2回にわたる大掃除と19ステージの追加調査を経て、空き容量を120.64GiBまで回復できました!

    今回は、何が起きていたのか、どんな原因が見つかったのか、そして、どうやって解決したのかをまとめてみます。

    まずは、容量を使っている場所を調べてみる

    最初にやったのは、Macのどこで容量を使っているのかを調べることです。

    ターミナルでディレクトリごとのサイズを調べると、開発関係のファイルがかなりの割合を占めていました。

    例えば、調査時点で見つかったものには次のようなものがあります。

    • 開発ビルド:約85GB

    • iOSシミュレータ:約75GB

    • node_modules:約27GB

    • 音源関連:約63GB

    ※集計範囲が重複する項目もあるため、合計値ではありません。

    私はReactやTypeScriptを使ったWebアプリだけでなく、iOSアプリも開発しています。そのため、Xcode、CocoaPods、Rust、Node.js、Playwrightなど、さまざまな開発環境が共存しています。

    これらが少しずつ容量を使っているのは理解できますが・・・それにしても多いよ!

    というわけで、さらに詳しく調べていきます。

    Chromeが677GB?!と思ったら・・・

    調査中、特に驚いたのがChromeのコピーでした。

    code_sign_clone という名前のディレクトリが大量に作られていて、調査したタイミングによっては、見かけ上の合計サイズが数百GBに達していました。

    最大で約677GBという数字まで出てきたのです。

    いやいや、Chromeだけでそんなに使っているんですか!?

    ・・・と思ったのですが、実はここにはmacOSのファイルシステムであるAPFSの仕組みが関係していました。

    APFSのクローンという仕組み

    APFSには、ファイルをコピーするときに、変更されていないデータを共有する仕組みがあります。

    例えば、1GBのファイルをコピーしたからといって、必ずしも新たに1GBの物理容量が必要になるわけではありません。

    そのため、Chromeのアプリ本体が大量に複製されていても、見かけのサイズほどディスク容量を消費していないことがあります。

    実際、これらのコピーを整理しても、数百GBがそのまま回復したわけではありませんでした。

    ここでひとつ勉強になりました。

    ディレクトリの見かけのサイズと、削除したときに実際に回復する容量は違うことがある!

    とはいえ、Chromeのコピーが大量に作られていること自体は気になります。

    この原因については、後で詳しく調べることになりました。

    1回目の大掃除で、約80GiBまで回復!

    最初の大掃除では、不要になったChromeのコピーやキャッシュ、開発時の一時ファイルなどを整理しました。

    npmやHomebrewのキャッシュ、古いビルド成果物、テスト用のファイルなど、いろいろな場所から削除候補が出てきます。

    ただし、ここで気をつけたのが、大きいディレクトリを片っ端から削除しないことです。

    例えば、開発用のディレクトリには、再生成できるキャッシュだけでなく、Gitにコミットしていない作業ファイルや、検証用に作った成果物が含まれていることがあります。

    そこで、Claude Codeには次のような方針で作業してもらいました。

    • まず削除候補を調査する

    • 使用中のプロセスやセッションを確認する

    • 再生成可能なものと、固有のデータを区別する

    • 削除する対象は個別に承認する

    これを繰り返した結果、空き容量は約80GiBまで回復しました!

    これでひと安心。

    ・・・のはずだったのですが・・・。

    数日後、80GiBあった空き容量が28GiBに

    なんと、せっかく増やした空き容量が再び減っていました。

    約80GiB → 約28GiB。

    およそ52GiBの減少です。

    しかも、調査したところ、約2日間でこれだけ減っていたようです。

    1日あたり約26GiB!

    さすがにこれは、不要ファイルが昔から溜まっていただけでは説明できません。

    どうやら、今も何かが大量のファイルを作り続けているようです。

    そこで2回目の大掃除では、単に不要ファイルを探すだけでなく、なぜ容量が増えているのかを調べることにしました。

    原因その1:E2Eテストの一時ファイルが残り続けていた

    まず見つかったのが、E2Eテストの一時ファイルです。

    私はPlaywrightなどを使って、アプリの画面操作を自動テストしています。Claude Codeに開発を依頼すると、実装後にテストを実行してもらうことも多いです。

    ところが、一部のテストでは、終了後の後片付けが十分に行われていませんでした。

    調査では、1プロジェクトあたり数百件といった規模で、テストの実行ごとに作られたファイルが、そのまま残っていたのです。

    さらに、別の調査では、E2Eテスト用のChromeプロファイル236件で約16.1GB、性能測定用の一時ファイル42件で約4.5GB・・・なども確認されました。

    テストが成功しても、後片付けが成功したとは限らない

    これが今回の大きな発見でした。

    テスト結果がすべて成功していても、一時ファイルが残っていることはあります。しかも、テストを繰り返せば繰り返すほど、その残骸も増えていきます。

    そこで、テスト終了時に一時ディレクトリを片付ける処理を追加しました。

    Playwrightであれば、例えば次のような処理が考えられます。

    test.afterAll(async () => {
      await fs.rm(tmpDir, {
        recursive: true,
        force: true,
      });
    });

    これはあくまで基本的な例で、実際にはテストが失敗した場合や、途中で中断された場合にも対応する必要があります。

    今回の修正では、終了方法の違いも考慮しながら、後片付けが行われるようにしました。

    テストの成功だけでなく、テスト後の環境がどうなっているかも確認しないといけないんですね・・・。

    原因その2:Claude Codeの作業用ディレクトリが巨大化していた

    次に見つかったのが、Claude Codeの作業用ディレクトリです。

    私は複数のClaude Codeセッションを並行して動かしています。それぞれが別のアプリをビルドしたり、スクリーンショットを撮ったり、検証用のデータベースを作ったりするので、当然ながら作業用ファイルも増えます。

    調査時点では、Claude関連の一時領域が約37GBあり、2日間で約18.7GB増加していました。中には、ひとつのセッションの作業領域だけで約24GB使っているものもありました!

    ただし、ここで重要なのが、これらは単なるチャットの履歴ではないということです。

    実際には、ビルド成果物、テスト用データ、画像、ログ、データベースなどが含まれていました。

    古い作業フォルダだからといって消せない

    さらに調べると、終了済みのClaude Codeセッションの作業フォルダにも、固有の制作物が残っていました。

    例えば、音楽制作のWAVファイルやプロジェクトファイル、ゲームの比較用アプリ、検証用のスクリーンショットなどです。

    こうしたものは、削除してしまうと元に戻せない可能性があります。

    そのため、古い作業フォルダ4つ、合計約6.5GiBは、最終的にも削除せずに保留しました。

    AIの作業用ディレクトリだからといって、全部が不要なファイルとは限らない。これは、AIを使って開発する際に意識しておきたいところです。

    原因その3:Xcodeのビルド成果物が大量にあった

    iPhoneアプリの開発では、Xcodeがさまざまな中間生成物を作ります。

    今回の調査では、Releaseビルドの出力が20か所あり、合計約11.22GBになっていました。

    内訳は次のとおりです。

    • 容量アプリ本体:約1.33GB

    • dSYM:約2.03GB

    • その他のビルド生成物:約7.87GB

    この中で、アプリ本体やdSYMは残しておきたいものです。

    特にdSYMは、アプリのクラッシュログを解析するときに使います。

    今回調べた20個のdSYMは、それぞれ異なるUUIDを持っていました。同じアプリ名、同じバージョンでも、ビルドが異なればdSYMも異なる場合があります。

    そのため、今回はdSYMを削除せず、再生成できる中間生成物だけを整理しました。

    Intermediates.noindexを整理する

    例えば、Xcodeのビルドディレクトリには、次のような場所があります。

    Build/
    ├── Products/
    └── Intermediates.noindex/

    Products にはアプリやフレームワークなどの成果物が含まれます。一方、Intermediates.noindex には、コンパイル途中のファイルなどが保存されています。

    今回の調査では、対象の中身が再生成可能なものだけであることを確認してから削除しました。

    PodsのRelease中間生成物8件を整理して約2.93GiB、さらに別の2か所の Intermediates.noindex を整理して約1.29GiB回復しています。

    削除後には、アプリ本体やdSYMが残っていること、UUIDが変わっていないことも確認しました。

    ビルド成果物を全部消すのではなく、残したいものと再生成できるものを分ける。

    この方法なら、必要なデータを守りながら容量を整理できます。

    原因その4:Chromeの起動処理と一時ファイルの片付け

    最初の大掃除で見つかったChromeの大量コピーについても、原因が分かってきました。

    一部の開発用スクリプトでは、Chromeを起動するときにアプリのコピーや一時プロファイルが作られ、それらが残ってしまうことがありました。

    特に、私が開発しているdoll-storageというアプリ(家に大量にあるリカちゃんやドール服等を管理するアプリです♡)では、Chromeを使った自動操作による検証を繰り返していました。

    そこで、Chromeの起動処理を共通化し、一時プロファイルを片付ける仕組みを整えました。

    また、Chromeのアプリコピーが増えないよう、起動時に次のオプションを指定するようにしました。

    --disable-features=MacAppCodeSignClone

    さらに、Swiftの検証プログラムにも問題が見つかりました。

    終了時の後片付けを defer に任せていたのですが、途中で exit() を呼んでいたため、期待した後片付けが実行されない構造になっていたのです。

    これも修正し、正常終了、失敗、Ctrl-C、強制終了などのケースで確認しました。

    シェル全体が強制終了されると片付けが実行できない場合もあるため、次回起動時に古い一時フォルダを整理する仕組みも追加しています。

    修正後の確認では、Chromeのコピーは48個から増えず、テスト用の一時ディレクトリも0個になっていました。

    ようやく、削除してもまた増えてしまう問題への対策ができたわけです。

    そのほかにも、いろいろ整理しました

    ここまで紹介したもの以外にも、かなりの数のファイルを調査しました。

    iOSシミュレータ

    シミュレータには、アプリのデータや設定が保存されている場合があります。

    そのため、必要なデータをバックアップし、SHA-256で整合性を確認してから初期化しました。

    あるiPhone 15 Proシミュレータでは、約3.3GiBあったデータ領域が、初期化後には約17MBになりました。

    Downloads

    Downloadsには、約31.9GiBのファイルがありました。

    古いインストーラやZIP、モデルファイルなどを調べ、不要と確認できたものを個別に削除しました。

    一方で、写真や動画、購入したソフトウェアのインストーラなどは慎重に扱いました。

    同じファイル名でも中身が違うことがありますし、クラウド上に同じ名前のファイルがあるだけでは、安全なバックアップとは限りません。

    Rustのtarget

    Rustでは、ビルド時に target ディレクトリが大きくなることがあります。

    今回も複数のプロジェクトで容量を使っていたため、使用中のビルドや必要な成果物を確認しながら、再生成可能な中間生成物を整理しました。

    2回目の大掃除は19ステージに分けて実施!

    今回の作業は、一度に大量のファイルを削除する方法では進めませんでした。

    調査し、候補を確認し、削除対象を承認してから実行する。

    その結果を確認して、次のステージに進む。この繰り返しです。

    途中の空き容量をまとめると、次のようになりました。

    • 最初の大掃除開始:2.5GiB

    • 最初の大掃除後:約80GiB

    • 数日後の再調査:約28GiB

    • 追加整理の途中:95.87GiB

    • その後も段階的に整理を行い・・・ステージ19でようやく:120.64GiB!

    途中で別の開発セッションが動いていたため、削除したファイルの容量と空き容量の増加量は必ずしも一致しません。

    それでも、最終的には最初の2.5GiBから118.14GiBの回復となりました!

    今後のために、ストレージ監視ツールも作りました

    ここまで整理しても、また同じことが起きたら困ります。

    そこで、容量の変化を継続的に確認するための StorageMonitor というツールも作りました。

    このツールは、30分ごとにストレージの状態を記録します。

    例えば、次のような状態を検知します。

    • 空き容量が50GiB未満になった

    • 24時間で20GiB以上減った

    • 1時間で5GiB以上減った

    • Rustの target が大きくなった

    • 特定のディレクトリが急速に肥大化した

    直近24時間の容量変化は、次のコマンドで確認できます。

    /usr/bin/python3 -I ~/StorageMonitor/storage_monitor.py report

    このツールは監視専用で、勝手にファイルを削除することはありません。

    今後は、容量が減ったときに、どのディレクトリが増えたのかを調べやすくなりました。

    まとめ:AI開発では、作ったものの後片付けも大切!

    今回の大掃除で、特に印象に残ったことは3つあります。

    1. テストが成功していても、一時ファイルが残っていることがある

    E2Eテストや自動検証では、Chromeのプロファイルや一時ディレクトリが作られます。テストの成否だけでなく、終了後にそれらが片付いているかも確認する必要があります。

    2. 大きいディレクトリをそのまま削除するのは危険

    APFSのクローンのように、見かけのサイズと実際の使用量が違うものがあります。また、古い作業フォルダにも固有の制作物が残っていることがあります。

    容量だけで判断せず、中身を確認することが大切でした。

    3. 一度掃除するだけでは、また容量が減ることがある

    最初に約80GiBまで回復したのに、数日後には28GiBまで減っていました。

    そこで、不要ファイルの削除だけでなく、テストの後片付けやChromeの起動処理など、ファイルが増える原因そのものを修正しました。

    今回の最終結果は、2.5GiB → 120.64GiB!

    約48倍の空き容量になりました。

    Claude Codeを使った開発はとても便利ですが、コードを書くだけでなく、テスト、ビルド、スクリーンショットの取得、ログの保存など、さまざまな作業が自動化されます。

    その分、開発環境の中では、知らないうちに大量のファイルが作られていることもあるようです。

    AIに開発を任せるなら、成果物だけでなく、その過程で作られたファイルの管理も考える必要があると感じました。

    それにしても、AIにアプリを作ってもらっていたらMacの容量がなくなり、今度はAIと一緒にその原因を調べて修正することになるとは・・・。なかなか大変な経験でした。

    これからもいろいろなアプリを作っていきたいので、ストレージ監視ツールにはしっかり働いてもらおうと思います!

    ではでは、みなさまも良いAI開発ライフを〜!

     
     

    YURIY

     
     
    ソフトウェアやアプリケーションの企画・開発を行っています。 このnoteでは、制作しているアプリの紹介をはじめ、設計や実装に関する技術的な取り組み、開発の過程、リリース情報などを掲載します。

    あなたへのおすすめ