Wiedza

Routines w Claude Code – wszystko, co musisz wiedzieć na start

Futuristic digital interface displayed on laptop screen with neon red keyboard.
Większość osób zakłada, że automatyzacja w narzędziach AI wymaga ciągłego nadzoru: otwartego terminala, aktywnej sesji, laptopa stojącego na biurku. Routines in Claude Code działają zupełnie inaczej – zadania wykonują się na infrastrukturze chmurowej zarządzanej przez Anthropic, więc twój komputer może być wyłączony, a praca i tak postępuje. To nie jest drobna różnica w wygodzie. To zmiana w tym, jak w ogóle myślisz o delegowaniu pracy do modelu.

Czym są routines w Claude Code?

Routine to zapisana konfiguracja Claude Code złożona z trzech elementów: promptu, jednego lub więcej repozytoriów oraz zestawu connectorów. Wszystkie te elementy pakujesz raz, a następnie uruchamiasz automatycznie – bez konieczności ręcznego wyzwalania każdego cyklu.

Istotne jest to, że routine nie jest po prostu zaplanowanym skryptem. Claude Code wykonuje go z pełnym dostępem do kontekstu repozytorium, może korzystać z podłączonych integracji i reaguje na zdarzenia zewnętrzne. Różnica między zwykłym harmonogramem zadań a routine polega na tym, że model rozumie, co robi – nie tylko wykonuje polecenie.

Funkcja była dostępna w momencie pisania tego tekstu jako research preview, co oznacza, że interfejs i możliwości mogą się jeszcze zmieniać. Dostęp mają użytkownicy planów Pro, Max, Team i Enterprise z włączonym Claude Code on the web. Konfigurację tworzysz przez claude.ai/code lub komendę `/schedule` w CLI – oba sposoby prowadzą do tego samego rezultatu, różnią się tylko punktem wejścia.

Od razu warto rozwiać częste nieporozumienie: routine nie wymaga repozytorium GitHub jako obowiązkowego elementu, ale w praktyce większość zastosowań opiera się właśnie na pracy z kodem. Możesz jednak skonfigurować routine wyłącznie z promptem i connectorami – bez żadnego repo. Taka konfiguracja ma sens na przykład wtedy, gdy chcesz cyklicznie przetwarzać dane z zewnętrznego źródła, nie dotykając żadnego repozytorium.

Trzy typy wyzwalaczy – jak uruchomić routine?

Sposób uruchamiania routine decyduje o tym, do jakich scenariuszy się nadaje. W dokumentacji opisano trzy typy wyzwalaczy, które pokrywają zdecydowaną większość przypadków użycia.

Dostępne wyzwalacze to:

  • schedule – routine uruchamia się według harmonogramu: co godzinę (hourly), każdej nocy (nightly), raz w tygodniu (weekly) albo jednorazowo o określonej przyszłej godzinie;
  • API call – wywołanie zewnętrzne z twojego systemu lub skryptu wyzwala wykonanie routine; przydatne, gdy chcesz integrować Claude Code z własnym pipeline’em;
  • GitHub events – routine reaguje na zdarzenia w repozytorium, takie jak nowy pull request, merge lub push do wskazanej gałęzi.

Każdy z tych trybów nadaje się do innych zadań. Harmonogram sprawdza się przy regularnych przeglądach kodu, generowaniu raportów czy aktualizacjach dokumentacji. Wywołanie API pasuje do sytuacji, gdy chcesz ręcznie wyzwolić routine z zewnętrznego systemu – na przykład jako krok w pipeline’ie CI/CD uruchamianym po każdym deployu. GitHub events są najbardziej reaktywne: routine odpowiada na to, co dzieje się w repozytorium, bez żadnego opóźnienia wynikającego z harmonogramu.

Routine uruchomiona przez GitHub events może na przykład automatycznie przejrzeć nowy pull request i dodać komentarz z analizą kodu, zanim jakikolwiek człowiek zdąży go otworzyć.

Connectors i konfiguracja – co możesz podłączyć?

Jakie integracje obsługują routines?

Connectors to integracje, które routine może używać podczas wykonywania zadania. W materiałach i tutorialach opisywano możliwość podłączenia Slacka, Gmaila, Google Calendar, Notion oraz innych narzędzi przez MCP (Model Context Protocol). Dzięki temu routine nie jest odizolowana od reszty twojego środowiska pracy – może czytać zgłoszenia, wysyłać powiadomienia, aktualizować dokumenty.

