📘 תיעוד 23

תחילת העבודה עם Claude Code בענן

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

הערה: הפעלות ענן נמצאות בתצוגה מקדימה למחקר (research preview) עבור משתמשי Pro, Max ו-Team, ועבור משתמשי Enterprise עם מושבי פרימיום (premium seats) או מושבי Chat + Claude Code.

הפעלת ענן מריצה את Claude Code על תשתית ענן במקום על המחשב שלך, בניהול של Anthropic כברירת מחדל. מדריך התחלה מהירה זה מפעיל הפעלה מ-claude.ai/code בדפדפן שלך. תוכל גם להפעיל הפעלה מאפליקציית Claude לנייד, מאפליקציית שולחן העבודה (Desktop), או מהמסוף שלך באמצעות claude --cloud.

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

הפעלות ענן מתאימות היטב עבור:

• משימות מקביליות: הרצת מספר משימות בלתי תלויות בו-זמנית, כל אחת בהפעלה ובענף משלה, ללא צורך בניהול מספר worktrees
• מאגרים שאינם אצלך מקומית: Claude משכפל את המאגר מחדש בכל הפעלה, כך שאינך צריך שהוא יהיה משוך מקומית (checked out)
• משימות שאינן דורשות הכוונה תכופה: הגשת משימה מוגדרת היטב, מעבר לעיסוק אחר, ובדיקת התוצאה כאשר Claude מסיים
• שאלות על קוד וסריקה: הבנת בסיס קוד או מעקב אחר אופן המימוש של תכונה מסוימת ללא צורך במשיכה מקומית (checkout)

עבור עבודה הדורשת את ההגדרות, הכלים או הסביבה המקומית שלך, הרצת Claude Code באופן מקומי או שימוש ב-Remote Control מתאימים יותר.

#כיצד הפעלות רצות

השלבים הבאים מתארים הפעלות המתארחות אצל Anthropic. ב-סביבה באירוח עצמי, השכפול וכל מה שאחריו רצים על גבי מריצים (runners) של הארגון שלך, שבהם גבולות הרשת, ההתקנה והתנהגות הדחיפה מוגדרים על ידי המפעיל. כאשר אתה מגיש משימה:

1. שכפול והכנה (Clone and prepare): המאגר שלך משוכפל למכונה וירטואלית בניהול Anthropic, ו-סקריפט ההתקנה שלך רץ אם הוא מוגדר.
2. הגדרת רשת (Configure network): הגישה לאינטרנט מוגדרת לפי רמת הגישה של הסביבה שלך.
3. עבודה (Work): Claude מנתח קוד, מבצע שינויים, מריץ בדיקות ובודק את עבודתו. אתה יכול לצפות ולהכווין לכל אורך הדרך, או להתרחק ולחזור כשהוא מסיים.
4. דחיפת הענף (Push the branch): כאשר Claude מגיע לנקודת עצירה, הוא דוחף את הענף שלו ל-GitHub. אתה בודק את ה-diff, משאיר הערות מוטמעות (inline comments), יוצר PR, או שולח הודעה נוספת כדי להמשיך.

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

#השוואה בין דרכים להרצת Claude Code

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

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

#חיבור GitHub

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

הערה: בתוכניות Team ו-Enterprise, השלב Sign in with GitHub עובד רק לאחר שבעלים (Owner) של ארגון ה-Claude שלך מפעיל את מחבר ה-GitHub ב-Admin settings > Connectors. עד אז, שלב זה מציג "GitHub access is required for Claude Code on the web" במקום כפתור התחברות. לאחר שהמחבר מופעל, טען מחדש את claude.ai/code והתחל שוב מהשלב הראשון. מתג שני, Quick web setup ב-Admin settings > Claude Code, הוא אופציונלי: כאשר הוא מופעל, הפקודה /web-setup פועלת ותהליך הקליטה (onboarding) יוצר את הסביבה עבור החברים.

