開発・技術公開

Claude Code の /loop の使い方|定期実行の書き方・止め方・30日の期限【v2.1.330 対応】

Claude Code の /loop(セッション内の定期実行)を、公式ドキュメントと v2.1.330 の実機確認で解説します。v2.1.330(2026年11月20日 UTC 公開)で繰り返しの期限が7日から30日に延びた点と、以前に作ったタスクは7日のままという版の境界、3つの使い方、間隔の書き方と実際に動く時刻、止め方と /tasks、再開したときの扱い、Desktop・クラウドの定期タスクとの使い分けまでまとめました。

Claude Code の /loop の使い方|定期実行の書き方・止め方・30日の期限【v2.1.330 対応】

Claude Code v2.1.330(2026年11月20日 UTC 公開、日本時間21日)から、/loop などの繰り返しの定期タスクは、セッションが動き続けている間なら最長30日まで動くようになりました。 これまでは作ってから7日で止まっていました。ただし v2.1.330 より前の版で作ったタスクは、これまでどおり7日で終わります。長く回したいループがある人は、v2.1.330 以降に更新してから作り直してください。

本記事は、2026年11月21日に取得した Anthropic 公式ドキュメント「Run prompts on a schedule」と Claude Code の CHANGELOG を原典にしています。執筆時点の公式ドキュメントは、期限をまだ「7日」と書いています。30日への変更は CHANGELOG にだけ載っているため、v2.1.330 を手元に入れ、ログインせずに確かめられる範囲で実行ファイルの中身も確認しました。実機で確認した内容と、ドキュメントに書かれている内容は書き分けています。

この記事を読むとわかること

  • /loop で何ができるのか(Desktop やクラウドの定期タスクとの違い)
  • 3つの使い方(間隔と指示を渡す/指示だけ/何も渡さない)
  • 間隔の書き方と、予定より遅れて動く理由
  • ループの止め方と、v2.1.329 からの /tasks での管理
  • 期限が記事によって「7日」「30日」と違う理由と、自分のタスクがどれに当たるか
  • 再開したときに戻るタスク・戻らないタスク

結論:/loop の要点

/loop とは、開いている Claude Code のセッションの中で、同じ指示を決まった間隔で繰り返し実行させる組み込みのスキルです。 押さえるべき点は次の4つです。

  1. 書き方は /loop [間隔] [指示]:/loop 5m デプロイが終わったか確認して のように書きます。間隔を省くと Claude が毎回1分〜1時間の間で待ち時間を決め、指示も省くと組み込みの「保守用の指示」が動きます
  2. セッションが動いている間だけ動く:ターミナルを閉じたり Claude Code を終了したりすると止まります(セッションをバックグラウンドに移した場合は、ターミナルが無くても動き続けます)。パソコンの電源を切っても動かしたいなら、クラウドの定期タスク(旧 Routines)か GitHub Actions を使います
  3. 止め方は種類で違う:Claude が間隔を決めるループ(/loop 指示)は Esc で止まりますが、間隔を指定したループ(/loop 5m 指示)は Esc では止まりません。Claude に取り消しを頼むか、v2.1.329 以降なら /tasks から止めます
  4. 期限は v2.1.330 から最長30日:繰り返しのタスクは、期限が来ると最後に1回動いてから消えます。v2.1.330 より前の版で作ったタスクは7日のままです

/loop とは

/loop は Claude Code に同梱されているスキル(よく使う手順をまとめて、名前で呼び出せるようにしたもの)です。間隔を指定すると、Claude Code が cron の式(時刻と曜日で予定を表す書き方)で予定を作り、その時刻になるたびに指示を会話に送ります。間隔を省いたときは、Claude が毎回、次の回までの待ち時間を決めて予約します。Claude は、そのセッションで開いているコード・git の履歴・使えるツールをそのまま使って作業します。

