תיעוד 25

אוטומציה של עבודה עם שגרות (routines)

העבר את Claude Code לטייס אוטומטי. הגדר שגרות (routines) שרצות לפי לוח זמנים, מופעלות באמצעות קריאות API, או מגיבות לאירועי GitHub מתוך תשתית ענן.

הערה: שגרות נמצאות בתצוגה מקדימה למחקר (research preview). ההתנהגות, המגבלות וממשק ה-API עשויים להשתנות.

שגרה היא תצורת Claude Code שמורה: הנחיה (prompt), מאגר אחד או יותר, וערכה של מחברים (connectors), שנארזים פעם אחת ורצים באופן אוטומטי. שגרות פועלות על גבי תשתית ענן בניהול Anthropic, או בתוך סביבה באירוח עצמי (self-hosted environment) של הארגון שלך כאשר הן מנותבות לשם, כך שהן ממשיכות לעבוד גם כאשר המחשב הנייד שלך סגור.

לכל שגרה ניתן להצמיד טריגר אחד או יותר:

לפי לוח זמנים (Scheduled): ריצה במחזוריות קבועה כמו מדי שעה, מדי לילה או מדי שבוע, או פעם אחת במועד עתידי מסוים.
API: הפעלה לפי דרישה על ידי שליחת HTTP POST לנקודת קצה ייעודית לשגרה עם אסימון נושא (bearer token).
GitHub: ריצה אוטומטית בתגובה לאירועי מאגר כגון בקשות משיכה (pull requests) או שחרור גרסאות (releases).

שגרה בודדת יכולה לשלב טריגרים. לדוגמה, שגרת סקירת PR יכולה לרוץ מדי לילה, לפעול מתוך סקריפט פריסה (deploy script), וגם להגיב לכל PR חדש.

שגרות זמינות בתוכניות Pro, Max, Team ו-Enterprise. ניתן ליצור ולנהל אותן בכתובת claude.ai/code/routines, או מתוך ה-CLI באמצעות הפקודה /schedule.

בעלי חשבון (Owners) בארגוני Team ו-Enterprise יכולים להשבית שגרות עבור כל החברים באמצעות מתג ה-Routines בכתובת claude.ai/admin-settings/claude-code. כאשר הן מושבתות, שגרות קיימות מפסיקות לרוץ וחברים אינם יכולים ליצור שגרות חדשות.

דף זה מכסה יצירת שגרה, הגדרת כל סוג טריגר, ניהול ריצות, ואופן החלת מגבלות השימוש.

#דוגמאות למקרי שימוש

כל דוגמה מצמידה סוג טריגר לסוג העבודה ששגרות מתאימות לה: עבודה ללא השגחה, ניתנת לחזרה, וקשורה לתוצאה ברורה.

תחזוקת צבר משימות (Backlog maintenance). טריגר לוח זמנים רץ בכל ערב בימי חול מול מעקב המשימות שלך באמצעות מחבר (connector). השגרה קוראת משימות שנפתחו מאז הריצה האחרונה, מחילה תוויות, מקצה אחראים על פי אזור הקוד המוזכר, ומפרסמת סיכום ב-Slack כדי שהצוות יתחיל את היום עם תור משימות מסודר.

מיון התראות (Alert triage). כלי הניטור שלך קורא לנקודת הקצה של ה-API של השגרה כאשר סף שגיאה נחצה, ומעביר את גוף ההתראה בתור text. ההנחיה של השגרה מורה ל-Claude לחקור את ההתראה במטען ההפעלה (fire payload), כך שהוא שולף את מעקב המחסנית (stack trace), מצליב אותו עם התחייבויות (commits) אחרונות במאגר, ופותח טיוטת בקשת משיכה (draft pull request) עם הצעה לתיקון וקישור חזרה להתראה. הכונן (on-call) סוקר את ה-PR במקום להתחיל ממסוף ריק.

סקירת קוד מותאמת אישית (Bespoke code review). טריגר GitHub רץ בעת pull_request.opened. השגרה מחילה את רשימת הבדיקות של הצוות שלך, משאירה הערות בתוך השורות (inline comments) לגבי בעיות אבטחה, ביצועים וסגנון, ומוסיפה הערת סיכום כדי שסוקרים אנושיים יוכלו להתמקד בתכנון במקום בבדיקות מכניות.

אימות פריסה (Deploy verification). צינור ה-CD שלך קורא לנקודת הקצה של ה-API של השגרה לאחר כל פריסה לייצור (production deploy). השגרה מריצה בדיקות עשן (smoke checks) מול הגרסה החדשה, סורקת יומני שגיאות לאיתור נסיגות (regressions), ומפרסמת אישור או פסילה (go או no-go) לערוץ השחרור לפני שחלון הפריסה נסגר.

סחיפת תיעוד (Docs drift). טריגר לוח זמנים רץ מדי שבוע. השגרה סורקת בקשות משיכה שמוזגו מאז הריצה האחרונה, מסמנת תיעוד שמפנה לממשקי API שהשתנו, ופותחת בקשות משיכה לעדכון מול מאגר התיעוד כדי שעורך יוכל לבדוק אותן.