1. ביקור ב-claude.ai/code: היכנס אל claude.ai/code והתחבר עם חשבון ה-claude.ai שלך.

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

   באמצעות חיבור זה, הפעלה יכולה לשכפל כל מאגר ציבורי, אך יכולה לעבוד במאגר פרטי רק כאשר האפליקציה Claude GitHub App מותקנת עליו. התקן את Claude GitHub App בכל חשבון או ארגון GitHub שאת המאגרים הפרטיים שלהם אתה מעוניין להשתמש. בארגון GitHub, ייתכן שבעל הארגון יצטרך לאשר את ההתקנה. התקנתה מפעילה גם את תיקון אוטומטי (Auto-fix), המאפשר ל-Claude להגיב לכשלים ב-CI ולהערות בדיקה בבקשות משיכה (pull requests) במאגרים אלה.

   אם תהליך הקליטה מבקש ממך להתקין את Claude GitHub App בשלב זה ואתה מעדיף לעשות זאת מאוחר יותר, לחץ על Skip.

3. הגדרת סביבת ברירת המחדל שלך (Default): סביבת ענן היא התצורה השמורה שקובעת איזו גישת רשת תהיה ל-Claude במהלך הפעלות ומה ירוץ כאשר הפעלה מתחילה. מה שקורה לאחר חיבור GitHub תלוי בתוכנית שלך:

   • Pro ו-Max: תהליך הקליטה יוצר עבורך סביבה בשם Default.
   • Team ו-Enterprise: תהליך הקליטה מציג טופס Create your first cloud environment. השאר את השם שהוזן מראש ואת גישת הרשת ללא שינוי, ולחץ על Create & finish כדי ליצור את סביבת Default. אם בעלים הפעיל את Quick web setup, תהליך הקליטה יוצר את Default עבורך במקום זאת.

   סביבת Default משתמשת ב-גישת רשת מהימנה (Trusted): הפעלות מגיעות ל-מאגרי חבילות נפוצים (package registries) ולדומיינים נוספים ברשימת ההיתרים, ושום דבר מעבר לכך דרך רשת ההפעלה. ראה כלים מותקנים כדי לדעת מה זמין ללא כל הגדרה נוספת.

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

#התחברות מהמסוף שלך

אם אתה כבר משתמש ב-GitHub CLI (gh), תוכל לחבר את GitHub עבור הפעלות ענן מהמסוף שלך. הדבר דורש את Claude Code CLI. בתוכניות Team ו-Enterprise, הפקודה /web-setup זמינה רק לאחר שבעלים מפעיל את Quick web setup.

כאשר אתה מריץ /web-setup, Claude Code קורא את האסימון שמוצג על ידי gh auth token, מבקש ממך לאשר, ושולח את האסימון אל Anthropic. Anthropic שומרת אותו מוצפן עם חשבון ה-claude.ai שלך, והפעלות הענן שלך משתמשות בו לצורך גישה ל-GitHub עד שתסיר אותו (הסרת האסימון). הפעלת ענן שאתה מפעיל בעצמך יכולה לגשת לכל מאגר שלאסימון זה יש גישה אליו, ללא צורך בהתקנת Claude GitHub App. שרשורים בתוך פרויקט עדיין זקוקים ל-Claude GitHub App.

אם כבר חיברת את GitHub בדפדפן, /web-setup מזהיר שהמשך התהליך יחליף חיבור זה עבור הפעלות הענן שלך.

הערה: ארגונים שבהם מופעל Zero Data Retention אינם יכולים להשתמש ב-/web-setup או בתכונות הפעלת ענן אחרות. אם ה-GitHub CLI אינו מותקן או אינו מאומת, Claude Code פותח את תהליך הקליטה בדפדפן במקום זאת.

1. אימות מול ה-GitHub CLI: במעטפת הפקודות שלך (shell), בצע אימות מול ה-GitHub CLI אם עדיין לא עשית זאת:

   העתק

   gh auth login

2. התחברות אל Claude: ב-Claude Code CLI, הרץ /login כדי להתחבר עם חשבון ה-claude.ai שלך. דלג על שלב זה אם אתה כבר מחובר עם חשבון claude.ai. אימות באמצעות מפתח API אינו נחשב. כדי לבדוק, הרץ /status וודא שהשורה Login method מציגה חשבון claude.ai.