向いているのは、作業の合間に何かを見張っておきたいときです。公式ドキュメントは、デプロイの完了を確かめる、PR の CI やレビューを見守る、時間のかかるビルドの結果を見に行く、といった使い方を挙げています。

  • 5分ごとにデプロイが終わったか確かめ、終わったら結果を教えてもらう
  • PR の CI が通ったか確かめ、レビューのコメントが来たら直してもらう
  • 30分ごとにテストを流し、失敗していたら原因を調べてもらう

反対に、「毎朝9時に必ず動かしたい」「パソコンを閉じても動いてほしい」という用途には向きません。/loop はセッションの中だけで動く仕組みだからです。使い分けは「ほかの定期実行との使い分け」で説明します。

/loop は2026年3月の v2.1.71 で追加され、その後のリリースで何度も動きが変わっています。古い解説記事と画面の動きが違うときは、まず claude --version で版を確かめてください。

3つの使い方

/loop は、間隔と指示のどちらを渡すかで動きが変わります。 公式ドキュメントの表を日本語にまとめると次のとおりです。

渡すもの例動き
間隔と指示/loop 5m デプロイを確認して決めた間隔で指示を繰り返す
指示だけ/loop デプロイを確認してClaude が毎回、次までの待ち時間を決める
間隔だけ、または何も渡さない/loop 15m、/loop組み込みの保守用の指示(loop.md があればその中身)を繰り返す

出典:Run prompts on a schedule(Claude Code Docs)(2026年11月21日取得)

間隔と指示を渡す(決まった間隔で回す)

もっとも基本的な使い方です。間隔を渡すと、Claude はそれを cron の式に直して予定を作り、間隔とタスクの ID(8文字)を返します。

/loop 5m デプロイが終わったか確認して、結果を教えて

間隔は指示の前に 30m のように置いても、文の後ろに every 2 hours のように書いてもかまいません。

指示だけを渡す(Claude が間隔を決める)

間隔を省くと、Claude が毎回の結果を見て、次まで1分〜1時間の間で待ち時間を決めます。ビルドが終わりかけているときや PR が動いているときは短く、何も起きていないときは長く待ちます。決めた待ち時間と理由は、毎回の最後に表示されます。

/loop CI が通ったか確認して、レビューのコメントが来ていたら対応して

解説記事の中には「間隔を省くと10分ごと」と書かれているものもありますが、2026年11月21日時点の公式ドキュメントでは、間隔を省いたときは Claude が待ち時間を決める動きになっています。

この「Claude が間隔を決めるループ」は、作業が終わったと Claude が判断すると、自分でループを終わらせることがあります。また v2.1.319 からは、Claude が次の回を予約しないまま1回分の作業を終えると、そこでループが止まるようになりました。止まった後にもう1回だけ様子を見てほしい場合は、環境変数 CLAUDE_CODE_LOOP_KEEPALIVE=1 を付けて起動します。対話のセッションで、2回目以降の回が次を予約せずに終わったとき、約20分後にもう1回だけ動きます。

何も渡さない(保守用の指示と loop.md)

/loop だけを打つと、Claude Code に組み込まれた保守用の指示が、Claude の決める間隔で動きます。毎回、次の順で作業します。

  1. 会話の中で終わっていない作業を続ける
  2. 今のブランチの PR を手入れする(レビューのコメント、失敗した CI、マージの競合)
  3. ほかにやることがなければ、バグ探しやコードの簡素化をする

push や削除をする前には、そのセッションの権限の確認が入ります。/loop 15m のように間隔だけを渡すと、同じ指示を決まった間隔で回します。

この保守用の指示は、loop.md というファイルで自分用に置き換えられます。

置き場所効く範囲
.claude/loop.mdそのプロジェクト。両方あるときはこちらが優先
~/.claude/loop.md自分のすべてのプロジェクト(プロジェクト側に無いとき)

中身は、/loop に続けて打つ指示と同じように普通の文章で書きます。ファイルを直すと次の回から反映されるので、ループを回しながら指示を調整できます。25,000バイトを超えた分は切り捨てられるので、短く保ちます。なお loop.md が使われるのは何も指示を渡さないときだけで、/loop 5m 指示 のように指示を渡したときは無視されます。

スキルを繰り返し動かす

指示の代わりにスキルを渡すこともできます。