הסבת ספרייה (Library port). טריגר GitHub רץ בעת pull_request.closed ומסונן לבקשות משיכה שמוזגו במאגר SDK יחיד. השגרה מסבה את השינוי ל-SDK מקביל בשפה אחרת ופותחת בקשת משיכה תואמת, וכך שומרת על שתי הספריות מסונכרנות מבלי שאדם יממש מחדש כל שינוי.

#יצירת שגרה

ניתן ליצור שגרה מהאינטרנט בכתובת claude.ai/code/routines, מאפליקציית שולחן העבודה (Desktop), או מתוך ה-CLI. כל שלושת הממשקים כותבים לאותו חשבון ענן, כך ששגרה שנוצרת באחד מהם מופיעה באחרים מיד. בלשונית Code באפליקציית שולחן העבודה, לחץ על Routines בסרגל הצד או בתפריט More של סרגל הצד, לאחר מכן לחץ על New routine, ובחר ב-Cloud. בחירה ב-Local יוצרת במקום זאת משימה מתוזמנת בשולחן העבודה, אשר רצה על המחשב שלך ולא בענן.

טופס היצירה מגדיר את ההנחיה (prompt), המאגרים, הסביבה, המחברים והטריגרים של השגרה.

שגרות רצות באופן אוטונומי כהפעלות ענן מלאות של Claude Code: אין בורר מצב הרשאות, וההפעלה מריצה פקודות מעטפת (shell), משתמשת ב-כישורים (skills) שהועלו למאגר המשוכפל, וקוראת לכל מחבר שתכלול, הכל מבלי לעצור לבקש אישור, למעט פעולות מסוימות של תוצרים (artifacts).

המשאבים ששגרה יכולה להגיע אליהם נקבעים על פי המאגרים שתבחר, גישת הרשת והמשתנים של הסביבה, והמחברים שתכלול. הגבל כל אחד מאלה למה שהשגרה באמת צריכה.

כאשר לוח הזמנים של השגרה או הלחצן Run now מתחילים ריצה, Claude מפרסם מחדש תוצר קיים ללא שאלה רק כאשר כל התנאים הבאים מתקיימים:

באפשרותך לערוך את התוצר והוא שייך לארגון שלך.
התוצר אינו משותף באופן ציבורי, ואינו משותף עם אנשים מסוימים או עם הארגון שלך כאשר הגרסה העדכנית ביותר נבחרה כגרסה שהצופים רואים.
הפרסום מעביר רק את הדף, ללא קבצים תומכים או כל דבר נוסף, ואינו דורס בכוח גרסה חדשה יותר.
הדף אינו כולל הרשאה שמגיעה מעבר לדף עצמו, כגון קריאות מחבר.

בכל מקרה אחר, כולל פרסום תוצר חדש, Claude שואל תחילה. כאשר תפקידה של שגרה הוא לשמור על דף מעודכן, ספק לה תוצר שכבר פרסמת.

שגרות שייכות לחשבון ה-claude.ai האישי שלך. הן אינן משותפות עם חברי צוות, והן נספרות כחלק ממכסת הריצה היומית של חשבונך. כל מה ששגרה מבצעת דרך זהות ה-GitHub המחוברת שלך או דרך מחברים מופיע בשמך: התחייבויות (commits) ובקשות משיכה נושאות את משתמש ה-GitHub שלך, והודעות Slack, כרטיסי Linear, או פעולות מחבר אחרות משתמשים בחשבונות המקושרים שלך עבור שירותים אלה.

#יצירה מהאינטרנט

פתח את טופס היצירה: בקר בכתובת claude.ai/code/routines ולחץ על New routine.
תן שם לשגרה וכתוב את ההנחיה: תן לשגרה שם תיאורי וכתוב את ההנחיה ש-Claude יריץ בכל פעם. ההנחיה היא החלק החשוב ביותר: השגרה פועלת באופן אוטונומי, לכן ההנחיה חייבת להיות עצמאית ומפורשת לגבי מה לעשות וכיצד נראית הצלחה.
כאשר טריגר מופעל, ההפעלה מקבלת את ההנחיה השמורה של השגרה כמשימה שהוקצתה לה ומבצעת אותה, במקום להתייחס אליה כאל תוכן לא מהימן שהגיע באמצע השיחה. הטריגר מאשר רק שההנחיה נשמרה מראש על ידי הפעלה מורשית בחשבונך, כך שההנחיה שהופעלה אינה קלט משתמש חי ואינה יכולה לשמש כאישור או הסכמה לפעולות במהלך הריצה. תוכן שההפעלה שולפת במהלך הריצה שומר על הטיפול הרגיל שלו. לפני גרסה v2.1.213, ההפעלה קיבלה את אותה הנחיה כהתראת רקע לא מהימנה ויכלה לסרב לפעול לפיה.
קלט ההנחיה כולל בורר מודל. Claude משתמש במודל הנבחר בכל ריצה.
בחר מאגרים: הוסף מאגר GitHub אחד או יותר ש-Claude יעבוד בהם. כל מאגר משוכפל בתחילת הריצה, החל מענף ברירת המחדל. Claude יוצר ענפים בעלי קידומת claude/ עבור השינויים שלו.
בחר סביבה: בחר סביבת ענן עבור השגרה. סביבות שולטות במה שיש להפעלת הענן גישה אליו:
- גישת רשת: הגדר את רמת הגישה לאינטרנט הזמינה במהלך כל ריצה.
- משתני סביבה: ספק ערכים ש-Claude יכול להשתמש בהם במהלך כל ריצה. הם גלויים לכל מי שמשתמש בסביבה, לכן בתוכניות Pro ו-Max, אחסן מפתחות עבור ממשקי ה-API ש-Claude קורא להם במהלך ריצה בתור אישורי API במקום זאת. סעיף זה מפרט גם את הבקשות שלעולם אינן מקבלות אישור.
- סקריפט הגדרה (Setup script): התקן תלויות וכלים שהשגרה זקוקה להם. התוצאה נשמרת במטמון, כך שהסקריפט אינו רץ מחדש בכל הפעלה.
  מסופקת סביבת Default (ברירת מחדל) עם גישת רשת Trusted (מהימנה), המאפשרת מעבר ברשת של ההפעלה רק עבור רשימת ההיתרים של ברירת המחדל של מאגרי חבילות, ממשקי API של ספקי ענן, מאגרי קונטיינרים ודומיינים נפוצים לפיתוח. מחברים שתוסיף לשגרה מגיעים לשירותים שלהם דרך השרתים של Anthropic, כך שהם אינם דורשים שינויים ברשימת ההיתרים. אם השגרה שלך צריכה להגיע לשירותים שלך ישירות, או לדומיין מחוץ לרשימה זו, ערוך את גישת הרשת של הסביבה לפני הריצה. כדי להשתמש בסביבה נפרדת, צור אחת תחילה.
