0
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 の定期タスク 3 方式(Cloud / Desktop / /loop)仕様解説

0
Posted at

Claude Code には、プロンプトを定期・予約実行する方式が 3 つあります。本稿は公式ドキュメントとの逐語照合を通過した事実だけを、仕様として整理したものです(検証日 2026-10-05)。数値はいずれも 2026-10-05 時点の記載に基づきます。

3 方式の比較

項目 Cloud Desktop /loop
最小実行間隔 1 時間 1 分 1 分
マシン起動の要否 不要 必要 必要
ローカルファイルへのアクセス 不可(fresh clone) 可 可
オープンセッションの要否 不要 不要 必要
権限プロンプト なし(自律実行) タスクごとに設定可 セッションから継承

最小実行間隔は Cloud が 1 時間、Desktop と /loop がそれぞれ 1 分です [1]。マシン起動の要否は Cloud のみ不要で、Desktop と /loop は必要です [1]。ローカルファイルへのアクセスは Cloud が新規クローン環境のため不可、Desktop と /loop は可能です [1]。オープンセッションを必要とするのは /loop のみです [1]。権限プロンプトは Cloud が自律実行のためなし、Desktop はタスクごとに設定可能、/loop はセッションの権限設定を継承します [1]。

ライフサイクルと上限

繰り返しタスクは作成から 7 日後に自動的に期限切れになり、最後に 1 回発火してから自身を削除します [1]。1 セッションで同時に保持できるスケジュールタスクは最大 50 件です [1]。

スケジューラーの挙動と遅延

スケジューラーは毎秒タスクの実行期限を確認し、低優先度でエンキューします。発火はターンの合間で、Claude の応答中には割り込みません [1]。発火予定時刻に Claude が長時間リクエストを処理中だった場合、キャッチアップは行われず、アイドルになった時点で 1 回だけ実行されます [1]。繰り返しタスクはスケジュール時刻から最大 30 分遅延する場合があり、毎時より高頻度のタスクは間隔の半分以内の遅延に限られます [1]。

/loop の動的スケジュールと loop.md

動的スケジュールの /loop では、Claude が各イテレーション後に観察結果へ基づいて 1 分〜1 時間の遅延を選びます [1]。/loop のデフォルトプロンプトは loop.md ファイルで上書きでき、25,000 バイトを超えた部分は切り捨てられます [1]。

cron 式と間隔の丸め

CronCreate は標準 5 フィールド形式(minute hour day-of-month month day-of-week)の cron 式を受け付けます [1]。7m や 90m のように正規の cron ステップへ対応しない間隔を指定すると、最も近い対応間隔へ丸められ、Claude が選んだ値を通知します [1]。

セッション再開時の復元

claude --resume または claude --continue でセッションを再開すると、CronCreate で登録したタスクは復元されます(期限切れの繰り返しタスクと予定時刻を過ぎた単発タスクを除く)。一方、自己ペースの /loop は復元されないため、手動で再実行が必要です [1]。

スケジューラーの無効化

環境変数 CLAUDE_CODE_DISABLE_CRON=1 を設定するとスケジューラーが完全に無効化され、cron ツールと /loop が使用不可になります [1]。

References

[1] https://code.claude.com/docs/en/scheduled-tasks

0
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
0
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?