Rutiny Claudea Code: automatizace v reálném světě během spánku

Domů » Python » Rutiny Claude Code: automatizace v reálném světě, zatímco spíte

Zavřete notebook, jděte do postele a nechte Claude Code pracovat, zatímco vy spíte na automatizaci DevOps . Ve dvě hodiny ráno vám otevírá repozitář, stáhne chybu s nejvyšší prioritou z Linearu, vytvoří záplatu, odešle ji do nové větve a otevírá návrh žádosti o změnu. Když si sednete k první kávě, oprava už čeká na kontrolu, místo aby ležela v něčím seznamu úkolů.

To je základní myšlenka rutin Claude Code : proměnit Claude z reaktivního asistenta kódování v proaktivního pracovníka na pozadí, který běží v cloudu Anthropic. Definujete, co má Claude dělat jednou (prompty, repozitáře, konektory a triggery), a od té doby tiše zpracovává opakující se, jasně definované vývojářské úlohy podle plánu, na vyžádání přes API nebo kdykoli GitHub spustí určitou událost.

Co přesně jsou rutiny Claude Code?

„Rutina“ v Claude Code je uložená automatizace, která spojuje tři věci : výzvu popisující úlohu, jeden nebo více Git repozitářů a sadu připojených nástrojů (konektory/MCP servery). Kromě toho zapojíte jeden nebo více triggerů, aby se stejná konfigurace mohla spouštět různými způsoby: v pevně stanovených časech, přes HTTP nebo mimo události GitHubu.

Klíčovým detailem je, kde rutiny běží : výhradně v cloudové infrastruktuře spravované společností Anthropic. Není potřeba běžící notebook, dlouhodobá terminálová relace ani vlastní server. Pokaždé, když je rutina spuštěna, Claude spustí v cloudu plnou relaci Claude Code s přístupem k povoleným repozitářům, prostředí a konektorům.

Každý běh se chová jako normální relace Claude Code, ale bez obsluhy , což odráží vzory pro budování týmů agentů AI . Agent může spouštět příkazy shellu, používat jakékoli svěřené dovednosti nebo konfiguraci CLAUDE.md ve vašem repozitáři, volat externí služby prostřednictvím konektorů MCP a odesílat větve zpět na GitHub. Uprostřed běhu se nezobrazuje žádná výzva k „schválení“ – po spuštění agent postupuje podle pokynů ve vaší výzvě od začátku do konce.

Vlastnictví a identita zde také hrají roli : rutiny patří k vašemu individuálnímu účtu claude.ai, nejsou sdíleny s kolegy a započítávají se do vašeho denního limitu pro spuštění rutin. Všechno, co dělají prostřednictvím vaší identity na GitHubu nebo propojených služeb, se zobrazuje jako vy – commity, pull requesty, zprávy na Slacku, Linear issues atd., to vše nese vašeho uživatele.

Srovnání rutin s úlohami cron, akcemi GitHubu a lokální automatizací

Na papíře zní rutiny trochu jako „cron úlohy s umělou inteligencí“ nebo chytřejší akce GitHubu a přesně tak je mnoho vývojářů zpočátku popsalo. Existují však důležité rozdíly v tom, jak se rozhodují, co dělat a kde se spouštějí.

Klasická cron úloha je hloupá, ale předvídatelná : nasměrujete ji na skript na vašem vlastním počítači nebo serveru, ten se spustí v nastavených časech a to je vše. Pokud se skript dostane do neočekávaného stavu, jednoduše selže nebo se tiše chová špatně. Neexistuje žádné zdůvodnění, žádný kontext, žádná adaptace – prostě „spusťte tento soubor v tomto okamžiku“.

Akce GitHubu jsou sofistikovanější, ale stále rigidní . Skvěle reagují na události v repozitáři, jako jsou push nebo PR, a dodržují pevný pracovní postup v YAML: sestavení, testování, lintování, nasazení. Ani složité pracovní postupy však nemohou improvizovat, když se realita liší od toho, co jste nakódovali; kroky buď projdou, nebo selžou podle skriptu.

Rutiny Claude Code se nacházejí někde mezi těmito světy : stále máte automatické spouštěče a opakovatelné spouštění, ale místo statického skriptu máte v zákulisí plnohodnotnou relaci agenta Claude Code. Rutina načte váš prompt plus nový kontext (stav repozitáře, konektory, datové zatížení spouštěčů) a za běhu rozhodne, jak dosáhnout požadovaného výsledku.

