gik|iewicz

szukaj
Claude Code '/loop’ – Wszystko co powinieneś wiedzieć o nowej opcji pętli

Claude Code '/loop’ – Wszystko co powinieneś wiedzieć o nowej opcji pętli


Anthropic wprowadził w marcu 2026 roku komendę /loop do Claude Code – wbudowany harmonogram zadań, który działa jak cron wewnątrz sesji terminalowej. Funkcja ta eliminuje potrzebę ręcznego powtarzania tych samych promptów i pozwala AI pracować w tle na twoim kodzie (Anthropic GitHub, 2026).

TL;DR: Komenda /loop w Claude Code to natywny scheduler zadań powtarzalnych działający w obrębie sesji. Pozwala definiować interwały (np. co 15 minut) lub wyrażenia cron dla precyzyjnego planowania. Loop automatycznie wygasa po 3 dniach, jest powiązany z sesją i pozwala na automatyzację monitorowania buildów, testów czy commitów bez zewnętrznych narzędzi.

Czym jest /loop i jak działa?

Komenda /loop została dodana w wersji Claude Code 2.1.71 jako odpowiedź na zapotrzebowanie deweloperów na automatyzację powtarzalnych zadań AI. Działa jak cron job uruchomiony wewnątrz sesji Claude Code – nie wymaga konfiguracji systemowej, crontab ani zewnętrznych schedulerów (MindStudio, 2026).

Gdy uruchamiasz /loop, Claude Code rejestruje zadanie powtarzalne powiązane z aktualną sesją. Na każdy cykl scheduler uruchamia prompt tak, jakbyś wpisał go ręcznie. Claude ma dostęp do kontekstu projektu, narzędzi i uprawnień które mu nadałeś.

Kluczowa różnica względem tradycyjnego cron: /loop nie tylko uruchamia komendę, ale daje Claude pełny kontekst sesji. AI może analizować wyniki poprzednich cykli, porównywać zmiany i dostosowywać swoje raporty. To nie jest dumb scheduler – to inteligentny agent pracujący na drugiej zmianie.

Składnia komendy /loop

Podstawowa forma komendy przyjmuje dwa parametry: prompt do wykonania oraz harmonogram wykonania.

Interwał czasowy:

/loop "sprawdź nowe komentarze TODO i zgłoś te dodane w ostatnim commicie" --interval 15m

Wyrażenie cron:

/loop "uruchom testy i podsumuj błędy" --cron "0 9 * * 1-5"

Flaga --interval przyjmuje wartości jak 5m, 1h, 30s. Flaga --cron obsługuje standardowe pięciopolowe wyrażenia cron dla precyzyjnego planowania – konkretne godziny, dni tygodnia, etc.

Możesz też ograniczyć liczbę cykli flagą --times:

/loop "pobierz status deployu" --interval 10m --times 6

Jak zarządzać aktywnymi pętlami?

Aby anulować aktywną pętlę, użyj:

/loop --cancel

Możesz też całkowicie wyłączyć funkcję cron w sesji ustawiając zmienną środowiskową:

export CLAUDE_CODE_DISABLE_CRON=1

To przydatne gdy chcesz zapobiec przypadkowemu uruchomieniu pętli w środowiskach produkcyjnych.

Z praktyki: Po dwóch tygodniach testowania /loop, najbardziej użyteczne okazały się interwały 15-30 minut dla monitoringu i godzina dla podsumowań. Krótsze interwały generują niepotrzebne koszty API, a dłuższe tracą aktualność informacji.

Praktyczne zastosowania /loop

Monitoring buildów i testów

Najczęstszy przypadek użycia – automatyczne monitorowanie czy build przechodzi:

/loop "uruchom npm run build i zgłoś czy przeszedł czy nie" --interval 10m

Claude wyłapuje błędy składniowe, problemy z zależnościami i zmiany w wynikach testów – nawet gdy nie patrzysz na terminal.

Codzienne podsumowanie commitów

Dla zespołów rozproszonych, poranne briefingi z repozytorium są nieocenione:

/loop "podsumuj wszystkie commity z ostatnich 24 godzin w prostym języku, pogrupowane według obszaru funkcjonalnego" --cron "0 8 * * 1-5"

Monitorowanie jakości kodu

Statyczne lintery nie wyłapują wszystkiego. /loop może pełnić rolę senior developera robiącego sanity check:

