/loop

実行間隔とプロンプトはどちらも省略でき、何を指定するかでループの動き方が変わります。デプロイの完了確認やプルリクエストの見直しなど、一定の間隔で状況を確かめる作業に関わる機能です。

/loop は、セッションが開いている間にプロンプトを繰り返し実行する同梱スキルです。実行間隔とプロンプトはどちらも省略でき、指定の有無でループの動き方が決まります。

• 間隔は、プロンプトの前に 30m のような単独の語として置くか、後ろに every 2 hours のような句として付けます。単位は s (秒)・m (分)・h (時間)・d (日) です。
• cron の粒度は 1 分のため、秒は分単位に切り上げます。7m や 90m のように cron の刻みに合わない間隔は、近い刻みに丸め、どの間隔にしたかを Claude が伝えます。
• プロンプトにはスキルも渡せます。ただし、定期実行で動くのは Claude が自分の判断で呼び出してよいスキルだけです。/permissions・/model・/clear などの組み込みコマンドは実行されず、ただのテキストとして Claude に渡ります。

間隔を省略すると、Claude は各回の終わりに、観察した状況をもとに 1 分から 1 時間の間で次の待ち時間を選びます。ビルドの完了待ちやプルリクエストが動いている間は短く、保留中のものが無いときは長く待ちます。選んだ待ち時間とその理由は、各回の終わりに表示されます。

• Monitor ツールが使えるセッションでは、動的なスケジュールを頼んだときに Claude がこのツールを直接使う場合があります。
• 動的に組まれたループも、ほかのタスクと同じくスケジュール済みタスクの一覧に載り、同じ方法で一覧表示やキャンセルができます。
• この自己ペースのモードでは、タスクが終わった時点で Claude が ScheduleWakeup ツールを stop: true で呼び、自らループを終了できます。
• ある回が次の予約も停止もせずに終わった場合は、約 20 分後に 1 回だけ予備のウェイクアップを入れ、その回でも次の予約が無ければループを終了します。

自己ペースのループは、次の回を待っている間に Esc を押すと止まります。Claude が待機中のときは Ctrl+C でも止められます (アタッチしたバックグラウンドセッションを除きます)。止まると Pending wakeup cancelled の通知が出ます。

プロンプトを付けない /loop は、組み込みの保守プロンプトを動的に選んだ間隔で実行します。/loop 15m のように間隔を付けると、同じ保守プロンプトを固定の周期で実行します。

保守プロンプトのもとでは、Claude は範囲外の新しい作業を始めません。プッシュや削除のような取り消せない操作は、会話の記録の中ですでに認められた作業の続きである場合だけ進めます。

既定のプロンプトは loop.md で置き換えられます。

• 置き場所は .claude/loop.md (プロジェクト単位、こちらが優先) または ~/.claude/loop.md (ユーザー単位) です。
• 中身は決まった構造の無い Markdown で、/loop のプロンプトを直接打ち込むつもりで書きます。
• loop.md が定めるのは引数なしの /loop 用の既定プロンプト 1 つで、別々の定期タスクの一覧ではありません。コマンドラインでプロンプトを指定したときは使われません。
• 編集は次の回から反映されるため、ループの実行中に指示を手直しできます。

• アタッチしたバックグラウンドセッションで Claude が待機中のとき、空のプロンプトで Ctrl+C を 2 回押すとデタッチでき、次の回を待っている自己ペースのループはそのまま動き続けます。ループを止めるには Esc を押します。
• スケジュールされたウェイクアップを待つバックグラウンドセッションは、アップデート時やメモリ不足時にも実行したまま残します。再起動や終了によって、ウェイクアップが通知されないまま失われるのを避けるための扱いです。
• リモートセッションでは、保留中のループがコンテナを維持しません。そのため、リモートセッションでは /loop の案内を出していません。
• クラウドセッションでコンテナの再起動により保留中の /loop ウェイクアップやスケジュール済みタスクが失われた場合、Claude には知らされず、セッションはスリープのままになります。

自己ペースの動的モードと、プロンプトなしの自律的な既定動作は、Bedrock・Vertex・Foundry を含めて常に使えます。対象となるプランは、公式のリリースノートには記載がありません。

ここでは、固定の間隔でプロンプトを実行し、止めるまでの流れを示します。

1. /loop に続けて間隔とプロンプトを入力して実行します。例: /loop 5m check if the deployment finished and tell me what happened
2. Claude が間隔を cron 式に変換してジョブを登録し、実行の周期とジョブ ID を示します。
3. 止めるときは、cancel the deploy check loop のように Claude にキャンセルを頼みます。固定間隔のループは Esc や Ctrl+C では止まりません。