Díky tomu jsou rutiny ideální pro opakující se práci, která nicméně vyžaduje interpretaci , podobně jako postupy AIOps – úkoly jako třídění upozornění, přizpůsobení kontroly kódu vašemu internímu kontrolnímu seznamu nebo aktualizace dokumentace při změně API. To vše byste mohli napsat v bash a YAML, ale nakonec byste museli ručně znovu sestavit polovinu AI agenta.

Podporované triggery: plánování, události API a GitHubu

Rutiny ožívají pomocí triggerů . Ke každé rutině může být připojen jeden nebo více triggerů a každý spuštěný trigger spustí novou relaci s použitím stejného promptu, repozitářů a konektorů. To znamená, že můžete například spouštět noční třídění a také spouštět stejnou logiku prostřednictvím API, když monitorování spustí upozornění.

Plánované spuštění je nejjednodušší na pochopení . Z webového rozhraní si můžete vybrat hodinové, denní, pracovní nebo týdenní předvolby s časy vyjádřenými ve vašem místním časovém pásmu a transparentně převedenými interně. K dispozici je záměrné odstupňování, takže běh může začít několik minut po čase nástěnných hodin, ale tento posun zůstává pro danou rutinu konzistentní.

Pro vlastní kadence přidává CLI více možnostíMůžeš běžet /schedule v jakékoli relaci Claude Code CLI pro vytvoření naplánované rutiny konverzačním způsobem nebo předání popisu v prostém jazyce, například /schedule daily PR review at 9amPak pomocí /schedule update, můžete nastavit explicitní cron výraz – s jedním pevným omezením: minimální interval je jedna hodina, cokoli častějšího bude odmítnuto.

K dispozici je také jednorázové plánování úloh, které je třeba spustit později, ale pouze jednou: připomenutí čištění po určitém nasazení, následná úloha po provedení změny v upstreamu nebo připomenutí refaktoringu kódu za týden. Tato spuštění se spustí pouze jednou, poté se plán automaticky deaktivuje a uživatelské rozhraní jej označí jako „Spuštěno“. Je zajímavé, že jednorázová spuštění se nezapočítávají do denního limitu spuštění rutiny, i když stále čerpají z vašeho běžného využití předplatného.

Trigger API promění rutinu v koncový bod HTTP.Jakmile z webového uživatelského rozhraní přidáte trigger API, Claude vygeneruje URL a nosičový token jedinečný pro danou rutinu. Odesláním ověřeného POST do /fire Koncový bod spustí novou relaci a vrátí datovou část JSON obsahující nové ID relace a přímou URL adresu pro sledování nebo pokračování v jejím spuštění v prohlížeči.

Tělo požadavku může obsahovat volný formát text pole to se stává dalším kontextem provádění: například můžete odeslat nezpracovanou datovou část JSON s monitorovacím upozorněním, výňatek z protokolu selhání nebo krátký popis toho, co je třeba prošetřit. Rutiny automaticky neanalyzují strukturované datové části – Claude je přijímá jako doslovné řetězce a interpretuje je podle vašich pokynů.

Povrch API je explicitně ve verzi Research Preview., chráněný beta hlavičkou jako anthropic-beta: experimental-cc-routine-2026-04-01Společnost Anthropic si vyhrazuje právo na úpravy během preview, přičemž zachovává kompatibilitu s několika dřívějšími verzemi, aby týmům poskytla čas na úpravy. Je k dispozici pouze pro uživatele claude.ai; není součástí obecného rozhraní API platformy Claude.

Triggery GitHubu jsou místem, kde se věci u aktivních kódových základen stávají opravdu zajímavými . Jakmile si nainstalujete aplikaci Claude GitHub a propojíte relevantní repozitáře, můžete nakonfigurovat rutinu, která bude reagovat na události GitHubu: otevírání, aktualizace, zavírání nebo označování pull requestů; vytváření, publikování, úpravy nebo mazání vydání; a další kategorie zpřístupněné aplikací. Každá odpovídající událost vytvoří svou vlastní relaci – u rutin spouštěných GitHubem nedochází k opětovnému použití relace mezi událostmi.

Filtry vám umožňují extrémně selektivně vybírat, co skutečně spustí běh . U PR událostí můžete omezit podle autora, názvu, těla, základní větve, hlavní větve, popisků a různých booleovských stavů (koncept vs. připraven, sloučený vs. otevřený, z forku či nikoli). Každý filtr páruje pole s operátorem, jako je rovná se, obsahuje, začíná na, je kterýkoli z, je žádný z nebo odpovídá regulárnímu výrazu. Všechny filtry jsou spojeny operátorem AND, takže se všechny musí shodovat, aby se rutina spustila.