/loop 20m /review-pr 1234

ただし、予定の時刻に動くのは Claude が自分で呼び出してよいスキルだけです。次のものは、スキルとして動かず、ただの文字として Claude に渡ります。

  • /permissions・/model・/clear などの組み込みのコマンド
  • disable-model-invocation: true を付けたスキル(同梱の /verify も含む)
  • 設定の skillOverrides や Skill の deny ルールで Claude から隠したスキル
  • MCP サーバーのプロンプト(/mcp__github__list_prs など)

スキルの作り方や呼び出しの制御は、Claude Code の Skills ガイドで解説しています。v2.1.325 からは、allowed-tools や hooks を宣言したスキルを定期実行で動かすとき、実行前に確認が出るようになりました。確認なしで動かしたい場合は、設定の permissions.allow に Skill(スキル名) を足します。

間隔の書き方と、実際に動く時刻

間隔の単位は s(秒)・m(分)・h(時間)・d(日)の4つです。 cron の最小単位は1分なので、秒で書いた間隔は分に切り上げられます。7m や 90m のように cron できれいに表せない間隔は、近い間隔に丸められ、Claude がどの間隔にしたかを伝えます。

時刻はパソコンのタイムゾーンで解釈されます。毎日9時を表す 0 9 * * * は「UTC の9時」ではなく、Claude Code を動かしている場所の9時です。

予定より遅れて動くのは仕様

定期タスクは、予定の時刻ちょうどではなく、少しずらして動きます。すべての利用者のタスクが同じ時刻に一斉に API を呼ばないようにするためです。公式ドキュメントが示すずれ方は次のとおりです。

間隔毎回いつ動くか
5分ごと(*/5 * * * *。/loop 5m が作る式)前回の4分45秒後
10分ごと0〜5分遅れる
30分ごと0〜15分遅れる
1時間ごと、またはそれより長い間隔(毎日など)0〜30分遅れる

出典:Run prompts on a schedule(Claude Code Docs)(2026年11月21日取得)

繰り返しのタスクは「間隔の半分まで、ただし最大30分」遅れます。間隔が均等なタスクは、毎回同じ分だけ遅れます。5分ごとのタスクだけは遅らせず、逆に15秒早めます。会話の読み込みを安くする仕組み(プロンプトキャッシュ)の有効期限5分が切れる前に動かすためです。

一回だけのタスクを :00 や :30 に予約すると、最大90秒早く動きます。時刻が大事なときは、0 9 * * * ではなく 3 9 * * * のように、ちょうどの時刻を避けて予約するのが公式のおすすめです。次に動く時刻は、Claude が予定を作ったときの表示(next run 10:21 AM のような行)か、「予定しているタスクを一覧にして」と頼んだときの表示で確かめられます。この次の実行時刻が出るのは v2.1.299 以降です。

また、Claude が返事を書いている途中には動きません。予定の時刻に Claude が作業中なら、その作業が終わってから動きます。長い作業の間に何回分も時刻が過ぎても、後からまとめて何回も動くことはなく、手が空いたときに1回だけ動きます。

一回だけのリマインダー

1回だけ動かしたいときは、/loop を使わずに普通の言葉で頼みます。

15時になったらリリース用のブランチを push するよう教えて
45分後に、結合テストが通ったか確認して

Claude は1回だけ動く予定を作り、動いた後にその予定を自分で消します。

止め方と /tasks

ループの止め方は、Claude が間隔を決めるループか、間隔を指定したループかで違います。

ループの種類止め方
Claude が間隔を決めるループ(/loop 指示、/loop)次の回を待っている間に、入力欄が空の状態で Esc。Claude が待機中なら Ctrl+C でも止まる(接続中のバックグラウンドのセッションを除く)。「Pending wakeup cancelled」と出れば止まった
間隔を指定したループ(/loop 5m 指示 など)Claude に「デプロイ確認のループを取り消して」と頼む。Esc や Ctrl+C では止まらない
どちらも(v2.1.329 以降)/tasks を開き、止めたい行で x を押す(確認が出る)

