--remove-session-state追加
CHANGELOG 原文(英語)
Added claude self-hosted-runner --remove-session-state (default off): delete each session's per-session directories under <base-dir>/_sessions/ when the session ends 公式の変更履歴を開く ↗ 日本語での補足
claude self-hosted-runner --remove-session-state(デフォルトはオフ)を追加。セッション終了時に<base-dir>/_sessions/配下の各セッション専用ディレクトリを削除するようになった。
ドキュメント
ドキュメントの抜粋(参考訳)
事前にウォームアップされたチェックアウトを再利用する
大規模なリポジトリでは、クローンの処理がセッション起動時間の大半を占めることがあります。コールドクローンを省くには、ランナーが自身のクローンを保持するパスに、自分でクローンを用意してください。checkout フックがない場合、ランナーはリポジトリごとに1つの正規クローンを <base-dir>/<repo-owner>/<repo> に保持し、セッションをまたいで再利用します。
--capacity 1の場合: ランナーは対象の ref を fetch し、HEADを detach してそこへハードリセットします。変更がほとんどない場合はほぼ瞬時に完了します。--capacityが1より大きい場合: ランナーはそのクローンに fetch した後、セッションごとにそこから個別のワークツリーをチェックアウトします。事前にウォームアップしたクローンでダウンロードは省けますが、チェックアウトは省けません。
クローンはイメージ内または永続ボリューム上に用意します。
- イメージ内にクローンを含める: ランナーイメージのそのパスにクローンを組み込んでビルドします。新しいコンテナはディスクを再利用しなくても、常にウォームなクローンから開始します。
- 永続ボリューム上にクローンを配置する:
--lock-to-accountで1人のユーザーのアカウントに事前ロックしたランナーでは、--base-dirを永続ボリュームに向けることで、そのディスクを常にそのアカウント専用にできます。事前ロックされたランナーは Claude Tag のチャンネルセッションを受け付けないため、この方法はそれらを扱うランナーには適用できません。
--base-dirの外にあるクローンを使うには、--capacity 1で、その実際のパスを--repository-folderに渡してください。例えば--repository-folder acme/api=/volumes/warm/apiのようにします。ランナーは、セッションごとにそのクローンのトラッキング済みファイルをリセットします。各ランナーには、すべてのランナーで同じパスに置いた専用のコピーを与えてください。各ランナーは新しいコピーで起動するか、--lock-to-accountで固定フリートのランナーを事前ロックしてください。
再利用の仕組みが保証すること、しないこと:
-
クローンの深さ: クローンは
--depthを付けずに作成してください(--single-branchを付けるかどうかは任意です)。ランナーは、originリモートを持つクローンへの fetch 時には--depthを渡しません。これはCLAUDE_RUNNER_FETCH_DEPTHを設定していても同じです。フルクローンの場合、各セッションはクローンに不足しているコミットのみをダウンロードします。シャロークローンの場合、クローンの最も古いコミットより前に分岐したブランチでのセッションは、そのブランチの履歴全体をダウンロードします。 -
トラッキング済みの変更はリセットされるが、未トラッキングのファイルは残る:
--capacity 1では、各セッションは前回のセッションでのトラッキング済みの変更を消し去るハードリセットから始まります。ただしランナーはgit cleanを実行しないため、ロックされた所有者の以前のセッションによる未トラッキングのファイルはツリーに残ったままです。 -
セッションごとのディレクトリも残る: チェックアウトと並んで、ランナーは実行するすべてのセッションについて、
<base-dir>/_sessions/配下にセッションごとのエントリを作成します。セッションの Claude 設定ディレクトリには、会話のトランスクリプトのローカルコピーが保存されます。その隣には、セッションにアップロードされたファイルがある場合、それらが置かれます。セッションディレクトリ自体もそこにあり、セッション実行中のセッションごとのワークツリーとcheckoutフックのチェックアウトを保持するほか、Claude がそこに書き込んだその他のものも保持します。既定では、セッションが終了してもランナーはこれらをそのまま残すため、ランナープロセスより長く存在するディスクでは蓄積していきます。すべてのセッションはランナー自身のユーザーとして実行されるため、そのディスクを利用する後続のセッションはどれもそれらを読み取れます。永続的な
--base-dirを維持する場合は、この増加分を見込んでボリュームのサイズを決めてください。同じことは、Docker Compose のレシピを含め、同じファイルシステム上でランナーを再起動するあらゆる構成にも当てはまります。 -
--remove-session-stateを指定すると、セッションごとのディレクトリは残らない:--remove-session-stateを指定してランナーを起動すると、各セッションの終了時にそのセッションごとのディレクトリを削除するようになります。この削除はベストエフォートであり、クリーンアップが実行される前にランナーが強制終了された場合、ディレクトリは残ります。正規クローンや、一時ディレクトリなどホスト上の他の場所にセッションが書き込んだファイルは、いずれにせよ残ります。 -
git プロキシを使うと、リセットがチェックアウトになる:
--use-anthropic-git-proxyを指定すると、ランナーは各セッションの前にクローンの.git/をサニタイズします。オブジェクトストアとシャロー状態は保持し、インデックスは削除します。インデックスがないため、各セッションはほぼ瞬時のリセットの代わりにフルなワークツリーのチェックアウトから始まります。それでもランナーは既存のクローンへの fetch を行うだけで、リポジトリを再クローンすることはありません。プロキシ配下ではサブモジュールの事前ウォームアップはサポートされません。 -
git プロキシを使うと、
reftableでの事前ウォームアップは ref を失う: ランナーが各セッションの前に.git/をサニタイズする際、.git/refs/は保持しますが.git/reftable/ディレクトリは削除します。そのため、git のreftableref 形式で事前ウォームアップしたクローンは、この処理で ref を失います。クローンの事前ウォームアップは、代わりに git のfilesref 形式で行ってください。 -
長時間かかるクローンに回避策は不要: ランナーは各 git 操作を、一律のタイムアウトではなく、120秒間進捗がない場合のウォッチドッグと 30 分のハードキャップで制限します。そのため、進捗を報告し続けている遅いコールドクローンは完了まで実行されます。
ランナーが自分のクローンを使っていることを確認する
ランナーが自分のクローンを使っていることを確認するには、--log-level debug を指定して起動し、そのリポジトリでセッションを開始します。ランナーは Prefetched repo found at とそのクローンのパスをログに出力します。代わりに No prefetched repo, fresh init at が出力された場合、その行にあるパスには使用可能なクローンが見つからなかったことを意味します。自分のクローンがそのパスにあり、ランナーのユーザーが所有者になっており、origin という名前のリモートを持っていることを確認してください。
ランナーが自分のクローンを見つけているのに、セッションの起動が依然として遅い場合は、そのクローンがシャローになっていないか確認してください。
取得日 · 2026-11-20