/loop "przejrzyj pliki zmienione w ostatnim commicie i oznacz funkcje dłuższe niż 50 linii lub bez obsługi błędów" --interval 30m

Sprawdzanie plików i pipeline’ów

Dla projektów przetwarzających pliki asynchronicznie:

/loop "sprawdź katalog /output pod kątem plików utworzonych w ciągu ostatniej godziny i zgłoś brakujące" --interval 1h

Limity i ograniczenia /loop

OgraniczenieOpisRozwiązanie
Wygasanie po 3 dniachLoops automatycznie kończą się po 72 godzinachUżyj system cron + claude -p dla trwałego schedulingu
Powiązanie z sesjąPętla umiera gdy kończysz sesjęUżyj tmux/screen do utrzymania sesji
Brak natywnego alertinguWyniki trafiają tylko do terminalaPipe’uj do skryptu wysyłającego Slack/email
Koszty APIKażdy cykl zużywa tokenyUżywaj /cost przed ustawieniem krótkich interwałów

Według analizy MindStudio, zadanie kosztujące $0.05 per run przy interwale 5 minut generuje $14.40 dziennie. Przed ustawieniem agresywnych interwałów sprawdź limity API w konsoli Anthropic i oszacuj koszt używając /cost po ręcznym uruchomieniu (MindStudio, 2026).

Kiedy użyć system cron zamiast /loop?

/loop jest idealny dla zadań powiązanych z kodem w aktywnej sesji developmentowej. Gdy potrzebujesz:

  • Przetrwania rebootów systemu
  • Gwarantowanego wykonania gdy Claude Code nie działa
  • Centralnego logowania przez standard output
  • Zadań na zdalnym serwerze

…użyj systemowego cron z flagą non-interactive:

# crontab -e
0 9 * * 1-5 claude -p "podsumuj commity z ostatnich 24h" >> /var/log/claude-summary.log

Porównanie /loop z Ralph Loop

Warto wspomnieć o alternatywie – Ralph Loop, który istniał przed natywnym /loop. Ralph to zewnętrzny plugin oferujący bardziej zaawansowane wykrywanie zakończenia pracy (intelligent exit detection). Główna różnica: /loop jest natywny, lżejszy i integrowany bezpośrednio w Claude Code, podczas gdy Ralph oferuje więcej kontroli nad warunkami zakończenia.

Najlepsze praktyki

  1. Dobierz interwał do wartości zadania – godzinowy wystarcza dla monitoringu, dzienny dla podsumowań
  2. Określ format wyjścia – nie determistyczne odpowiedzi Claude utrudniają parsowanie:
    /loop "sprawdź przestarzałe importy i wypisz TYLKO tablicę JSON ścieżek plików" --interval 1h
  3. Używaj tmux dla długotrwałych sesji – pętle przetrwają odłączenie od terminala
  4. Testuj ręcznie przed automatyzacją – uruchom prompt raz, sprawdź /cost, dopiero potem ustaw /loop

Często zadawane pytania

Czy /loop działa gdy komputer jest uśpiony?

Nie. /loop jest powiązany z procesem Claude Code. Gdy komputer przejdzie w stan uśpienia lub sesja się zakończy, pętle przestają działać. Dla zadań wymagających ciągłości użyj system cron lub serwera z always-on sesją.

Jaki jest minimalny interwał?

Nie ma udokumentowanego minimum, ale interwały poniżej minuty szybko uderzą w limity rate API Anthropic i wygenerują wysokie koszty. Zalecane minimum praktyczne to 5 minut.

Czy mogę mieć wiele aktywnych pętli?

Tak, ale każda zużywa tokeny niezależnie. Przy wielu pętlach koszty rosną liniowo. Monitoruj zużycie w konsoli Anthropic.

Jak sprawdzić które pętle są aktywne?

Użyj /loop --list aby wyświetlić wszystkie zarejestrowane pętle w bieżącej sesji.

Podsumowanie

Komenda /loop to znaczący krok w stronę autonomicznego AI development. Pozwala Claude Code pracować w tle na twoim kodzie – monitorować buildy, analizować commity, sprawdzać jakość kodu – bez Twojej ciągłej uwagi.

Kluczowe ograniczenia: wygasanie po 3 dniach, powiązanie z sesją, brak natywnego alertingu. Dla trwałego schedulingu połącz /loop z tmux lub użyj system cron z flagą -p.

Jeśli powtarzasz ten sam prompt częściej niż raz dziennie – /loop jest dla Ciebie.