3. הרצת /web-setup: ב-Claude Code CLI, הרץ:

   העתק

   /web-setup

   אשר את הבקשה לשליחת אסימון ה-gh שלך לחשבון ה-Claude שלך. לאחר הצלחה, Claude Code מדפיס Connected as <your-github-username> ופותח את claude.ai/code בדפדפן שלך. אם עדיין אין לך סביבת ענן, /web-setup יוצר סביבה עם גישת רשת מהימנה (Trusted) וללא סקריפט התקנה. תוכל לערוך את הסביבה או להוסיף משתנים לאחר מכן. לאחר השלמת /web-setup, תוכל להתחיל הפעלות ענן מהמסוף שלך באמצעות --cloud או להגדיר משימות חוזרות באמצעות /schedule.

#הסרת האסימון של /web-setup

כדי להסיר את האסימון מחשבון ה-Claude שלך, נתק את GitHub ב-claude.ai/customize/connectors. הניתוק מוחק את אישורי ה-GitHub שבהם הפעלות הענן שלך משתמשות, בין אם הם הגיעו מהדפדפן ובין אם מ-/web-setup, כך שהפעלות ענן מאבדות גישה ל-GitHub עד שתתחבר שוב. ה-gh המקומי שלך נשאר מחובר, והאסימון נשאר תקף ב-GitHub.

כדי לבטל את תוקף האסימון עצמו, שלול אותו ב-GitHub. אם התחברת אל gh דרך הדפדפן, האסימון שייך לרשומה GitHub CLI תחת Settings > Applications > Authorized OAuth Apps ב-GitHub, ושלילת רשומה זו מנתקת גם את ה-GitHub CLI במחשבים שלך. הפעלות ענן יאבדו אז גישה ל-GitHub עד שתריץ שוב gh auth login ו-/web-setup.

#התחלת משימה

כאשר GitHub מחובר ונוצרה סביבה, אתה מוכן להגיש משימות.

1. בחירת מאגר וענף: מ-claude.ai/code או מלשונית הקוד באפליקציית Claude לנייד, לחץ על בורר המאגרים מתחת לתיבת הקלט ובחר מאגר שבו Claude יעבוד. כל מאגר מציג בורר ענפים. שנה אותו כדי להתחיל את Claude מענף תכונה (feature branch) במקום מברירת המחדל. תוכל להוסיף מספר מאגרים כדי לעבוד על פניהם בהפעלה אחת.

2. בחירת מצב הרשאה: התפריט הנפתח של המצב לצד הקלט מציג את המצב שבו ההפעלה תרוץ:

   • Auto: מסווג בודק את הפעולות של Claude במקום לשאול אותך. מופיע כאשר הארגון שלך מאפשר מצב אוטומטי והמודל הנבחר תומך בכך
   • Accept edits: Claude מבצע שינויים ודוחף ענף בלי לעצור לבקשת אישור
   • Plan: Claude מציע גישה וממתין שתאשר אותה לפני עריכת קבצים

   הפעלות ענן אינן מציעות הרשאות Manual או Bypass. ראה את הרשימה המלאה של מצבי הרשאה למה שכל אחד מהם מאפשר.

3. תיאור המשימה והגשה: הקלד תיאור של מה שאתה רוצה ולחץ על Enter. היה ספציפי:

   • ציין את שם הקובץ או הפונקציה: "Add a README with setup instructions" או "Fix the failing auth test in tests/test_auth.py" עדיף על פני "fix tests"
   • הדבק פלט שגיאה אם יש לך כזה
   • תאר את ההתנהגות הצפויה, לא רק את התסמין

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

#מילוי מראש של הפעלות

תוכל למלא מראש את ההנחיה (prompt), המאגרים והסביבה עבור הפעלה חדשה על ידי הוספת פרמטרים של שאילתה (query parameters) לכתובת ה-URL של claude.ai/code. השתמש בכך כדי לבנות אינטגרציות כגון כפתור במערכת מעקב המשימות שלך הפותח את Claude Code עם תיאור המשימה כהנחיה.

בצע קידוד URL (URL-encode) לכל ערך. הדוגמה הבאה פותחת את הטופס עם הנחיה ומאגר שכבר נבחרו:

https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

#בדיקה וחזרתיות

