定期タスクとは：ローカルとクラウドの違い

公式ドキュメントでは、DesktopアプリのScheduled tasksページに、ローカルのタスクとクラウドのタスク（以前の名前はRoutines）が並んで表示されると説明されています。

手元のファイルやツールを使いたいならDesktop、PCを切っていても動かしたいならクラウドが向いています。この記事はDesktop（ローカル）のタスクを扱います。クラウドの詳しい設定は公式のScheduled tasksのページを見てください。

定期タスクの作り方（手順）

公式ドキュメントの手順は次のとおりです。画面は版によって少し違うので、見えている項目に合わせて進めてください。

1. Scheduledページを開く：DesktopのCodeタブで、サイドバーのScheduled（またはMoreメニュー内）をクリックします。
2. New taskをクリック：Create with ClaudeとSet up manuallyが出たら、Set up manuallyを選びます。
3. 名前を付ける：入力した名前は小文字のケバブケースに変換され、タスクのフォルダ名になります。ほかのタスクと重複しない名前にします。
4. 指示を書く：実行のたびにClaudeが何をするかを書きます。
5. Only on this computerをオン：Advanced settingsのGeneralタブにあります。オンにすると、自分のPCのローカルフォルダで動きます。
6. Local folderを選ぶ：選ばないとCreateが押せません。
7. スケジュールを選ぶ：Triggerのカードでプリセットを選びます。
8. 権限モードとモデルを選ぶ：指示ボックスのツールバーから選びます。変えなければ、Claude Codeの設定と既定のモデルが使われます。
9. Createをクリック：フォルダを信頼していなければ、ここで確認が出ます。

画面を操作しなくても、どのセッションでも「毎朝9時にコードレビューを実行する定期タスクを作って」のように頼めば、定期タスクが作られます。「明日の15時にデプロイの確認を促して」のような頼み方では、1回だけ動いて自動で無効になるタスクになります。

スケジュールの選択肢：Hourly・Daily・Weekdays・Weekly・Custom

Custom（cron式）の書き方には注意点があります。公式ドキュメントによると、曜日や月は名前ではなく数字で書き、日曜は7ではなく0です。たとえば毎朝9時なら次のとおりです。

0 9 * * *

1時間より短い間隔の式は、フォームでは受け付けられません。また、「ManualとCustom」は、タスクを作った後のEditフォームから選べます。

1時間より短い間隔にしたいときは、Claudeに「テストを30分ごとに実行して」と頼む方法があります。公式ドキュメントでは、Claudeに頼む場合は1時間の制限を受けないと説明されています。

PCがスリープしたらどうなるか：実行のずれと取りこぼし

ローカルのタスクは、Desktopアプリが起動していて、PCが起きている間だけ動きます。ここを知らないと「朝になっても動いていない」ことになります。

• Desktopは、アプリが開いている間、1分ごとに予定を確認する
• 予定の時刻から数分の遅れが入る（同じタスクでは毎回同じ長さ）
• PCがスリープしていた時刻の実行はスキップされる
• アイドル時のスリープを防ぐには、Settings > Desktop appまたはSettings > This computer > SystemのKeep computer awakeをオンにする
• ノートPCのフタを閉じると、この設定でもスリープする

取りこぼした分は1回だけ実行される

アプリの起動時やPCの復帰時に、Desktopは過去7日間の取りこぼしを調べます。あれば、最も新しい取りこぼしについて1回だけ追いかけて実行し、それより古い分は捨てます。6日間スリープしていた毎日のタスクも、復帰時に1回だけ動きます。

そのため、9時のタスクが夜の23時に動くことがあります。時刻が大事なら、指示の中に条件を入れておきます。公式ドキュメントは次のような例を挙げています。

今日のコミットだけをレビューする。17時を過ぎていたらレビューはせず、取りこぼした内容の要約だけを出す。

スリープ対策を詳しく知りたい場合は、MacBookを閉じたまま動かし続ける設定ガイドも参考になります。

権限で止まらないようにする

タスクごとに権限モードを持ちます。~/.claude/settings.jsonの許可ルールも、定期タスクのセッションに適用されます。

Manualモードのタスクが、許可のないツールを使おうとすると、承認されるまで実行が止まります。夜間に動くタスクだと、朝まで止まったままになりかねません。公式ドキュメントが勧める予防策は次のとおりです。

1. 作成したらすぐにRun nowを押す
2. 権限の確認が出たら、そのたびに「always allow」を選ぶ
3. 以降の実行では、同じツールが自動で承認される

承認済みの内容は、タスクの詳細ページのAlways allowedパネルで確認・取り消しができます。なお、MCPツールのうちrequiresUserInteractionが付いたものは、毎回確認が出て「always allow」を選べないため、それを呼ぶタスクは毎回止まります。

作成後の管理と、設定ファイルの場所

サイドバーのScheduledからタスクを開くと、詳細ページで次の操作ができます。

スキップの理由には、PCがスリープしていた、前回の実行がまだ終わっていなかった、ほかのタスクが実行中だった、などがあります。動かなかった日は、まずHistoryを見てください。

指示の中身は、~/.claude/scheduled-tasks/<タスク名>/SKILL.mdに保存されます。frontmatterにnameとdescription、本文が指示です。編集すると次の実行から反映されます。ただし、スケジュール・フォルダ・モデル・有効かどうかは、このファイルではなくEditフォームか、Claudeへの依頼で変えます。削除してもこのフォルダは残るので、消したいときは自分で削除します。

ファイルを同じ状態から動かしたくない場合は、EditフォームでWorktreeを選ぶと、実行ごとに独立したGitワークツリーで動きます（フォルダがGitリポジトリのときだけ選べます）。何も選ばないと、コミットしていない変更も含めた、そのときの作業フォルダの状態で動きます。

よくある質問（FAQ）

まとめ

まずは「毎朝の確認」のような軽い作業を1つ作り、Run nowで動きを確かめるところから始めてみてください。