Claude Codeのログが22MBに膨れた ― launchdで夜間自動トリムする

「Claude Code環境」シリーズの続きです。前回の環境セルフ監査でシステム全体を棚卸しした後、今度は ~/.claude/logs/ の肥大化が気になりはじめました。

自動化エージェントを20本超常駐させると、ログファイルが誰も見ていないまま積み上がります。計測した今朝（03:45の自動実行後）の ~/.claude/logs/ は 21M・184ファイル（du -sh 実測）。前日夜のトリム直前は 約22MB に達していた計算です（後述）。削除ではなく「5MB超 → 末尾2000行だけ残してtruncate」という方針で、最新コンテキストを保ちながら肥大を抑えています。この記事はその log-rotate.sh と launchd 設定の実コードと、実行ログから見えた動きの記録です。

困りごと：ログが静かに積み上がる

ls -lh ~/.claude/logs/ で上位を見るとこんな状態です。

3.3M  vault-auto-ingest.log
3.2M  cost-log.jsonl
1.7M  skills-update.err
930K  hook-latency.jsonl
484K  com.shun.daily-brief.log
428K  bokuwalily-sync.log

hook-latency.jsonl はエージェントのフック実行を1行1レコードで記録します。毎セッション数件ずつ追記するだけで、2026-07-31 のトリム直前には 5,824,638 bytes（約5.8MB） に達していました（log-rotate.log 実測）。vault-auto-ingest.log も夜間の Vault 同期ログが 2026-07-19 のトリム前には 5,255,158 bytes（約5MB） まで積み上がっていました。

問題は「ある日突然大きくなる」のではなく「誰も気づかないまま毎日少しずつ積まれる」こと。手動で管理する気力は続かない。

設計：「削除しない」truncate 方式

~/.claude/scripts/log-rotate.sh の全文です（60行）。

#!/bin/bash
# log-rotate.sh — ~/.claude/logs の肥大防止（毎日03:45 launchd）
# 方針: 5MB超のログは末尾2000行だけ残して切詰め / 30日超の日付付き成果物・マーカー・bakは削除
set -uo pipefail
LOGDIR="$HOME/.claude/logs"
SELF_LOG="$LOGDIR/log-rotate.log"
MAX_BYTES=$((5 * 1024 * 1024))
KEEP_LINES=2000

echo "[$(date '+%F %T')] rotate start" >> "$SELF_LOG"

# 1) 肥大ログの切詰め（.log / .err / .out / .jsonl）
find "$LOGDIR" -maxdepth 1 -type f \( -name '*.log' -o -name '*.err' -o -name '*.out' -o -name '*.jsonl' \) | while read -r f; do
  sz=$(stat -f%z "$f" 2>/dev/null || echo 0)
  if [ "$sz" -gt "$MAX_BYTES" ]; then
    tail -n "$KEEP_LINES" "$f" > "$f.tmp" && mv "$f.tmp" "$f"
    echo "[$(date '+%F %T')] truncated $(basename "$f") ($sz bytes -> $(stat -f%z "$f") bytes)" >> "$SELF_LOG"
  fi
done

# 2) 日付付き成果物・マーカー・バックアップの30日超削除
find "$LOGDIR" -maxdepth 1 -type f \( \
  -name 'daily-brief-2*.md' -o -name 'project-health-2*.md' -o \
  -name '.*-done-*' -o -name '.vault-ingest-*' -o -name '*.plist.bak*' \
  \) -mtime +30 -delete 2>/dev/null

# 3) 自分自身のログも肥大防止
sz=$(stat -f%z "$SELF_LOG" 2>/dev/null || echo 0)
[ "$sz" -gt "$MAX_BYTES" ] && tail -n "$KEEP_LINES" "$SELF_LOG" > "$SELF_LOG.tmp" && mv "$SELF_LOG.tmp" "$SELF_LOG"

echo "[$(date '+%F %T')] rotate done (dir=$(du -sh "$LOGDIR" | cut -f1))" >> "$SELF_LOG"

核心は tail -n 2000 "$f" > "$f.tmp" && mv "$f.tmp" "$f" の1行。ファイルを消さずに末尾だけ残します。mv は同一ファイルシステム上で atomic なので、トリム中にロギングプロセスが書き込んでも壊れません。

2つ目の find ... -delete はログ本体には触れず、日付付きの使い捨て成果物だけを30日後に削除します。ログ本体は絶対に消さない設計です。

tail "$f" > "$f" のような直接上書きは絶対に使いません。シェルはリダイレクトを先に処理するので、tail が読む前にファイルが空になります。tmp に書いてから mv する2ステップが必須です。

launchd 設定：LowPriorityIO + Nice 10 + 03:45

~/Library/LaunchAgents/com.shun.log-rotate.plist の要点を引用します（EnvironmentVariables の PATH は省略、スクリプトパスは ~ で表記）。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.shun.log-rotate</string>

    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>~/.claude/scripts/log-rotate.sh</string>
    </array>

    <key>StartCalendarInterval</key>
    <array>
        <dict>
            <key>Hour</key><integer>3</integer>
            <key>Minute</key><integer>45</integer>
        </dict>
    </array>

    <key>LowPriorityIO</key><true/>
    <key>Nice</key><integer>10</integer>
    <key>ProcessType</key><string>Background</string>

    <key>StandardErrorPath</key>
    <string>~/.claude/logs/log-rotate.err</string>