בחר טריגר: תחת Select a trigger, בחר כיצד השגרה מתחילה. ניתן לבחור סוג טריגר אחד או לשלב כמה:
- לוח זמנים (Schedule): בחר תדירות מוגדרת מראש לריצה מחזורית, או תזמן ריצה חד-פעמית בודדת בחותמת זמן מסוימת. ראה הוספת טריגר לוח זמנים לפרטים על טיפול באזורי זמן, דירוג זמנים (stagger), מרווחי cron מותאמים אישית וריצות חד-פעמיות.
- אירוע GitHub (GitHub event): בחר את המאגר, את האירוע שיש להגיב אליו, ומסננים אופציונליים. ראה הוספת טריגר GitHub לרשימה המלאה של אירועים נתמכים ושדות סינון.
- API: בחר API כאן, ולאחר מכן שמור את השגרה. כתובת ה-URL והאסימון נוצרים לאחר שמירת השגרה, מכיוון שהם תלויים במזהה השגרה. ראה הוספת טריגר API כדי להעתיק את ה-URL ולהפיק אסימון.
בדוק מחברים (connectors): תחת Connectors בתחתית הטופס, כל מחברי ה-MCP המחוברים שלך כלולים כברירת מחדל. הסר את אלה שהשגרה אינה זקוקה להם: Claude יכול להשתמש בכל כלי ממחבר שנכלל, כולל פעולות כתיבה, מבלי לבקש אישור במהלך ריצה.
צור את השגרה: לחץ על Create. השגרה מופיעה ברשימה ותרוץ בפעם הבאה שאחד הטריגרים שלה יתאים. כדי להתחיל ריצה באופן מיידי, לחץ על Run now בדף הפרטים של השגרה.
כל ריצה יוצרת הפעלה חדשה לצד ההפעלות האחרות שלך, שבה תוכל לראות מה Claude עשה, לבדוק שינויים וליצור בקשת משיכה.

#יצירה מתוך ה-CLI

הרץ /schedule בכל הפעלה כדי ליצור שגרה מתוזמנת באופן שיחתי. ניתן גם להעביר תיאור ישירות, עבור שגרה מחזורית כמו /schedule daily PR review at 9am או עבור שגרה חד-פעמית כמו /schedule clean up feature flag in one week. Claude עובר על אותם הפרטים שטופס האינטרנט אוסף, ולאחר מכן שומר את השגרה בחשבונך. הפקודה זמינה גם תחת הכינוי /routines.

התחלה מוצלחת נראית כמו שיחה: Claude שואל שאלות המשך לגבי לוח הזמנים, המאגרים וההנחיה לפני השמירה. אם במקום זאת Claude משיב שעליך לבצע אימות או שאינו מצליח להתחבר לחשבון ה-claude.ai המרוחק שלך, שום שגרה לא נוצרה; ראה פתרון בעיות.

הפקודה /schedule ב-CLI יוצרת שגרות מתוזמנות. כדי להוסיף טריגר API, ערוך את השגרה באינטרנט בכתובת claude.ai/code/routines. ניתן להוסיף טריגר GitHub מהאינטרנט או מתוך ה-CLI. הנתיב דרך ה-CLI דורש את Claude Code בגרסה v2.1.225 ומעלה.

לשגרה ללא טריגר לוח זמנים, כגון שגרה שמופעלת רק על ידי קריאות API או אירועי GitHub, אין מועד ריצה הבא, וה-CLI אינו מציג מועד כזה כאשר Claude שומר או מעדכן אותה. לפני גרסה v2.1.211, ה-CLI דיווח על מועד ריצה הבא בשנת 1 עבור שגרות אלו.

#הגדרת טריגרים

שגרה מתחילה כאשר אחד הטריגרים שלה מתאים. ניתן להצמיד כל שילוב של טריגרי לוח זמנים, API ו-GitHub לאותה שגרה, ולהוסיף או להסיר אותם בכל עת מתוך החלק Select a trigger בטופס עריכת השגרה.

