Claude Code のスケジュールタスクについて、詳細ページに何が表示されるか、過去の実行(History)の結果表示が何を意味するか、実行が止まる・始まらない条件を、公式ドキュメント [1] の記述に沿って整理します(2026-11-19 検証)。
概要と前提
- スケジュールタスクは、プロンプト、1 つ以上のリポジトリ、コネクタ一式をまとめて保存した Claude Code の設定です [1]。
- 機能は research preview です。挙動、上限、API 面は変更される可能性があります [1](2026-11-19 時点)。
- 利用できるプランは Pro、Max、Ultra、Team、Enterprise です [1](2026-11-19 時点)。
- タスクは個人の claude.ai アカウントに属し、チームメンバーとは共有されません [1]。
- 以前は routines と呼ばれており、一部の箇所に旧名が残っています [1]。旧名が残る箇所の一覧は、本稿の出典引用の範囲外です。
- 対応 OS の条件は、本稿の出典範囲では確認していません。
詳細ページ
- 一覧でタスクをクリックすると詳細ページが開きます。詳細ページには、リポジトリ、コネクタ、プロンプト、スケジュール、API トークン、GitHub トリガー、過去の実行一覧が表示されます [1]。
- 詳細ページの Run now をクリックすると、実行をすぐ開始できます [1]。
- History の実行をクリックすると、その実行が通常のセッションとして開きます [1]。
- 実行ごとに新しいセッションが作られ、Claude の作業内容の確認、変更のレビュー、プルリクエストの作成ができます [1]。
History の結果表示
- 完了した実行の行は、失敗なら末尾に Error、キャンセルなら Cancelled が付き、成功ならどちらの語も付きません [1]。
- Status フィルタでは、行末の表示と同じ 3 種の結果で絞り込めます [1]。
- 失敗は、セッションが正常に終了しなかった場合です。予期せぬ停止、エラーでの終了、実行開始前のアーカイブが例として挙げられています [1]。
- キャンセルは、実行が失敗したのではなく、そのセッションがアーカイブされた状態を指します [1]。
- これらの結果はセッションの終わり方を示すだけで、プロンプトが求めた作業を Claude が完了したかどうかは示しません。何が起きたかは、実行を開いてトランスクリプトを読んで確認します [1]。
- 成功の行でも、ブロックされたネットワークリクエスト、欠けたコネクタツール、Claude が完了できなかった作業は、行ではなくトランスクリプトに現れます [1]。
警告と、実行が始まらない場合
- クラウド環境が見つからない、または使えないために直前の実行が始まらなかったことを示す警告があります [1]。
- 警告の説明では、Run now で再試行するか次の実行を待つよう案内されており、失敗した実行には開けるセッションがないと書かれています [1]。
- 警告は、後の実行が始まると消えます [1]。
一時停止・ワンオフ・GitHub 接続
- 一時停止中のタスクは設定を保持しますが、オンに戻すまで実行されません [1]。スイッチの位置は本稿の出典引用の範囲外です。
- ワンオフ実行は、実行後に自動でオフになり、Web UI で Completed と表示されます [1]。
- GitHub 接続が欠けている、または失効している間、タスクは再接続されるまで最長 72 時間、実行をスキップします [1](2026-11-19 時点)。
- 接続がないまま 72 時間が経過すると、タスクはオフになります [1]。
スケジュールの時刻
- プリセットの頻度を選ぶ場合、時刻はローカルタイムゾーンで入力します [1]。
- cron 式では時刻を UTC で書きます。例として、0 9 * * 1-5 は平日の 9:00 AM UTC に実行されます [1]。
- 1 時間に 1 回より高頻度の cron 式は拒否されます [1]。
- 9:00 のように正時ちょうどに設定した実行は、数分遅れて始まることがあります [1]。
- スケジュールトリガーを持たないタスクには次回実行時刻がなく、Claude が保存・更新した際に CLI には none と表示されます [1]。
上限(2026-11-19 時点)
- ワンオフ実行を含むスケジュール実行は、アカウント単位で 100 回/時間です。超過すると、上限がリセットされるまで実行は待機します [1]。
- タスク単位で 30 回/時間の上限があり、3 種類の操作が 1 つのカウントを共有します。超過すると、上限がリセットされるまでその操作は失敗します [1]。3 操作の名称は本稿の出典引用の範囲外です。
実行時の挙動
- Anthropic のクラウドで起動した実行は、auto mode が使えない場合を除いて auto mode でセッションを開始します [1]。
- auto mode でブロックが繰り返されてしきい値に達すると、実行のセッション内に権限プロンプトが表示され、誰かが応答するまで待機します [1]。
- Claude は、プロンプトで別のブランチを指示しない限り、claude/ プレフィックスのブランチに作業を push します [1]。
- 実行に渡されたテキストは ブロックで包まれます。このブロックはテキストを信頼できないデータと明示し、その中の指示に従わないよう Claude に伝えます [1]。入力経路の一覧は本稿の出典引用の範囲外です。
CLI
- /schedule list で一覧表示、/schedule update で変更、/schedule run で即時実行ができます [1]。
- 実行履歴を尋ねると、Claude はタスクの直近の実行を、ステータスと Web で開くリンク付きで一覧表示します [1]。
- Claude は実行ログを読み、ツールエラー、権限拒否、最終結果を含めて何が起きたかを説明します。この機能には Claude Code v2.1.227 以降が必要です [1](2026-11-19 時点)。