Claude Code のセッション内スケジュール済みタスク(1 回限りのリマインダー、定期タスク、/loop)について、次の 4 点を公式ドキュメント [1] の記述に沿って整理します。
- いつ発火するか
- 予定時刻からどれだけずれるか
- いつ消えるか
- 何が発火を止めるか
数値はすべて 2026-11-18 時点の記載です。
発火の仕組み
- スケジューラは 1 秒ごとに期限が来たタスクを確認し、低優先度でキューに積みます [1]。「低優先度」が何と比べた優先度なのかは、ドキュメントには低優先度でキューに積むとだけ記載されています。
- スケジュール済みのプロンプトはターンの合間に発火します。Claude の応答中には発火しません [1]。
A scheduled prompt fires between your turns, not while Claude is mid-response.
- Claude が処理中に期限が来た場合、プロンプトは現在のターンが終わるまで待機します [1]。
- 処理中に逃した発火は、逃した回数分は実行されません。Claude が idle になった時点で 1 回だけ発火します [1]。
- タスクが発火するのは、Claude Code が起動していて idle の間だけです [1]。
タスクの作成
- CronCreate は新しいタスクを登録するツールです。5 フィールドの cron 式、実行するプロンプト、繰り返すか 1 回限りかの指定を受け取ります [1]。
- 1 回限りのリマインダーを自然言語で頼むと、Claude は cron 式で分と時を固定し、いつ発火するかを確認として返します [1]。
- 秒を指定すると、cron の粒度が 1 分なので、近い分に切り上げられます [1]。
- 1 セッションに保持できるスケジュール済みタスクは最大 50 件です [1]。
Jitter(実行時刻のずらし)
すべてのセッションのタスクが予定どおりに動くと、多くのセッションが同じ瞬間に API を呼ぶことになります。これを避けるため、Claude Code は各タスクの実行時刻をずらします [1]。
- 5 分間隔以外の定期タスク:各回の開始が、次の回までの間隔の最大半分、かつ最大 30 分まで遅れます [1]。
- 1 時間以上の間隔(毎時、日次など):0〜30 分遅れて開始します [1]。
- 5 分間隔の定期タスク:5 分ちょうどだと、5 分のプロンプトキャッシュが切れた後に始まってしまいます。そのため各回を 15 秒早め、前回実行の 4 分 45 秒後に開始します [1]。
- :00 または :30 に置いた 1 回限りのタスク:最大 90 秒早く実行されます [1]。
ライフサイクル
- 定期タスクは作成から 7 日で期限切れになります。最後に 1 回発火してから、自動で削除されます [1]。
自己ペース型 /loop
- /loop の間隔を省略すると、Claude は各イテレーションの後、観察した内容をもとに 1 分〜1 時間の範囲で次までの待ち時間を選びます [1]。
- イテレーションが再スケジュールも停止もせずに終わると、約 20 分後に fallback の wakeup が 1 回設定されます。そのイテレーションも再スケジュールしなければ、ループは終わります [1]。
- 自己ペース型の /loop は復元されません。再開するには /loop をもう一度実行します [1]。
cron 式の解釈
- 時刻はすべてローカルタイムゾーンで解釈されます [1]。
- day-of-month と day-of-week の両方を指定した場合、どちらかに一致した日が対象になります [1]。
無効化とバージョン要件
- 環境変数 CLAUDE_CODE_DISABLE_CRON=1 を設定すると、スケジューラ全体が無効になります [1]。
- feature-flag の取得を無効にした環境では、動的な間隔と組み込みのメンテナンスプロンプトの両方に Claude Code v2.1.248 以上が必要です [1]。
- Ctrl+C でループを止めずにデタッチするには、Claude Code v2.1.295 以上が必要です [1]。
- スケジュール機能そのものの最小バージョン、対応 OS、必要な権限は、本稿の検証範囲では記載を確認できていません。
- タスクの取り消し手順は本稿の検証範囲外です。ドキュメントの「Stop a loop」「Manage session-scoped scheduled tasks」の節を参照してください。
References
[1] https://code.claude.com/docs/en/scheduled-tasks (取得日 2026-11-18。ページメタデータ lastModified: 2026-11-16T22:37:10.593Z)