#הוספת טריגר לוח זמנים

טריגר לוח זמנים מריץ את השגרה במחזוריות קבועה, או פעם אחת במועד עתידי מסוים. בחר תדירות מוגדרת מראש בחלק Select a trigger: מדי שעה, מדי יום, בימי חול או מדי שבוע. זמנים מוזנים באזור הזמן המקומי שלך ומומרים אוטומטית, כך שהשגרה רצה באותו זמן שעון ללא קשר למיקום תשתית הענן.

ריצות עשויות להתחיל מספר דקות לאחר הזמן המתוזמן עקב דירוג זמנים (stagger). ההיסט (offset) עקבי עבור כל שגרה.

עבור מרווח מותאם אישית כמו כל שעתיים או בראשון לכל חודש, בחר בהגדרה המוגדרת מראש הקרובה ביותר בטופס, ולאחר מכן הרץ /schedule update ב-CLI כדי להגדיר ביטוי cron ספציפי. המרווח המינימלי הוא שעה אחת; ביטויים שרצים בתדירות גבוהה יותר נדחים.

#תזמון ריצה חד-פעמית

לוח זמנים חד-פעמי מפעיל את השגרה פעם אחת בודדת בחותמת זמן מסוימת. השתמש בו כדי להזכיר לעצמך מאוחר יותר השבוע, לפתוח PR של ניקוי לאחר סיום פריסה הדרגתית, או להתחיל משימת המשך לאחר ששינוי במעלה הזרם נשלח. לאחר שהשגרה מופעלת, היא מושבתת אוטומטית וממשק האינטרנט מסמן אותה כ-Ran. כדי להריץ אותה שוב, ערוך את השגרה והגדר זמן חד-פעמי חדש.

צור ריצה חד-פעמית מתוך ה-CLI על ידי תיאור הזמן בשפה טבעית. Claude מפענח את הביטוי ביחס לזמן הנוכחי ומאשר את חותמת הזמן המוחלטת לפני השמירה.

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

אותה המרה מזמן מקומי ל-UTC כמו בלוחות זמנים מחזוריים חלה על חותמות זמן חד-פעמיות.

ריצות חד-פעמיות אינן נספרות כחלק ממכסת הריצות היומית של שגרות. ראה שימוש ומגבלות לפרטים.

#הוספת טריגר API

טריגר API מעניק לשגרה נקודת קצה ייעודית של HTTP. שליחת POST לנקודת הקצה עם אסימון הנושא (bearer token) של השגרה מתחילה הפעלה חדשה ומחזירה כתובת URL של הפעלה. השתמש בכך כדי לחבר את Claude Code למערכות התראה, צינורות פריסה (deploy pipelines), כלים פנימיים, או לכל מקום שבו תוכל לבצע בקשת HTTP מאומתת.

טריגרי API מתווספים לשגרה קיימת מתוך ממשק האינטרנט. ה-CLI אינו יכול כרגע ליצור או לבטל אסימונים.

פתח את השגרה לעריכה: עבור אל claude.ai/code/routines, לחץ על השגרה שברצונך להפעיל דרך API, לאחר מכן פתח את התפריט ליד שם השגרה ובחר ב-Edit.
הוסף טריגר API: גלול לחלק Select a trigger מתחת לתיבת ה-Instructions, לחץ על Add another trigger, ובחר ב-API.
העתק את כתובת ה-URL והפק אסימון: חלון המודאל מציג את כתובת ה-URL עבור שגרה זו לצד פקודת curl לדוגמה. העתק את כתובת ה-URL, לאחר מכן לחץ על Generate token והעתק את האסימון מיד. האסימון מוצג פעם אחת בלבד ולא ניתן לשחזר אותו מאוחר יותר, לכן שמור אותו במקום מאובטח כגון מאגר הסודות של כלי ההתראות שלך.
קרא לנקודת הקצה: שלח את האסימון בכותרת Authorization: Bearer בעת שליחת POST לכתובת ה-URL. הסעיף הפעלת שגרה להלן מציג דוגמה מלאה.

לכל שגרה יש אסימון משלה, המוגבל להפעלת אותה שגרה בלבד. כדי להחליף או לבטל אותו, חזור לאותו חלון מודאל ולחץ על Regenerate או Revoke.

#הפעלת שגרה

שלח בקשת POST לנקודת הקצה /fire עם אסימון הנושא בכותרת Authorization. גוף הבקשה מקבל שדה אופציונלי בשם text עבור הקשר ספציפי לריצה כמו גוף התראה או יומן שגיאות, המועבר לשגרה לצד ההנחיה השמורה שלה. הערך הוא טקסט חופשי ואינו מנותח: אם תשלח JSON או מטען מובנה אחר, השגרה תקבל אותו כמחרוזת מילולית.

ערך ה-text אינו מגיע לשגרה כהודעה נקייה. הוא מגיע עטוף בבלוק <routine-fire-payload> שמסמן אותו כנתונים לא מהימנים ומורה ל-Claude לא לפעול לפי הוראות שבתוכו אלא אם ההנחיה של השגרה עצמה מורה על כך. אותה עטיפה חלה על טקסט שסופק עם Run now בממשק האינטרנט.

