
Claude Code のスケジュール実行、3つの方法を整理する
Claude Code に日次のタスク管理をやらせていたのですが、毎日手動でスキルを打つのが面倒になり自動化したくなりました。
そこで、Claude Code に「毎日実行するようにして」と頼んだところ /loop で設定してくれたのですが、怪しく思い調べたところセッションを閉じるたびに作り直す必要があることが判明。更に調べたところ、Claude Code のスケジュール実行には3つの方法があることが分かったのでまとめました。
この記事について
【 対象読者 】
- Claude Code に定期実行をさせたいと思っている方
- Claude Code の知見を深めたい方
本題
Claude Code でプロンプトを定期実行する方法は3つあります。
それぞれ動く場所や寿命が違うので、一つずつ見ていきましょう。
なお、公式ドキュメントには日本語版もありますが、翻訳がこなれていない箇所が多く意図が読み取りづらいことと情報が古い可能性を排除できることから、本記事では英語版から引用しています。
/loop(CronCreateツール)
公式ドキュメントには以下のように書かれています。
Use
/loopfor quick polling during a session.
この /loop コマンド (CronCreateツール) はセッション中の短期ポーリング用です。デプロイの完了監視、ビルドの完了チェックなどが想定されています。
ビルトインスキルなので、Claude Code から明示的に /loop コマンドを呼んでも設定できますし、自然言語で依頼することでも設定できます。
標準の5フィールドcron式(分 時 日 月 曜日)で柔軟にスケジュールを設定でき、最小間隔は1分です。
セッションスコープで動作するため、永続化機能はありません。 セッションを閉じればタスクも消えます。また、繰り返しジョブはセッションが生きていたとしても数日で自動的に削除されます(ドキュメントには3日、ツールスキーマには7日とあり、正確な日数は不明です)。いずれにせよ、長期運用を想定した機能ではありません。
/schedule(Cloudタスク)
公式ドキュメントには以下のように書かれています。
A scheduled task runs a prompt on a recurring cadence using Anthropic-managed infrastructure. Tasks keep working even when your computer is off.
この /schedule コマンドで作成する Cloudタスクは Anthropic のサーバー上で実行されます。
Claude Code の /schedule コマンドのほか、Web や デスクトップアプリからも作成できます。最小間隔は1時間で、Pro・Max・Team・Enterprise プランで利用可能です。
毎回リポジトリを新たに clone した上で新しいセッションが起動するため、前回の実行コンテキストは引き継がれません。 プロンプトはそれだけで完結する内容にしておく必要があります。
また、MCPサーバーは claude.ai 上で設定した Connectors(Slack, Linear 等の GUIセットアップ型 MCPサーバー)のみ利用可能です。リポジトリに .mcp.json をコミットしていても、Cloudタスクの実行環境では読み込まれません。また、対応するリポジトリは GitHub のみで、GitLab 等は利用できません。
Desktop Localタスク
公式ドキュメントには以下のように書かれています。
Local tasks: run on your machine. They have direct access to your local files and tools, but the desktop app must be open and your computer awake for them to run.
Desktop Localタスクは、デスクトップアプリが管理するスケジュール実行です。そのままのローカル環境上で実行されるので、言わずもがなローカルのファイルにもアクセス可能で、 ローカルで設定したMCPも使用できます。
デスクトップアプリの GUI から作成するか、Desktopセッション内で「毎朝9時にコードレビューして」のように自然言語で依頼して作成します。最小間隔は1分です。
なお、なぜ CLIの Claude Code からは作成できなくて、 Claude Desktop のセッション内からだと作成できるのかを調べたところ、デスクトップアプリには scheduled-tasks MCP という専用のMCPが設定されているから可能なようです。
また、大事なこととして、デスクトップアプリが起動中かつ PC がスリープしていない状態でないと実行されません。 スリープ中にスキップされたタスクは、復帰時に過去7日分までさかのぼってチェックし、最新の1回分だけキャッチアップ実行されます。
比較表
| /loop | /schedule | Desktop Local | |
|---|---|---|---|
| 設定方法 | CLI / Desktop | CLI / Web / Desktop | Desktop のみ |
| 実行場所 | ローカル | Anthropic Cloud | ローカル |
| PC起動が必要 | Yes | No | Yes |
| セッション起動が必要 | Yes | No | No |
| 永続性 | なし | あり | あり |
| 自動削除 | あり(3 or 7日で失効) | なし | なし |
| ローカルファイル | アクセス可 | アクセス不可 | アクセス可 |
| MCPサーバー | セッション継承 | Connectors のみ | ローカル設定 + Connectors |
| 最小間隔 | 1分 | 1時間 | 1分 |
| 実行遅延 | 周期の最大10%(上限15分) | 数分(固定) | 最大10分(固定) |
まとめ
公式ドキュメントの使い分けガイドがそのまま分かりやすいので引用しておきます。
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.
- /schedule(Cloudタスク): PCを閉じても確実に動かしたい場合
- Desktop Localタスク: ローカルのファイルやツールにアクセスしたい場合
- /loop: セッション中のちょっとしたポーリング
ちなみに冒頭の私のケースでは、ローカルの SQLite にアクセスが必要なこと、ローカルで設定しているMCPを使用する必要があることから Desktop Localタスク一択でした。
参考URL
- Run prompts on a schedule(/loop)
- Schedule tasks on the web(Cloudタスク)
- Claude Code Desktop(Desktop Localタスク)
クラスメソッドオペレーションズ株式会社について
クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AIをフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイト をぜひご覧ください。







