Claude Codeの/loopコマンド｜定期実行でデプロイ監視・ステータスチェックを自動化する

Claude Codeの/loopコマンドは、指定したプロンプトやスラッシュコマンドを一定間隔で繰り返し実行する機能です。デプロイの完了監視、CI/CDパイプラインのステータスチェック、定期的なテスト実行など、「繰り返し確認する作業」をClaude Codeに任せることで、開発者は他の作業に集中できます。手動ポーリングの煩わしさを解消する実践的な使い方を解説します。

この記事でわかること

デプロイの完了待ちやCI/CDの結果確認など、「定期的に確認する作業」をClaude Codeに任せる方法を解説します。/loopコマンドを使えば、手動ポーリングから解放され、待ち時間を他の作業に充てられます。

• /loopコマンドの基本構文と間隔設定のルール — は、ClaudeCodeに組み込まれたスラッシュコマンドの一つです。
• デプロイ監視、CI/CDチェック、テスト実行の3つの主要ユースケース — 不必要に短い間隔はトークンの浪費につながります。デプロイ監視なら2〜5分、ヘルスチェックなら1分、長期の定期タスクなら10〜30分が目安です。
• /loopの停止条件と安全な運用のためのガイドライン — は実行のたびにClaudeCodeのトークンを消費します。短い間隔で長時間実行し続けると、トークン消費が大きくなります。
• 他のコマンドとの組み合わせによる高度な自動化パターン — はポーリング（定期チェック）型の自動化であり、Hooksはイベント駆動型の自動化です。
• トークン消費を抑えるための最適な使い方 — を停止するには、以下の方法があります。

対象読者: デプロイやCI/CDの監視を効率化したいエンジニア、Claude Codeの自動化機能を活用したい開発者

/loopコマンドとは

/loopは、Claude Codeに組み込まれたスラッシュコマンドの一つです。指定したプロンプトまたはスラッシュコマンドを、一定の間隔で繰り返し実行します。

開発作業では「デプロイが完了したか定期的に確認したい」「CIのステータスが変わったら教えてほしい」「テストが通るまで修正を繰り返したい」といった場面が頻繁にあります。こうした「ポーリング的な作業」は、手動で何度もコマンドを打つのが面倒で、かといってCIツールやcronで自動化するほどでもないケースが多いです。

/loopは、まさにその隙間を埋めるコマンドです。Claude Codeのセッション内で手軽に定期実行を設定でき、条件に応じて自動的に停止させることも可能です。

出典: Anthropic公式ドキュメント: Claude Code Overview

基本的な使い方

構文

/loop [間隔] [実行するプロンプトまたはコマンド]

• 間隔: 5m（5分）、30s（30秒）、1h（1時間）など。省略するとデフォルトの10分間隔で実行されます
• 実行内容: 自然言語のプロンプト、またはスラッシュコマンド

基本例

# 5分間隔でデプロイステータスを確認
/loop 5m デプロイのステータスを確認してください。完了していたら教えてください。

# 10分間隔（デフォルト）でテストを実行
/loop npm testを実行して結果を教えてください

# 30秒間隔でログを監視
/loop 30s 直近のサーバーログにエラーが出ていないか確認してください

停止方法

/loopを停止するには、以下の方法があります。

• Ctrl+C: 現在実行中のループを即座に停止
• 停止条件の指定: プロンプトに「○○が完了したら停止」と記述しておくと、Claude Codeが条件を判断して停止

# 停止条件付きのloop
/loop 5m Vercelのデプロイステータスを確認してください。デプロイが「Ready」になったらループを停止して教えてください。

パラメータ一覧

実務での活用パターン

パターン1: デプロイの完了監視

Before: vercel deployを実行した後、ブラウザでVercelのダッシュボードを開き、デプロイが完了するまで数分おきに画面を更新していました。デプロイの待ち時間に別の作業を始めると、完了に気づくのが遅れることもありました。

After: /loopでデプロイステータスを自動監視します。

/loop 2m vercel inspectコマンドで最新のデプロイステータスを確認してください。ステータスが「READY」になったら、デプロイURLとともにループを停止して教えてください。エラーの場合もすぐに教えてください。

この設定により、2分間隔でデプロイステータスを確認し、完了またはエラーが検出された時点で自動的に通知されます。待ち時間を他の作業に充てられるようになり、デプロイ完了の見逃しもなくなります。

GitHub Actionsなどの外部CIの監視にも応用できます。

