フォルダごとに、それぞれのルール。
Devbroom はどの場所も、Claude Code 自身の振る舞いに合わせて扱います。エージェント自身が片付けるものはエージェントに任せ、専用のコマンドがあるものはそのコマンドで実行します。
作業用ワークスペース
セッションのワークスペースと一時ファイル。終了したセッションのものは、Claude Code 自身が削除する前に、目を通したうえでクリーンアップできます。実行中のセッションのものはブロックのままです。
/private/tmp/claude-<uid>MCP とエラーのログ
ログファイルのみです。
~/Library/Caches/claude-cli-nodejsセッションログ
ファイルを手で削除すると、セッションの再開やメモリが壊れます。Devbroom はこれに Claude Code 自身のコマンドを使い、フォルダがもう存在しないプロジェクトの履歴を一度に消去します。削除する代わりに、プロジェクトの会話をアーカイブすることもできます (Pro)。アーカイブが検証されるまで何も移動せず、メモリはその場に残り、履歴から再び開けます。
~/.claude/projectsチェックポイント
cleanupPeriodDays (既定は 30 日) より古いものは Claude Code 自身が削除します。
~/.claude/file-historyログとキャッシュ
デバッグログ、シェルのスナップショット、貼り付けた内容や画像。古いものは Claude Code 自身が削除します。
~/.claude/debug~/.claude/shell-snapshots~/.claude/paste-cache~/.claude/image-cacheCLI のバージョン
アップデータが、現在のもの、実行中のもの、最新の 2 つを残します。
~/.local/share/claude/versionsプラグイン
/plugin が管理します。使用中のプラグインは削除すべきではありません。
~/.claude/plugins/cache~/.claude/plugins/marketplacesデスクトップアプリのデータ
アプリの状態です。同梱の CLI や仮想マシンのイメージも含みます。
~/Library/Application Support/Claudeアカウントと設定には触れません。
これらのファイルとフォルダは保護されています。どの判定もこれらをクリーンアップの対象にすることはなく、サイズにかかわらずその場に残ります。
~/.claude.json~/.claude/.credentials.jsonsettings.json · settings.local.json~/.claude/history.jsonl~/.claude/agent-memory~/.claude/pluginsClaude Code のワークツリーを、その痕跡で見分けます。
次の痕跡から、ワークツリーが Claude Code のものだと見分けます。痕跡が強いほど、所有者をより確かに示します。
- 確実git メタデータ内の
CLAUDE_BASEマーカー - 確実Claude Code が設定したワークツリーのロック
- 高い
.claude/worktreesフォルダの中にある - 高いClaude Code のワークスペースの中にある
- 可能性あり
worktree-で始まるブランチ名
- 保存されていない作業を含むならブロック。 git は
--forceなしではそのようなワークツリーを削除せず、Devbroom は--forceを決して使いません。 - その中か親フォルダでセッションが実行中ならブロック。
- 無視されたファイルがあるなら要確認:
git worktree removeは確認なしにそれらを削除します。
見えていますが、実行中は触れません。
Devbroom はどの Claude Code セッションが実行中かを把握しています。実行中のセッションのプロセスには決して触れず、セッションが続くあいだ、そのフォルダと作業用領域はブロックのままです。
2 セッション実行中
まず Claude Code のファイルを確認します。
エージェントのデータを信頼する前に、Devbroom はファイルが想定どおりの形式かどうかを確認します。そうでなければ、そのデータは読み取るだけで、クリーンアップ可能とは見なしません。
この範囲外のバージョンでも、形式が合っていれば動作し、「未テスト」と表示されます。
~/.claude/projects のログには、セッションとフォルダを結びつけるこの 2 つのフィールドが必要です。
フォルダが別の場所にある場合は CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR に従います。