出典:Run prompts on a schedule、CHANGELOG v2.1.329(2026年11月21日取得)

Esc で止まらないときは、まず間隔を指定したループかどうかを確かめてください。間隔を指定したループや、Claude に直接頼んで作った定期タスクは、取り消すまで(または期限まで)動き続けます。

v2.1.329 からの /tasks

v2.1.329(2026年11月19日 UTC 公開)から、/tasks の一覧に次のものが並ぶようになりました。

  • このセッションの定期タスク
  • /loop の「次の回の待ち」
  • /goal(条件を満たすまで作業を続けさせる機能)の目標
  • この会話から枝分かれさせた会話(fork)

行で x を押すと、確認のあとで止められます。/tasks の見出しと画面下のバックグラウンドの件数も、シェル・モニター・MCP の呼び出し・エージェント・ワークフロー・定期タスクをまとめた1つの数字になりました。

/tasks に定期タスクが並ばない v2.1.328 以前の版では、Claude に「予定しているタスクを一覧にして」と頼みます。Claude は内部で CronList(一覧)と CronDelete(取り消し)というツールを使い、タスクの ID・予定・次の実行時刻・指示を返します。1つのセッションで持てる定期タスクは最大50件です。

バックグラウンドのセッションでループを残したまま離れる

エージェントビュー(複数のセッションを並べて管理する画面)からバックグラウンドのセッションに接続している場合、Claude が待機中に入力欄が空の状態で Ctrl+C を2回押すと、ループを止めずに接続だけ切れます(v2.1.295 以降)。ループを止めたいときは、切る前に Esc を押します。

定期実行そのものを止める

環境変数 CLAUDE_CODE_DISABLE_CRON=1 を付けて起動すると、定期実行の仕組みがすべて止まります。/loop と CronCreate が使えなくなり、すでに予約したタスクも動かなくなります。プロジェクトの .claude/scheduled_tasks.json にタスクが残っている間は、一覧と取り消しだけはできます。

期限:7日と30日の違い

繰り返しの定期タスクには期限があり、期限が来ると最後に1回動いてから自分で消えます。 忘れたループがいつまでも使用量を使い続けないための仕組みです。この期限は記事によって「7日」「30日」と違って書かれています(解説記事の中にはほかの日数のものもあります)。違いは、書かれた時期と、タスクを作った版です。

情報の出どころ書かれている期限当てはまるタスク
公式ドキュメント(2026年11月21日時点)7日v2.1.329 以前に作ったタスク
CHANGELOG v2.1.330(2026年11月20日 UTC)最長30日v2.1.330 以降に作ったタスク(セッションが動き続けている間)

出典:Run prompts on a schedule、CHANGELOG v2.1.330(2026年11月21日取得)

CHANGELOG の v2.1.330 の記載は、要約すると次のとおりです。

  • 繰り返しの定期タスクと /loop は、セッションが動き続けている間、7日ではなく最大30日動く
  • いつ終わるかを伝えるようになった
  • このリリースより前に作ったタスクは、これまでどおり7日で終わる

公式ページの「Seven-day expiry」の節と、間隔を指定したループの止め方の説明は、2026年11月21日時点でまだ7日のままです。

長く回したいときにすること

  1. claude --version で版を確かめ、v2.1.330 より前なら更新する
  2. 7日で終わるはずの古いループを、Claude に頼むか /tasks で取り消す
  3. 同じ /loop をもう一度作る(作り直したタスクから30日が当てはまる)

30日はあくまで上限です。セッションを閉じれば、期限の前でも止まります。

再開したとき・保存したタスク

/loop の予定は、基本的にそのセッションの中だけのものです。 claude --resume や claude --continue で会話を再開すると、CronCreate(Claude が予定を作るときに使うツール)で作った予定は戻りますが、戻らないものもあります。

