Loop: авто-повторяющиеся задачи
📖 Теория
Команда /loop в Claude Code позволяет вам создавать авто-повторяющиеся задачи, что значительно упрощает рутинные операции. Это особенно полезно, когда вам нужно выполнять одно и то же действие через определённые промежутки времени. Настройка выполнения через cron позволяет вам гибко управлять частотой выполнения задач, используя стандартный синтаксис этой утилиты.
Архитектура /loop
Команда /loop работает в двух режимах:
- Static mode: фиксированный интервал (например,
/loop 30m) - Dynamic mode: адаптивное расписание через
ScheduleWakeup
Жизненный цикл loop-задачи:
1. Инициализация: /loop <интервал> <промпт>
2. Выполнение: Claude выполняет промпт
3. Планирование: Определяется следующий запуск
4. Сон: Задача ждёт до следующего запуска
5. Повтор: Возврат к шагу 2
Что такое cron?
cron— это планировщик задач в Unix-подобных операционных системах, который позволяет запускать команды или скрипты в заданное время или через определённые интервалы.- Синтаксис cron-задания состоит из пяти полей, которые определяют минуту, час, день месяца, месяц и день недели.
- Пример:
0 * * * *— это задание, которое будет выполняться каждый час на нулевой минуте.
Cron vs /loop: когда что использовать
| Критерий | /loop | cron |
|---|---|---|
| Простота | ✅ Одна команда, без конфигурации | ❌ Требует редактирования crontab |
| Контекст | ✅ Сохраняет контекст сессии Claude | ❌ Каждый запуск — новая сессия |
| Адаптивность | ✅ Может менять интервал динамически | ❌ Фиксированное расписание |
| Надёжность | ❌ Работает только пока сессия активна | ✅ Работает независимо от сессии |
| Масштабируемость | ❌ Ограничено одной сессией | ✅ Множество независимых задач |
| Логирование | ✅ Встроено в сессию Claude | ❌ Требует ручной настройки |
Рекомендации:
- Используйте
/loopдля краткосрочных задач во время активной сессии - Используйте
cronдля долгосрочных фоновых задач на сервере - Комбинируйте оба: cron запускает сессию Claude, внутри которой работает /loop
🛠 Практика
Базовое использование /loop
Шаг 1. Создайте простую задачу с использованием команды /loop. Например, вы хотите, чтобы Claude Code проверял наличие обновлений в вашем репозитории GitHub каждые 30 минут.
/loop 30m check for new commits in the main branch
Что происходит под капотом:
# Claude Code создаёт задачу через CronCreate
CronCreate({
cron: "*/30 * * * *",
prompt: "check for new commits in the main branch",
recurring: true
})
# Задача выполняется каждые 30 минут
# Результаты появляются в вашей сессии автоматически
Варианты интервалов:
/loop 5m # Каждые 5 минут
/loop 1h # Каждый час
/loop 6h # Каждые 6 часов
/loop 1d # Раз в день
/loop 1w # Раз в неделю
Dynamic Loop с адаптивным расписанием
Пример: мониторинг CI/CD с умным расписанием
/loop check CI/CD pipeline status and notify me when builds complete
# Claude адаптирует интервалы:
# - Если билд активен → проверка каждые 2 минуты
# - Если билд завершён → проверка каждые 30 минут
# - Если ночь → проверка каждые 2 часа
Claude использует ScheduleWakeup для оптимизации:
ScheduleWakeup({
delaySeconds: 120, // 2 минуты во время активного билда
noop: false, // Есть изменения
reason: "CI build in progress, checking status",
prompt: "<>"
})
Продвинутые сценарии с /loop
Сценарий 1: Автоматический code review
/loop 1h check for new pull requests and review them
# Claude будет:
# 1. Проверять новые PR каждый час
# 2. Анализировать изменения
# 3. Оставлять комментарии с замечаниями
# 4. Уведомлять вас о критичных проблемах
Сценарий 2: Мониторинг production метрик
/loop 10m monitor error rate and alert if > 1%
# Claude будет:
# - Читать логи production сервера
# - Считать error rate
# - Если > 1% → отправлять PushNotification
# - Автоматически создавать incident ticket
Сценарий 3: Автоматическое обновление документации
/loop 1d update API documentation if code changed
# Claude проверяет:
# - Изменения в API endpoints
# - Обновляет OpenAPI spec
# - Регенерирует документацию
# - Создаёт PR с изменениями
Настройка Cron для долгосрочных задач
Шаг 2. Настройте cron для выполнения задачи. Откройте терминал и введите:
crontab -e
Базовый синтаксис cron:
# ┌───────────── минута (0 - 59)
# │ ┌───────────── час (0 - 23)
# │ │ ┌───────────── день месяца (1 - 31)
# │ │ │ ┌───────────── месяц (1 - 12)
# │ │ │ │ ┌───────────── день недели (0 - 6) (воскресенье=0)
# │ │ │ │ │
# * * * * * команда для выполнения
Примеры cron-выражений:
# Каждые 30 минут
*/30 * * * * /path/to/script.sh
# Каждый час в начале часа
0 * * * * /path/to/script.sh
# Каждый день в 2:30 AM
30 2 * * * /path/to/backup.sh
# Каждый понедельник в 9:00
0 9 * * 1 /path/to/weekly-report.sh
# Каждый первый день месяца в полночь
0 0 1 * * /path/to/monthly-task.sh
# Каждый рабочий день в 8:00
0 8 * * 1-5 /path/to/morning-sync.sh
Интеграция Claude Code с cron:
# /etc/cron.d/claude-tasks
SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin
# Ежечасная проверка обновлений
0 * * * * user cd /project && claude "check for dependency updates" >> /var/log/claude-updates.log 2>&1
# Ежедневный бэкап в 3 AM
0 3 * * * user cd /project && claude "create backup of database and upload to S3" >> /var/log/claude-backup.log 2>&1
# Еженедельный отчёт по пятницам в 17:00
0 17 * * 5 user cd /project && claude "generate weekly report and send via email" >> /var/log/claude-reports.log 2>&1
Шаг 3. Проверьте, что ваша задача успешно добавлена:
crontab -l
# Проверить логи выполнения
grep CRON /var/log/syslog
# Мониторинг последнего запуска
ls -la /var/spool/cron/crontabs/
Production-Ready Cron Wrapper для Claude Code
#!/usr/bin/env bash
# /usr/local/bin/claude-cron-wrapper
# Обёртка для безопасного запуска Claude Code из cron
set -euo pipefail
# Конфигурация
PROJECT_DIR="${PROJECT_DIR:-/var/www/myproject}"
LOG_DIR="${LOG_DIR:-/var/log/claude-cron}"
LOCK_DIR="/var/lock/claude-cron"
MAX_RUNTIME=3600 # 1 час
NOTIFICATION_EMAIL="devops@example.com"
# Создаём директории
mkdir -p "$LOG_DIR" "$LOCK_DIR"
# Функция логирования
log() {
echo "[$(date +'%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_DIR/wrapper.log"
}
# Функция для отправки уведомлений
notify() {
local subject="$1"
local message="$2"
echo "$message" | mail -s "$subject" "$NOTIFICATION_EMAIL"
log "Notification sent: $subject"
}
# Проверка lock файла (предотвращение параллельных запусков)
TASK_NAME="$1"
LOCK_FILE="$LOCK_DIR/${TASK_NAME}.lock"
if [ -f "$LOCK_FILE" ]; then
PID=$(cat "$LOCK_FILE")
if ps -p "$PID" > /dev/null 2>&1; then
log "Task $TASK_NAME is already running (PID: $PID)"
exit 0
else
log "Stale lock file found, removing"
rm -f "$LOCK_FILE"
fi
fi
# Создаём lock файл
echo $$ > "$LOCK_FILE"
trap "rm -f $LOCK_FILE" EXIT
# Переходим в проект
cd "$PROJECT_DIR" || {
log "ERROR: Cannot cd to $PROJECT_DIR"
exit 1
}
# Формируем имя лог-файла
LOG_FILE="$LOG_DIR/${TASK_NAME}_$(date +'%Y%m%d_%H%M%S').log"
# Запускаем задачу с таймаутом
log "Starting task: $TASK_NAME"
START_TIME=$(date +%s)
timeout "$MAX_RUNTIME" claude "${@:2}" > "$LOG_FILE" 2>&1
EXIT_CODE=$?
END_TIME=$(date +%s)
DURATION=$((END_TIME - START_TIME))
# Анализируем результат
if [ $EXIT_CODE -eq 0 ]; then
log "Task $TASK_NAME completed successfully in ${DURATION}s"
elif [ $EXIT_CODE -eq 124 ]; then
log "ERROR: Task $TASK_NAME timed out after ${MAX_RUNTIME}s"
notify "Claude Cron: Task Timeout" "Task $TASK_NAME exceeded ${MAX_RUNTIME}s limit"
else
log "ERROR: Task $TASK_NAME failed with exit code $EXIT_CODE"
notify "Claude Cron: Task Failed" "Task $TASK_NAME failed. Check logs: $LOG_FILE"
fi
# Ротация логов (храним только последние 30 дней)
find "$LOG_DIR" -name "${TASK_NAME}_*.log" -mtime +30 -delete
exit $EXIT_CODE
Использование wrapper:
# В crontab
0 * * * * /usr/local/bin/claude-cron-wrapper check-updates "check for new commits and create summary"
30 2 * * * /usr/local/bin/claude-cron-wrapper backup "backup database to S3"
0 9 * * 1 /usr/local/bin/claude-cron-wrapper weekly-report "generate weekly metrics report"
Мониторинг и алертинг для Cron задач
#!/usr/bin/env python3
"""
Cron Monitor - отслеживание состояния cron-задач
"""
import os
import json
from datetime import datetime, timedelta
from pathlib import Path
class CronMonitor:
def __init__(self, log_dir="/var/log/claude-cron"):
self.log_dir = Path(log_dir)
self.state_file = self.log_dir / "monitor-state.json"
def check_task_health(self, task_name, expected_interval_minutes=60):
"""Проверить, что задача выполнялась недавно"""
pattern = f"{task_name}_*.log"
log_files = sorted(self.log_dir.glob(pattern), reverse=True)
if not log_files:
return {
"status": "MISSING",
"message": f"No logs found for {task_name}"
}
latest_log = log_files[0]
last_run = datetime.fromtimestamp(latest_log.stat().st_mtime)
time_since = datetime.now() - last_run
expected_delta = timedelta(minutes=expected_interval_minutes * 1.5)
if time_since > expected_delta:
return {
"status": "STALE",
"message": f"Last run {time_since} ago (expected every {expected_interval_minutes}m)",
"last_run": last_run.isoformat()
}
# Проверяем на ошибки в логе
with open(latest_log) as f:
content = f.read()
if "ERROR" in content or "failed" in content.lower():
return {
"status": "FAILED",
"message": "Errors found in latest log",
"last_run": last_run.isoformat()
}
return {
"status": "HEALTHY",
"message": f"Last run {time_since} ago",
"last_run": last_run.isoformat()
}
def get_all_tasks(self):
"""Получить список всех задач"""
tasks = set()
for log_file in self.log_dir.glob("*_*.log"):
task_name = "_".join(log_file.stem.split("_")[:-2])
tasks.add(task_name)
return sorted(tasks)
def generate_report(self):
"""Сгенерировать отчёт о состоянии всех задач"""
report = {
"timestamp": datetime.now().isoformat(),
"tasks": {}
}
for task in self.get_all_tasks():
report["tasks"][task] = self.check_task_health(task)
return report
def alert_if_needed(self):
"""Отправить алерт если есть проблемы"""
report = self.generate_report()
failed_tasks = [
name for name, status in report["tasks"].items()
if status["status"] in ["FAILED", "STALE", "MISSING"]
]
if failed_tasks:
message = f"Cron tasks need attention:\n\n"
for task in failed_tasks:
status = report["tasks"][task]
message += f"❌ {task}: {status['status']} - {status['message']}\n"
# Отправить в Slack/Email/etc
print(message)
return False
return True
# Использование
if __name__ == "__main__":
monitor = CronMonitor()
# Проверить здоровье конкретной задачи
health = monitor.check_task_health("check-updates", expected_interval_minutes=60)
print(f"Task health: {health}")
# Полный отчёт
report = monitor.generate_report()
print(json.dumps(report, indent=2))
# Алертинг
monitor.alert_if_needed()
Добавить мониторинг в cron:
# Проверка здоровья задач каждые 15 минут
*/15 * * * * python3 /usr/local/bin/cron-monitor.py
⚠️ Troubleshooting
Проблема 1: /loop задача не запускается
Симптомы: Команда /loop не выполняется по расписанию.
Решение:
# Проверить список активных loop-задач
CronList()
# Проверить, не истёк ли TTL (loop работает только 7 дней)
# Пересоздать задачу
/loop 30m your task here
# Убедиться что сессия Claude не закрыта
# Loop работает только в активной сессии
Проблема 2: Cron задача не выполняется
Симптомы: Задача в crontab, но не запускается.
Решение:
# Проверить права на выполнение скрипта
chmod +x /path/to/script.sh
# Проверить переменные окружения
# Cron имеет минимальный PATH
# Добавить в начало crontab:
PATH=/usr/local/bin:/usr/bin:/bin
SHELL=/bin/bash
# Проверить логи cron
grep CRON /var/log/syslog
tail -f /var/log/cron
# Проверить синтаксис crontab
crontab -l | grep -v '^#' | grep -v '^$'
# Тест запуска вручную
/bin/bash -c "$(crontab -l | grep your-task)"
Проблема 3: Cron работает, но Claude Code не запускается
Симптомы: Скрипт выполняется, но Claude не отвечает.
Решение:
# Проверить, что claude в PATH
which claude
# Указать полный путь в crontab
0 * * * * /usr/local/bin/claude "your prompt"
# Проверить переменные окружения
# Добавить в crontab:
CLAUDE_API_KEY=your-key-here
HOME=/home/user
# Проверить логи
0 * * * * claude "test" >> /tmp/claude-cron.log 2>&1
Проблема 4: Loop задача замедляет сессию
Симптомы: Сессия Claude тормозит из-за loop задач.
Решение:
# Увеличить интервал
/loop 1h вместо /loop 5m
# Использовать dynamic mode для адаптивного расписания
/loop your adaptive task
# Или перенести на cron для фонового выполнения
CronDelete task-id # удалить loop
# Настроить cron вместо этого
Проблема 5: Задача пропускает выполнения
Симптомы: Cron пропускает некоторые запуски.
Решение:
# Проверить, не перекрываются ли задачи
# Если задача выполняется дольше интервала, используйте lock:
#!/bin/bash
LOCKFILE=/tmp/mytask.lock
if [ -f "$LOCKFILE" ]; then
echo "Task already running"
exit 0
fi
touch "$LOCKFILE"
trap "rm -f $LOCKFILE" EXIT
# Ваша задача здесь
claude "do something"
Проблема 6: Cron задачи не отправляют email уведомления
Симптомы: Настроен MAILTO, но письма не приходят.
Решение:
# Проверить почтовый агент
which sendmail || apt-get install mailutils
# Добавить в crontab
MAILTO=your-email@example.com
# Тест отправки
echo "test" | mail -s "Cron test" your-email@example.com
# Использовать внешний сервис для критичных уведомлений
curl -X POST https://api.slack.com/webhooks/your-webhook \
-d '{"text":"Cron task completed"}'
Проблема 7: Loop превышает context window
Симптомы: После нескольких итераций loop переполняется контекст.
Решение:
# Используйте noop: true для тихих итераций
ScheduleWakeup({
delaySeconds: 300,
noop: true, # Эта итерация не добавит в историю
reason: "No changes detected"
})
# Или перезапускайте loop периодически
# Вместо бесконечного loop, делайте 24-часовые циклы
📝 Домашнее задание
- Базовый /loop: Настройте команду
/loopдля проверки статуса вашего приложения каждые 10 минут. Задача должна проверять HTTP endpoint и алертить при ошибках. - Cron интеграция: Создайте cron-задание для автоматизации ежедневного бэкапа базы данных в 3 AM. Используйте wrapper скрипт для логирования.
- Dynamic loop: Создайте адаптивную loop-задачу, которая мониторит CI/CD pipeline и меняет частоту проверок в зависимости от статуса билда.
- Мониторинг: Реализуйте систему мониторинга для ваших cron-задач используя CronMonitor класс. Настройте алертинг при проблемах.
- Production wrapper: Доработайте claude-cron-wrapper скрипт: добавьте retry логику при временных ошибках, интеграцию с Prometheus для метрик.
- Интервалы: Попрактикуйтесь в использовании различных интервалов с командой
/loop(5m, 1h, 6h, 1d) и различных cron-выражений. - Отчёт: Опишите в документе, какие задачи вы автоматизировали с помощью
/loopи cron. Сравните производительность и удобство обоих подходов.
🎓 После урока вы умеете
- Использовать команду
/loopдля автоматизации рутинных задач - Настраивать
cronдля выполнения команд на регулярной основе - Работать с синтаксисом cron для гибкой настройки времени выполнения задач
- Применять различные интервалы в команде
/loopдля решения своих задач - Создавать production-ready wrapper скрипты для безопасного запуска Claude из cron
- Настраивать мониторинг и алертинг для cron-задач
- Использовать dynamic loop с адаптивным расписанием
- Диагностировать и решать типичные проблемы с loop и cron
- Интегрировать Claude Code в CI/CD pipeline через cron
- Оптимизировать context window usage в долгоживущих loop-задачах
🔗 Дополнительные ресурсы
Рекомендуемые курсы
Продолжите обучение по смежным темам
ИИ-наставник по этому уроку
Задайте вопрос по теме урока «Loop: авто-повторяющиеся задачи» — наставник ответит, опираясь на его содержание. Он помогает понять, но не делает домашку за вас.