この記事で紹介する3つの対策

① 無駄なコピーを止める設定を入れる（同じデータを何度も保存しないようにする）

② フックを導入しディスクが枯渇する前に Claude Code を自動で止める仕組みを入れる

③ 放っておくとまた溜まるDocker とキャッシュを削除する

用語メモ

フック（hook）とは、「何かをする前に、決めておいた別の処理を差し込む」仕組みのことです。今回は「コマンドを実行する前に、ディスクの空きをチェックする関所（せきしょ）」を置くイメージです。空きが少なければ、その場で通行止めにします。

なぜ自分のPCではなく EC2 を使うのか

自分のPC上で Linux（WSL という機能）を動かすと、その中身はC ドライブの中の仮想ディスクとして保存されます。これは一度大きくなると自動では小さくならないため、PC本体の空き容量をどんどん奪っていきます。それを避けるため、Claude Code を動かす場所は EC2（Amazon Linux 2023）にして、保存領域を EBS 側に分けています。

用語メモ

「No space left on device」…… 直訳すると「デバイスに空き領域がありません」。ディスクが枯渇したときに出るエラーメッセージです。専門的には ENOSPC（イーノースペース）とも呼ばれます。

枯渇したときに起きたこと

• 明け方の時間帯に「No space left on device」というエラーが 543 行も発生
• 時刻合わせやサーバー管理の裏方プログラムが、保存できずに軒並みエラー
• 最終的にサーバーを再起動して、ようやく復旧

用語メモ

キャッシュとは、「一度使ったデータを、次に速く使えるように取っておく一時保存」のことです。便利な反面、放っておくと溜まり続けて容量を圧迫します。

ここが落とし穴

この部品一式は、初期設定のままだと作業フォルダごとに毎回まるごとコピーされます。つまり、作業する場所（フォルダ）が10個あれば、同じ 700MB のデータが10個分＝約7GBもコピーされてしまうのです。中身はほとんど同じです。

2026-08-03  sample-infra/account-a/.terraform            675M
2026-08-04  .../account-b/management/.terraform          709M
2026-08-04  .../account-b/shared-service/.terraform      692M
2026-08-05  .../account-b/connectivity/.terraform        675M
2026-08-05  .../account-b/customers/customer-a/.terraform 692M

$ docker system df

TYPE            TOTAL   ACTIVE   SIZE      RECLAIMABLE
Images          12      2        3.96GB    3.68GB (93%)
Containers      2       2        0B        0B
Local Volumes   3       1        120MB     40MB (33%)
Build Cache     40      0        3.5GB     3.5GB (100%)

表の見方

• TYPE：データの種類（Images＝イメージ、Build Cache＝ビルド中の一時ファイル など）
• SIZE：その種類が今使っている容量
• RECLAIMABLE：そのうち「消しても問題ない量」。上の例ではイメージの 3.68GB（93%）が回収可能＝これが記事の「93%」の正体です

ポイント：docker system df は「見るだけ」で何も削除しない安全なコマンドです。まずこれで現状を確認し、そのうえで対策③の docker system prune で実際に削除する、という順番が安心です。

用語メモ

シンボリックリンク…… ファイルの実体をコピーする代わりに置く「近道の看板」です。看板は容量をほとんど使いません。

ホームディレクトリ（~）…… 自分専用の基点フォルダのこと。コマンドの中の ~ はこの場所を表します。

mkdir -p ~/.terraform.d/plugin-cache
cat >> ~/.terraformrc <<'EOF'
plugin_cache_dir = "$HOME/.terraform.d/plugin-cache"
EOF

上のコマンドの意味

• mkdir -p ...：共有用のフォルダを作る（mkdir は「フォルダを作る」コマンド）
• cat >> ~/.terraformrc ...：Terraform の設定ファイルに「共有フォルダを使ってね」という一行を書き足す

# プロバイダの共有保存先を Terraform に設定する
export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache"

# いまの .terraform フォルダの大きさを確認する
find . -type d -name .terraform -prune -exec du -sh {} \;

# 例：account-a フォルダに移動する
cd ~/sample-infra/account-a

# 古い .terraform を削除する
rm -rf .terraform

# 設定を効かせた状態で作り直す
terraform init

上のコマンドの意味

• cd フォルダ名：そのフォルダに「移動する」コマンド（cd＝change directory）
• rm -rf .terraform：.terraform フォルダを丸ごと削除する
• terraform init：準備をやり直す。今回は設定のおかげでコピーではなくショートカットになる

注意：rm -rf は「確認なしで完全に削除」する強力なコマンドです。移動先のフォルダが合っているか、消すのが .terraform で間違いないかを必ず確かめてから実行してください。

この設定だけで、約 7.6GB 分の無駄が消えます。今回の枯渇の一番の原因だったので、まず最初にやるべき対策です。

#!/usr/bin/env bash
threshold_mb=3000   # 空きがこの数字(MB)を下回ったら止める
avail_mb=$(( $(df --output=avail / | tail -1) / 1024 ))
if [ "$avail_mb" -lt "$threshold_mb" ]; then
  echo "disk-guard: ディスクの空きが ${avail_mb}MB しかありません（下限 ${threshold_mb}MB）。枯渇を防ぐため中断しました。不要なファイルを削除してから再実行してください。" >&2
  exit 2   # 「2」を返すと、この後のコマンドが止まる
fi
exit 0     # 空きが十分なら、そのまま実行を続ける

このスクリプトがやっていること

• いまのディスクの空き容量（MB）を調べる
• 空きが 3000MB（＝3GB）を下回っていたら、警告を出して作業を止める
• 十分に空きがあれば、何もせずそのまま通す

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "bash ~/.claude/hooks/disk-guard.sh" }
        ]
      }
    ]
  }
}

chmod +x ~/.claude/hooks/disk-guard.sh

これで何が起きる？

空きが 3GB を切った状態で Claude Code がコマンドを実行しようとすると、関所で止められ、「空きが足りません」という警告が Claude 側に伝わります。すると Claude は「容量が足りない」と気づき、勝手にディスクを枯渇させてしまう前に手を止めます。止める基準（ここでは 3GB）は、運用に合わせて 3〜5GB くらいで調整してください。

docker system prune -af --volumes

docker system prune は「Docker の不要なゴミをまとめて削除する」コマンドです。使っていないイメージや一時ファイルを削除して、空き容量を取り戻します。

注意：このコマンドは「今使っていないもの」を消します。停止中でも後で使いたいイメージがある場合は消えてしまうので、実行前に本当に不要か確認してください。

この記事の要点

• 対策①：共有設定（TF_PLUGIN_CACHE_DIR）で、無駄なコピー約7.6GBをなくす
• 対策②：フック（安全装置）で、枯渇する直前に作業を自動で止める
• 対策③：Docker やキャッシュを定期的に削除する

df -h /