המשמעות היא שההנחיה השמורה של השגרה חייבת להסכים במפורש לפעול לפי טקסט ההפעלה: נסח את ההנחיה כך שתפנה אל המטען במפורש, לדוגמה "Investigate the alert described in the routine-fire-payload block", אחרת השגרה תתייחס לטקסט כאל הקשר דומם. כל מי שמחזיק באסימון הנושא יכול לשלוח text, ולכן העטיפה גורמת לכך שטקסט הפעלה מאסימון שדלף יגיע מסומן כנתונים לא מהימנים ולא כהוראות ישירות לשגרה שלך.

הדוגמה שלהלן מפעילה שגרה מתוך מעטפת (shell). מזהה השגרה והאסימון המוצגים הם שומרי מקום: החלף אותם בכתובת ה-URL ובאסימון שהעתקת בעת הוספת טריגר API, אחרת הבקשה תיכשל עם שגיאת אימות 401:

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

בקשה מוצלחת מחזירה גוף JSON עם מזהה ההפעלה החדש וכתובת ה-URL:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

פתח את כתובת ה-URL של ההפעלה בדפדפן כדי לצפות בריצה בזמן אמת, לסקור שינויים, או להמשיך את השיחה באופן ידני.

אזהרה: נקודת הקצה /fire מסופקת תחת כותרת הבטא experimental-cc-routine-2026-04-01. מבנה הבקשה והתגובה, מגבלות הקצב (rate limits) וסמנטיקת האסימונים עשויים להשתנות בזמן שהתכונה נמצאת בתצוגה מקדימה למחקר. שינויים שוברים מופצים תחת גרסאות חדשות ומתוארכות של כותרות בטא, ושתי גרסאות הכותרת הקודמות האחרונות ממשיכות לעבוד כדי שלקוראים יהיה זמן לבצע הגירה.

#הפניית API

לעיון בהפניית ה-API המלאה, כולל כל תגובות השגיאה, כללי האימות ומגבלות השדות, ראה Trigger a routine via API בתיעוד של Claude Platform.

נקודת הקצה /fire זמינה למשתמשי claude.ai בלבד ואינה חלק ממשטח ה-API של Claude Platform.

#הוספת טריגר GitHub

טריגר GitHub מתחיל הפעלה חדשה באופן אוטומטי כאשר אירוע תואם מתרחש במאגר מחובר. Claude Code אינו עושה שימוש חוזר בהפעלות בין אירועים, ולכן שני עדכוני PR יוצרים שתי הפעלות עצמאיות.

הערה: במהלך התצוגה המקדימה למחקר, אירועי webhook של GitHub כפופים למכסות שעתיות לשגרה ולחשבון. אירועים מעבר למגבלה מושמטים עד לאיפוס החלון. ראה את המגבלות הנוכחיות שלך בכתובת claude.ai/code/routines.

אפליקציית ה-GitHub של Claude (Claude GitHub App) חייבת להיות מותקנת במאגר שאליו ברצונך להירשם, ללא קשר לממשק שממנו אתה מגדיר את הטריגר.

הגדר טריגרים של GitHub מממשק האינטרנט, אשר מציג בקשה להתקין את האפליקציה כאשר היא חסרה. בצע את השלבים להלן כדי להגדיר טריגר באינטרנט.
מתוך ה-CLI, התקן תחילה את האפליקציה מתוך דף אפליקציית GitHub, ולאחר מכן בקש מ-Claude להצמיד טריגר GitHub לשגרה קיימת, לדוגמה /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. הנתיב דרך ה-CLI דורש את Claude Code בגרסה v2.1.225 ומעלה. כאשר Claude מוסיף את הטריגר, הוא משיב עם קישור לשגרה שהטריגר מפעיל.

פתח את השגרה לעריכה: עבור אל claude.ai/code/routines, לחץ על השגרה, לאחר מכן פתח את התפריט ליד שם השגרה ובחר ב-Edit.
הוסף טריגר אירוע GitHub: גלול לחלק Select a trigger, לחץ על Add another trigger, ובחר ב-GitHub event.

הערה: הרצת /web-setup ב-CLI מעניקה גישה למאגר לצורך שכפול (cloning), אך היא אינה מתקינה את אפליקציית Claude GitHub App ואינה מאפשרת מסירת webhooks.
הגדר את הטריגר: בחר את המאגר, בחר אירוע מתוך רשימת האירועים הנתמכים, ובאופן אופציונלי הוסף מסננים. שמור את הטריגר.

#אירועים נתמכים

טריגרים של GitHub יכולים להירשם לכל אחת מקטגוריות האירועים הבאות. בתוך כל קטגוריה ניתן לבחור פעולה ספציפית, כגון pull_request.opened, או להגיב לכל הפעולות בקטגוריה.

אירוע	מופעל כאשר
Pull request	בקשת משיכה (PR) נפתחת, נסגרת, מוקצית, מתויגת, מסונכרנת, או מעודכנת בכל דרך אחרת
Release	שחרור גרסה (release) נוצר, מפורסם, נערך או נמחק

#סינון בקשות משיכה

השתמש במסננים כדי לצמצם אילו בקשות משיכה יתחילו הפעלה חדשה. כל תנאי הסינון חייבים להתאים כדי שהשגרה תופעל. שדות הסינון הזמינים הם:

