📘 תיעוד 23

התחלה עם Claude Code בענן

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

[!NOTE]

סשנים בענן זמינים בתוכניות Pro, Max, Ultra ו-Team, ולמשתמשי Enterprise עם מושבי premium או מושבי Chat + Claude Code.

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

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

סשנים בענן מתאימים היטב ל:

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

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

#איך סשנים רצים

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

1. שכפול והכנה: המאגר שלך משוכפל ל-VM שמנוהל על ידי Anthropic, וסקריפט ההגדרה שלך רץ אם הוא מוגדר.
2. הגדרת רשת: הגישה לאינטרנט נקבעת לפי רמת הגישה של הסביבה שלך.
3. עבודה: Claude מנתח קוד, מבצע שינויים, מריץ בדיקות, ובודק את העבודה שלו. אפשר לצפות ולהנחות לאורך כל הדרך, או להתרחק ולחזור כשזה מסתיים.
4. דחיפת הענף: כש-Claude מגיע לנקודת עצירה, הוא דוחף את הענף שלו ל-GitHub. סוקרים את ה-diff, משאירים הערות בשורה, יוצרים PR, או שולחים הודעה נוספת כדי להמשיך.

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

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

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

ראה את התיעוד של המדריך המהיר לטרמינל, אפליקציית Desktop, או Remote Control כדי להגדיר סשנים מקומיים.

#חיבור GitHub

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

[!NOTE]

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

1. ביקור ב-claude.ai/code

עבור אל claude.ai/code והתחבר עם חשבון claude.ai שלך.

2. התחברות עם GitHub

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

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

כשמתחברים, Claude גם מקשר את חשבונות GitHub שבבעלותך לארגון Claude שלך, אם מותקן בהם Claude GitHub App. בתוכניות Team ו-Enterprise, Owners של ארגון Claude שלך רואים את החשבונות האלה ברשימת חשבונות GitHub המחוברים.

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

3. הגדרת סביבת Default

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

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

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

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

#חיבור מהטרמינל

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

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

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

[!NOTE]

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

1. אימות עם GitHub CLI

במעטפת, אמת את 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 או מלשונית Code באפליקציית Claude לנייד, לחץ על בורר המאגר מתחת לתיבת הקלט ובחר מאגר ש-Claude יעבוד בו. אפשר להוסיף כמה מאגרים כדי לעבוד עליהם בסשן אחד.

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

2. בחירת מצב הרשאה

פקד מצב ההרשאה מציג את מצב ההרשאה שבו הסשן ירוץ:

• Auto: מסווג סוקר את הפעולות של Claude במקום לשאול אותך. מופיע כשהארגון שלך מאפשר מצב auto והמודל שנבחר תומך בו
• 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 משכפל את המאגרים, מריץ את סקריפט ההגדרה שלך אם הוא מוגדר, ומתחיל לעבוד. כל משימה מקבלת סשן משלה וענף משלה, כך שאין צורך לחכות שאחת תסתיים לפני שמתחילים אחרת.

#מילוי מראש של סשנים

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

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

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

#סקירה ואיטרציה

כש-Claude מסיים, סקור את השינויים, השאר משוב על שורות מסוימות, והמשך עד שה-diff נראה נכון.

1. פתיחת תצוגת ה-diff

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

• אפשר גם ללחוץ על Changes בשורת הכותרת של הסשן, או בתפריט ⋮ של השורה.
• כדי להציג את הלוח כשהוא מוסתר, לחץ על סמל Show session rail בשורת הכותרת של הסשן, או בתפריט ⋮ של השורה.

ה-diff משווה את השינויים של הסשן מול ענף הבסיס שלו כברירת מחדל. כדי להשוות מול ענף אחר, בחר Compare against ובחר אחד. מול ענף הבסיס, ה-diff יכול להשמיט שינויים שעדיין לא נדחפו.

2. השארת הערות בשורה

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

3. יצירת pull request

כשה-diff נראה נכון, הצג שוב את הלוח אם כרטיס Changes לא בתצוגה, ואז צור pull request או טיוטה מהכרטיס:

• לחץ על Create PR. Claude Code יוצר את ה-pull request עם כותרת ותיאור שנוצרו.
• כדי לפתוח טיוטה במקום זאת, לחץ לחיצה ימנית על Create PR, בחר Create draft PR כדי לשנות מה הכפתור עושה, ואז לחץ על הכפתור

4. המשך איטרציה אחרי ה-PR

הסשן נשאר פעיל אחרי יצירת ה-PR. הדבק פלט של כשל CI או הערות סוקר בצ'אט ובקש מ-Claude לטפל בהן. כדי ש-Claude יעקוב אחרי ה-PR אוטומטית, ראה Auto-fix pull requests.

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

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

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

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

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

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

#"Claude Code isn't available on your account"

המושב שלך בארגון שנבחר לא כולל את Claude Code. אם אתה שייך לארגון אחר, לחץ על Switch organization בדף הזה. אחרת, בקש מ-Owner של הארגון להקצות לך מושב שכולל את Claude Code.

#/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 שלך אין את ההיקף workflow, אפשר להמשיך, אבל GitHub יכול לדחות חלק מהדחיפות שנעשות עם הטוקן הזה, כמו דחיפות שמשנות קבצי workflow של 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 setup כבוי עד ש-Owner מפעיל אותו. כל עוד הוא כבוי, חבר את GitHub מהדפדפן במקום זאת.

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

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

#"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.

#סקריפט ההגדרה נכשל

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

סיבות נפוצות:

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

כדי לאתר את התקלה, הוסף set -x בראש הסקריפט כדי לראות איזו פקודה נכשלה. לפקודות שאינן קריטיות, הוסף בסוף || true כדי שלא יכשילו את הסקריפט. אחרי שתתקן את הסיבה, התחל סשן חדש כדי שהסקריפט ירוץ שוב. אם מה שנכשל להתחיל היה הרצה של משימה מתוזמנת בענן, לחץ על Run now בדף הפרטים של המשימה במקום להתחיל סשן חדש.

#סשנים חדשים נתקעים או פגים במהלך ההגדרה

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

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

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

#הסשן ממשיך לרוץ אחרי סגירת הלשונית

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

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

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

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