再開したときに戻るか
間隔を指定したループ・繰り返しのタスク(期限内)戻る。ただし止まっていた間の分は動かず、再開後の最初の予定から動く
期限が切れた繰り返しのタスク戻らない
時刻を過ぎた一回だけのタスク戻らない
Claude が間隔を決めるループ(/loop 指示、/loop)戻らない。もう一度 /loop を打つ
終了するときに「Exit and stop tasks」を選んだタスク戻らない(v2.1.329 以降。ただし Claude の返事の途中で終了した場合は戻る)
動いていたバックグラウンドの Bash コマンドやモニター戻らない。必要なら Claude にもう一度始めてもらう

出典:Run prompts on a schedule、CHANGELOG v2.1.329(2026年11月21日取得)

会話の再開の手順は、Claude Code の会話履歴と再開の方法で詳しく解説しています。

セッションをまたいで残すタスク

Claude に「再起動しても残して」と頼んで作ったタスクは、プロジェクトの .claude/scheduled_tasks.json に保存されることがあります(v2.1.330 の実行ファイルにあるツールの説明で確認。公式ページにはまだ詳しい説明がありません)。保存したタスクには次の注意があります。

  • 作ったプロジェクトのフォルダでだけ動く:ファイルを別のフォルダ(同じリポジトリを別の場所に取り出した worktree など)に写しても、一覧には出ますが動きません。そのフォルダで作り直します
  • v2.1.329 から、古い版で保存したタスクの多くは作り直しが必要:v2.1.329 の CHANGELOG によると、サインインした状態で新しく始めたセッションでは、以前の版で保存したタスクの多くを予約し直す必要があります。作ったときのセッションを --resume で再開すれば、そのまま動きます
  • .claude フォルダやそのファイルがシンボリックリンクだと、保存せずにエラーになります

権限と使用量

定期実行される指示も、そのセッションの権限の設定どおりに確認が入ります。 /loop は新しい権限を足さず、セッションの権限モードをそのまま使います。確認が出ると、ループはそこで返事を待ちます。席を外している間に確認待ちで止まらないようにするには、許可してよい操作を permissions.allow に書いておくか、auto モードを使います。権限モードの違いは Claude Code auto モード完全ガイドで解説しています。

使用量にも注意します。定期実行は、1回動くたびに会話を読み込んで作業するので、そのぶんプランの枠を使います。30日まで動くようになったことで、忘れたループが使う量は以前より大きくなりえます。

  • v2.1.243 から、/usage に「Loops」の内訳が出ます。ループごとの実行回数・使ったトークンの合計・1回あたりのトークン・最後に動いた時刻が分かります
  • 指示は短くし、何も変わっていなければ1行で返すよう書いておく
  • 用が済んだループは期限を待たずに止める

プランの枠の仕組みは Claude の使用量の上限ガイドにまとめています。

ほかの定期実行との使い分け

Claude Code で定期的に作業させる方法は、/loop のほかに、Desktop の定期タスクとクラウドの定期タスクがあります。 公式ドキュメントの比較表をまとめると次のとおりです。

クラウドの定期タスク(/schedule)Desktop の定期タスク/loop
動く場所クラウド(既定は Anthropic の環境)自分のパソコン自分のパソコン
パソコンの電源不要必要必要
セッションを開いておく不要不要必要(バックグラウンドに移せばターミナルは不要)
再起動後も残るか残る残る--resume で戻る(例外あり)
手元のファイル使えない(毎回新しく取り出す)使える使える
権限の確認既定は auto モードタスクごとに設定セッションの設定のまま
最小の間隔1時間Claude が設定すれば1分、画面のフォームからは1時間1分

出典:Run prompts on a schedule(Claude Code Docs)(2026年11月21日取得)

選び方の目安は次のとおりです。

  • 作業中の見張り(数分〜数時間):/loop。今の会話の文脈をそのまま使える
  • 毎朝・毎週など、パソコンが起きている時間の定期作業で、手元のファイルを使う:Desktop の定期タスク。パソコンがスリープ中だった時刻の回は飛ばされ、起きたときに直近7日間で最後に逃した1回分だけが動く(9時の予定が夜に動くこともある)
  • パソコンを閉じても確実に動かしたい:クラウドの定期タスク(/schedule)。詳しくは Claude Code Routines 完全ガイド
  • CI の一部として決まった時刻に動かしたい:GitHub Actions の schedule トリガー