מסנן	מתאים ל-
Author	שם המשתמש ב-GitHub של מחבר ה-PR
Title	טקסט כותרת ה-PR
Body	טקסט תיאור ה-PR
Base branch	ענף היעד שה-PR מכוון אליו
Head branch	ענף המקור שממנו מגיע ה-PR
Labels	תוויות שהוחלו על ה-PR
Is draft	האם ה-PR נמצא במצב טיוטה
Is merged	האם ה-PR כבר מוזג

כל מסנן מצמיד שדה עם אופרטור: equals, contains, starts with, is one of, is not one of, או matches regex.

האופרטור matches regex בודק את ערך השדה כולו, ולא תת-מחרוזת בתוכו. כדי להתאים לכל כותרת המכילה את hotfix, כתוב .*hotfix.*. ללא ה-.* מסביב, המסנן יתאים רק לכותרת שהיא בדיוק hotfix ללא שום דבר לפניה או אחריה. להתאמת תת-מחרוזת מילולית ללא תחביר regex, השתמש באופרטור contains במקום זאת.

כמה שילובי מסננים לדוגמה:

סקירת מודול אימות: base branch הוא main, head branch מכיל auth-provider. שולח כל PR שנוגע באימות לסוקר ממוקד.
מוכן לסקירה בלבד: is draft הוא false. מדלג על טיוטות כך שהשגרה רצה רק כאשר ה-PR מוכן לסקירה.
הסבה לאחור מותנית בתווית (Label-gated backport): תוויות כוללות needs-backport. מפעיל שגרת הסבה לענף אחר רק כאשר מתחזק מתייג את ה-PR.

#ניהול שגרות

לחץ על שגרה ברשימה כדי לפתוח את דף הפרטים שלה. דף הפרטים מציג את המאגרים, המחברים, ההנחיה, לוח הזמנים, אסימוני ה-API, טריגרי ה-GitHub ורשימת ריצות עבר של השגרה.

#צפייה בריצות ואינטראקציה איתן

לחץ על כל ריצה כדי לפתוח אותה כהפעלה מלאה. משם תוכל לראות מה Claude עשה, לבדוק שינויים, ליצור בקשת משיכה, או להמשיך את השיחה. כל הפעלת ריצה פועלת כמו כל הפעלה אחרת: השתמש בתפריט הנפתח ליד כותרת ההפעלה כדי לשנות את שמה, להעביר אותה לארכיון או למחוק אותה.

הערה: סטטוס ירוק ברשימת הריצות מציין שההפעלה התחילה והסתיימה ללא שגיאת תשתית. אין פירושו שהמשימה בהנחיה שלך הצליחה. פתח את הריצה כדי לקרוא את התמליל ולוודא מה Claude עשה בפועל. בקשות רשת חסומות, כלי מחבר חסרים וכשלים ברמת המשימה מופיעים כולם שם ולא במחוון הסטטוס.

#עריכה ושליטה בשגרות

מדף הפרטים של השגרה באפשרותך:

ללחוץ על Run now כדי להתחיל ריצה באופן מיידי מבלי לחכות למועד המתוזמן הבא. ניתן לספק באופן אופציונלי טקסט ספציפי לריצה, אשר מגיע לשגרה באותו אופן כמו שדה ה-text של טריגר ה-API.
להשתמש במתג ההפעלה והכיבוי בראש הדף כדי להשהות או לחדש את לוח הזמנים. שגרות מושהות שומרות על התצורה שלהן אך אינן רצות עד שתפעיל אותן מחדש.
לפתוח את התפריט ליד שם השגרה ולבחור ב-Edit כדי לשנות את השם, ההנחיה, המאגרים, הסביבה, המחברים או כל אחד מהטריגרים של השגרה. החלק Select a trigger הוא המקום שבו מוסיפים או מסירים לוחות זמנים, אסימוני API וטריגרי אירועי GitHub.
לפתוח את אותו תפריט ולבחור ב-Delete כדי למחוק את השגרה.

#ניהול שגרות מתוך ה-CLI

ה-CLI תומך בניהול שגרות קיימות. הרץ /schedule list כדי לראות את כל השגרות, /schedule update כדי לשנות שגרה, או /schedule run כדי להפעיל אותה באופן מיידי.

ניתן גם לשאול על היסטוריית הריצות של שגרה, לדוגמה /schedule why did my nightly review do nothing this morning?. Claude מציג את הריצות האחרונות של השגרה עם הסטטוס שלהן וקישור לפתיחת כל ריצה באינטרנט, וקורא את יומן הריצה כדי להסביר מה קרה, כולל שגיאות כלים, דחיות הרשאה והתוצאה הסופית. דורש את Claude Code בגרסה v2.1.227 ומעלה.

#הרשאות מאגרים וענפים

שגרות זקוקות לגישת GitHub כדי לשכפל מאגרים. כאשר אתה יוצר שגרה מתוך ה-CLI באמצעות /schedule, Claude בודק האם לחשבונך יש גישת GitHub למאגר שממנו הרצת אותה, ואם לא, הוא מוסיף הערת הגדרה המציינת כיצד להעניק אותה. ראה אפשרויות אימות GitHub לשתי הדרכים להענקת גישה.