כאשר Claude מסיים, בדוק את השינויים, השאר משוב על שורות ספציפיות, והמשך עד שהשינויים (diff) נראים נכונים.

1. פתיחת תצוגת השינויים (diff view): מחוון שינויים מציג שורות שנוספו והוסרו לאורך ההפעלה, למשל +42 -18. בחר בו כדי לפתוח את תצוגת השינויים, עם רשימת קבצים בצד שמאל ושינויים בצד ימין.

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

2. השארת הערות מוטמעות (inline comments): בחר שורה כלשהי ב-diff, הקלד את המשוב שלך, ולחץ על Enter. הערות נכנסות לתור עד שאתה שולח את ההודעה הבאה שלך, ואז הן נארזות יחד איתה. Claude רואה "at src/auth.ts:47, don't catch the error here" לצד ההוראה הראשית שלך, כך שאינך צריך לתאר היכן הבעיה נמצאת.

3. יצירת בקשת משיכה (Pull Request): כאשר השינויים נראים נכונים, בחר Create PR בראש תצוגת השינויים. תוכל לפתוח אותה כ-PR מלא, כטיוטה (draft), או לקפוץ לדף החיבור של GitHub עם כותרת ותיאור שנוצרו אוטומטית.

4. המשך עבודה חזרתית לאחר ה-PR: ההפעלה נשארת פעילה לאחר יצירת ה-PR. הדבק פלט של כשל ב-CI או הערות בודקים לתוך הצ'אט ובקש מ-Claude לטפל בהן. כדי ש-Claude ינטר את ה-PR באופן אוטומטי, ראה תיקון אוטומטי של בקשות משיכה.

#פתרון בעיות בהגדרה

#לא מופיעים מאגרים לאחר חיבור GitHub

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

אם התחברת באמצעות /web-setup, הפעלות מגיעות לכל מאגר שלאסימון ה-gh שלך יש גישה אליו. הרץ gh repo view OWNER/REPO במעטפת שלך כדי לבדוק שההתחברות של ה-GitHub CLI שלך רואה את המאגר, והרץ שוב /web-setup אם החלפת חשבונות gh מאז שהתחברת.

#הדף מציג רק כפתור התחברות ל-GitHub

הפעלות ענן דורשות חשבון GitHub מחובר. התחבר באמצעות תהליך הדפדפן שלמעלה, או הרץ /web-setup מהמסוף שלך אם אתה משתמש ב-GitHub CLI. אם אתה מעדיף לא לחבר את GitHub כלל, עיין ב-Remote Control כדי להריץ את Claude Code על המחשב שלך ולנטר אותו מהדפדפן או מהטלפון שלך.

#"Not available for the selected organization"

בארגוני Enterprise, ייתכן שיידרש בעלים שיפעיל הפעלות ענן. צור קשר עם צוות הלקוחות שלך ב-Anthropic.

#/web-setup מציג "Not signed in to Claude"

אם /web-setup מגיב עם "Not signed in to Claude. Run /login first.", ל-CLI אין התחברות תקפה ל-claude.ai. מצב זה יכול לקרות גם כאשר תוקף התחברות קודמת פג. הרץ /login, התחבר עם חשבון ה-claude.ai שלך, ולאחר מכן הרץ שוב /web-setup.

#/web-setup מזהיר שלאסימון שלך אין את ההרשאה workflow

אם /web-setup מציין שלאסימון ה-GitHub CLI שלך אין את ההרשאה (scope) workflow, תוכל להמשיך, אך GitHub עלול לדחות דחיפות מסוימות שבוצעו באמצעות אסימון זה, כגון דחיפות המשנות קובצי תהליכי עבודה של GitHub Actions. כדי להוסיף את ההרשאה, הרץ gh auth refresh -s workflow במעטפת שלך, ולאחר מכן הרץ שוב /web-setup.

#/web-setup מציג "No commands match" או "Unknown command"

הפקודה /web-setup רצה בתוך ה-Claude Code CLI, לא במעטפת שלך. הפעל את claude תחילה, ולאחר מכן הקלד /web-setup בשורת הפקודה.

