Claude Code(またはそれに準ずるエージェント型CLI)を長時間・複数プロジェクトで回していると、 必ずと言っていいほど起きる「無言で止まる事故」への動く対策スクリプト集です。 「利用量制限に達しているはずなのに、CLIの外からは気づけなかった」 「コンテナランタイムの自動更新でコンテナが全滅していたのに、tmuxセッションだけは生き残っていて しばらく気づけなかった」 「進捗が会話の記憶にしか残っておらず、セッションが落ちた瞬間にどこまで進んでいたか分からなくなった」 こうした事故は、読み物としてのノウハウ記事だけでは防げません。本キットは「実際に検知・通知・ 復旧補助まで動くスクリプト」として、5つの事故パターンに対応する道具一式を同梱しています。 ■ 中身 - 利用量制限(quota)検知スクリプト tmuxペインの表示内容を定期的にスキャンし、利用量制限を示すメッセージが出ていないかを 機械的にチェックします - セッション復旧スクリプト TASKS.md / JOURNAL.md の鮮度と直近の作業内容を読み取り、次のセッションにそのまま渡せる 再開プロンプトを自動生成します - 指標監視スクリプト+アダプタの雛形 売上・PV等の指標を定期巡回(既定3時間おき)で取得し、CSVへ追記専用で時系列蓄積します。 取得先はサイトごとに「アダプタ」を書いて差し替える設計なので、自分のサービスに合わせて 拡張できます - サンドボックス健全性チェックスクリプト 「セッションが存在すること」と「セッションが実際に仕事をしていること」を別軸で確認し、 コンテナの消失や無応答状態を検知します - JOURNAL自動要約プロンプト生成スクリプト 作業ログの直近エントリを抽出し、要約用プロンプトに整形します(LLM API自体は呼び出さないため、 APIキーの同梱・追加課金は発生しません) - 事故パターンのチェックリスト 上記の設計思想のもとになった、自律運用でよく起きる事故の型をまとめたドキュメント ■ dogfood について 同梱スクリプトは、制作者自身が複数のポートフォリオプロジェクトを実運用するなかで書いた/踏んだものが 下敷きになっています。利用量制限の検知と指標監視の2本は、実際に運用で回している監視スクリプトの サニタイズ版(サイト固有情報を除いて一般化したもの)です。セッション復旧・サンドボックス健全性 チェック・JOURNAL要約の3本は、同じ運用で実際に起きた事故と、その復旧を支えている状態ファイル運用から 設計を起こして実装したものです。いずれも例示用に書いたコードではなく実運用の一次経験に根ざしており、 稼働実数は別途公開予定の透明性レポートで公開していく予定です。 ■ こんな方におすすめです - Claude Code を複数プロジェクトで長時間・並行運用していて、無言で止まる事故を1回以上経験した方 - 「セッションが動いているように見えるが、実は何もしていなかった」という事故に心当たりがある方 - 売上・PV等の指標を、後から検証できる形で時系列に残したい方 ■ 併せてどうぞ 同じ運用ノウハウの「体制の型」側を扱った『Claude Code 対応 マルチエージェント運用スターターキット』 も販売しています。キット1が運用体制、本キットが事故対策という役割分担です。両方セットでの利用も おすすめです。 ■ ご注意 - 本キットは非公式の個人制作物であり、Anthropic 社とは関係ありません。Claude・Claude Code は Anthropic 社の製品/商標です。本キットは同社の公式ドキュメントやサポートを代替するものではありません - 実際の運用には Claude Code(またはそれに準ずるエージェント型コーディングツール)、tmux、 必要に応じて Docker が別途必要です - 本キットは検知・通知・復旧補助までを提供するものです。事故そのものの発生を防止することを 保証するものではありません - ダウンロード商品のため、購入後の返品はお受けできません。内容についてご不明点があれば 購入前にメッセージにてお問い合わせください - 再配布・再販売は禁止しています。詳細は同梱の LICENSE.md をご確認ください