אם חיבור ה-GitHub שלך חסר או פג תוקף כאשר מגיע מועד הריצה, השגרה מדלגת על ריצות עד שתתחבר מחדש, למשך עד 72 שעות. אם תחבר מחדש את GitHub בתוך חלון זה, השגרה תחזור לפעול מעצמה. לאחר 72 שעות ללא חיבור, השגרה נכבית, ועליך להפעיל אותה מחדש לאחר חיבור GitHub מחדש.

כל מאגר שתוסיף משוכפל בכל ריצה. Claude מתחיל מענף ברירת המחדל של המאגר, אלא אם ההנחיה שלך מציינת אחרת.

Claude דוחף את עבודתו לענפים עם הקידומת claude/, אשר תמיד מתקבלים. כאשר ההנחיה שלך מורה ל-Claude לדחוף לענף אחר, Claude Code בודק את הדחיפה תחילה ודוחה אותה אם אחד מהתנאים הבאים מתקיים:

הענף מוגן ב-GitHub.
למישהו אחר יש בקשת משיכה (PR) פתוחה מאותו ענף.
הענף כולל התחייבויות (commits) שנכתבו על ידי מישהו שאינו אתה.

#מחברים

שגרות יכולות להשתמש במחברי ה-MCP המחוברים שלך כדי לקרוא משירותים חיצוניים ולכתוב אליהם במהלך כל ריצה. לדוגמה, שגרה שממיינת פניות תמיכה עשויה לקרוא מערוץ Slack וליצור משימות ב-Linear.

מחברים הם האינטגרציות של claude.ai בחשבונך. שרתי MCP שהוספת מקומית ב-CLI באמצעות claude mcp add מאוחסנים במחשב שלך ולא בחשבון ה-claude.ai שלך, ולכן הם אינם מופיעים ברשימת המחברים. כדי להשתמש באחד משרתים אלה בשגרה, הוסף אותו כמחבר בכתובת claude.ai/customize/connectors. עבור שגרה עם מאגר יחיד, ניתן במקום זאת להצהיר עליו בקובץ .mcp.json שנשמר במאגר, כך שהוא יהיה חלק מהמאגר המשוכפל.

בעת יצירת שגרה, כל המחברים המחוברים שלך כרגע נכללים כברירת מחדל. הסר מחברים שאינם נחוצים כדי להגביל לאילו כלים תהיה ל-Claude גישה במהלך הריצה. ניתן גם להוסיף מחברים ישירות מטופס השגרה.

כדי לנהל או להוסיף מחברים מחוץ לטופס השגרה, בקר בכתובת claude.ai/customize/connectors או השתמש ב-/schedule update ב-CLI.

#סביבות וגישת רשת

כל שגרה משתמשת ב-סביבת ענן השולטת בגישת הרשת, במשתני הסביבה ובסקריפטים של ההגדרה. השגרה יורשת את מדיניות הרשת של הסביבה בכל ריצה.

סביבת ה-Default (ברירת מחדל) משתמשת בגישת רשת Trusted (מהימנה), המאפשרת מעבר ברשת של ההפעלה רק עבור רשימת ההיתרים של ברירת המחדל. בקשות בנתיב זה למארחים (hosts) מחוץ לרשימת ההיתרים נכשלות עם שגיאת 403 ו-x-deny-reason: host_not_allowed. תעבורת מחברי MCP מנותבת דרך השרתים של Anthropic ולא דרך נתיב זה, כך שהמחברים שתוסיף לשגרה פועלים מבלי להוסיף את המארחים שלהם אל Allowed domains. הסר מחברים שאינך צריך תחת מחברים.

כדי לאפשר דומיינים נוספים באחת מהסביבות שלך, בצע את השלבים הבאים. סביבה משותפת לארגון נפתחת כאן לקריאה בלבד, כך שבעל חשבון (Owner) משנה את גישת הרשת שלה מדף Cloud environments ב-הגדרות הניהול במקום זאת.

פתח את השגרה לעריכה: בדף הפרטים של השגרה, פתח את התפריט ליד שם השגרה ובחר ב-Edit.
פתח את בורר הסביבה: מתחת לתיבת ה-Instructions, בחר בסמל הענן המציג את שם הסביבה שלך, כגון Default.
פתח את הגדרות הסביבה: רחף עם העכבר מעל הסביבה ברשימה ולחץ על סמל ההגדרות שמופיע מימין.
שנה את רמת גישת הרשת: בתיבת הדו-שיח Update cloud environment, שנה את Network access ל-Custom והזן את הדומיינים שלך ב-Allowed domains. סמן את Also include default list of common package managers כדי לשמור על רשימת ההיתרים של ברירת המחדל לצד הדומיינים המותאמים אישית שלך. בחר ב-Full במקום זאת עבור גישה בלתי מוגבלת.
שמור: לחץ על Save changes. המדיניות החדשה תחול מהריצה הבאה.

ראה גישת רשת לפרטים על רמות גישה ועל רשימת ההיתרים של ברירת המחדל.

#שימוש ומגבלות

שגרות צורכות שימוש במנוי באותו אופן שבו הפעלות אינטראקטיביות צורכות אותו. בנוסף למגבלות המנוי הרגילות, לשגרות יש מכסה יומית על מספר הריצות שיכולות להתחיל לכל חשבון. ראה את הצריכה הנוכחית שלך ואת יתרת ריצות השגרה היומיות בכתובת claude.ai/code/routines או claude.ai/settings/usage.