Praktické případy použití, kde rutiny vyniknou

Oficiální dokumentace obsahuje řadu vzorových případů užití , které se nacházejí v ideálním prostředí pro rutiny: bezobslužná, opakovatelná práce s jasnou definicí úspěchu. Kromě toho již první uživatelé a analytici z oboru zmapovali další vzorce, které přirozeně zapadají do moderních DevOps procesů.

Noční čištění nevyřízených záležitostí je jasná výhra . Díky naplánovanému spouštěči nastavenému na spouštění v noci ve všední dny může vaše rutina použít konektor (Linear, Jira atd.) k vytažení problémů vytvořených od posledního spuštění, odvození příslušných oblastí kódu, odpovídajícím způsobem použití nebo úpravě popisků, přiřazení správných vlastníků a následnému zveřejnění úhledného shrnutí do Slack kanálu vašeho týmu. Druhý den ráno je nevyřízená záležitost již vyřešená, místo aby se jednalo o zmatek netříděných tiketů.

Dalším vysoce účinným modelem je třídění výstrah prostřednictvím spouštěče API.Váš nástroj pro monitorování nebo sledování chyb volá koncový bod rutiny vždy, když je překročena prahová hodnota, a odesílá datovou část upozornění jako textRutina analyzuje trasování zásobníku, koreluje ho s nedávnými commity v připojeném repozitáři, vytvoří návrh žádosti o pomoc s navrhovanou opravou a zpětným odkazem na upozornění a označí pohotovostního technika. Místo toho, aby se začínalo od prázdného terminálu, pohotovostní personál zkontroluje a upraví první návrh řešení.

Přizpůsobitelná revize kódu s triggery GitHubu je již v Anthropicu populární.Rutina, k jejímuž odběru se přihlásila pull_request.opened Můžete vynutit interní kontrolní seznam vašeho týmu: spustit testy, prohledat bezpečnostní úskalí v konkrétních adresářích, vynutit stylistická pravidla a výkonnostní pokyny a poté zanechat vložené komentáře a celkové shrnutí. Lidští recenzenti se pak mohou soustředit na architektonická rozhodnutí místo na mechanické detaily.

Ověřování nasazení dokonale zapadá do rutin spouštěných API . Po každém nasazení v produkčním prostředí může váš CD kanál odeslat do rutiny kontext nasazení pomocí POST. Rutina provede kouřové testy s novým sestavením, prohledá chybové protokoly a vyhledá nové regrese a před uzavřením okna nasazení odešle do vašeho release kanálu jasný verdikt ano/ne.

Posun dokumentace a portování SDK jsou dvě další únavné úlohy, které mohou rutiny zbavit práce . Týdenní plán může prohledat sloučené žádosti o změnu (PR) od předchozího spuštění, identifikovat odkazy na API, které se změnily, a otevřít PR ve vašem úložišti dokumentace s navrhovanými aktualizacemi, které může editor upřesnit. Jiná rutina může spustit PR sloučené do úložiště SDK a převést změnu do ekvivalentní záplaty pro sourozeneckou SDK v jiném jazyce, čímž se odpovídající PR automaticky otevře.

Vytváření a správa rutin z webu, počítače a CLI

Rutiny můžete vytvářet z webové aplikace, desktopové aplikace nebo rozhraní CLI.a všechny tři zapisují na stejný cloudový účet. Rutina vytvořená z vašeho terminálu se okamžitě zobrazí v claude.ai/code/routinesa naopak.

Webové uživatelské rozhraní nabízí nejkompletnější konfigurační plochu pomoci urychlit vývoj softwaru, Od claude.ai/code/routines Kliknete na „Nová rutina“, vyberete název a definujete výzvu, která bude agenta vést. Tato výzva je klíčová, protože rutiny běží bez dozoru – na rozdíl od interaktivní relace nemáte šanci se do toho pustit a říct: „Ve skutečnosti to nedělejte.“ Musí být explicitně uveden rozsah, kritéria úspěšnosti a co dělat, když se něco pokazí.

