1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code のセッション内スケジュール済みタスク:発火タイミングの仕様(2026-11-18 検証)

1
Posted at

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)

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?