כאשר שגרה מגיעה למכסה היומית או למגבלת השימוש במנוי שלך, ארגונים שבהם מופעלים זיכויי שימוש (usage credits) יכולים להמשיך להריץ שגרות על בסיס חריגה מדודה (metered overage). ללא זיכויי שימוש, ריצות נוספות נדחות עד לאיפוס החלון. הפעל זיכויי שימוש בכתובת claude.ai/settings/usage. בתוכניות Team ו-Enterprise, מנהל מערכת מפעיל אותם עבור הארגון בכתובת claude.ai/admin-settings/usage.

ריצות חד-פעמיות אינן נספרות כחלק ממכסת השגרות היומית. הן צורכות את השימוש הרגיל שלך במנוי כמו כל הפעלה אחרת.

בזמן שהמנוי שלך מושהה, השגרות שלך מוקפאות ואינן רצות. ברגע שהמנוי שלך פעיל שוב, הפעל אותן מחדש.

#פתרון בעיות

#הפקודה `/schedule` מחזירה "Unknown command"

ה-CLI מסתיר את /schedule כאשר אחת הדרישות שלה אינה מתקיימת: תפריט הפקודות מציג No commands match "/schedule" בזמן שאתה מקליד. שליחת הפקודה מחזירה Unknown command: /schedule, למעט במקרים שלהלן המציינים תשובה שונה.

הסיבה היא בדרך כלל אחת מהבאות:

אתה מאומת באמצעות מפתח Console API, פרופיל Anthropic או אישור פדרציה, או ספק ענן כגון Amazon Bedrock, Google Cloud's Agent Platform, או Microsoft Foundry. הפקודה /schedule דורשת התחברות עם מנוי claude.ai. עם מפתח Console API או פרופיל, וכאשר שליפת דגלי תכונות (feature flags) מופעלת, שליחת /schedule מציגה במקום זאת את ההודעה /schedule is available with Claude for Enterprise: ask your admin about migrating from API-key access. בעת התחברות דרך ספק ענן, עדיין תראה Unknown command: /schedule. אם ANTHROPIC_API_KEY או ANTHROPIC_AUTH_TOKEN מוגדרים במעטפת שלך, או ש-apiKeyHelper מוגדר ב-settings.json, הסר אותם תחילה, מכיוון שיש להם עדיפות על פני התחברות ל-claude.ai. גם לפרופיל או לאישור פדרציה יש עדיפות, לכן כבה גם אותם.
אתה מנותק לחלוטין, ללא מפתח API או אישור אחר. כאשר שליפת דגלי תכונות מופעלת, שליחת /schedule מציגה את ההודעה /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account.. לפני גרסה v2.1.268, הפעלה מנותקת הציגה את אותה הודעת Claude for Enterprise כמו מפתח Console API.
אתה נמצא בתוך הפעלת ענן, שבה שליחת /schedule משיבה שהפקודה אינה זמינה בסביבה זו. נהל שגרות מתוך ממשק האינטרנט במקום זאת.
מדיניות הארגון שלך משביתה הפעלות ענן, ששגרות דורשות אותן. במקרה זה, שליחת /schedule משיבה במקום זאת Cloud sessions are disabled by your organization's policy. לפני גרסה v2.1.268, היא החזירה Unknown command: /schedule.
בעל חשבון (Owner) כיבה את השגרות עבור ארגון ה-Team או ה-Enterprise שלך. לפני גרסה v2.1.227, הפקודה עדיין הופיעה במקרה זה, ו-claude.ai דחה את השגרה כאשר Claude ניסה ליצור או להריץ אותה.

אלא אם מדיניות הארגון שלך משביתה שגרות או הפעלות ענן, תוכל ליצור ולנהל שגרות בכתובת claude.ai/code/routines ללא קשר לאופן שבו ה-CLI מוגדר.

#"Routines are disabled by your organization's policy"

סביר להניח שבעל חשבון (Owner) בארגון ה-Team או ה-Enterprise שלך כיבה את מתג ה-Routines בכתובת claude.ai/admin-settings/claude-code. ב-Claude Code גרסה v2.1.227 ומעלה, אותו מתג גם מסתיר את /schedule ב-CLI. זוהי הגדרת ארגון בצד השרת, ולכן לא ניתן לעקוף אותה מהתצורה המקומית שלך. בקש מבעל חשבון להפעיל שגרות עבור הארגון שלך.

#משאבים קשורים

/loop ותזמון בתוך הפעלה: תזמון משימות מקומיות בתוך הפעלת CLI פתוחה.
משימות מתוזמנות בשולחן העבודה: משימות מתוזמנות מקומיות שרצות על המחשב שלך עם גישה לקבצים מקומיים.
סביבות ענן: הגדרת גישת רשת, משתני סביבה וסקריפטים של הגדרה עבור הפעלות ענן.
פרויקטים: עבודה מתמשכת ש-Claude מתאם בין הפעלות ענן מקבילות; שגרות שנוצרות מתוך פרויקט מופיעות בלשונית Routines שלו.
מחברי MCP: חיבור שירותים חיצוניים כמו Slack, Linear ו-Google Drive.
GitHub Actions: הרצת Claude בצינור ה-CI שלך בעת אירועי מאגר.