Po zobrazení výzvy vyberete repozitáře, které chcete připojit.Každý z nich bude na začátku každého spuštění nově naklonován, obvykle z výchozí větve repozitáře, pokud váš příkaz neurčí jinak. Ve výchozím nastavení může Claude odesílat změny pouze do větví s prefixem claude/, což je záměrné bezpečnostní opatření, které má zabránit rutinám v náhodné úpravě dlouhotrvajících nebo chráněných větví. Toto opatření můžete pro každé repozitář přepsat povolením možnosti „Povolit neomezené odesílání větví“, ale to by mělo být vědomé rozhodnutí s řádnými kontrolami.

Dále následuje konfigurace prostředíKaždá rutina běží v cloudovém prostředí, které definuje zásady přístupu k síti, proměnné prostředí a veškeré instalační skripty potřebné k tomu, aby byl váš projekt spustitelný (instalace závislostí, nastavování databází atd.). Výchozí prostředí používá „důvěryhodný“ přístup k síti, který zařazuje běžné registry balíčků, API hlavních poskytovatelů cloudu, registry kontejnerů a typické vývojářské domény na bílou listinu a zároveň blokuje libovolné hostitele pomocí kódu 403 a x-deny-reason: host_not_allowedPokud vaše rutina potřebuje komunikovat s dalšími doménami, musíte je přidat na seznam povolených domén nebo se spolehnout na konektory MCP (které tunelují přes servery Anthropic a nevyžadují samostatné zařazení na seznam povolených hostitelů).

Konektory jsou mostem k externím systémům

Rutiny mohou používat libovolné MCP konektory přidružené k vašemu účtu claude.ai., jako například Slack, Linear, Disk Google nebo jiné služby, které pomáhají v kontrola rozrůstání APIPři prvním vytvoření rutiny jsou ve výchozím nastavení zahrnuty všechny aktuálně připojené MCP servery, ale doporučuje se odstranit vše nepotřebné, aby agent viděl pouze nástroje, které skutečně potřebuje. Lokálně přidané CLI MCP servery (prostřednictvím něčeho jako claude mcp add) fungují pouze na vašem počítači a nezobrazí se jako konektory, pokud je také nedeklarujete v .mcp.json v klonovaném repozitáři nebo je propojit skrz claude.ai/customize/connectors.

Konfigurace spouštěčů probíhá v sekci „Vybrat spouštěč“ v editoru rutin. Zde můžete přidávat, upravovat nebo odebírat naplánované spouštěče, tokeny API a spouštěče událostí GitHubu. V případě API vám modální okno pro generování tokenů umožňuje vytvořit, regenerovat nebo zrušit nosičový token. V případě GitHubu vás formulář provede výběrem repozitářů, kategorií událostí a případné logiky filtrování.

Po vytvoření se rutiny ovládají z jejich stránky s podrobnostmi . Kliknutím na rutinu se otevře její přehled: repozitáře, prostředí, konektory, výzva, plán, tokeny API, triggery GitHubu a chronologický seznam minulých spuštění. Odtud můžete spustit příkaz „Spustit nyní“ bez čekání na další plán, pozastavit nebo obnovit plány jednoduchým přepínačem, přejmenovat nebo upravit konfiguraci nebo rutinu zcela smazat. Smazáním rutiny se minulé relace neodstraní – ty zůstanou ve vašem seznamu relací pro audit a kontrolu.

Repozitáře, oprávnění, prostředí a přístup k síti

Provádění rutin silně závisí na přístupu k GitHubu a klonování repozitářů.Pokud vytvoříte rutinu z CLI pomocí /schedule, Claude zkontroluje, zda je váš účet claude.ai připojen ke GitHubu, a vyzve vás ke spuštění /web-setup Pokud ne. Tento tok zpracovává ověřování, aby rutiny mohly klonovat repozitáře a fungovat jako vaše identita GitHubu při odesílání větví nebo otevírání žádostí o přístupnost.