</dict>
</plist>

3点セットの意図：

03:45 を選んだのは、他の重いジョブとぶつからない静粛な時間帯だからです。Nice はCPU、LowPriorityIO はディスクで別の軸なので、両方指定する必要があります。

launchd のカレンダーインターバルは Mac スリープ中をスキップします。深夜確実運用が必要なら pmset scheduledpoweroff で先に実行するか、pmset の wake on schedule を設定します。翌朝に「ログイン時に1回だけ実行」で十分なら RunAtLoad: true を追加するのが手軽です。

実行ログで見る効果

~/.claude/logs/log-rotate.log の実ログ（7月19日〜8月1日の実測）：

[2026-07-19 03:45:05] rotate start
[2026-07-19 03:45:05] truncated hook-latency.jsonl (5376787 bytes -> 178061 bytes)
[2026-07-19 03:45:05] truncated vault-auto-ingest.log (5255158 bytes -> 105277 bytes)
[2026-07-19 03:45:05] rotate done (dir=8.1M)
[2026-07-20 03:45:11] rotate done (dir= 10M)
[2026-07-21 03:45:05] rotate done (dir= 13M)
[2026-07-25 03:45:05] rotate done (dir= 18M)
[2026-07-26 03:45:05] rotate done (dir= 20M)
[2026-07-27 03:45:05] truncated agentmemory.err.log (5590723 bytes -> 297105 bytes)
[2026-07-27 03:45:06] rotate done (dir= 16M)
[2026-07-29 03:45:05] rotate done (dir= 21M)
[2026-07-30 03:45:05] rotate done (dir= 20M)
[2026-07-31 03:45:05] truncated hook-latency.jsonl (5824638 bytes -> 181316 bytes)
[2026-07-31 03:45:06] rotate done (dir= 16M)
[2026-08-01 03:45:06] rotate done (dir= 20M)

7月19日のトリムでは hook-latency.jsonl が 5.1MB → 174KB（97%削減）、vault-auto-ingest.log が 5.0MB → 103KB に。ディレクトリ全体が 8.1M に落ちました。

「約22MB」の根拠はこうです。7月30日のトリム後が 20M → 翌31日のトリムで hook-latency.jsonl の 5.8MB を削って → トリム後が 16M。逆算すると トリム直前は 16 + (5.8 − 0.18) ≈ 21.6M ≈ 22MB です。

ディレクトリサイズが「のこぎり波」を描くのは設計上の正常動作です。5MB を超えたファイルが出るまで溜まり続け、超えた瞬間に一気に縮む。縮んだ後もまた別のファイルが積み上がり次の山を作る。20〜22MB 台をうろつきながら、1ファイルあたり「2000行」というウインドウで最新コンテキストを保ちます。

踏んだ落とし穴

• > "$f" で直接上書き → ファイルが空になる ―― シェルはリダイレクトを先に処理する。tail が読む前にファイルが切り詰められ、中身がゼロになる。必ず tmp → mv の2ステップ
• stat -f%z は macOS 専用 ―― Linux では stat -c%s。plist は macOS launchd 専用なので問題ないが、スクリプトを他環境に持ち出す時は書き換えが必要
• launchd カレンダーインターバルはスリープ中をスキップ ―― 終夜スリープしていた場合は翌朝のその時刻まで実行されない
• StandardErrorPath を指定しないと stderr が無音で捨てられる ―― スクリプトのエラーが見えなくなる。別ファイル (log-rotate.err) で受けておく
• 自己ログ (log-rotate.log) の肥大は誰も気づかない ―― スクリプト末尾の3ブロック目で自分自身にも同じしきい値を適用している
• Nice だけでは I/O が詰まる局面がある ―― Nice は CPU、LowPriorityIO はディスクで別の軸。両方指定が必須

まとめ

• 自動化エージェントを20本超常駐させると ~/.claude/logs/ は 184ファイル・22MB 近くまで静かに積み上がる
• 「削除」ではなく tail -n 2000 > tmp && mv tmp f のtruncate で最新コンテキストを保持したまま5MB超を抑える
• launchd は LowPriorityIO=true + Nice=10 + ProcessType=Background + 03:45 の組み合わせで、他ジョブとぶつからない静粛起動を実現する
• 実行結果は log-rotate.log に残る。5.8MB → 181KB（97%削減）が記録されており、AIの自己申告ではなくOSの計測値で確認できる
• のこぎり波パターンは正常。2000行ウインドウで最新コンテキストを保ちながら 16〜22MB 台をキープするのが安定状態

次回は、このログディレクトリが整理されたことで autopilot の自己改善ループがどう安定したか ―― 無人ループの長期運用で踏んだ落とし穴を書く予定です。

---

Lily（@bokuwalily）― 個人開発者。Claude Code で自動化基盤を組みながら、iOSアプリやWebサービスを量産しています

• AIで「寝てても回る仕組み」を作って月120万にした話は noteの有料記事 に💰
• OSS: github.com/bokuwalily 🐙
• 最新情報・お問い合わせは X @bokuwalily へ🌍

皆さんの ❤️ やシェアが励みになります！