なお、/loop で一定時間ごとに確かめるより、出来事が起きたときに知らせてもらうほうが合う場面もあります。公式ドキュメントは、CI の失敗をセッションに直接送り込む Channels(外の出来事をセッションに直接届ける仕組み)や、条件を満たすまで作業を続けさせる /goal を、別の選択肢として案内しています。

うまく動かないとき

症状考えられる原因対処
Esc を押してもループが止まらない間隔を指定したループ(/loop 5m …)を止めようとしているClaude に取り消しを頼むか、/tasks で x
予定の時刻から数分〜30分遅れて動くすべての利用者の実行を分散させる仕組み(仕様)「予定より遅れて動くのは仕様」の表で、遅れの幅を確かめる
1週間でループが消えたv2.1.330 より前の版で作ったタスクは7日で終わるv2.1.330 以降に更新し、作り直す
再開したらループが無くなっていたClaude が間隔を決めるループは再開時に戻らない。期限切れや「Exit and stop tasks」でも戻らないもう一度 /loop を打つ
指示に書いたスキルが動かず、文字のまま渡る組み込みのコマンド、disable-model-invocation: true のスキル、MCP のプロンプトは定期実行で動かないClaude が呼び出せるスキルにするか、手順を指示の文章で書く
定期実行のたびに確認で止まるセッションの権限設定で確認が必要な操作をしている。allowed-tools や hooks を宣言したスキルは v2.1.325 から確認が出るpermissions.allow に操作や Skill(スキル名) を足す
新しい worktree で保存したタスクが動かない保存したタスクは作ったフォルダでだけ動くその worktree で作り直す
/loop が使えないCLAUDE_CODE_DISABLE_CRON=1 が設定されている環境変数を外して起動し直す。会社の設定で付いている場合は管理者に確認

実機で確認したこと(v2.1.330)

2026年11月21日に、作業用のフォルダへ @anthropic-ai/claude-code@2.1.330 を入れ、ログインせず、手元の設定とは別の設定フォルダを指定した状態で確認しました。

  • claude --version は 2.1.330 (Claude Code) を返した
  • 実行ファイルの中に、繰り返しのタスクの上限として 2592000000 ミリ秒(30日)という値があった
  • 上限を持たないタスクには 604800000 ミリ秒(7日)を当て、タスク自身の上限と全体の上限のうち短いほうを使う処理があった。CHANGELOG の「このリリースより前に作ったタスクは7日のまま」と合う
  • Claude に渡すツールの説明には「繰り返しのタスクは期限が来ると、最後の回であることを添えて1回動き、その後に消える」「予定を作るときに期限を利用者に伝える」とあった

ループを実際に回したときの画面(期限の表示のしかたなど)は、ログインしないと確かめられないため、本記事では CHANGELOG と公式ドキュメントの記載として紹介しています。

関連する記事

よくある質問

まとめ

  • /loop は、開いているセッションの中で同じ指示を繰り返し実行させる組み込みのスキル。書き方は /loop [間隔] [指示]
  • 間隔を省くと Claude が1分〜1時間の間で待ち時間を決め、指示も省くと保守用の指示(または loop.md)が動く
  • 止め方は、Claude が間隔を決めるループなら Esc、間隔を指定したループなら Claude に取り消しを頼む。v2.1.329 以降は /tasks でも止められる
  • 期限は v2.1.330 以降に作ったタスクなら最長30日、それより前に作ったタスクは7日。長く回したいなら更新して作り直す
  • パソコンを閉じても動かしたいなら、クラウドの定期タスク(/schedule)や GitHub Actions を使う

/loop はリリースのたびに動きが変わっています。本記事も、公式ドキュメントの更新にあわせて見直します。

この記事に合う資料

関連記事

資料で全体をつかんでから、御社の場合をご相談ください

  • 研修・稟議・外注の準備に使える資料を無料で
  • 見積書の確認は、登録なしで診断できます
  • 相談は 30 分無料。代表が直接お返事します
  • 要件が決まっていなくても大丈夫です