/loop 3m gh run list --limit 1 を実行して、最新のGitHub Actionsの実行ステータスを確認してください。成功または失敗が確定したら教えてください。

パターン2: テストの自動修正ループ

Before: テストが失敗するたびに手動でエラーメッセージを確認し、コードを修正し、再度テストを実行していました。修正→テスト→確認のサイクルが1回あたり5〜10分かかり、複数のテストが連鎖的に失敗する場合は30分以上かかることもありました。

After: /loopでテスト実行と自動修正を繰り返します。

/loop 3m npm testを実行してください。失敗したテストがあれば、エラーメッセージを分析して修正を試みてください。全テストが通ったらループを停止して報告してください。

Claude Codeはテスト結果を分析し、コードの修正案を生成・適用し、再度テストを実行します。このサイクルが自動で繰り返されるため、開発者はテスト修正作業から解放されます。

ただし、この運用には注意点があります。Claude Codeの修正が的外れな場合、ループが永続的に実行され続ける可能性があります。ループ回数の上限を明示しておくのが安全です。

/loop 3m npm testを実行してください。失敗があれば修正を試みてください。全テスト通過でループ停止。5回実行しても通らない場合は停止して状況を報告してください。

パターン3: サービスのヘルスチェック

Before: 開発環境のサービス（API、データベース、外部連携など）がダウンした場合、手動でcurlやpingを叩いて復旧を確認していました。復旧待ちの間、他の作業に移ると復旧タイミングを逃すことがありました。

After: /loopでヘルスチェックを定期実行します。

/loop 1m curl -s http://localhost:3000/api/health のレスポンスを確認してください。200が返ってきたら「サービス復旧」と教えてください。エラーの場合はステータスコードを記録してください。

開発サーバーの再起動待ち、データベースのマイグレーション完了待ち、外部APIの復旧待ちなど、「状態が変わるまで待つ」あらゆるシーンに応用できます。

/loopの安全な運用ガイドライン

トークン消費への配慮

/loopは実行のたびにClaude Codeのトークンを消費します。短い間隔で長時間実行し続けると、トークン消費が大きくなります。

間隔は目的に応じて適切に設定してください。「とりあえず30秒間隔」で設定すると、不要なトークン消費が発生します。

停止条件の明確化

/loopを使用する際は、必ず停止条件を含めてください。停止条件がないと、手動でCtrl+Cするまでループが永続的に実行されます。

推奨される停止条件の例:

• 「ステータスが○○になったら停止」
• 「N回実行したら停止」
• 「エラーが検出されたら停止」
• 「特定の時刻を過ぎたら停止」

副作用のある操作に注意

/loopで副作用のある操作（ファイルの書き込み、APIの呼び出し、デプロイの実行など）を繰り返す場合は、冪等性（何度実行しても同じ結果になること）を意識してください。冪等でない操作をループで繰り返すと、意図しない重複処理が発生する可能性があります。

関連コマンドとの組み合わせ

/loop × Hooks: イベント駆動との使い分け

/loopはポーリング（定期チェック）型の自動化であり、Hooksはイベント駆動型の自動化です。両者は目的が異なります。

外部システムのステータスを監視するなら/loop、Claude Code自身の操作にフックを仕掛けるならHooksを使います。詳しくは「Claude Code Hooksで開発を自動化する方法」で解説しています。こうしたAI活用に関心のある方は、経営データの可視化やコンテンツマーケティングの効率化の詳細もあわせてご覧ください。

/loop × /compact: 長時間ループのコンテキスト管理

/loopを長時間実行すると、実行ごとの結果がコンテキストウィンドウに蓄積されていきます。コンテキストが埋まると、Claude Codeの応答精度が低下したり、自動的にコンテキストの圧縮が走ったりします。

長時間の/loopを実行する場合は、ループのプロンプトに「前回の結果を簡潔にサマリーして記録し、詳細は破棄してください」と指示しておくと、コンテキストの消費を抑えられます。詳しくは「Claude Codeの/compactコマンド」で解説しています。

/loop × カスタムコマンド: よく使う監視パターンのテンプレート化

頻繁に使用する/loopパターンをカスタムスラッシュコマンドとして定義しておくと、毎回プロンプトを入力する手間が省けます。

.claude/commands/monitor-deploy.md:

Vercelの最新デプロイステータスを確認してください。
- vercel inspect で最新のデプロイを取得
- ステータスが READY なら「デプロイ完了」と報告してループ停止
- ステータスが ERROR なら「デプロイ失敗」と報告してループ停止
- それ以外なら現在のステータスを1行で報告