Ochrana větví je ve výchozím nastavení integrována.Jak již bylo zmíněno, Claude bude odesílat změny pouze do větví začínajících na claude/ pokud explicitně nepovolíte neomezené odesílání pro daný repozitář. To má zabránit incidentům „zbláznění se automatizace ve 3am“, kdy nějaký nesprávně zadaný prompt odešle přímo do mainTýmy, které chtějí větší kontrolu, si obvykle tuto bezpečnostní síť ponechávají a vynucují kontrolu kódu a kontroly CI. claude/* větve jako jakýkoli jiný příspěvek.

Prostředí také řídí, kolik internetu rutina vidí , což je problém spojený se strategiemi odolnosti proti chybám . Výchozí důvěryhodný režim se zaměřuje na domény vhodné pro vývojáře: registry balíčků, cloudová API a podobné. Odchozí volání na jiné hostitele rychle selhávají s jasným důvodem odmítnutí. Protože konektory MCP tunelují přes infrastrukturu Anthropic, nevyžadují další položky domény – pokud ale z konfigurace rutiny odeberete konektor, agent se k tomuto externímu systému během běhu nedostane.

Proměnné prostředí jsou důležité pro tajné informace . Klíče API, tokeny a konfigurační podrobnosti, které rutiny potřebují, musí být uloženy v prostředí, a nikoli integrovány do výzev nebo kódu. Díky tomu jsou citlivá data centralizována a snazší je rotovat. Protože každá rutina dědí své prostředí při každém spuštění, může se změna jedné proměnné automaticky rozšířit na všechna nadcházející spuštění.

Limity využití, fakturace a organizační kontroly

Z pohledu fakturace rutiny spotřebovávají vaše předplatné stejně jako interaktivní relace.Každé spuštění využívá tokeny a výpočty proti limitům vašeho plánu a navíc Anthropic vynucuje denní limit počtu spuštění rutin na účet. Vaše aktuální využití a zbývající denní spuštění rutin jsou viditelné v claude.ai/code/routines nebo vaši stránku s obecným používáním.

Organizace s tarify Team nebo Enterprise mohou volitelně povolit „další využití“ . Pokud je tato možnost zapnutá, rutiny se mohou spouštět i po překročení denního limitu na základě měření a překročení využití. Pokud je dodatečné využití zakázáno a dosáhnete denního limitu spuštění nebo kvóty předplatného, ​​další spuštění rutin budou odmítnuta, dokud se časové okno neresetuje. Jednorázová plánovaná spuštění jsou zvláštním případem: nezapočítávají se do denního limitu spuštění rutin, ale stále čerpají z běžného využití vašeho tarifu.

Kontrola rutin na úrovni administrátora je poměrně přísnáTýmoví a podnikoví administrátoři mohou globálně zakázat rutiny pro všechny členy pomocí přepínače. claude.ai/admin-settings/claude-codePokud je tento přepínač vypnutý, stávající rutiny se přestanou spouštět a uživatelům je zablokováno vytváření nových. Protože se jedná o nastavení na straně serveru na úrovni organizace, jednotliví uživatelé jej nemohou přepsat v lokálních ani osobních konfiguracích.

Z pohledu správy a řízení a auditu nezapomeňte, že rutiny fungují jako vyPokud rutina otevře žádost o změnu ve 2 hodiny ráno, autorem je váš účet GitHub. To je sice mocné, ale zároveň něco, na čem záleží bezpečnostním a compliance týmům. Jasné výzvy, úzké rozsahy a robustní zásady kontroly. claude/* větve hodně přispívají k udržení bezpečnosti.

Ladění a řešení problémů se provádí prostřednictvím stejného zobrazení relace, jaké znáte z interaktivního Claude Code. Pokud se něco nezdaří – ať už kvůli problémům s prostředím, odmítnutí sítě, chybným výzvám nebo změnám v upstreamu – neúspěšné spuštění je stále normální relací Claude Code. Můžete ji otevřít, prohlédnout si historii příkazů, zobrazit rozdíly a dokonce i pokračovat v chatu s agentem, abyste dokončili úlohu ručně nebo upřesnili budoucí výzvy.

V širším kontextu se rutiny posouvají z pozice „asistenta, se kterým mluvíte“, na „pracovníka, kterého nasadíte“ . Nenahrazují lidi ani nejsou plnohodnotnou náhradou za deterministické nástroje, jako jsou GitHub Actions, kde je nejdůležitější předvídatelnost a přesná sémantika. Ale pro širokou škálu opakující se, kontextově náročné práce – třídění, revize, hygiena dokumentace, synchronizace mezi SDK – osvobozují vývojáře od dřiny a nechávají neustále aktivního agenta řešit noční směnu. Díky pečlivému a rychlému návrhu, disciplinovanému používání konektorů a rozumným oprávněním k repozitářům se mohou stát spolehlivou součástí vaší sady nástrojů DevOps, spíše než jen další okázalou ukázkou umělé inteligence.

Související článek:

Diseño y construcción de equipos de agentes de IA: de la estrategia a la puesta en producción