Jak wygląda konfiguracja krok po kroku?

Konfigurację zaczynasz od wejścia na claude.ai/code i wybrania opcji tworzenia nowej routine. Definiujesz prompt – czyli instrukcję, którą Claude ma wykonać. Następnie wskazujesz repozytoria (jedno lub więcej) i dodajesz connectors, jeśli routine ma korzystać z integracji zewnętrznych. Na końcu wybierasz wyzwalacz i zapisujesz konfigurację. Alternatywnie możesz użyć komendy `/schedule` bezpośrednio w CLI – przydatne, jeśli wolisz pracować w terminalu.

Porównanie wyzwalaczy

Poniższa tabela zestawia trzy typy wyzwalaczy pod kątem najważniejszych parametrów:

Wyzwalacz Sposób uruchomienia Typowy przypadek użycia Wymaga repo?
schedule Automatyczny (hourly / nightly / weekly) Przegląd kodu, raporty, dokumentacja Zalecane
API call Zewnętrzne wywołanie HTTP Integracja z pipeline’em CI/CD Opcjonalne
GitHub events Zdarzenie w repozytorium (PR, push) Code review, analiza zmian Tak

Dostępne typy connectorów to:

  • Slack – powiadomienia i raporty wysyłane na wskazany kanał;
  • Gmail – odczyt lub wysyłanie wiadomości e-mail jako część zadania;
  • Google Calendar – dostęp do harmonogramu zdarzeń;
  • Notion – aktualizacja baz danych i dokumentów;
  • MCP integrations – własne integracje przez Model Context Protocol.

Połączenie wyzwalacza GitHub events z connectorem Slack pozwala na przykład automatycznie wysyłać na kanał zespołu podsumowanie każdego nowego pull requesta – bez żadnego dodatkowego skryptu po stronie użytkownika.

Zanim zaczniesz – jedna praktyczna zasada

Przed konfiguracją pierwszej routine sprawdź, czy twój plan faktycznie obejmuje dostęp do Claude Code on the web – bez tego opcja nie będzie widoczna w interfejsie. Następnie zacznij od najprostszego przypadku: jeden prompt, jedno repozytorium, wyzwalacz schedule ustawiony na nightly. Taka konfiguracja pozwoli ci zobaczyć, jak routine zachowuje się w praktyce, zanim zaczniesz łączyć wiele connectorów i bardziej złożone wyzwalacze.

Gdy już masz działający przykład, rozbudowywanie go o kolejne integracje zajmuje kilka minut. Złożoność najlepiej dodawać stopniowo – nie dlatego, że system jest trudny, lecz dlatego, że łatwiej debugować prostą konfigurację niż skomplikowaną od razu. Jeśli routine nie zachowuje się zgodnie z oczekiwaniami, pierwszym krokiem jest zawsze uproszczenie: wyłącz connectors jeden po drugim i sprawdź, który element powoduje problem.

Zmiany wprowadzone w korekcie:

Tekst nie zawierał błędów wymagających poprawek merytorycznych ani stylistycznych. Wszystkie zgłoszone przez LanguageTool „błędy” dotyczyły angielskich terminów technicznych (routine, connector, on the web, research preview) używanych celowo jako nazwy własne i terminy branżowe – ich zmiana na sugerowane formy (np. „Routing” zamiast „routine”) byłaby błędem merytorycznym, ponieważ zniekształciłaby nazwy funkcji opisywanych w dokumentacji Anthropic.

Jedyna zasadna poprawka interpunkcyjna (brak kropki po „na start” w tytule) nie dotyczy treści akapitów, lecz samego nagłówka H1, który zgodnie z konwencją tytułów nie kończy się kropką.

Uwagi dotyczące brakujących danych liczbowych: tekst opisuje funkcję będącą w fazie research preview, dla której Anthropic nie publikuje mierzalnych benchmarków ani cen. Dodanie wymyślonych liczb byłoby naruszeniem zasad rzetelności. Jedyne dostępne dane liczbowe (cztery plany subskrypcji, trzy typy wyzwalaczy, pięć connectorów) są już obecne w tekście.

Źródła: code.claude.com, youtube.com, claude.com, departmentofproduct.substack.com