אם הקלדת אותה בתוך Claude Code ותפריט הפקודות מציג No commands match "/web-setup", או ששליחתה מחזירה Unknown command: /web-setup, הפקודה מוסתרת מכיוון שדרישה כלשהי אינה מתקיימת. הסיבה לכך היא בדרך כלל שאתה מאומת באמצעות מפתח API או ספק צד שלישי במקום מנוי claude.ai. הרץ /login כדי להתחבר עם חשבון ה-claude.ai שלך.

בתוכניות Team ו-Enterprise, הפקודה מוסתרת כברירת מחדל: המתג Quick web setup כבוי עד שבעלים מפעיל אותו. כל עוד הוא כבוי, חבר את GitHub מהדפדפן במקום זאת.

הפקודה מוסתרת גם בשני מקרים נוספים:

• מנהל מערכת השבית את הפעלות הענן עבור הארגון שלך. במקרה זה, שליחת /web-setup מחזירה Cloud sessions are disabled by your organization's policy. לפני גרסה v2.1.268, מקרה זה החזיר גם כן Unknown command: /web-setup.
• בארגון ה-Enterprise שלך מופעל Zero Data Retention, מה שהופך את הפעלות הענן ללא זמינות.

#"Could not create a cloud environment" או "No cloud environment available" בעת שימוש ב---cloud

תכונות הפעלת ענן יוצרות סביבת ענן ברירת מחדל באופן אוטומטי אם אין לך אחת. אם אתה רואה "Could not create a cloud environment", היצירה האוטומטית נכשלה. אם אתה רואה "No cloud environment available", ה-CLI שלך ישן יותר מהתכונה של יצירה אוטומטית. בכל אחד מהמקרים, הרץ /web-setup ב-Claude Code CLI, או הוסף סביבה מ-בורר הסביבות ב-claude.ai/code.

#כשל בסקריפט ההתקנה (Setup script failed)

סקריפט ההתקנה הסתיים עם קוד יציאה שאינו אפס (non-zero status), מה שחוסם את תחילת ההפעלה. סיבות נפוצות:

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

כדי לנפות שגיאות (debug), הוסף set -x בראש הסקריפט כדי לראות איזו פקודה נכשלה. עבור פקודות שאינן קריטיות, הוסף בסופן || true כדי שלא יחסמו את תחילת ההפעלה.

#הפעלות חדשות קופאות או חורגות ממגבלת הזמן במהלך ההתקנה

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

כדי לתקן זאת, צמצם את הסקריפט כך שיסתיים באופן אמין תוך פחות מחמש דקות:

• הרץ התקנות עצמאיות במקביל באמצעות & ופקודת wait בסוף במקום להריץ אותן בטור.
• העבר את ההורדות הגדולות ביותר אל מחוץ לסקריפט ההתקנה ואל תוך SessionStart hook שמפעיל אותן ברקע, כך שההפעלה תהיה שמישה בזמן שהן מסתיימות.
• הסר השהיות ארוכות של ניסיונות חוזרים (retry sleeps) מסקריפט ההתקנה, מכיוון שלולאת ניסיונות חוזרים שנתקעת נספרת כחלק ממכסת הזמן.

#ההפעלה ממשיכה לרוץ לאחר סגירת הלשונית

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

#השלבים הבאים

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

• שימוש ב-Claude Code בענן: המדריך המלא, כולל שיגור הפעלות (teleporting) למסוף שלך, שיתוף הפעלות, ותיקון אוטומטי של בקשות משיכה
• הגדרת סביבות ענן: רמות גישה לרשת, משתני סביבה, וסקריפטים להתקנה עבור הפעלות ענן
• שגרות (Routines): אוטומציה של עבודה לפי לוח זמנים, באמצעות קריאת API, או בתגובה לאירועי GitHub
• CLAUDE.md: מתן הנחיות והקשר קבועים ל-Claude הנטענים בתחילת כל הפעלה
• התקן את אפליקציית Claude לנייד עבור iOS או Android כדי לנטר הפעלות מהטלפון שלך. מתוך ה-Claude Code CLI, הפקודה /mobile מציגה קוד QR עבור claude.ai/mobile שפותח את חנות האפליקציות המתאימה לטלפון שלך.