AICodingLab
Claude Code лайфхаки · Урок 21 из 35

Loop: авто-повторяющиеся задачи

🎯 Цель урока: Научиться использовать команду /loop для автоматического выполнения задач на регулярной основе, а также настроить выполнение через cron и освоить продвинутые техники автоматизации.

📖 Теория

Команда /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-часовые циклы

📝 Домашнее задание

  1. Базовый /loop: Настройте команду /loop для проверки статуса вашего приложения каждые 10 минут. Задача должна проверять HTTP endpoint и алертить при ошибках.
  2. Cron интеграция: Создайте cron-задание для автоматизации ежедневного бэкапа базы данных в 3 AM. Используйте wrapper скрипт для логирования.
  3. Dynamic loop: Создайте адаптивную loop-задачу, которая мониторит CI/CD pipeline и меняет частоту проверок в зависимости от статуса билда.
  4. Мониторинг: Реализуйте систему мониторинга для ваших cron-задач используя CronMonitor класс. Настройте алертинг при проблемах.
  5. Production wrapper: Доработайте claude-cron-wrapper скрипт: добавьте retry логику при временных ошибках, интеграцию с Prometheus для метрик.
  6. Интервалы: Попрактикуйтесь в использовании различных интервалов с командой /loop (5m, 1h, 6h, 1d) и различных cron-выражений.
  7. Отчёт: Опишите в документе, какие задачи вы автоматизировали с помощью /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: авто-повторяющиеся задачи» — наставник ответит, опираясь на его содержание. Он помогает понять, но не делает домашку за вас.

Привет! Я наставник по этому уроку. Спросите что угодно по теме — объясню простыми словами. 🙂
Ответы генерирует ИИ и может ошибаться — сверяйтесь с уроком.
ИИ-консультант
Помогу выбрать курс