/loop 2m /project:monitor-deploy

詳しくは「Claude Codeカスタムコマンド」で解説しています。

/loop × ヘッドレスモード: バックグラウンド監視

Claude Codeの-p（print）フラグと組み合わせることで、バックグラウンドでの定期実行スクリプトを構築できます。

# バックグラウンドでデプロイ監視を実行
while true; do
  result=$(claude -p "vercel inspectで最新デプロイのステータスを確認。READYなら'DONE'とだけ出力。それ以外は'WAITING'と出力。")
  if echo "$result" | grep -q "DONE"; then
    echo "デプロイ完了！"
    break
  fi
  sleep 120
done

この方法はシェルスクリプトとして保存できるため、CI/CDパイプラインやcronジョブに組み込むことも可能です。

/loopのベストプラクティス

1. 間隔は目的に合わせて最小限に

不必要に短い間隔はトークンの浪費につながります。デプロイ監視なら2〜5分、ヘルスチェックなら1分、長期の定期タスクなら10〜30分が目安です。

2. 停止条件は必ず含める

「○○になったら停止」「N回実行したら停止」という条件を明示してください。無条件の/loopは、手動停止を忘れるリスクがあります。

3. 出力は簡潔に指示する

ループ内で毎回詳細なレポートを出力させると、コンテキストウィンドウが早く埋まります。「状態に変化がなければ1行で報告」と指示しておくのが効率的です。

4. 副作用のある操作は冪等性を確認

ファイルの上書き、APIの呼び出し、データの更新など、副作用のある操作をループで繰り返す場合は、同じ操作を何度実行しても安全であることを確認してください。

あわせて読みたい

• Claude Coworkで営業チームを支援する方法｜商談準備・提案書・フォローの自動化
• Claude Codeの企業導入セキュリティガイド｜managed-settings・情報漏洩対策・Team/Enterprise選定
• Claude Codeのパーミッションモード完全ガイド｜default・plan・auto・bypassの使い分け

まとめ

/loopコマンドは、Claude Codeで定期実行タスクを手軽に設定する機能です。デプロイの完了監視、CI/CDステータスのチェック、テストの自動修正ループ、サービスのヘルスチェックなど、「定期的に確認する必要があるが自動化するほどでもない作業」を効率化できます

押さえておきたいポイントは以下の通りです。

• 停止条件を明示する、間隔を適切に設定する、トークン消費に配慮するという3つの基本ルールを守れば、安全かつ効果的に運用できます
• Hooksとの使い分け（ポーリング型 vs イベント駆動型）を意識し、カスタムコマンドとの組み合わせでよく使うパターンをテンプレート化すると、日常の開発ワークフローがさらにスムーズになります
• *Claude Codeの全コマンド一覧はClaude Codeチートシートをご覧ください
• AI活用の全体像はAI活用完全ガイドで解説しています

よくある質問（FAQ）

Q1. /loopはセッションを閉じても継続しますか？

いいえ。/loopはClaude Codeのセッション内でのみ動作します。ターミナルを閉じたり、Claude Codeのセッションを終了したりすると、ループも停止します。永続的な定期実行が必要な場合は、シェルスクリプト + cronジョブの組み合わせや、ヘッドレスモード（claude -p）を使ったバックグラウンドスクリプトを検討してください。tmuxやscreenでセッションを維持する方法もあります。

Q2. /loopの実行中に別のコマンドを入力できますか？

/loopの実行中は、ループの次の実行まで待機している間にClaude Codeへの入力が可能です。ループの実行中（AIが処理を行っている最中）は入力を待つ必要があります。ループを止めずに別の作業をしたい場合は、別のターミナルウィンドウで新しいClaude Codeセッションを開始し、並行して作業するのが実用的です。

Q3. /loopでAPI呼び出しを繰り返しても大丈夫ですか？

外部APIのレートリミットに注意してください。たとえば、GitHub APIは認証ありで1時間5,000リクエスト、Vercel APIにも同様のレートリミットがあります。/loopの間隔とAPI呼び出し回数を計算し、レートリミットを超えないことを事前に確認してください。Claude Codeが内部的に複数回APIを呼び出す場合もあるため、余裕を持った間隔設定が推奨されます。レートリミットに引っかかった場合は、Claude Codeがエラーを報告するので、間隔を広げて再実行してください。