/goal を参照してください。
タスクはセッションスコープです。現在の会話に存在し、新しい会話を開始すると停止します。--resume または --continue で再開すると、有効期限切れになっていないタスクが復元されます。過去 7 日以内に作成された定期的なタスク、またはスケジュール済み時間がまだ経過していない 1 回限りのタスクです。セッションとは独立して存在する永続的なスケジューリングについては、Routines を使用して Anthropic 管理インフラストラクチャ上にルーチンを作成するか、Desktop スケジュール済みタスク をセットアップするか、GitHub Actions を使用してください。
スケジューリングオプションを比較する
Claude Code offers three ways to schedule recurring or one-off work:/loop で定期的にプロンプトを実行する
/loop バンドルスキル は、セッションが開いている間、プロンプトを繰り返し実行する最速の方法です。間隔とプロンプトの両方はオプションであり、提供する内容によってループの動作が決まります。
スキルをプロンプトとして渡すこともできます。例えば
/loop 20m /review-pr 1234 は、各反復でそのスキルを再実行します。v2.1.196 以降、スケジュール済みの実行は Claude が独自に呼び出すことを許可されているスキルのみを実行します。以下は Claude にプレーンテキストとして到達し、実行されません。
/permissions、/model、/clearなどの組み込みコマンドdisable-model-invocation: trueとマークされたスキルskillOverrides設定またはSkill拒否ルールによって Claude から保留されたスキル- MCP プロンプト（
/mcp__github__list_prsなど）。MCP サーバーが公開するスキルは引き続き実行されます
固定間隔で実行する
間隔を指定すると、Claude はそれを cron 式に変換し、ジョブをスケジュールし、頻度とジョブ ID を確認します。30m のような裸のトークンとしてプロンプトの前に配置することも、every 2 hours のような句としてプロンプトの後に配置することもできます。サポートされている単位は、秒の場合は s、分の場合は m、時間の場合は h、日の場合は d です。
秒は cron が 1 分の粒度を持つため、最も近い分に切り上げられます。7m や 90m など、クリーンな cron ステップにマップされない間隔は、最も近い間隔に丸められ、Claude が選択したものを通知します。
Claude に間隔を選択させる
間隔を省略すると、Claude は固定 cron スケジュールで実行する代わりに、動的に間隔を選択します。各反復の後、観察した内容に基づいて 1 分から 1 時間の間の遅延を選択します。ビルドが完了している間または PR がアクティブな間は短い待機時間、何も保留中でない場合は長い待機時間です。選択された遅延とその理由は、各反復の終了時に出力されます。 以下の例は CI とレビューコメントをチェックし、PR が静かになると Claude がより長く反復間で待機します。/loop スケジュールをリクエストすると、Claude は Monitor ツール を直接使用する場合があります。Monitor はバックグラウンドスクリプトを実行し、各出力行をストリーミングバックします。これにより、ポーリングを完全に回避でき、プロンプトを間隔で再実行するよりも多くの場合、トークン効率が高く、応答性が高くなります。
動的にスケジュールされたループは、他のタスクと同様にスケジュール済みタスクリストに表示されるため、同じ方法でリストまたはキャンセルできます。ジッタールールは適用されませんが、7 日間の有効期限は適用されます。ループは開始後 7 日で自動的に終了します。
Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry では、間隔なしのプロンプトは固定 10 分スケジュールで実行されます。
組み込みメンテナンスプロンプトを実行する
プロンプトを省略すると、Claude は提供するプロンプトの代わりに組み込みメンテナンスプロンプトを使用します。各反復で、以下を順番に処理します。- 会話からの未完了の作業を続行する
- 現在のブランチのプルリクエストを処理する。レビューコメント、失敗した CI 実行、マージコンフリクト
- 他に何も保留中でない場合、バグハントや簡素化などのクリーンアップパスを実行する
/loop は、このプロンプトを動的に選択された間隔で実行します。例えば /loop 15m のように間隔を追加して、代わりに固定スケジュールで実行します。組み込みプロンプトを独自のデフォルトに置き換えるには、loop.md でデフォルトプロンプトをカスタマイズするを参照してください。
Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry では、プロンプトなしの
/loop は使用メッセージを出力する代わりにメンテナンスプロンプトを実行します。loop.md でデフォルトプロンプトをカスタマイズする
loop.md ファイルは、組み込みメンテナンスプロンプトを独自の指示に置き換えます。これは、裸の /loop の単一のデフォルトプロンプトを定義し、個別のスケジュール済みタスクのリストではなく、コマンドラインでプロンプトを指定するたびに無視されます。それと一緒に追加のプロンプトをスケジュールするには、/loop <prompt> を使用するか、Claude に直接依頼してください。
Claude は 2 つの場所でファイルを探し、最初に見つかったものを使用します。
ファイルは必須の構造を持たないプレーン Markdown です。
/loop プロンプトを直接入力しているかのように記述してください。以下の例は、リリースブランチを健全に保ちます。
.claude/loop.md
loop.md への編集は次の反復で有効になるため、ループが実行中に指示を改善できます。どちらの場所にも loop.md が存在しない場合、ループは組み込みメンテナンスプロンプトにフォールバックします。ファイルは簡潔に保ってください。25,000 バイトを超えるコンテンツは切り詰められます。
Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry では、
loop.md は読み込まれず、プロンプトなしの /loop は使用メッセージを出力する代わりにメンテナンスプロンプトを実行します。ループを停止する
/loop が次の反復を待機している間に停止するには、Esc を押してください。これにより、保留中のウェイクアップがクリアされるため、ループは再度実行されません。Claude に直接依頼してスケジュールしたタスクは Esc の影響を受けず、削除するまで存在し続けます。
自分のペースモードでは、Claude はタスクが完了したら自分でループを終了することもできます。Claude は ScheduleWakeup ツールを stop: true で呼び出し、保留中のウェイクアップを直ちにキャンセルします。反復がスケジュール変更またはスケジュール停止のいずれも行わずに終了した場合、Claude Code は約 20 分後にフォールバックウェイクアップをスケジュールし、その反復がスケジュール変更も行わない場合にループを終了します。v2.1.202 より前は、スケジュール変更を行わないことが Claude がループを自分で終了できる唯一の方法でした。
固定間隔のループは、停止するか7 日が経過するまで実行し続けます。
1 回限りのリマインダーを設定する
1 回限りのリマインダーの場合は、/loop を使用する代わりに、自然言語で実行したい内容を説明してください。Claude は実行後に自身を削除する単一実行タスクをスケジュールします。
スケジュール済みタスクを管理する
自然言語で Claude にタスクをリストまたはキャンセルするよう依頼するか、基盤となるツールを直接参照してください。
各スケジュール済みタスクには、
CronDelete に渡すことができる 8 文字の ID があります。セッションは一度に最大 50 個のスケジュール済みタスクを保持できます。
スケジュール済みタスクの実行方法
スケジューラは毎秒期限切れのタスクをチェックし、低優先度でキューに入れます。スケジュール済みプロンプトは、Claude が応答の途中ではなく、ターン間で実行されます。タスクが期限切れになったときに Claude がビジーの場合、プロンプトは現在のターンが終了するまで待機します。 すべての時間はローカルタイムゾーンで解釈されます。0 9 * * * のような cron 式は、UTC ではなく、Claude Code を実行している場所の午前 9 時を意味します。
ジッター
すべてのセッションが同じ壁時計の瞬間に API にヒットするのを避けるために、スケジューラは火災時間に決定論的オフセットを追加します。- 定期的なタスクは、スケジュール済み時刻の最大 30 分後に実行されます（または 1 時間より頻繁に実行されるタスクの場合は間隔の最大半分）。時間ごとのジョブがスケジュール済みの
:00は:30までのどこかで実行される可能性があります。 - 時間の上部または下部にスケジュール済みの 1 回限りのタスクは、最大 90 秒早く実行されます。
0 9 * * * ではなく 3 9 * * * など、:00 または :30 ではない分を選択すると、1 回限りのジッターは適用されません。
7 日間の有効期限
定期的なタスクは作成後 7 日で自動的に期限切れになります。タスクは最後に 1 回実行され、その後自身を削除します。これにより、忘れられたループが実行できる期間が制限されます。定期的なタスクをより長く続ける必要がある場合は、期限切れになる前にキャンセルして再作成するか、永続的なスケジューリングのために Routines または Desktop スケジュール済みタスク を使用してください。Cron 式リファレンス
CronCreate は標準 5 フィールド cron 式を受け入れます。minute hour day-of-month month day-of-week。すべてのフィールドは、ワイルドカード（*）、単一値（5）、ステップ（*/15）、範囲（1-5）、カンマ区切りリスト（1,15,30）をサポートしています。
曜日は日曜日の場合は
0 または 7、土曜日の場合は 6 を使用します。L、W、? などの拡張構文や、MON や JAN などの名前エイリアスはサポートされていません。
月の日と曜日の両方が制約されている場合、どちらかのフィールドが一致すれば日付が一致します。これは標準の vixie-cron セマンティクスに従います。
スケジュール済みタスクを無効にする
環境でCLAUDE_CODE_DISABLE_CRON=1 を設定して、スケジューラ全体を無効にします。cron ツールと /loop は利用できなくなり、既にスケジュール済みのタスクは実行を停止します。無効化フラグの完全なリストについては、環境変数 を参照してください。
制限事項
セッションスコープのスケジューリングには固有の制約があります。- タスクは Claude Code が実行中でアイドル状態の場合にのみ実行されます。ターミナルを閉じるか、セッションを終了すると、タスクは実行を停止します。セッションをバックグラウンドで実行すると、
/loopタスクがバックグラウンドセッションに引き継がれ、ターミナルなしで実行を続けます。 - 見落とされた実行のキャッチアップはありません。タスクのスケジュール済み時間が Claude が長時間実行されるリクエストでビジーの間に経過した場合、Claude がアイドル状態になったときに 1 回実行され、見落とされた間隔ごとに 1 回ではありません。
- 新しい会話を開始すると、すべてのセッションスコープのタスクがクリアされます。
claude --resumeまたはclaude --continueで再開すると、有効期限切れになっていないタスクが復元されます。過去 7 日以内に作成された定期的なタスク、およびスケジュール済み時間がまだ経過していない 1 回限りのタスク。バックグラウンド Bash およびモニタータスクは再開時に復元されることはありません。
- Routines：Anthropic 管理インフラストラクチャでスケジュールに従って実行、API 呼び出し、または GitHub イベント時に実行
- GitHub Actions：CI で
scheduleトリガーを使用 - Desktop スケジュール済みタスク：マシン上でローカルに実行